Vec3 Class

Extends ValueType

Module: cc

Representation of 3D vectors and points.

Index

Properties

• x Number
• y Number
• z Number

Methods

• constructor Constructor
• clone clone a Vec3 value
• set Set the current vector value with the given vector.
• equals Check whether the vector equals another one
• fuzzyEquals Check whether two vector equal with some degree of variance.
• toString Transform to string with vector informations
• lerp Calculate linear interpolation result between this vector and another one with given ratio
• clampf Clamp the vector between from float and to float.
• addSelf Adds this vector.
• add Adds two vectors, and returns the new result.
• subSelf Subtracts one vector from this.
• sub Subtracts one vector from this, and returns the new result.
• mulSelf Multiplies this by a number.
• mul Multiplies by a number, and returns the new result.
• scaleSelf Multiplies two vectors.
• scale Multiplies two vectors, and returns the new result.
• divSelf Divides by a number.
• div Divides by a number, and returns the new result.
• negSelf Negates the components.
• neg Negates the components, and returns the new result.
• dot Dot product
• cross Cross product
• mag Returns the length of this vector.
• magSqr Returns the squared length of this vector.
• normalizeSelf Make the length of this vector to 1.
• normalize Note that the current vector is unchanged and a new normalized vector is returned.
• transformMat4 Transforms the vec3 with a mat4.
• v3 The convenience method to create a new cc.Vec3.

Details

Properties

x

y

z

Methods

constructor

Constructor see Cc/vec3:method

Parameters

• x number
• y number
• z number

clone

clone a Vec3 value

set

Set the current vector value with the given vector.

Parameters

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

equals

Check whether the vector equals another one

Parameters

• other Vec3

fuzzyEquals

Check whether two vector equal with some degree of variance.

Parameters

• other Vec3
• variance Number

toString

Transform to string with vector informations

lerp

Calculate linear interpolation result between this vector and another one with given ratio

Parameters

• 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

Clamp the vector between from float and to float.

Parameters

• min_inclusive Vec3
• max_inclusive Vec3

addSelf

Adds this vector. If you want to save result to another vector, use add() instead.

Parameters

• vector Vec3

add

Adds two vectors, and returns the new result.

Parameters

• 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

Subtracts one vector from this. If you want to save result to another vector, use sub() instead.

Parameters

• vector Vec3

sub

Subtracts one vector from this, and returns the new result.

Parameters

• 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

Multiplies this by a number. If you want to save result to another vector, use mul() instead.

Parameters

• num number

mul

Multiplies by a number, and returns the new result.

Parameters

• 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

Multiplies two vectors.

Parameters

• vector Vec3

scale

Multiplies two vectors, and returns the new result.

Parameters

• 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

Divides by a number. If you want to save result to another vector, use div() instead.

Parameters

• divisor number

div

Divides by a number, and returns the new result.

Parameters

• 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

Negates the components. If you want to save result to another vector, use neg() instead.

neg

Negates the components, and returns the new result.

Parameters

• 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

Dot product

Parameters

• vector Vec3

cross

Cross product

Parameters

• vector Vec3
• out Vec3

mag

Returns the length of this vector.

Examples

var v = cc.v2(10, 10);
v.mag(); // return 14.142135623730951;

magSqr

Returns the squared length of this vector.

normalizeSelf

Make the length of this vector to 1.

normalize

Returns this vector with a magnitude of 1.

Note that the current vector is unchanged and a new normalized vector is returned. If you want to normalize the current vector, use normalizeSelf function.

Parameters

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

Parameters

• 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

The convenience method to create a new cc.Vec3.

Parameters

• x Number | Object
• y Number
• z Number

Examples

var v1 = cc.v3();
var v2 = cc.v3(0, 0, 0);
var v3 = cc.v3(v2);
var v4 = cc.v3({x: 100, y: 100, z: 0});