Public 成员函数 - 《Cocos2dx 3.0 api 文档帮助手册教程》

详细描述
构造及析构函数说明
成员函数说明
类成员变量说明

cocos2d-x 3.0

- 首页 - 相关页面 - 模块 - 命名空间 - 类 - 文件 -

)
- 类列表 - 类索引 - 类继承关系 - 类成员

全部) 类) 命名空间) 文件) 函数) 变量) 类型定义) 枚举) 枚举值) 属性) 友元) 宏定义) 组) 页)

Public 成员函数 | 静态 Public 成员函数 | Public 属性 | 静态 Public 属性 | 所有成员列表

Vec4类参考

定义一个四维浮点向量更多…

#include

## Public 成员函数
	Vec4 ()
	构造一个初始值为零的向量更多…

	Vec4 (float xx, float yy, float zz, float ww)
	构造一个新的向量并用特定值初始化 xx为x方向的值 yy为y方向的值 zz为z方向的值 ww为w方向的值更多…

	Vec4 (const float array)
	用特定array来构造一个新的向量该array顺序包含向量x,y,z,w各分量的值。更多…

	Vec4 (const Vec4 &p1, const Vec4 &p2)
	构造一个由p1指向p2的向量。更多…

	Vec4 (const Vec4 &copy)
	拷贝一个已有向量更多…

	~Vec4 ()
	虚构函数更多…

bool	isZero () const
	该向量是否为零（每个分量都为零）如果该向量为零返回true，否则返回false 更多…

bool	isOne () const
	该向量是否为单位向量（每个分量都为1）如果该向量为单位向量则返回true,否则返回false 更多…

void	add (const Vec4 &v)
	与给定向量v求和，结果保存在本向量中更多…

void	clamp (const Vec4 &min, const Vec4 &max)
	将向量限制在指定范围内，min为最小值，max为最大值。更多…

float	distance (const Vec4 &v) const
	计算向量与v的距离并返回更多…

float	distanceSquared (const Vec4 &v) const
	计算向量与v的距离的平方并返回更多…

float	dot (const Vec4 &v) const
	计算向量与v的点积并返回更多…

float	length () const
	计算向量的长度并返回更多…

