Vec3 类型

继承于 ValueType

模块: cc 父模块: cc

表示 3D 向量和坐标

索引

属性(properties)
  • x Number
  • y Number
  • z Number
  • ONE Vec3 新 Vec3 对象。
  • ZERO Vec3 返回 x = 0,y = 0,z = 0 的 Vec3 对象。
  • UP Vec3 返回 x = 0, y = 1, z = 0 的 Vec3 对象。
  • RIGHT Vec3 返回 x = 1,y = 0,z = 0 的 Vec3 对象。
  • FRONT Vec3 返回 x = 0,y = 0,z = 1 的 Vec3 对象。
方法
  • 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'
  • angle 夹角的弧度。
  • project 返回当前向量在指定 vector 向量上的投影向量。
  • signAngle 带方向的夹角的弧度。
  • rotate 返回旋转给定弧度后的新向量。
  • rotateSelf 按指定弧度旋转向量。

Details

属性(properties)

x
meta description
类型 Number
定义于 cocos2d/core/value-types/vec3.js:70
y
meta description
类型 Number
定义于 cocos2d/core/value-types/vec3.js:73
z
meta description
类型 Number
定义于 cocos2d/core/value-types/vec3.js:76
ONE

新 Vec3 对象。

meta description
类型 Vec3
定义于 cocos2d/core/value-types/vec3.js:533
ZERO

返回 x = 0,y = 0,z = 0 的 Vec3 对象。

meta description
类型 Vec3
定义于 cocos2d/core/value-types/vec3.js:544
UP

返回 x = 0, y = 1, z = 0 的 Vec3 对象。

meta description
类型 Vec3
定义于 cocos2d/core/value-types/vec3.js:555

返回 x = 1,y = 0,z = 0 的 Vec3 对象。

meta description
类型 Vec3
定义于 cocos2d/core/value-types/vec3.js:566
FRONT

返回 x = 0,y = 0,z = 1 的 Vec3 对象。

meta description
类型 Vec3
定义于 cocos2d/core/value-types/vec3.js:577

方法

constructor

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

meta description
定义于 cocos2d/core/value-types/vec3.js:46
参数列表
clone

克隆一个 Vec3 值

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:83
set

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

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

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

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

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

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

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

meta description
返回 string
定义于 cocos2d/core/value-types/vec3.js:140
lerp

线性插值。

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:154
参数列表
  • 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。
否则返回自身。

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

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

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

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:203
参数列表
  • 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() 代替。

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

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:234
参数列表
  • 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() 代替。

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

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:265
参数列表
  • 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

分量相乘。

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

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:296
参数列表
  • 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() 代替。

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

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:327
参数列表
  • 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
negSelf

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:343
neg

返回取反后的新向量。

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:357
参数列表
  • 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

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

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

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

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

返回该向量的长度。

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

返回该向量的长度平方。

meta description
返回 number
定义于 cocos2d/core/value-types/vec3.js:410
normalizeSelf

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:420
normalize

返回归一化后的向量。

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

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:432
参数列表
  • 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'

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:451
参数列表
  • m Mat4 matrix to transform with
  • 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
angle

夹角的弧度。

meta description
返回 number
定义于 cocos2d/core/value-types/vec3.js:463
参数列表
project

返回当前向量在指定 vector 向量上的投影向量。

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:472
参数列表
示例
var v1 = cc.v3(20, 20, 20);
var v2 = cc.v3(5, 5, 5);
v1.project(v2); // Vec3 {x: 20, y: 20, z: 20};
signAngle

带方向的夹角的弧度。该方法仅用做兼容 2D 计算。

meta description
返回 number
定义于 cocos2d/core/value-types/vec3.js:487
参数列表
rotate

返回旋转给定弧度后的新向量。该方法仅用做兼容 2D 计算。

meta description
返回 Vec2 | Vec3
定义于 cocos2d/core/value-types/vec3.js:503
参数列表
  • radians number
  • out Vec3 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created
rotateSelf

按指定弧度旋转向量。该方法仅用做兼容 2D 计算。

meta description
返回 Vec3
定义于 cocos2d/core/value-types/vec3.js:516
参数列表

条与 "" 相匹配的结果

    没有与 "" 匹配的结果