cc 模块

Cocos 引擎的主要命名空间,引擎代码中所有的类,函数,属性和常量都在这个命名空间中定义。

类型

枚举

索引

属性(properties)
  • ENGINE_VERSION String The current version of Cocos2d being used.
    Please DO NOT remove this String, it is an important flag for bug tracking.
    If you post a bug to forum, please attach this flag.
  • _renderContext CanvasRenderingContext2D|WebGLRenderingContext main Canvas 2D/3D Context of game engine
  • _canvas HTMLCanvasElement Main canvas of game engine
  • container HTMLDivElement The element contains the game canvas
  • view View cc.view 是全局的视图对象。
  • director Director 导演类。
  • winSize Size cc.winSize 为当前的游戏窗口的大小。
  • game Game
  • systemEvent SystemEvent 系统事件单例,方便全局使用
  • Integer string Specify that the input value must be integer in Inspector. Also used to indicates that the elements in array should be type integer.
  • Float string Indicates that the elements in array should be type double.
  • Boolean string Indicates that the elements in array should be type boolean.
  • String string Indicates that the elements in array should be type string.
方法

当指定了 target 选项时,如果 target 引用的其它 asset 的 uuid 不变,则不会改变 target 对 asset 的引用, 也不会将 uuid 保存到 result 对象中。

  • instantiate 克隆指定的任意类型的对象,或者从 Prefab 实例化出新节点。

(Instantiate 时,function 和 dom 等非可序列化对象会直接保留原有引用,Asset 会直接进行浅拷贝,可序列化类型会进行深拷贝。)

  • find Finds a node by hierarchy path, the path is case-sensitive. It will traverse the hierarchy by splitting the path using '/' character. This function will still returns the node even if it is inactive. It is recommended to not use this function every frame instead cache the result at startup.
  • color 通过该方法来创建一个新的 Color/Color:method 对象。 Alpha 通道是可选的。默认值是 255。
  • colorEqual 判断两个颜色对象的 RGB 部分是否相等,不比较透明度。
  • hexToColor 16 进制转换为 Color
  • colorToHex Color 转换为 16进制。
  • pNeg 返回相反的向量。
  • pAdd 返回两个向量的和。
  • pSub 返回两个向量的差。
  • pMult 向量缩放。
  • pMidpoint 两个向量之间的中心点。
  • pDot 两个向量之间进行点乘。
  • pCross 两个向量之间进行叉乘。
  • pPerp 返回逆时针旋转 90 度后的新向量。
  • pRPerp 将指定向量顺时针旋转 90 度并返回。
  • pProject 返回 v1 在 v2 上的投影向量。
  • pLengthSQ 返回指定向量长度的平方。
  • pDistanceSQ 返回两个点之间距离的平方。
  • pLength 返回指定向量的长度.
  • pDistance 返回指定 2 个向量之间的距离。
  • pNormalize 返回一个长度为 1 的标准化过后的向量。
  • pForAngle 将弧度转换为一个标准化后的向量,返回坐标 x = cos(a) , y = sin(a)。
  • pToAngle 返回指定向量的弧度。
  • clampf 限定浮点数的最大最小值。
    数值大于 max_inclusive 则返回 max_inclusive。
    数值小于 min_inclusive 则返回 min_inclusive。
    否则返回自身。
  • clamp01 限定浮点数的取值范围为 0 ~ 1 之间。
  • pClamp 返回指定限制区域后的向量。
    向量大于 max_inclusive 则返回 max_inclusive。
    向量小于 min_inclusive 则返回 min_inclusive。
    否则返回自身。
  • pFromSize 快速转换 cc.Size 为 cc.Vec2。
  • pCompOp 通过运行指定的数学运算函数来计算指定的向量。
  • pLerp 两个点 A 和 B 之间的线性插值。
    alpha == 0 ? a
    alpha == 1 ? b
    否则这个数值在 a ~ b 之间。
  • pFuzzyEqual 近似判断两个点是否相等。
    判断 2 个向量是否在指定数值的范围之内,如果在则返回 true,反之则返回 false。
  • pCompMult 计算两个向量的每个分量的乘积, a.x b.x, a.y b.y。
  • pAngleSigned 返回两个向量之间带正负号的弧度。
  • pAngle 获取当前向量与指定向量之间的弧度角。
  • pRotateByAngle 返回给定向量围绕指定轴心顺时针旋转一定弧度后的结果。
  • pLineIntersect 返回 A 为起点 B 为终点线段 1 所在直线和 C 为起点 D 为终点线段 2 所在的直线是否相交,
    如果相交返回 true,反之则为 false,参数 retP 是返回交点在线段 1、线段 2 上的比例。
  • pSegmentIntersect 返回线段 A - B 和线段 C - D 是否相交。
  • pIntersectPoint 返回线段 A - B 和线段 C - D 的交点。
  • pSameAs 检查指定的 2 个向量是否相等。
  • pZeroIn 设置指定向量归 0。
  • pIn 令 v1 向量等同于 v2。
  • pMultIn 向量缩放,结果保存到第一个向量。
  • pSubIn 向量减法,结果保存到第一个向量。
  • pAddIn 向量加法,结果保存到第一个向量。
  • pNormalizeIn 规范化 v 向量,设置 v 向量长度为 1。
  • rect 该方法用来快速创建一个新的矩形。Rect/Rect:method
  • rectEqualToRect 判断两个矩形是否相等。
  • rectContainsRect 检查 rect1 矩形是否包含 rect2 矩形。
    注意:如果要允许 rect1 和 rect2 的边界重合,应该用 cc.rectOverlapsRect
  • rectGetMaxX 返回矩形在 x 轴上的最大值
  • rectGetMidX 返回矩形在 x 轴上的中点。
  • rectGetMinX 返回矩形在 x 轴上的最小值。
  • rectGetMaxY 返回矩形在 y 轴上的最大值。
  • rectGetMidY 返回矩形在 y 轴上的中点。
  • rectGetMinY 返回矩形在 y 轴上的最小值。
  • rectContainsPoint 检查一个矩形是否包含某个坐标点。
  • rectIntersectsRect 检查一个矩形是否与另一个相交。
  • rectOverlapsRect 检查一个矩形是否重叠另一个。
  • rectUnion 返回一个包含两个指定矩形的最小矩形。
  • rectIntersection 返回 2 个矩形重叠的部分。
  • size 创建一个 cc.Size 对象的帮助函数。
    注意:可以使用 cc.p 或者是 cc.v2 代替,它们将很快取代 cc.Size。
  • sizeEqualToSize 检查 Size 对象是否等于另一个。
  • V3F_C4B_T2F_QuadZero
  • V3F_C4B_T2F_QuadCopy
  • V3F_C4B_T2F_QuadsCopy
  • v2 通过该简便的函数进行创建 cc.Vec2 对象。
  • p 通过该简便的函数进行创建 cc.Vec2 对象。
  • pointEqualToPoint 判断两个向量是否相等。