float	lengthSquared () const
	计算向量长度的平方并返回当不是必须使用精确长度的时候建议使用本方法代替length(）（如比较不同向量的长度）。更多…

void	negate ()
	求反向量更多…

void	normalize ()
	求向量的标准化向量更多…

Vec4	getNormalized () const
	标准化这个向量并将结果保存在dst中更多…

void	scale (float scalar)
	用指定的放缩系数scalar对向量的各分量进行放缩更多…

void	set (float xx, float yy, float zz, float ww)
	设置当前向量各分量值为指定值 xx是新的x分量值 yy是新的y分量值 zz是新的z分量值 ww是新的w分量值更多…

void	set (const float array)
	给定array序列，依序设置向量x,y,z，w各分量的值。更多…

void	set (const Vec4 &v)
	拷贝向量v的值到本向量中更多…

void	set (const Vec4 &p1, const Vec4 &p2)
	设置向量值由给定两点求得。更多…

void	subtract (const Vec4 &v)
	求与向量v的差（this-v），并将结果保存在本向量中. 更多…

const Vec4	operator+ (const Vec4 &v) const
	向量加法，求向量与给定向量v的和注意：这个加法并不改变原向量的值，返回值单独定义。更多…

Vec4 &	operator+= (const Vec4 &v)
	向量加法，求向量与给定向量v的和，将结果保存在该向量中，并返回。更多…

const Vec4	operator- (const Vec4 &v) const
	向量减法，求向量与给定向量v的差注意：这个减法并不改变原向量的值，返回值单独定义更多…

Vec4 &	operator-= (const Vec4 &v)
	向量减法，求向量与给定向量v的差，将结果保存在该向量中，并返回。更多…

const Vec4	operator- () const
	求反向量注意：这个方法并不改变原向量的值，返回值单独定义更多…

const Vec4	operator* (float s) const
	向量乘法，给定浮点数s，求向量各分量分别乘以s后的值。注意：这个方法并不改变原向量的值，返回值单独保存。更多…

Vec4 &	operator*= (float s)
	向量乘法，给定浮点数s，求向量各分量分别乘以s后的值，将所得结果保存在原向量中。更多…

const Vec4	operator/ (float s) const
	向量除法，给定浮点数s，求向量各分量分别除以s后的值。注意：这个方法并不改变原向量的值，返回值单独保存。更多…

bool	operator< (const Vec4 &v) const
	判断该向量是否小于给定向量v，如果小于则返回true，否则返回false。更多…

bool	operator== (const Vec4 &v) const
	判断该向量是否等于给定向量v，如果等于则返回True，否则返回false。更多…

bool	operator!= (const Vec4 &v) const
	判断该向量是否不等于给定向量v，如果不等则返回True，否则返回False。更多…

## 静态 Public 成员函数
static Vec4	fromColor (unsigned int color)
	用一个表示RGBA颜色值的整数来创建一个向量例如：Oxff0000ff表示不透明红色，向量值为（1，0，0，1）. 更多…

static float	angle (const Vec4 &v1, const Vec4 &v2)
	返回两个给定向量v1,v2之间的角度（单位为弧度）更多…

static void	add (const Vec4 &v1, const Vec4 &v2, Vec4 dst)
	求向量v1与v2的和，结果保存在dst中更多…

static void	clamp (const Vec4 &v, const Vec4 &min, const Vec4 &max, Vec4 dst)
	将给定的向量v限制在指定范围[min,max]内，结果保存在dst中。更多…

static float	dot (const Vec4 &v1, const Vec4 &v2)
	计算v1与v2的点积并返回。更多…

static void	subtract (const Vec4 &v1, const Vec4 &v2, Vec4 *dst)
	求v1-v2的值，将结果保存在dst中。更多…

## Public 属性
float	x
	x方向分量更多…

float	y
	y方向分量更多…

float	z
	z方向分量更多…

float	w
	w方向分量更多…

## 静态 Public 属性
static const Vec4	ZERO
	等于 Vec4(0,0,0,0) 更多…

static const Vec4	ONE
	等于 Vec4(1,1,1,1) 更多…

static const Vec4	UNIT_X
	等于 Vec4(1,0,0,0) 更多…

static const Vec4	UNIT_Y
	等于 Vec4(0,1,0,0) 更多…

static const Vec4	UNIT_Z
	等于 Vec4(0,0,1,0) 更多…

static const Vec4	UNIT_W
	等于 Vec4(0,0,0,1) 更多…

详细描述

定义一个四维浮点向量

构造及析构函数说明

Vec4

(

)

构造一个初始值为零的向量

Vec4	(	float	xx,
		float	yy,
		float	zz,
		float	ww
	)

构造一个新的向量并用特定值初始化 xx为x方向的值 yy为y方向的值 zz为z方向的值 ww为w方向的值

Vec4

(

const float *

array

)

用特定array来构造一个新的向量该array顺序包含向量x,y,z,w各分量的值。

Vec4	(	const Vec4 &	p1,
		const Vec4 &	p2
	)

构造一个由p1指向p2的向量。

Vec4

(

const Vec4 &

copy

)

拷贝一个已有向量

~Vec4

(

)

虚构函数

成员函数说明

void add

(

const Vec4 &

)

与给定向量v求和，结果保存在本向量中

static void add	(	const Vec4 &	v1,
		const Vec4 &	v2,
		Vec4 *	dst
	)

static

求向量v1与v2的和，结果保存在dst中

static float angle	(	const Vec4 &	v1,
		const Vec4 &	v2
	)

static

返回两个给定向量v1,v2之间的角度（单位为弧度）

void clamp	(	const Vec4 &	min,
		const Vec4 &	max
	)

将向量限制在指定范围内，min为最小值，max为最大值。

static void clamp	(	const Vec4 &	v,
		const Vec4 &	min,
		const Vec4 &	max,
		Vec4 *	dst
	)

static

将给定的向量v限制在指定范围[min,max]内，结果保存在dst中。

float distance

(

const Vec4 &

)

const

计算向量与v的距离并返回

float distanceSquared

(

const Vec4 &

)

const

计算向量与v的距离的平方并返回

当不是必须使用精确距离的时候建议使用本方法代替distance(const Vec3& v）（如比较不同向量间距离大小）

float dot

(

const Vec4 &

)

const

计算向量与v的点积并返回

static float dot	(	const Vec4 &	v1,
		const Vec4 &	v2
	)

static

计算v1与v2的点积并返回。

static Vec4 fromColor

(

unsigned int

color

)

static

用一个表示RGBA颜色值的整数来创建一个向量例如：Oxff0000ff表示不透明红色，向量值为（1，0，0，1）.

参数color为该RGBA值返回该颜色值对应生成的向量

Vec4 getNormalized

(

)

const

标准化这个向量并将结果保存在dst中

如果向量已经是单位长度或者长度为零，这个方法将简单的把当前向量值拷贝到dst中。

bool isOne

(

)

const

该向量是否为单位向量（每个分量都为1）如果该向量为单位向量则返回true,否则返回false

bool isZero

(

)

const

该向量是否为零（每个分量都为零）如果该向量为零返回true，否则返回false

float length

(

)

const

计算向量的长度并返回

float lengthSquared

(

)

const

计算向量长度的平方并返回当不是必须使用精确长度的时候建议使用本方法代替length(）（如比较不同向量的长度）。

void negate

(

)

求反向量

void normalize

(

)

求向量的标准化向量

这个方法标准化一个Vec4向量为单位长度（调用这个方法后向量长度为1.0f）。如果向量已经是单位长度或者长度为零，这个方法不起任何作用。

bool operator!=

(

const Vec4 &

)

const

inline

判断该向量是否不等于给定向量v，如果不等则返回True，否则返回False。

const Vec4 operator*

(

float

)

const

inline

向量乘法，给定浮点数s，求向量各分量分别乘以s后的值。注意：这个方法并不改变原向量的值，返回值单独保存。

Vec4& operator*=

(

float

)

inline

向量乘法，给定浮点数s，求向量各分量分别乘以s后的值，将所得结果保存在原向量中。

const Vec4 operator+

(

const Vec4 &

)

const

inline

向量加法，求向量与给定向量v的和注意：这个加法并不改变原向量的值，返回值单独定义。

Vec4& operator+=

(

const Vec4 &

)

inline

向量加法，求向量与给定向量v的和，将结果保存在该向量中，并返回。

const Vec4 operator-

(

const Vec4 &

)

const

inline

向量减法，求向量与给定向量v的差注意：这个减法并不改变原向量的值，返回值单独定义

const Vec4 operator-

(

)

const

inline

求反向量注意：这个方法并不改变原向量的值，返回值单独定义

Vec4& operator-=

(

const Vec4 &

)

inline

向量减法，求向量与给定向量v的差，将结果保存在该向量中，并返回。

const Vec4 operator/

(

float

)

const

inline

向量除法，给定浮点数s，求向量各分量分别除以s后的值。注意：这个方法并不改变原向量的值，返回值单独保存。

bool operator<

(

const Vec4 &

)

const

inline

判断该向量是否小于给定向量v，如果小于则返回true，否则返回false。

bool operator==

(

const Vec4 &

)

const

inline

判断该向量是否等于给定向量v，如果等于则返回True，否则返回false。

void scale

(

float

scalar

)

用指定的放缩系数scalar对向量的各分量进行放缩

void set	(	float	xx,
		float	yy,
		float	zz,
		float	ww
	)

设置当前向量各分量值为指定值 xx是新的x分量值 yy是新的y分量值 zz是新的z分量值 ww是新的w分量值

void set

(

const float *

array

)

给定array序列，依序设置向量x,y,z，w各分量的值。

void set

(

const Vec4 &

)

拷贝向量v的值到本向量中

void set	(	const Vec4 &	p1,
		const Vec4 &	p2
	)

设置向量值由给定两点求得。

void subtract

(

const Vec4 &

)

求与向量v的差（this-v），并将结果保存在本向量中.

static void subtract	(	const Vec4 &	v1,
		const Vec4 &	v2,
		Vec4 *	dst
	)

static

求v1-v2的值，将结果保存在dst中。

类成员变量说明

const Vec4 ONE

static

等于 Vec4(1,1,1,1)

const Vec4 UNIT_W

static

等于 Vec4(0,0,0,1)

const Vec4 UNIT_X

static

等于 Vec4(1,0,0,0)

const Vec4 UNIT_Y

static

等于 Vec4(0,1,0,0)

const Vec4 UNIT_Z

static

等于 Vec4(0,0,1,0)

float w

w方向分量

float x

x方向分量

float y

y方向分量

float z

z方向分量

const Vec4 ZERO

static

等于 Vec4(0,0,0,0)

该类的文档由以下文件生成:

/Users/zeroyang/Documents/github/cocos2d-x/cocos/math/Vector4.h

Vec4
生成于 2014年五月 29日星期四 09:41:43 , 为 cocos2d-x使用 1.8.6