Vec3 类型

继承于 ValueType

模块: cc父模块: cc

表示 3D 向量和坐标

索引

属性(properties)
  • x Number
  • y Number
  • z Number
方法
  • constructor 构造函数,可查看 Cc/vec3:method
  • clone 克隆一个 Vec3 值
  • set 用另一个向量设置当前的向量对象值。
  • equals 当前的向量是否与指定的向量相等。
  • fuzzyEquals 近似判断两个点是否相等。
  • toString 转换为方便阅读的字符串。
  • lerp 线性插值。
  • clampf 返回指定限制区域后的向量。
  • addSelf 向量加法。
  • add 向量加法,并返回新结果。
  • subSelf 向量减法。
  • sub 向量减法,并返回新结果。
  • mulSelf 缩放当前向量。
  • mul 缩放向量,并返回新结果。
  • scaleSelf 分量相乘。
  • scale 分量相乘,并返回新的结果。
  • divSelf 向量除法。
  • div 向量除法,并返回新的结果。
  • negSelf 向量取反。
  • neg 返回取反后的新向量。
  • dot 当前向量与指定向量进行点乘。
  • cross 当前向量与指定向量进行叉乘。
  • mag 返回该向量的长度。
  • magSqr 返回该向量的长度平方。
  • normalizeSelf 向量归一化,让这个向量的长度为 1。
  • normalize 返回归一化后的向量。
  • transformMat4 Transforms the vec3 with a mat4. 4th vector component is implicitly '1'
  • v3 通过该简便的函数进行创建 cc.Vec3 对象。

Details

属性(properties)

x

metadescription
类型Number
定义于cocos2d/core/value-types/vec3.js:68
y

metadescription
类型Number
定义于cocos2d/core/value-types/vec3.js:71
z

metadescription
类型Number
定义于cocos2d/core/value-types/vec3.js:74



#### 方法



##### constructor


构造函数,可查看 Cc/vec3:method

metadescription
定义于cocos2d/core/value-types/vec3.js:44
参数列表
clone

克隆一个 Vec3 值

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:81
set

用另一个向量设置当前的向量对象值。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:91
参数列表
  • newValue Vec3 !#en new value to set. !#zh 要设置的新值
equals

当前的向量是否与指定的向量相等。

metadescription
返回Boolean
定义于cocos2d/core/value-types/vec3.js:106
参数列表
fuzzyEquals

近似判断两个点是否相等。判断 2 个向量是否在指定数值的范围之内,如果在则返回 true,反之则返回 false。

metadescription
返回Boolean
定义于cocos2d/core/value-types/vec3.js:118
参数列表
toString

转换为方便阅读的字符串。

metadescription
返回string
定义于cocos2d/core/value-types/vec3.js:138
lerp

线性插值。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:152
参数列表
  • to Vec3
  • ratio number the interpolation coefficient
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
clampf

返回指定限制区域后的向量。向量大于 max_inclusive 则返回 max_inclusive。向量小于 min_inclusive 则返回 min_inclusive。否则返回自身。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:167
参数列表
addSelf

向量加法。如果你想保存结果到另一个向量,使用 add() 代替。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:186
参数列表
add

向量加法,并返回新结果。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:201
参数列表
  • vector Vec3
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
subSelf

向量减法。如果你想保存结果到另一个向量,可使用 sub() 代替。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:217
参数列表
sub

向量减法,并返回新结果。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:232
参数列表
  • vector Vec3
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
mulSelf

缩放当前向量。如果你想结果保存到另一个向量,可使用 mul() 代替。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:248
参数列表
mul

缩放向量,并返回新结果。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:263
参数列表
  • num number
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
scaleSelf

分量相乘。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:279
参数列表
scale

分量相乘,并返回新的结果。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:294
参数列表
  • vector Vec3
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
divSelf

向量除法。如果你想结果保存到另一个向量,可使用 div() 代替。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:310
参数列表
div

向量除法,并返回新的结果。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:325
参数列表
  • vector Vec3
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
negSelf

向量取反。如果你想结果保存到另一个向量,可使用 neg() 代替。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:341
neg

返回取反后的新向量。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:355
参数列表
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
dot

当前向量与指定向量进行点乘。

metadescription
返回number
定义于cocos2d/core/value-types/vec3.js:370
参数列表
cross

当前向量与指定向量进行叉乘。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:381
参数列表
mag

返回该向量的长度。

metadescription
返回number
定义于cocos2d/core/value-types/vec3.js:395
示例
  1. var v = cc.v2(10, 10);
  2. v.mag(); // return 14.142135623730951;
magSqr

返回该向量的长度平方。

metadescription
返回number
定义于cocos2d/core/value-types/vec3.js:408
normalizeSelf

向量归一化,让这个向量的长度为 1。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:418
normalize

返回归一化后的向量。注意,当前向量不变,并返回一个新的归一化向量。如果你想来归一化当前向量,可使用 normalizeSelf 函数。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:430
参数列表
  • out Vec3 optional, the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
transformMat4

Transforms the vec3 with a mat4. 4th vector component is implicitly '1'

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:449
参数列表
  • m Mat4 matrix to transform with
    • m00 Number Component in column 0, row 0 position (index 0)
    • m01 Number Component in column 0, row 1 position (index 1)
    • m02 Number Component in column 0, row 2 position (index 2)
    • m03 Number Component in column 0, row 3 position (index 3)
    • m10 Number Component in column 1, row 0 position (index 4)
    • m11 Number Component in column 1, row 1 position (index 5)
    • m12 Number Component in column 1, row 2 position (index 6)
    • m13 Number Component in column 1, row 3 position (index 7)
    • m20 Number Component in column 2, row 0 position (index 8)
    • m21 Number Component in column 2, row 1 position (index 9)
    • m22 Number Component in column 2, row 2 position (index 10)
    • m23 Number Component in column 2, row 3 position (index 11)
    • m30 Number Component in column 3, row 0 position (index 12)
    • m31 Number Component in column 3, row 1 position (index 13)
    • m32 Number Component in column 3, row 2 position (index 14)
    • m33 Number Component in column 3, row 3 position (index 15)
  • out Vec3 the receiving vector, you can pass the same vec3 to save result to itself, if not provided, a new vec3 will be created
v3

通过该简便的函数进行创建 cc.Vec3 对象。

metadescription
返回Vec3
定义于cocos2d/core/value-types/vec3.js:461
参数列表
示例
  1. var v1 = cc.v3();
  2. var v2 = cc.v3(0, 0, 0);
  3. var v3 = cc.v3(v2);
  4. var v4 = cc.v3({x: 100, y: 100, z: 0});