Cocos Creator API

1.2.0

Cocos Creator is a highly customizable game development tool that utilizes the power of cocos2d-x.

Vec2

继承于 ValueType
模块: cc

表示 2D 向量和坐标

属性(properties)

ONE Vec2 static

新 Vec2 对象。

ZERO Vec2 static

返回 x = 0 和 y = 0 的 Vec2 对象。

up Vec2 static

返回 x = 0 和 y = 1 的 Vec2 对象。

RIGHT Vec2 static

返回 x = 1 和 y = 0 的 Vec2 对象。

There are no properties that match your current filter settings. You can change your filter settings in the index section on this page. index

方法

Vec2
(
  • [x =0]
  • [y =0]
)
Vec2

构造函数,可查看 Cc/vec2:method 或者 cc.p

名称 类型 描述
x optional number 0
y optional number 0

返回:

类型: Vec2

clone ( ) Vec2

克隆一个 Vec2 值

返回:

类型: Vec2

set
(
  • newValue
)
Vec2

设置向量值。

名称 类型 描述
newValue Vec2

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

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

returns this

equals
(
  • other
)
Boolean

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

名称 类型 描述
other Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Boolean

toString ( ) string

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

返回:

类型: string

lerp
(
  • to
  • ratio
  • [out ]
)
Vec2

线性插值。

名称 类型 描述
to Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0
ratio number

the interpolation coefficient

out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

addSelf
(
  • vector
)
Vec2

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

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

returns this

示例:

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

add
(
  • vector
  • [out ]
)
Vec2

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

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

the result

示例:

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

subSelf
(
  • vector
)
Vec2

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

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

returns this

示例:

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

sub
(
  • vector
  • [out ]
)
Vec2

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

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

the result

示例:

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

mulSelf
(
  • num
)
Vec2

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

名称 类型 描述
num number

返回:

类型: Vec2

returns this

示例:

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

mul
(
  • num
  • [out ]
)
Vec2

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

名称 类型 描述
num number
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

the result

示例:

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

scaleSelf
(
  • vector
)
Vec2

分量相乘。

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

returns this

示例:

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

scale
(
  • vector
  • [out ]
)
Vec2

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

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

the result

示例:

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

divSelf
(
  • vector
)
Vec2

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

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

returns this

示例:

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

div
(
  • vector
  • [out ]
)
Vec2

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

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

the result

示例:

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

negSelf ( ) Vec2

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

返回:

类型: Vec2

returns this

示例:

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

neg
(
  • [out ]
)
Vec2

返回取反后的新向量。

名称 类型 描述
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

the result

示例:

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

dot
(
  • [vector ]
)
number

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

名称 类型 描述
vector optional Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: number

the result

示例:

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

cross
(
  • [vector ]
)
number

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

名称 类型 描述
vector optional Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: number

the result

示例:

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

mag ( ) number

返回该向量的长度。

返回:

类型: number

the result

示例:

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

magSqr ( ) number

返回该向量的长度平方。

返回:

类型: number

the result

示例:

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

normalizeSelf ( ) Vec2

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

返回:

类型: Vec2

returns this

示例:

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

normalize
(
  • [out ]
)
Vec2

返回归一化后的向量。

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

名称 类型 描述
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

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

angle
(
  • vector
)
number

夹角的弧度。

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: number

from 0 to Math.PI

signAngle
(
  • vector
)
number

带方向的夹角的弧度。

名称 类型 描述
vector Vec2

!#en Constructor see Cc/vec2:method or cc.p !#zh 构造函数,可查看 Cc/vec2:method 或者 cc.p

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: number

from -MathPI to Math.PI

rotate
(
  • radians
  • [out ]
)
Vec2

返回旋转给定弧度后的新向量。

名称 类型 描述
radians number
out optional Vec2

optional, the receiving vector

  • x number optional , default: 0
  • y number optional , default: 0

返回:

类型: Vec2

the result

rotateSelf
(
  • radians
)
Vec2

按指定弧度旋转向量。

名称 类型 描述
radians number

返回:

类型: Vec2

returns this

There are no methods that match your current filter settings. You can change your filter settings in the index section on this page. index