Vec4 类型

继承于 ValueType

模块: cc 父模块: cc

表示 3D 向量和坐标

索引

属性(properties)
  • x Number
  • y Number
  • z Number
  • w Number
方法
  • subSelf 向量减法。
  • sub 向量减法,并返回新结果。
  • mulSelf 缩放当前向量。
  • mul 缩放向量,并返回新结果。
  • divSelf 向量除法。
  • div 向量除法,并返回新的结果。
  • scaleSelf 分量相乘。
  • scale 分量相乘,并返回新的结果。
  • negSelf 向量取反。
  • neg 返回取反后的新向量。
  • clone 获得指定向量的拷贝
  • copy 复制目标向量
  • set 设置向量值
  • add 逐元素向量加法
  • subtract 逐元素向量减法
  • multiply 逐元素向量乘法
  • divide 逐元素向量除法
  • ceil 逐元素向量向上取整
  • floor 逐元素向量向下取整
  • min 逐元素向量最小值
  • max 逐元素向量最大值
  • round 逐元素向量四舍五入取整
  • multiplyScalar 向量标量乘法
  • scaleAndAdd 逐元素向量乘加: A + B * scale
  • distance 求两向量的欧氏距离
  • squaredDistance 求两向量的欧氏距离平方
  • len 求向量长度
  • lengthSqr 求向量长度平方
  • negate 逐元素向量取负
  • inverse 逐元素向量取倒数,接近 0 时返回 Infinity
  • inverseSafe 逐元素向量取倒数,接近 0 时返回 0
  • normalize 归一化向量
  • dot 向量点积(数量积)
  • lerp 逐元素向量线性插值: A + t * (B - A)
  • random 生成一个在单位球体上均匀分布的随机向量
  • transformMat4 向量矩阵乘法
  • transformQuat 向量四元数乘法
  • strictEquals 向量等价判断
  • equals 排除浮点数误差的向量近似等价判断
  • toArray 向量转数组
  • fromArray 数组转向量
  • constructor 构造函数,可查看 Cc/vec4:method
  • clone 克隆一个 Vec4 值
  • set 用另一个向量设置当前的向量对象值。
  • equals 当前的向量是否与指定的向量相等。
  • equals4f 判断当前向量是否在误差范围内与指定分量的向量相等。
  • strictEquals 判断当前向量是否与指定向量相等。
  • strictEquals4f 判断当前向量是否与指定分量的向量相等。
  • lerp 根据指定的插值比率,从当前向量到目标向量之间做插值。
  • toString 返回当前向量的字符串表示。
  • clampf 设置当前向量的值,使其各个分量都处于指定的范围内。
  • addSelf 向量加法。
  • add 向量加法,并返回新结果。
  • subtract 向量减法,并返回新结果。
  • multiplyScalar 缩放当前向量。
  • multiply 分量相乘。
  • divide 向量除法。
  • negate 向量取反
  • dot 当前向量与指定向量进行点乘。
  • cross 当前向量与指定向量进行叉乘。
  • len 返回该向量的长度。
  • lengthSqr 返回该向量的长度平方。
  • normalizeSelf 向量归一化,让这个向量的长度为 1。
  • normalize 返回归一化后的向量。
  • transformMat4 Transforms the vec4 with a mat4. 4th vector component is implicitly '1'
  • maxAxis Returns the maximum value in x, y, z, w.

Details

属性(properties)

x
meta description
类型 Number
定义于 cocos2d/core/value-types/vec4.ts:728
y
meta description
类型 Number
定义于 cocos2d/core/value-types/vec4.ts:733
z
meta description
类型 Number
定义于 cocos2d/core/value-types/vec4.ts:738
w
meta description
类型 Number
定义于 cocos2d/core/value-types/vec4.ts:743

方法

subSelf

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:57
参数列表
sub

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:66
参数列表
  • vector Vec4
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
mulSelf

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:77
参数列表
mul

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:86
参数列表
  • num number
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
divSelf

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:97
参数列表
div

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:106
参数列表
  • num number
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
scaleSelf

分量相乘。

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:117
参数列表
scale

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:126
参数列表
  • vector Vec4
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
negSelf

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:137
neg

返回取反后的新向量。

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:145
参数列表
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
clone

获得指定向量的拷贝

meta description
定义于 cocos2d/core/value-types/vec4.ts:165
copy

复制目标向量

meta description
定义于 cocos2d/core/value-types/vec4.ts:177
set

设置向量值

meta description
定义于 cocos2d/core/value-types/vec4.ts:193
add

逐元素向量加法

meta description
定义于 cocos2d/core/value-types/vec4.ts:209
subtract

逐元素向量减法

meta description
定义于 cocos2d/core/value-types/vec4.ts:225
multiply

逐元素向量乘法

meta description
定义于 cocos2d/core/value-types/vec4.ts:241
divide

逐元素向量除法

meta description
定义于 cocos2d/core/value-types/vec4.ts:257
ceil

逐元素向量向上取整

meta description
定义于 cocos2d/core/value-types/vec4.ts:273
floor

逐元素向量向下取整

meta description
定义于 cocos2d/core/value-types/vec4.ts:289
min

逐元素向量最小值

meta description
定义于 cocos2d/core/value-types/vec4.ts:305
max

逐元素向量最大值

meta description
定义于 cocos2d/core/value-types/vec4.ts:321
round

逐元素向量四舍五入取整

meta description
定义于 cocos2d/core/value-types/vec4.ts:337
multiplyScalar

向量标量乘法

meta description
定义于 cocos2d/core/value-types/vec4.ts:353
scaleAndAdd

逐元素向量乘加: A + B * scale