Details

属性(properties)

ENGINE_VERSION

The current version of Cocos2d being used.
Please DO NOT remove this String, it is an important flag for bug tracking.
If you post a bug to forum, please attach this flag.

meta description
类型 String
定义于 https:/github.com/cocos-creator/engine/blob/master/CCBoot.js:31
_renderContext

main Canvas 2D/3D Context of game engine

meta description
类型 CanvasRenderingContext2D | WebGLRenderingContext
定义于 https:/github.com/cocos-creator/engine/blob/master/CCBoot.js:41
_canvas

Main canvas of game engine

meta description
类型 HTMLCanvasElement
定义于 https:/github.com/cocos-creator/engine/blob/master/CCBoot.js:48
container

The element contains the game canvas

meta description
类型 HTMLDivElement
定义于 https:/github.com/cocos-creator/engine/blob/master/CCBoot.js:54
view

cc.view 是全局的视图对象。

meta description
类型 View
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/CCGame.js:377
director

导演类。

meta description
类型 Director
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/CCGame.js:385
winSize

cc.winSize 为当前的游戏窗口的大小。

meta description
类型 Size
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/CCGame.js:394
game
meta description
类型 Game
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/CCGame.js:820
systemEvent

系统事件单例,方便全局使用

meta description
类型 SystemEvent
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/event-manager/CCSystemEvent.js:166
Integer

Specify that the input value must be integer in Inspector. Also used to indicates that the elements in array should be type integer.

meta description
类型 string
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/attribute.js:152
示例
// in cc.Class
member: {
    default: [],
    type: cc.Integer
}
// ES6 ccclass
Float

Indicates that the elements in array should be type double.

meta description
类型 string
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/attribute.js:171
示例
// in cc.Class
member: {
    default: [],
    type: cc.Float
}
// ES6 ccclass
Boolean

Indicates that the elements in array should be type boolean.

meta description
类型 string
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/attribute.js:196
示例
// in cc.Class
member: {
    default: [],
    type: cc.Boolean
}
// ES6 ccclass
String

Indicates that the elements in array should be type string.

meta description
类型 string
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/attribute.js:214
示例
// in cc.Class
member: {
    default: [],
    type: cc.String
}
// ES6 ccclass

方法

_initDebugSetting

设置调试模式。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/CCDebugger.js:102
参数列表
error

输出错误消息到 Cocos Creator 编辑器的 Console 或运行时页面端的 Console 中。

  • 在 Cocos Creator 中,错误信息显示是红色的。
  • 在 Chrome 中,错误信息有红色的图标以及红色的消息文本。
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/CCDebugger.js:180
参数列表
  • msg Any A JavaScript string containing zero or more substitution strings.
  • subst Any JavaScript objects with which to replace substitution strings within msg. This gives you additional control over the format of the output.
warn

输出警告消息到 Cocos Creator 编辑器的 Console 或运行时 Web 端的 Console 中。

  • 在 Cocos Creator 中,警告信息显示是黄色的。
  • 在 Chrome 中,警告信息有着黄色的图标以及黄色的消息文本。
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/CCDebugger.js:224
参数列表
  • msg Any A JavaScript string containing zero or more substitution strings.
  • subst Any JavaScript objects with which to replace substitution strings within msg. This gives you additional control over the format of the output.
log

输出一条消息到 Cocos Creator 编辑器的 Console 或运行时 Web 端的 Console 中。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/CCDebugger.js:255
参数列表
  • msg String | Any A JavaScript string containing zero or more substitution strings.
  • subst Any JavaScript objects with which to replace substitution strings within msg. This gives you additional control over the format of the output.
info

输出一条信息消息到 Cocos Creator 编辑器的 Console 或运行时 Web 端的 Console 中。

  • 在 Cocos Creator 中,Info 信息显示是蓝色的。
  • 在 Firefox 和 Chrome 中,Info 信息有着小 “i” 图标。
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/CCDebugger.js:281
参数列表
  • msg Any A JavaScript string containing zero or more substitution strings.
  • subst Any JavaScript objects with which to replace substitution strings within msg. This gives you additional control over the format of the output.
speed

修改目标动作的速率。

meta description
返回 Action
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCAction.js:366
参数列表
示例
// change the target action speed;
var action = cc.scaleTo(0.2, 1, 0.6);
var newAction = cc.speed(action, 0.5);
follow

追踪目标节点的位置。

meta description
返回 Action | Null
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCAction.js:561
参数列表
示例
// example
// creates the action with a set boundary
var followAction = cc.follow(targetNode, cc.rect(0, 0, screenWidth * 2 - 100, screenHeight));
node.runAction(followAction);

// creates the action with no boundary set
var followAction = cc.follow(targetNode);
node.runAction(followAction);
setPoints

Points setter

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionCatmullRom.js:224
参数列表
cardinalSplineTo

按基数样条曲线轨迹移动到目标位置。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionCatmullRom.js:234
参数列表
示例
//create a cc.CardinalSplineTo
var action1 = cc.cardinalSplineTo(3, array, 0);
updatePosition

update position of target

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionCatmullRom.js:318
参数列表
cardinalSplineBy

按基数样条曲线轨迹移动指定的距离。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionCatmullRom.js:339
参数列表
catmullRomTo

按 Catmull Rom 样条曲线轨迹移动到目标位置。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionCatmullRom.js:385
参数列表
示例
var action1 = cc.catmullRomTo(3, array);
catmullRomBy

