Vec2 Class

Extends ValueType

Module: cc Parent Module: cc

Representation of 2D vectors and points.

Index

Properties

• ONE Vec2 return a Vec2 object with x = 1 and y = 1.
• ZERO Vec2 return a Vec2 object with x = 0 and y = 0.
• ZERO_R Vec2 return a readonly Vec2 object with x = 0 and y = 0.
• UP Vec2 return a Vec2 object with x = 0 and y = 1.
• UP_R Vec2 return a readonly Vec2 object with x = 0 and y = 1.
• RIGHT Vec2 return a readonly Vec2 object with x = 1 and y = 0.
• RIGHT_R Vec2 return a Vec2 object with x = 1 and y = 0.
• x Number
• y Number

Methods

• mag Returns the length of this vector.
• magSqr Returns the squared length of this vector.
• 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.
• divSelf Divides by a number.
• div Divides by a number, and returns the new result.
• scaleSelf Multiplies two vectors.
• scale Multiplies two vectors, and returns the new result.
• negSelf Negates the components.
• neg Negates the components, and returns the new result.
• clone
• copy
• set
• add
• subtract
• multiply
• divide
• ceil
• floor
• min
• max
• round
• multiplyScalar
• scaleAndAdd
• distance
• squaredDistance
• len
• lengthSqr
• negate
• inverse
• inverseSafe
• normalize
• dot
• cross
• lerp
• random
• transformMat3
• transformMat4
• strictEquals
• equals
• angle
• toArray
• fromArray
• constructor Constructor
• clone clone a Vec2 object
• set Sets vector with another's value
• equals Check whether two vector equal
• 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.
• add Adds this vector.
• addSelf Adds this vector.
• subtract Subtracts one vector from this.
• multiplyScalar Multiplies this by a number.
• multiply Multiplies two vectors.
• divide Divides by a number.
• negate Negates the components.
• dot Dot product
• cross Cross product
• len Returns the length of this vector.
• lengthSqr 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.
• angle Get angle in radian between this and vector.
• signAngle Get angle in radian between this and vector with direction.
• rotate rotate
• rotateSelf rotate self
• project Calculates the projection of the current vector over the given vector.
• transformMat4 Transforms the vec2 with a mat4.
• maxAxis Returns the maximum value in x, y.

Details

Properties

ONE

return a Vec2 object with x = 1 and y = 1.

ZERO

return a Vec2 object with x = 0 and y = 0.

ZERO_R

return a readonly Vec2 object with x = 0 and y = 0.

UP

return a Vec2 object with x = 0 and y = 1.

UP_R

return a readonly Vec2 object with x = 0 and y = 1.

RIGHT

return a readonly Vec2 object with x = 1 and y = 0.

RIGHT_R

return a Vec2 object with x = 1 and y = 0.

x

y

Methods

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.

Examples

var v = cc.v2(10, 10);
v.magSqr(); // return 200;

subSelf

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

Parameters

• vector Vec2

Examples

var v = cc.v2(10, 10);
v.subSelf(cc.v2(5, 5));// return Vec2 {x: 5, y: 5};

sub

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

Parameters

• vector Vec2
• out Vec2 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

Examples

var v = cc.v2(10, 10);
v.sub(cc.v2(5, 5));      // return Vec2 {x: 5, y: 5};
var v1 = new Vec2;
v.sub(cc.v2(5, 5), v1);  // return Vec2 {x: 5, y: 5};

mulSelf

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

Parameters

• num number

Examples

var v = cc.v2(10, 10);
v.mulSelf(5);// return Vec2 {x: 50, y: 50};

mul

Multiplies by a number, and returns the new result.

Parameters

• num number
• out Vec2 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

Examples

var v = cc.v2(10, 10);
v.mul(5);      // return Vec2 {x: 50, y: 50};
var v1 = new Vec2;
v.mul(5, v1);  // return Vec2 {x: 50, y: 50};

divSelf

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

Parameters

• num number

Examples

var v = cc.v2(10, 10);
v.divSelf(5); // return Vec2 {x: 2, y: 2};

div

Divides by a number, and returns the new result.

Parameters

• num number
• out Vec2 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

Examples

var v = cc.v2(10, 10);
v.div(5);      // return Vec2 {x: 2, y: 2};
var v1 = new Vec2;
v.div(5, v1);  // return Vec2 {x: 2, y: 2};

scaleSelf

Multiplies two vectors.

Parameters

• vector Vec2

Examples

var v = cc.v2(10, 10);
v.scaleSelf(cc.v2(5, 5));// return Vec2 {x: 50, y: 50};

scale

Multiplies two vectors, and returns the new result.

Parameters

• vector Vec2
• out Vec2 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

Examples