meta description
定义于 cocos2d/core/value-types/vec4.ts:369
distance

求两向量的欧氏距离

meta description
定义于 cocos2d/core/value-types/vec4.ts:385
squaredDistance

求两向量的欧氏距离平方

meta description
定义于 cocos2d/core/value-types/vec4.ts:401
len

求向量长度

meta description
定义于 cocos2d/core/value-types/vec4.ts:417
lengthSqr

求向量长度平方

meta description
定义于 cocos2d/core/value-types/vec4.ts:433
negate

逐元素向量取负

meta description
定义于 cocos2d/core/value-types/vec4.ts:449
inverse

逐元素向量取倒数,接近 0 时返回 Infinity

meta description
定义于 cocos2d/core/value-types/vec4.ts:465
inverseSafe

逐元素向量取倒数,接近 0 时返回 0

meta description
定义于 cocos2d/core/value-types/vec4.ts:481
normalize

归一化向量

meta description
定义于 cocos2d/core/value-types/vec4.ts:522
dot

向量点积(数量积)

meta description
定义于 cocos2d/core/value-types/vec4.ts:546
lerp

逐元素向量线性插值: A + t * (B - A)

meta description
定义于 cocos2d/core/value-types/vec4.ts:558
random

生成一个在单位球体上均匀分布的随机向量

meta description
定义于 cocos2d/core/value-types/vec4.ts:574
参数列表
  • scale Unknown 生成的向量长度
transformMat4

向量矩阵乘法

meta description
定义于 cocos2d/core/value-types/vec4.ts:597
transformQuat

向量四元数乘法

meta description
定义于 cocos2d/core/value-types/vec4.ts:637
strictEquals

向量等价判断

meta description
定义于 cocos2d/core/value-types/vec4.ts:667
equals

排除浮点数误差的向量近似等价判断

meta description
定义于 cocos2d/core/value-types/vec4.ts:679
toArray

向量转数组

meta description
定义于 cocos2d/core/value-types/vec4.ts:694
参数列表
  • ofs Unknown 数组起始偏移量
fromArray

数组转向量

meta description
定义于 cocos2d/core/value-types/vec4.ts:711
参数列表
  • ofs Unknown 数组起始偏移量
constructor

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

meta description
定义于 cocos2d/core/value-types/vec4.ts:748
参数列表
clone

克隆一个 Vec4 值

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:775
set

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

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

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

meta description
返回 Boolean
定义于 cocos2d/core/value-types/vec4.ts:811
参数列表
equals4f

判断当前向量是否在误差范围内与指定分量的向量相等。

meta description
返回 Boolean
定义于 cocos2d/core/value-types/vec4.ts:826
参数列表
  • x number 相比较的向量的 x 分量。
  • y number 相比较的向量的 y 分量。
  • z number 相比较的向量的 z 分量。
  • w number 相比较的向量的 w 分量。
  • epsilon number 允许的误差,应为非负数。
strictEquals

判断当前向量是否与指定向量相等。两向量的各分量都分别相等时返回 true;否则返回 false

meta description
返回 boolean
定义于 cocos2d/core/value-types/vec4.ts:844
参数列表
  • other Vec4 相比较的向量。
strictEquals4f

判断当前向量是否与指定分量的向量相等。两向量的各分量都分别相等时返回 true;否则返回 false

meta description
返回 boolean
定义于 cocos2d/core/value-types/vec4.ts:855
参数列表
  • x number 指定向量的 x 分量。
  • y number 指定向量的 y 分量。
  • z number 指定向量的 z 分量。
  • w number 指定向量的 w 分量。
lerp

根据指定的插值比率,从当前向量到目标向量之间做插值。

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:869
参数列表
  • to Vec4 目标向量。
  • ratio number 插值比率,范围为 [0,1]。
toString

返回当前向量的字符串表示。

meta description
返回 string
定义于 cocos2d/core/value-types/vec4.ts:889
clampf

设置当前向量的值,使其各个分量都处于指定的范围内。

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:899
参数列表
  • minInclusive Vec4 每个分量都代表了对应分量允许的最小值。
  • maxInclusive Vec4 每个分量都代表了对应分量允许的最大值。
addSelf

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:915
参数列表
add

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:931
参数列表
  • vector Vec4
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
subtract

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:948
参数列表
  • vector Vec4
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
multiplyScalar

缩放当前向量。

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:965
参数列表
multiply

分量相乘。

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:981
参数列表
divide

向量除法。

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:997
参数列表
negate

向量取反

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:1013
dot

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

meta description
返回 number
定义于 cocos2d/core/value-types/vec4.ts:1028
参数列表
cross

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:1039
参数列表
len

返回该向量的长度。

meta description
返回 number
定义于 cocos2d/core/value-types/vec4.ts:1058
示例
var v = cc.v4(10, 10);
v.len(); // return 14.142135623730951;
lengthSqr

返回该向量的长度平方。

meta description
返回 number
定义于 cocos2d/core/value-types/vec4.ts:1075
normalizeSelf

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:1089
normalize

返回归一化后的向量。

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:1101
参数列表
  • out Vec4 optional, the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
transformMat4

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

meta description
返回 Vec4
定义于 cocos2d/core/value-types/vec4.ts:1131
参数列表
  • m Mat4 matrix to transform with
  • out Vec4 the receiving vector, you can pass the same vec4 to save result to itself, if not provided, a new vec4 will be created
maxAxis

Returns the maximum value in x, y, z, w.

meta description
返回 number
定义于 cocos2d/core/value-types/vec4.ts:1152

条与 "" 相匹配的结果

    没有与 "" 匹配的结果