按 Catmull Rom 样条曲线轨迹移动指定的距离。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionCatmullRom.js:433
参数列表
示例
var action1 = cc.catmullRomBy(3, array);
easeIn

创建 easeIn 缓动对象,由慢到快。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:197
参数列表
示例
action.easing(cc.easeIn(3.0));
easeOut

创建 easeOut 缓动对象,由快到慢。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:247
参数列表
示例
action.easing(cc.easeOut(3.0));
easeInOut

创建 easeInOut 缓动对象,慢到快,然后慢。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:301
参数列表
示例
action.easing(cc.easeInOut(3.0));
easeExponentialIn

创建 easeExponentialIn 缓动对象。
EaseExponentialIn 是按指数函数缓动进入的动作。
参考 easeInExpo:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:366
示例
action.easing(cc.easeExponentialIn());
easeExponentialOut

创建 easeExponentialOut 缓动对象。
EaseExponentialOut 是按指数函数缓动退出的动作。
参考 easeOutExpo:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:421
示例
action.easing(cc.easeExponentialOut());
easeExponentialInOut

创建 easeExponentialInOut 缓动对象。
EaseExponentialInOut 是按指数函数缓动进入并退出的动作。
参考 easeInOutExpo:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:491
示例
action.easing(cc.easeExponentialInOut());
easeSineIn

创建 EaseSineIn 缓动对象。
EaseSineIn 是按正弦函数缓动进入的动作。
参考 easeInSine:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:546
示例
action.easing(cc.easeSineIn());
easeSineOut

创建 EaseSineOut 缓动对象。
EaseSineIn 是按正弦函数缓动退出的动作。
参考 easeOutSine:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:602
示例
action.easing(cc.easeSineOut());
easeSineInOut

创建 easeSineInOut 缓动对象。
EaseSineIn 是按正弦函数缓动进入并退出的动作。
参考 easeInOutSine:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:658
示例
action.easing(cc.easeSineInOut());
easeElasticIn

创建 easeElasticIn 缓动对象。
EaseElasticIn 是按弹性曲线缓动进入的动作。
参数 easeInElastic:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:787
参数列表
示例
// example
action.easing(cc.easeElasticIn(3.0));
easeElasticOut

创建 easeElasticOut 缓动对象。
EaseElasticOut 是按弹性曲线缓动退出的动作。
参考 easeOutElastic:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:867
参数列表
示例
// example
action.easing(cc.easeElasticOut(3.0));
easeElasticInOut

创建 easeElasticInOut 缓动对象。
EaseElasticInOut 是按弹性曲线缓动进入并退出的动作。
参考 easeInOutElastic:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:943
参数列表
示例
// example
action.easing(cc.easeElasticInOut(3.0));
easeBounceIn

创建 easeBounceIn 缓动对象。
EaseBounceIn 是按弹跳动作缓动进入的动作。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1081
示例
// example
action.easing(cc.easeBounceIn());
easeBounceOut

创建 easeBounceOut 缓动对象。
EaseBounceOut 是按弹跳动作缓动退出的动作。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1136
示例
// example
action.easing(cc.easeBounceOut());
easeBounceInOut

创建 easeBounceInOut 缓动对象。
EaseBounceInOut 是按弹跳动作缓动进入并退出的动作。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1204
示例
// example
action.easing(cc.easeBounceInOut());
easeBackIn

创建 easeBackIn 缓动对象。
easeBackIn 是在相反的方向缓慢移动,然后加速到正确的方向。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1261
示例
// example
action.easing(cc.easeBackIn());
easeBackOut

创建 easeBackOut 缓动对象。
easeBackOut 快速移动超出目标,然后慢慢回到目标点。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1319
示例
// example
action.easing(cc.easeBackOut());
easeBackInOut

创建 easeBackInOut 缓动对象。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1387
示例
// example
action.easing(cc.easeBackInOut());
easeBezierAction

创建 easeBezierAction 缓动对象。
EaseBezierAction 是按贝塞尔曲线缓动的动作。

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1469
参数列表
  • p0 Number The first bezier parameter
  • p1 Number The second bezier parameter
  • p2 Number The third bezier parameter
  • p3 Number The fourth bezier parameter
示例
// example
action.easing(cc.easeBezierAction(0.5, 0.5, 1.0, 1.0));
easeQuadraticActionIn

创建 easeQuadraticActionIn 缓动对象。
EaseQuadraticIn是按二次函数缓动进入的动作。
参考 easeInQuad:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1539
示例
//example
action.easing(cc.easeQuadraticActionIn());
easeQuadraticActionOut

创建 easeQuadraticActionOut 缓动对象。
EaseQuadraticOut 是按二次函数缓动退出的动作。
参考 easeOutQuad:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1597
示例
//example
action.easing(cc.easeQuadraticActionOut());
easeQuadraticActionInOut

创建 easeQuadraticActionInOut 缓动对象。
EaseQuadraticInOut 是按二次函数缓动进入并退出的动作。
参考 easeInOutQuad:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1663
示例
//example
action.easing(cc.easeQuadraticActionInOut());
easeQuarticActionIn

创建 easeQuarticActionIn 缓动对象。
EaseQuarticIn 是按四次函数缓动进入的动作。
参考 easeIntQuart:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1720
示例
//example
action.easing(cc.easeQuarticActionIn());
easeQuarticActionOut

创建 easeQuarticActionOut 缓动对象。
EaseQuarticOut 是按四次函数缓动退出的动作。
参考 easeOutQuart:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1779
示例
//example
action.easing(cc.QuarticActionOut());
easeQuarticActionInOut

创建 easeQuarticActionInOut 缓动对象。
EaseQuarticInOut 是按四次函数缓动进入并退出的动作。
参考 easeInOutQuart:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1840
easeQuinticActionIn

创建 easeQuinticActionIn 缓动对象。
EaseQuinticIn 是按五次函数缓动进的动作。
参考 easeInQuint:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1895
示例
//example
action.easing(cc.easeQuinticActionIn());
easeQuinticActionOut