var v = cc.v2(10, 10);
v.scale(cc.v2(5, 5));      // return Vec2 {x: 50, y: 50};
var v1 = new Vec2;
v.scale(cc.v2(5, 5), v1);  // return Vec2 {x: 50, y: 50};

negSelf

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

Examples

var v = cc.v2(10, 10);
v.negSelf(); // return Vec2 {x: -10, y: -10};

neg

Negates the components, and returns the new result.

Parameters

• out Vec2 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

Examples

var v = cc.v2(10, 10);
var v1 = new Vec2;
v.neg(v1);  // return Vec2 {x: -10, y: -10};

clone

copy

set

add

subtract

multiply

divide

ceil

floor

min

max

round

multiplyScalar

scaleAndAdd

distance

squaredDistance

len

lengthSqr

negate

inverse

inverseSafe

normalize

dot

cross

lerp

random

transformMat3

transformMat4

strictEquals

equals

angle

toArray

fromArray

constructor

Constructor see Cc/vec2:method or Cc/p:method

Parameters

• x Number
• y Number

clone

clone a Vec2 object

set

Sets vector with another's value

Parameters

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

equals

Check whether two vector equal

Parameters

• other Vec2

fuzzyEquals

Check whether two vector equal with some degree of variance.

Parameters

• other Vec2
• 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 Vec2
• ratio Number the interpolation coefficient
• out Vec2 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

clampf

Clamp the vector between from float and to float.

Parameters

• min_inclusive Vec2
• max_inclusive Vec2

Examples

var min_inclusive = cc.v2(0, 0);
var max_inclusive = cc.v2(20, 20);
var v1 = cc.v2(20, 20).clampf(min_inclusive, max_inclusive); // Vec2 {x: 20, y: 20};
var v2 = cc.v2(0, 0).clampf(min_inclusive, max_inclusive);   // Vec2 {x: 0, y: 0};
var v3 = cc.v2(10, 10).clampf(min_inclusive, max_inclusive); // Vec2 {x: 10, y: 10};

add

Adds this vector.

Parameters

• vector Vec2
• out Vec2

Examples

var v = cc.v2(10, 10);
v.add(cc.v2(5, 5));// return Vec2 {x: 15, y: 15};

addSelf

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

Parameters

• vector Vec2

subtract

Subtracts one vector from this.

Parameters

• vector Vec2

Examples

var v = cc.v2(10, 10);
v.subSelf(cc.v2(5, 5));// return Vec2 {x: 5, y: 5};

multiplyScalar

Multiplies this by a number.

Parameters

• num number

Examples

var v = cc.v2(10, 10);
v.multiply(5);// return Vec2 {x: 50, y: 50};

multiply

Multiplies two vectors.

Parameters

• vector Vec2

Examples

var v = cc.v2(10, 10);
v.multiply(cc.v2(5, 5));// return Vec2 {x: 50, y: 50};

divide

Divides by a number.

Parameters

• num number

Examples

var v = cc.v2(10, 10);
v.divide(5); // return Vec2 {x: 2, y: 2};

negate

Negates the components.

Examples

var v = cc.v2(10, 10);
v.negate(); // return Vec2 {x: -10, y: -10};

dot

Dot product

Parameters

• vector Vec2

Examples

var v = cc.v2(10, 10);
v.dot(cc.v2(5, 5)); // return 100;

cross

Cross product

Parameters

• vector Vec2

Examples

var v = cc.v2(10, 10);
v.cross(cc.v2(5, 5)); // return 0;

len

Returns the length of this vector.

Examples

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

lengthSqr

Returns the squared length of this vector.

Examples

var v = cc.v2(10, 10);
v.lengthSqr(); // return 200;

normalizeSelf

Make the length of this vector to 1.

Examples

var v = cc.v2(10, 10);
v.normalizeSelf(); // return Vec2 {x: 0.7071067811865475, y: 0.7071067811865475};

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 Vec2 optional, the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

angle

Get angle in radian between this and vector.

Parameters

• vector Vec2

signAngle

Get angle in radian between this and vector with direction.

Parameters

• vector Vec2

rotate

rotate

Parameters

• radians number
• out Vec2 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

rotate self

Parameters

• radians number

project

Calculates the projection of the current vector over the given vector.

Parameters

• vector Vec2

Examples

var v1 = cc.v2(20, 20);
var v2 = cc.v2(5, 5);
v1.project(v2); // Vec2 {x: 20, y: 20};

transformMat4

Transforms the vec2 with a mat4. 3rd vector component is implicitly '0', 4th vector component is implicitly '1'

Parameters

• m Mat4 matrix to transform with
• out Vec2 the receiving vector, you can pass the same vec2 to save result to itself, if not provided, a new vec2 will be created

maxAxis

Returns the maximum value in x, y.