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 向量矩阵乘法
• transformAffine 向量仿射变换
• 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

y

z

w

方法

subSelf

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

参数列表

• vector Vec4

sub

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

参数列表

• 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() 代替。

参数列表

• num number

mul

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

参数列表

• 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() 代替。

参数列表

• num number

div

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

参数列表

• 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

分量相乘。

参数列表

• vector Vec4

scale

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

参数列表

• 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() 代替。

neg

返回取反后的新向量。

参数列表

• 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

获得指定向量的拷贝

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

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

参数列表

• scale Unknown 生成的向量长度

transformMat4

向量矩阵乘法

transformAffine

向量仿射变换

transformQuat

向量四元数乘法

strictEquals

向量等价判断

equals

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

toArray

向量转数组

参数列表

• ofs Unknown 数组起始偏移量

fromArray

数组转向量

参数列表

• ofs Unknown 数组起始偏移量

constructor

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

参数列表

• x number
• y number
• z number
• w number

clone

克隆一个 Vec4 值

set

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

参数列表

• newValue Vec4 !#en new value to set. !#zh 要设置的新值

equals

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

参数列表

• other Vec4
• epsilon number

equals4f

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

参数列表

• x number 相比较的向量的 x 分量。
• y number 相比较的向量的 y 分量。
• z number 相比较的向量的 z 分量。
• w number 相比较的向量的 w 分量。
• epsilon number 允许的误差，应为非负数。

strictEquals

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

参数列表

• other Vec4 相比较的向量。

strictEquals4f

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

参数列表

• x number 指定向量的 x 分量。
• y number 指定向量的 y 分量。
• z number 指定向量的 z 分量。
• w number 指定向量的 w 分量。

lerp

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

参数列表

• to Vec4 目标向量。
• ratio number 插值比率，范围为 [0,1]。

toString

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

clampf

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

参数列表

• minInclusive Vec4 每个分量都代表了对应分量允许的最小值。
• maxInclusive Vec4 每个分量都代表了对应分量允许的最大值。

addSelf

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

参数列表

• vector Vec4

add

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

参数列表

• 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

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

参数列表

• 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

缩放当前向量。

参数列表

• num number

multiply

分量相乘。

参数列表

• vector Vec4

divide

向量除法。

参数列表

• num number

negate

向量取反

dot

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

参数列表

• vector Vec4

cross

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

参数列表

• vector Vec4
• out Vec4

len

返回该向量的长度。

示例

var v = cc.v4(10, 10);
v.len(); // return 14.142135623730951;

lengthSqr

返回该向量的长度平方。

normalizeSelf

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

normalize

返回归一化后的向量。

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

参数列表

• 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'

参数列表

• 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.