创建 easeQuinticActionOut 缓动对象。
EaseQuinticOut 是按五次函数缓动退出的动作 参考 easeOutQuint:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:1954
示例
//example
action.easing(cc.easeQuadraticActionOut());
easeQuinticActionInOut

创建 easeQuinticActionInOut 缓动对象。
EaseQuinticInOut是按五次函数缓动进入并退出的动作。
参考 easeInOutQuint:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:2016
示例
//example
action.easing(cc.easeQuinticActionInOut());
easeCircleActionIn

创建 easeCircleActionIn 缓动对象。
EaseCircleIn是按圆形曲线缓动进入的动作。
参考 easeInCirc:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:2074
示例
//example
action.easing(cc.easeCircleActionIn());
easeCircleActionOut

创建 easeCircleActionOut 缓动对象。
EaseCircleOut是按圆形曲线缓动退出的动作。
参考 easeOutCirc:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:2133
easeCircleActionInOut

创建 easeCircleActionInOut 缓动对象。
EaseCircleInOut 是按圆形曲线缓动进入并退出的动作。
参考 easeInOutCirc:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:2195
示例
//example
action.easing(cc.easeCircleActionInOut());
easeCubicActionIn

创建 easeCubicActionIn 缓动对象。
EaseCubicIn 是按三次函数缓动进入的动作。
参考 easeInCubic:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:2253
示例
//example
action.easing(cc.easeCubicActionIn());
easeCubicActionOut

创建 easeCubicActionOut 缓动对象。
EaseCubicOut 是按三次函数缓动退出的动作。
参考 easeOutCubic:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:2312
示例
//example
action.easing(cc.easeCubicActionOut());
easeCubicActionInOut

创建 easeCubicActionInOut 缓动对象。
EaseCubicInOut是按三次函数缓动进入并退出的动作。
参考 easeInOutCubic:http://www.zhihu.com/question/21981571/answer/19925418

meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionEase.js:2374
show

立即显示。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:97
示例
// example
var showAction = cc.show();
hide

立即隐藏。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:134
示例
// example
var hideAction = cc.hide();
toggleVisibility

显隐状态切换。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:171
示例
// example
var toggleVisibilityAction = cc.toggleVisibility();
removeSelf

从父节点移除自身。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:221
参数列表
示例
// example
var removeSelfAction = cc.removeSelf();
flipX

X轴翻转。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:279
参数列表
  • flip Boolean Indicate whether the target should be flipped or not
示例
var flipXAction = cc.flipX(true);
flipY

Y轴翻转。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:335
参数列表
示例
var flipYAction = cc.flipY(true);
place

放置在目标位置。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:399
参数列表
示例
// example
var placeAction = cc.place(cc.p(200, 200));
var placeAction = cc.place(200, 200);
callFunc

执行回调函数。

meta description
返回 ActionInstant
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInstant.js:509
参数列表
  • selector function
  • selectorTarget object
  • data Any data for function, it accepts all data types.
示例
// example
// CallFunc without data
var finish = cc.callFunc(this.removeSprite, this);

// CallFunc with data
var finish = cc.callFunc(this.removeFromParentAndCleanup, this._grossini,  true);
sequence

顺序执行动作,创建的动作将按顺序依次运行。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:435
参数列表
示例
// example
// create sequence with actions
var seq = cc.sequence(act1, act2);

// create sequence with array
var seq = cc.sequence(actArray);
repeat

重复动作,可以按一定次数重复一个动,如果想永远重复一个动作请使用 repeatForever 动作来完成。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:613
参数列表
示例
// example
var rep = cc.repeat(cc.sequence(jump2, jump1), 5);
repeatForever

永远地重复一个动作,有限次数内重复一个动作请使用 repeat 动作,由于这个动作不会停止,所以不能被添加到 cc.sequence 或 cc.spawn 中。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:716
参数列表
示例
// example
var repeat = cc.repeatForever(cc.rotateBy(1.0, 360));
spawn

同步执行动作,同步执行一组动作。

meta description
返回 FiniteTimeAction
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:830
参数列表
示例
// example
var action = cc.spawn(cc.jumpBy(2, cc.p(300, 0), 50, 4), cc.rotateBy(2, 720));
todo:It should be the direct use new
rotateTo

旋转到目标角度,通过逐帧修改它的 rotation 属性,旋转方向将由最短的角度决定。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:951
参数列表
  • duration Number duration in seconds
  • deltaAngleX Number deltaAngleX in degrees.
  • deltaAngleY Number deltaAngleY in degrees.
示例
// example
var rotateTo = cc.rotateTo(2, 61.0);
rotateBy

旋转指定的角度。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1038
参数列表
  • duration Number duration in seconds
  • deltaAngleX Number deltaAngleX in degrees
  • deltaAngleY Number deltaAngleY in degrees
示例
// example
var actionBy = cc.rotateBy(2, 360);
moveBy

移动指定的距离。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1157
参数列表
示例
// example
var actionTo = cc.moveBy(2, cc.p(windowSize.width - 40, windowSize.height - 40));
moveTo

移动到目标位置。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1235
参数列表
示例
// example
var actionBy = cc.moveTo(2, cc.p(80, 80));
skewTo

偏斜到目标角度。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1329
参数列表
示例
// example
var actionTo = cc.skewTo(2, 37.2, -37.2);
skewBy

偏斜指定的角度。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1403
参数列表
  • t Number time in seconds
  • sx Number sx skew in degrees for X axis
  • sy Number sy skew in degrees for Y axis
示例
// example
var actionBy = cc.skewBy(2, 0, -90);
jumpBy

用跳跃的方式移动指定的距离。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1532
参数列表
示例
// example
var actionBy = cc.jumpBy(2, cc.p(300, 0), 50, 4);
var actionBy = cc.jumpBy(2, 300, 0, 50, 4);
jumpTo

用跳跃的方式移动到目标位置。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1615
参数列表
示例
// example
var actionTo = cc.jumpTo(2, cc.p(300, 300), 50, 4);
var actionTo = cc.jumpTo(2, 300, 300, 50, 4);
bezierBy

按贝赛尔曲线轨迹移动指定的距离。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1761
参数列表
示例
// example
var bezier = [cc.p(0, windowSize.height / 2), cc.p(300, -windowSize.height / 2), cc.p(300, 100)];
var bezierForward = cc.bezierBy(3, bezier);
bezierTo

按贝赛尔曲线轨迹移动到目标位置。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1830
参数列表
示例
// example
var bezier = [cc.p(0, windowSize.height / 2), cc.p(300, -windowSize.height / 2), cc.p(300, 100)];
var bezierTo = cc.bezierTo(2, bezier);
scaleTo

将节点大小缩放到指定的倍数。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1915
参数列表
  • duration Number
  • sx Number scale parameter in X
  • sy Number scale parameter in Y, if Null equal to sx
示例
// example
// It scales to 0.5 in both X and Y.
var actionTo = cc.scaleTo(2, 0.5);

// It scales to 0.5 in x and 2 in Y
var actionTo = cc.scaleTo(2, 0.5, 2);
scaleBy

按指定的倍数缩放节点大小。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:1962
参数列表
  • duration Number duration in seconds
  • sx Number sx scale parameter in X
  • sy Number | Null sy scale parameter in Y, if Null equal to sx
示例
// example without sy, it scales by 2 both in X and Y
var actionBy = cc.scaleBy(2, 2);

//example with sy, it scales by 0.25 in X and 4.5 in Y
var actionBy2 = cc.scaleBy(2, 0.25, 4.5);

闪烁(基于透明度)。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2047
参数列表
  • duration Number duration in seconds
  • blinks Number blinks in times
示例
// example
var action = cc.blink(2, 10);
fadeTo

修改透明度到指定值。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2113
参数列表
示例
// example
var action = cc.fadeTo(1.0, 0);
fadeIn

渐显效果。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2168
参数列表
  • duration Number duration in seconds
示例
//example
var action = cc.fadeIn(1.0);
fadeOut

渐隐效果。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2215
参数列表
  • d Number duration in seconds
示例
// example
var action = cc.fadeOut(1.0);
tintTo

修改颜色到指定值。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2302
参数列表
示例
// example
var action = cc.tintTo(2, 255, 0, 255);
tintBy

按照指定的增量修改颜色。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2395
参数列表
示例
// example
var action = cc.tintBy(2, -127, -255, -127);
delayTime
meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2436
参数列表
  • d Number duration in seconds
示例
// example
var delay = cc.delayTime(1);
reverseTime

反转目标动作的时间轴。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2519
参数列表
示例
// example
 var reverse = cc.reverseTime(this);
targetedAction

用已有动作和一个新的目标节点创建动作。

meta description
返回 ActionInterval
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/actions/CCActionInterval.js:2776
参数列表
Class

定义一个 CCClass,传入参数必须是一个包含类型参数的字面量对象,具体用法请查阅类型定义

meta description
返回 Function
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCClass.js:828
参数列表
  • options Object
    • name String The class name used for serialization.
    • extends Function The base class.
    • ctor Function The constructor.
    • ctor Function The same as ctor, but less encapsulated.
    • properties Object The property definitions.
    • statics Object The static members.
    • mixins Function[]
    • editor Object attributes for Component listed below.
      • executeInEditMode Boolean Allows the current component to run in edit mode. By default, all components are executed only at runtime, meaning that they will not have their callback functions executed while the Editor is in edit mode.
      • requireComponent Function Automatically add required component as a dependency.
      • menu String The menu path to register a component to the editors "Component" menu. Eg. "Rendering/Camera".
      • executionOrder Number The execution order of lifecycle methods for Component. Those less than 0 will execute before while those greater than 0 will execute after. The order will only affect onLoad, onEnable, start, update and lateUpdate while onDisable and onDestroy will not be affected.
      • disallowMultiple Boolean If specified to a type, prevents Component of the same type (or subtype) to be added more than once to a Node.
      • playOnFocus Boolean This property is only available when executeInEditMode is set. If specified, the editor's scene view will keep updating this node in 60 fps when it is selected, otherwise, it will update only if necessary.
      • inspector String Customize the page url used by the current component to render in the Properties.
      • icon String Customize the icon that the current component displays in the editor.
      • help String The custom documentation URL
    • update Function lifecycle method for Component, see update
    • lateUpdate Function lifecycle method for Component, see lateUpdate
    • onLoad Function lifecycle method for Component, see onLoad
    • start Function lifecycle method for Component, see start
    • onEnable Function lifecycle method for Component, see onEnable
    • onDisable Function lifecycle method for Component, see onDisable
    • onDestroy Function lifecycle method for Component, see onDestroy
    • onFocusInEditor Function lifecycle method for Component, see onFocusInEditor
    • onLostFocusInEditor Function lifecycle method for Component, see onLostFocusInEditor
    • resetInEditor Function lifecycle method for Component, see resetInEditor
    • onRestore Function for Component only, see onRestore
    • _getLocalBounds Function for Component only, see _getLocalBounds
示例
// define base class
var Node = cc.Class();

// define sub class
var Sprite = cc.Class({
name: 'Sprite',
extends: Node,
ctor: function () {
this.url = "";
this.id = 0;
},

statics: {
// define static members
count: 0,
getBounds: function (spriteList) {
// compute bounds...
}
},

properties {
width: {
default: 128,
type: 'Integer',
tooltip: 'The width of sprite'
},
height: 128,
size: {
get: function () {
return cc.v2(this.width, this.height);
}
}
},

load: function () {
// load this.url...
};
});

// instantiate

var obj = new Sprite();
obj.url = 'sprite.png';
obj.load();
_isCCClass

Checks whether the constructor is created by cc.Class

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCClass.js:992
参数列表
isChildClassOf

Checks whether subclass is child of superclass or equals to superclass

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCClass.js:1029
参数列表
getInheritanceChain

Return all super classes

meta description
返回 Function[]
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCClass.js:1064
参数列表
Enum

定义一个枚举类型。
用户可以把枚举值设为任意的整数,如果设为 -1,系统将会分配为上一个枚举值 + 1。

meta description
返回 object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCEnum.js:33
参数列表
  • obj object a JavaScript literal object containing enum names and values, or a TypeScript enum type
示例
// JavaScript:

var WrapMode = cc.Enum({
    Repeat: -1,
    Clamp: -1
});

// Texture.WrapMode.Repeat == 0
// Texture.WrapMode.Clamp == 1
// Texture.WrapMode[0] == "Repeat"
// Texture.WrapMode[1] == "Clamp"

var FlagType = cc.Enum({
    Flag1: 1,
    Flag2: 2,
    Flag3: 4,
    Flag4: 8,
});

var AtlasSizeList = cc.Enum({
    128: 128,
    256: 256,
    512: 512,
    1024: 1024,
});

// TypeScript:

// If used in TypeScript, just define a TypeScript enum:
enum Direction {
    Up,
    Down,
    Left,
    Right
}

// If you need to inspect the enum in Properties panel, you can call cc.Enum:
const {ccclass, property} = cc._decorator;

@ccclass
class NewScript extends cc.Component {
    @property({
        default: Direction.Up,
        type: cc.Enum(Direction)    // call cc.Enum
    })
    direction: Direction = Direction.Up;
}
getList
meta description
返回 Object[]
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCEnum.js:89
参数列表
  • enumDef Object the enum type defined from cc.Enum
setAccelerometerEnabled

whether enable accelerometer event

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputExtension.js:37
参数列表
setAccelerometerInterval

set accelerometer interval value

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputExtension.js:58
参数列表
handleTouchesBegin
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:96
参数列表
handleTouchesMove
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:131
参数列表
handleTouchesEnd
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:163
参数列表
handleTouchesCancel
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:177
参数列表
getSetOfTouchesEndOrCancel
meta description
返回 Array
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:191
参数列表
getHTMLElementPosition
meta description
返回 Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:217
参数列表
getPreTouch
meta description
返回 Touch
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:264
参数列表
setPreTouch
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:284
参数列表
getTouchByXY
meta description
返回 Touch
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:309
参数列表
getTouchByXY
meta description
返回 Event.EventMouse
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:326
参数列表
getPointByEvent
meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:344
参数列表
getTouchesByEvent
meta description
返回 Array
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:365
参数列表
registerSystemEvent
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:403
参数列表
update
meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCInputManager.js:573
参数列表
lerp

Linear interpolation between 2 numbers, the ratio sets how much it is biased to each end

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:1979
参数列表
示例
----
lerp
cc.lerp(2,10,0.5)//returns 6
cc.lerp(2,10,0.2)//returns 3.6
rand

get a random number from 0 to 0xffffff

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:1993
randomMinus1To1

returns a random float between -1 and 1

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:2002
random0To1

returns a random float between 0 and 1, use Math.random directly

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:2011
degreesToRadians

converts degrees to radians

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:2018
参数列表
radiansToDegrees

converts radians to degrees

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:2028
参数列表
nodeDrawSetup

Helpful macro that setups the GL server state, the correct GL program and sets the Model View Projection matrix

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:2038
参数列表
  • node Node setup node
incrementGLDraws

Increments the GL Draws counts by one.
The number of calls per frame are displayed on the screen when the CCDirector's stats are enabled.

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:2090
参数列表
checkGLErrorDebug

Check webgl error.Error will be shown in console if exists.

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCMacro.js:2102
isValid

检查该对象是否不为 null 并且尚未销毁。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/CCObject.js:460
参数列表
  • value Any
示例
cc.log(cc.isValid(target));
deserialize

将 JSON 反序列化为对象实例。

当指定了 target 选项时,如果 target 引用的其它 asset 的 uuid 不变,则不会改变 target 对 asset 的引用, 也不会将 uuid 保存到 result 对象中。

meta description
返回 object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/deserialize.js:809
参数列表
  • data String | Object the serialized cc.Asset json string or json object.
  • details Details additional loading result
  • options Object
instantiate

克隆指定的任意类型的对象,或者从 Prefab 实例化出新节点。

(Instantiate 时,function 和 dom 等非可序列化对象会直接保留原有引用,Asset 会直接进行浅拷贝,可序列化类型会进行深拷贝。)

meta description
返回 Node | Object
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/platform/instantiate.js:35
参数列表
  • original Prefab | Node | Object An existing object that you want to make a copy of.
示例
// instantiate node from prefab
var scene = cc.director.getScene();
var node = cc.instantiate(prefabAsset);
node.parent = scene;
// clone node
var scene = cc.director.getScene();
var node = cc.instantiate(targetNode);
node.parent = scene;
find

Finds a node by hierarchy path, the path is case-sensitive. It will traverse the hierarchy by splitting the path using '/' character. This function will still returns the node even if it is inactive. It is recommended to not use this function every frame instead cache the result at startup.

meta description
返回 Node | Null
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/utils/find.js:29
参数列表
color

通过该方法来创建一个新的 Color/Color:method 对象。 Alpha 通道是可选的。默认值是 255。

meta description
返回 Color
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:620
参数列表
示例
-----------------------
// 1. All channels seperately as parameters
var color1 = new cc.Color(255, 255, 255, 255);
// 2. Convert a hex string to a color
var color2 = new cc.Color("#000000");
// 3. An color object as parameter
var color3 = new cc.Color({r: 255, g: 255, b: 255, a: 255});
colorEqual

判断两个颜色对象的 RGB 部分是否相等,不比较透明度。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:651
参数列表
示例
cc.log(cc.colorEqual(cc.Color.RED, new cc.Color(255, 0, 0))); // true
hexToColor

16 进制转换为 Color

meta description
返回 Color
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:670
参数列表
示例
cc.hexToColor("#FFFF33"); // Color {r: 255, g: 255, b: 51, a: 255};
colorToHex

Color 转换为 16进制。

meta description
返回 String
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCColor.js:690
参数列表
示例
var color = new cc.Color(255, 6, 255)
cc.colorToHex(color); // #ff06ff;
pNeg

返回相反的向量。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:46
参数列表
示例
cc.pNeg(cc.v2(10, 10));// Vec2 {x: -10, y: -10};
pAdd

返回两个向量的和。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:59
参数列表
示例
cc.pAdd(cc.v2(1, 1), cc.v2(2, 2));// Vec2 {x: 3, y: 3};
pSub

返回两个向量的差。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:73
参数列表
示例
cc.pSub(cc.v2(20, 20), cc.v2(5, 5)); // Vec2 {x: 15, y: 15};
pMult

向量缩放。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:87
参数列表
示例
cc.pMult(cc.v2(5, 5), 4); // Vec2 {x: 20, y: 20};
pMidpoint

两个向量之间的中心点。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:101
参数列表
示例
cc.pMidpoint(cc.v2(10, 10), cc.v2(5, 5)); // Vec2 {x: 7.5, y: 7.5};
pDot

两个向量之间进行点乘。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:115
参数列表
示例
cc.pDot(cc.v2(20, 20), cc.v2(5, 5)); // 200;
pCross

两个向量之间进行叉乘。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:129
参数列表
示例
cc.pCross(cc.v2(20, 20), cc.v2(5, 5)); // 0;
pPerp

返回逆时针旋转 90 度后的新向量。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:143
参数列表
示例
cc.pPerp(cc.v2(20, 20)); // Vec2 {x: -20, y: 20};
pRPerp

将指定向量顺时针旋转 90 度并返回。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:156
参数列表
示例
cc.pRPerp(cc.v2(20, 20)); // Vec2 {x: 20, y: -20};
pProject

返回 v1 在 v2 上的投影向量。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:169
参数列表
示例
var v1 = cc.v2(20, 20);
var v2 = cc.v2(5, 5);
cc.pProject(v1, v2); // Vec2 {x: 20, y: 20};
pLengthSQ

返回指定向量长度的平方。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:185
参数列表
示例
cc.pLengthSQ(cc.v2(20, 20)); // 800;
pDistanceSQ

返回两个点之间距离的平方。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:198
参数列表
示例
var point1 = cc.v2(20, 20);
var point2 = cc.v2(5, 5);
cc.pDistanceSQ(point1, point2); // 450;
pLength

返回指定向量的长度.

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:214
参数列表
示例
cc.pLength(cc.v2(20, 20)); // 28.284271247461902;
pDistance

返回指定 2 个向量之间的距离。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:227
参数列表
示例
var v1 = cc.v2(20, 20);
var v2 = cc.v2(5, 5);
cc.pDistance(v1, v2); // 21.213203435596427;
pNormalize

返回一个长度为 1 的标准化过后的向量。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:243
参数列表
示例
cc.pNormalize(cc.v2(20, 20)); // Vec2 {x: 0.7071067811865475, y: 0.7071067811865475};
pForAngle

将弧度转换为一个标准化后的向量,返回坐标 x = cos(a) , y = sin(a)。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:257
参数列表
示例
cc.pForAngle(20); // Vec2 {x: 0.40808206181339196, y: 0.9129452507276277};
pToAngle

返回指定向量的弧度。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:270
参数列表
示例
cc.pToAngle(cc.v2(20, 20)); // 0.7853981633974483;
clampf

限定浮点数的最大最小值。
数值大于 max_inclusive 则返回 max_inclusive。
数值小于 min_inclusive 则返回 min_inclusive。
否则返回自身。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:283
参数列表
示例
var v1 = cc.clampf(20, 0, 20); // 20;
var v2 = cc.clampf(-1, 0, 20); //  0;
var v3 = cc.clampf(10, 0, 20); // 10;
clamp01

限定浮点数的取值范围为 0 ~ 1 之间。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:309
参数列表
示例
var v1 = cc.clampf(20);  // 1;
var v2 = cc.clampf(-1);  // 0;
var v3 = cc.clampf(0.5); // 0.5;
pClamp

返回指定限制区域后的向量。
向量大于 max_inclusive 则返回 max_inclusive。
向量小于 min_inclusive 则返回 min_inclusive。
否则返回自身。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:324
参数列表
示例
var min_inclusive = cc.v2(0, 0);
var max_inclusive = cc.v2(20, 20);
var v1 = cc.pClamp(cc.v2(20, 20), min_inclusive, max_inclusive); // Vec2 {x: 20, y: 20};
var v2 = cc.pClamp(cc.v2(0, 0), min_inclusive, max_inclusive);   // Vec2 {x: 0, y: 0};
var v3 = cc.pClamp(cc.v2(10, 10), min_inclusive, max_inclusive); // Vec2 {x: 10, y: 10};
pFromSize

快速转换 cc.Size 为 cc.Vec2。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:347
参数列表
示例
cc.pFromSize(new cc.size(20, 20)); // Vec2 {x: 20, y: 20};
pCompOp

通过运行指定的数学运算函数来计算指定的向量。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:360
参数列表
示例
cc.pCompOp(cc.p(-10, -10), Math.abs); // Vec2 {x: 10, y: 10};
pLerp

两个点 A 和 B 之间的线性插值。
alpha == 0 ? a
alpha == 1 ? b
否则这个数值在 a ~ b 之间。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:376
参数列表
示例
cc.pLerp(cc.v2(20, 20), cc.v2(5, 5), 0.5); // Vec2 {x: 12.5, y: 12.5};
pFuzzyEqual

近似判断两个点是否相等。
判断 2 个向量是否在指定数值的范围之内,如果在则返回 true,反之则返回 false。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:399
参数列表
示例
var a = cc.v2(20, 20);
var b = cc.v2(5, 5);
var b1 = cc.pFuzzyEqual(a, b, 10); // false;
var b2 = cc.pFuzzyEqual(a, b, 18); // true;
pCompMult

计算两个向量的每个分量的乘积, a.x b.x, a.y b.y。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:423
参数列表
示例
cc.pCompMult(acc.v2(20, 20), cc.v2(5, 5)); // Vec2 {x: 100, y: 100};
pAngleSigned

返回两个向量之间带正负号的弧度。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:437
参数列表
pAngle

获取当前向量与指定向量之间的弧度角。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:454
参数列表
pRotateByAngle

返回给定向量围绕指定轴心顺时针旋转一定弧度后的结果。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:468
参数列表
  • v Vec2 v is the point to rotate
  • pivot Vec2 pivot is the pivot, naturally
  • angle Number angle is the angle of rotation cw in radians
pLineIntersect

返回 A 为起点 B 为终点线段 1 所在直线和 C 为起点 D 为终点线段 2 所在的直线是否相交,
如果相交返回 true,反之则为 false,参数 retP 是返回交点在线段 1、线段 2 上的比例。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:486
参数列表
  • A Vec2 A is the startpoint for the first line P1 = (p1 - p2).
  • B Vec2 B is the endpoint for the first line P1 = (p1 - p2).
  • C Vec2 C is the startpoint for the second line P2 = (p3 - p4).
  • D Vec2 D is the endpoint for the second line P2 = (p3 - p4).
  • retP Vec2 retP.x is the range for a hitpoint in P1 (pa = p1 + s(p2 - p1)),
    retP.y is the range for a hitpoint in P3 (pa = p2 + t
    (p4 - p3)).
pSegmentIntersect

返回线段 A - B 和线段 C - D 是否相交。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:537
参数列表
pIntersectPoint

返回线段 A - B 和线段 C - D 的交点。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:555
参数列表
pSameAs

检查指定的 2 个向量是否相等。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:579
参数列表
  • A Vec2 A ccp a
  • B Vec2 B ccp b to be compared
pZeroIn

设置指定向量归 0。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:598
参数列表
pIn

令 v1 向量等同于 v2。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:609
参数列表
pMultIn

向量缩放,结果保存到第一个向量。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:621
参数列表
pSubIn

向量减法,结果保存到第一个向量。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:633
参数列表
pAddIn

向量加法,结果保存到第一个向量。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:645
参数列表
pNormalizeIn

规范化 v 向量,设置 v 向量长度为 1。

meta description
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCPointExtension.js:657
参数列表
rect

该方法用来快速创建一个新的矩形。Rect/Rect:method

meta description
返回 Rect
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:369
参数列表
示例
var a = new cc.Rect(0 , 0, 10, 0);
rectEqualToRect

判断两个矩形是否相等。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:391
参数列表
示例
var a = new cc.Rect(0, 0, 10, 10);
var b = new cc.Rect(0, 0, 5, 5);
cc.rectEqualToRect(a, b); // false;
var c = new cc.Rect(0, 0, 5, 5);
cc.rectEqualToRect(b, c); // true;
rectContainsRect

检查 rect1 矩形是否包含 rect2 矩形。
注意:如果要允许 rect1 和 rect2 的边界重合,应该用 cc.rectOverlapsRect

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:413
参数列表
示例
var a = new cc.Rect(0, 0, 20, 20);
var b = new cc.Rect(10, 10, 20, 20);
cc.rectContainsRect(a, b); // true;
rectGetMaxX

返回矩形在 x 轴上的最大值

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:435
参数列表
示例
var a = new cc.Rect(10, 0, 20, 20);
cc.rectGetMaxX(a); // 30;
rectGetMidX

返回矩形在 x 轴上的中点。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:449
参数列表
示例
var a = new cc.Rect(10, 0, 20, 20);
cc.rectGetMidX(a); // 20;
rectGetMinX

返回矩形在 x 轴上的最小值。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:462
参数列表
示例
var a = new cc.Rect(10, 0, 20, 20);
cc.rectGetMinX(a); // 10;
rectGetMaxY

返回矩形在 y 轴上的最大值。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:476
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
cc.rectGetMaxY(a); // 30;
rectGetMidY

返回矩形在 y 轴上的中点。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:490
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
cc.rectGetMidY(a); // 20;
rectGetMinY

返回矩形在 y 轴上的最小值。

meta description
返回 Number
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:504
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
cc.rectGetMinY(a); // 10;
rectContainsPoint

检查一个矩形是否包含某个坐标点。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:518
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Vec2(0, 10, 10, 10);
cc.rectContainsPoint(a, b); // true;
rectIntersectsRect

检查一个矩形是否与另一个相交。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:535
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
cc.rectIntersectsRect(a, b); // true;
rectOverlapsRect

检查一个矩形是否重叠另一个。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:555
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
cc.rectOverlapsRect(a, b); // true;
rectUnion

返回一个包含两个指定矩形的最小矩形。

meta description
返回 Rect
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:574
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
cc.rectUnion(a, b); // Rect {x: 0, y: 10, width: 20, height: 20};
rectIntersection

返回 2 个矩形重叠的部分。

meta description
返回 Rect
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCRect.js:595
参数列表
示例
var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
cc.rectIntersection(a, b); // Rect {x: 0, y: 10, width: 10, height: 10};
size

创建一个 cc.Size 对象的帮助函数。
注意:可以使用 cc.p 或者是 cc.v2 代替,它们将很快取代 cc.Size。

meta description
返回 Size
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCSize.js:157
参数列表
示例
var size1 = cc.size();
var size2 = cc.size(100,100);
var size3 = cc.size(size2);
var size4 = cc.size({width: 100, height: 100});
sizeEqualToSize

检查 Size 对象是否等于另一个。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCSize.js:174
参数列表
示例
var a = new cc.size(10, 10);
var b = new cc.size(10, 10);
cc.sizeEqualToSize(a, b);// return true;
var b = new cc.size(5, 10);
cc.sizeEqualToSize(a, b);// return false;
V3F_C4B_T2F_QuadZero
meta description
返回 V3F_C4B_T2F_Quad
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCTypesWebGL.js:501
V3F_C4B_T2F_QuadCopy
meta description
返回 V3F_C4B_T2F_Quad
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCTypesWebGL.js:509
参数列表
V3F_C4B_T2F_QuadsCopy
meta description
返回 Array
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCTypesWebGL.js:536
参数列表
v2

通过该简便的函数进行创建 cc.Vec2 对象。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCVec2.js:592
参数列表
示例
var v1 = cc.v2();
var v2 = cc.v2(0, 0);
var v3 = cc.v2(v2);
var v4 = cc.v2({x: 100, y: 100});
p

通过该简便的函数进行创建 cc.Vec2 对象。

meta description
返回 Vec2
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCVec2.js:609
参数列表
示例
var point1 = cc.p();
var point2 = cc.p(100, 100);
var point3 = cc.p(point2);
var point4 = cc.p({x: 100, y: 100});
pointEqualToPoint

判断两个向量是否相等。

meta description
返回 Boolean
定义于 https:/github.com/cocos-creator/engine/blob/master/cocos2d/core/value-types/CCVec2.js:627
参数列表

results matching ""

    No results matching ""