cc 模块

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

类型

• Acceleration
• Action
• ActionEase
• ActionInstant
• ActionInterval
• ActionManager
• AffineTransform
• Animation
• AnimationClip
• AnimationState
• Asset
• AudioClip
• audioEngine
• AudioSource
• BitmapFont
• BlendFunc
• BlockInputEvents
• BoxCollider
• Button
• CallbacksInvoker
• Camera
• Canvas
• CircleCollider
• CoffeeScript
• Collider
• Collider.Box
• Collider.Circle
• Collider.Polygon
• CollisionManager
• Color
• Component
• Component.EventHandler
• ContainerStrategy
• ContentStrategy
• Details
• Director
• DistanceJoint
• EaseBounce
• EaseElastic
• EaseRateAction
• EditBox
• EqualToFrame
• EqualToWindow
• Event
• Event.EventAcceleration
• Event.EventCustom
• Event.EventKeyboard
• Event.EventMouse
• Event.EventTouch
• EventListener
• eventManager
• EventTarget
• FiniteTimeAction
• Font
• Game
• Graphics
• Intersection
• Joint
• JsonAsset
• Label
• LabelAtlas
• LabelOutline
• Layout
• loader
• LoadingItems
• Manifold
• ManifoldPoint
• Mask
• MotionStreak
• MotorJoint
• MouseJoint
• Node
• Node.EventType
• NodePool
• OriginalContainer
• PageView
• PageViewIndicator
• ParticleSystem
• PhysicsBoxCollider
• PhysicsChainCollider
• PhysicsCircleCollider
• PhysicsCollider
• PhysicsContact
• PhysicsImpulse
• PhysicsManager
• PhysicsPolygonCollider
• PhysicsRayCastResult
• Pipeline
• Pipeline.Downloader
• Pipeline.Loader
• Playable
• PolygonCollider
• pool
• Prefab
• PrismaticJoint
• ProgressBar
• ProportionalToFrame
• ProportionalToWindow
• Quad2
• Quad3
• RawAsset
• Rect
• ResolutionPolicy
• RevoluteJoint
• RichText
• RigidBody
• RopeJoint
• Scene
• SceneAsset
• Scheduler
• screen
• Scrollbar
• ScrollView
• Size
• Slider
• Sprite
• SpriteAtlas
• SpriteDistortion
• SpriteFrame
• sys
• SystemEvent
• SystemEvent.EventType
• Tex2F
• TextAsset
• Texture2D
• textureCache
• TiledLayer
• TiledMap
• TiledMapAsset
• TiledObjectGroup
• TMXObject
• Toggle
• ToggleContainer
• ToggleGroup
• Touch
• TTFFont
• TypeScript
• url
• V2F_C4B_T2F
• V2F_C4B_T2F_Triangle
• V3F_C4B_T2F
• V3F_C4B_T2F_Quad
• ValueType
• Vec2
• Vertex2F
• Vertex3F
• VideoPlayer
• View
• ViewGroup
• visibleRect
• WebGLColor
• WebView
• WeldJoint
• WheelJoint
• Widget
• WorldManifold

枚举

• audioEngine.AudioState
• BlendFactor
• Button.Transition
• DebugMode
• DrawBits
• EditBox.InputFlag
• EditBox.InputMode
• EditBox.KeyboardReturnType
• Flags
• Graphics.LineCap
• Graphics.LineJoin
• ImageFormat
• KEY
• Label.HorizontalAlign
• Label.Overflow
• Label.Type
• Label.VerticalAlign
• Layout.AxisDirection
• Layout.HorizontalDirection
• Layout.ResizeMode
• Layout.Type
• Layout.VerticalDirection
• LoadingItems.ItemState
• macro
• Mask.Type
• NetworkType
• PageView.Direction
• PageView.EventType
• PageView.SizeMode
• PageViewIndicator.Direction
• ParticleSystem.EmitterMode
• ParticleSystem.PositionType
• Prefab.OptimizationPolicy
• ProgressBar.Mode
• RayCastType
• RigidBodyType
• Scrollbar.Direction
• ScrollView.EventType
• Slider.Direction
• Sprite.FillType
• Sprite.SizeMode
• Sprite.Type
• TextAlignment
• Texture2D.Filter
• Texture2D.PixelFormat
• Texture2D.WrapMode
• TiledMap.Orientation
• VideoPlayer.EventType
• VideoPlayer.ResourceType
• WebView.EventType
• Widget.AlignMode
• WrapMode

索引

属性（properties）

• _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
• ENGINE_VERSION String The current version of Cocos2d being used....
• view View cc.view 是全局的视图对象。
• director Director 导演类。
• winSize Size cc.winSize 为当前的游戏窗口的大小。
• game Game
• Integer string Specify that the input value must be integer in Inspector....
• 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.
• systemEvent SystemEvent 系统事件单例，方便全局使用

方法

• _initDebugSetting 设置调试模式。
• error 输出错误消息到 Cocos Creator 编辑器的 Console 或运行时页面端的 Console 中。
• warn 输出警告消息到 Cocos Creator 编辑器的 Console 或运行时 Web 端的 Console 中。
• log 输出一条消息到 Cocos Creator 编辑器的 Console 或运行时 Web 端的 Console 中。
• speed 修改目标动作的速率。
• follow 追踪目标节点的位置。
• setPoints Points setter
• cardinalSplineTo 按基数样条曲线轨迹移动到目标位置。
• updatePosition update position of target
• cardinalSplineBy 按基数样条曲线轨迹移动指定的距离。
• catmullRomTo 按 Catmull Rom 样条曲线轨迹移动到目标位置。
• catmullRomBy 按 Catmull Rom 样条曲线轨迹移动指定的距离。
• show 立即显示。
• hide 立即隐藏。
• toggleVisibility 显隐状态切换。
• removeSelf 从父节点移除自身。
• flipX X轴翻转。
• flipY Y轴翻转。
• place 放置在目标位置。
• callFunc 执行回调函数。
• sequence 顺序执行动作，创建的动作将按顺序依次运行。
• repeat 重复动作，可以按一定次数重复一个动，如果想永远重复一个动作请使用 repeatForever 动作来完成。
• repeatForever 永远地重复一个动作，有限次数内重复一个动作请使用 repeat 动作，由于这个动作不会停止，所以不能被添加到 cc.sequence 或 cc.spawn 中。
• spawn 同步执行动作，同步执行一组动作。
• rotateTo 旋转到目标角度，通过逐帧修改它的 rotation 属性，旋转方向将由最短的角度决定。
• rotateBy 旋转指定的角度。
• moveBy 移动指定的距离。
• moveTo 移动到目标位置。
• skewTo 偏斜到目标角度。
• skewBy 偏斜指定的角度。
• jumpBy 用跳跃的方式移动指定的距离。
• jumpTo 用跳跃的方式移动到目标位置。
• bezierBy 按贝赛尔曲线轨迹移动指定的距离。
• bezierTo 按贝赛尔曲线轨迹移动到目标位置。
• scaleTo 将节点大小缩放到指定的倍数。
• scaleBy 按指定的倍数缩放节点大小。
• blink 闪烁（基于透明度）。
• fadeTo 修改透明度到指定值。
• fadeIn 渐显效果。
• fadeOut 渐隐效果。
• tintTo 修改颜色到指定值。
• tintBy 按照指定的增量修改颜色。
• delayTime
• reverseTime 反转目标动作的时间轴。
• targetedAction 用已有动作和一个新的目标节点创建动作。
• easeIn 创建 easeIn 缓动对象，由慢到快。
• easeOut 创建 easeOut 缓动对象，由快到慢。
• easeInOut 创建 easeInOut 缓动对象，慢到快，然后慢。
• easeExponentialIn 创建 easeExponentialIn 缓动对象。
• easeExponentialOut 创建 easeExponentialOut 缓动对象。
• easeExponentialInOut 创建 easeExponentialInOut 缓动对象。
• easeSineIn 创建 EaseSineIn 缓动对象。
• easeSineOut 创建 EaseSineOut 缓动对象。
• easeSineInOut 创建 easeSineInOut 缓动对象。
• easeElasticIn 创建 easeElasticIn 缓动对象。
• easeElasticOut 创建 easeElasticOut 缓动对象。
• easeElasticInOut 创建 easeElasticInOut 缓动对象。
• easeBounceIn 创建 easeBounceIn 缓动对象。
• easeBounceOut 创建 easeBounceOut 缓动对象。
• easeBounceInOut 创建 easeBounceInOut 缓动对象。
• easeBackIn 创建 easeBackIn 缓动对象。
• easeBackOut 创建 easeBackOut 缓动对象。
• easeBackInOut 创建 easeBackInOut 缓动对象。
• easeBezierAction 创建 easeBezierAction 缓动对象。
• easeQuadraticActionIn 创建 easeQuadraticActionIn 缓动对象。
• easeQuadraticActionOut 创建 easeQuadraticActionOut 缓动对象。
• easeQuadraticActionInOut 创建 easeQuadraticActionInOut 缓动对象。
• easeQuarticActionIn 创建 easeQuarticActionIn 缓动对象。
• easeQuarticActionOut 创建 easeQuarticActionOut 缓动对象。
• easeQuarticActionInOut 创建 easeQuarticActionInOut 缓动对象。
• easeQuinticActionIn 创建 easeQuinticActionIn 缓动对象。
• easeQuinticActionOut 创建 easeQuinticActionOut 缓动对象。
• easeQuinticActionInOut 创建 easeQuinticActionInOut 缓动对象。
• easeCircleActionIn 创建 easeCircleActionIn 缓动对象。
• easeCircleActionOut 创建 easeCircleActionOut 缓动对象。
• easeCircleActionInOut 创建 easeCircleActionInOut 缓动对象。
• easeCubicActionIn 创建 easeCubicActionIn 缓动对象。
• easeCubicActionOut 创建 easeCubicActionOut 缓动对象。
• easeCubicActionInOut 创建 easeCubicActionInOut 缓动对象。
• handleTouchesBegin
• handleTouchesMove
• handleTouchesEnd
• handleTouchesCancel
• getSetOfTouchesEndOrCancel
• getHTMLElementPosition
• getPreTouch
• setPreTouch
• getTouchByXY
• getPointByEvent
• getTouchesByEvent
• registerSystemEvent
• Class 定义一个 CCClass，传入参数必须是一个包含类型参数的字面量对象，具体用法请查阅类型定义。
• _isCCClass Checks whether the constructor is created by cc.Class
• isChildClassOf Checks whether subclass is child of superclass or equals to superclass
• Enum 定义一个枚举类型。
• getList
• setAccelerometerEnabled whether enable accelerometer event
• setAccelerometerInterval set accelerometer interval value
• handleTouchesBegin
• handleTouchesMove
• handleTouchesEnd
• handleTouchesCancel
• getSetOfTouchesEndOrCancel
• getHTMLElementPosition
• getPreTouch
• setPreTouch
• getTouchByXY
• getTouchByXY
• getPointByEvent
• getTouchesByEvent
• registerSystemEvent
• update
• lerp Linear interpolation between 2 numbers, the ratio sets how much it is biased to each end
• rand get a random number from 0 to 0xffffff
• randomMinus1To1 returns a random float between -1 and 1
• random0To1 returns a random float between 0 and 1, use Math.random directly
• degreesToRadians converts degrees to radians
• radiansToDegrees converts radians to degrees
• nodeDrawSetup Helpful macro that setups the GL server state, the correct GL program and sets the Model View Projection matrix
• incrementGLDraws

  ...

• checkGLErrorDebug Check webgl error.Error will be shown in console if exists.
• isValid 检查该对象是否不为 null 并且尚未销毁。
• deserialize 将 JSON 反序列化为对象实例。
• instantiate 克隆指定的任意类型的对象，或者从 Prefab 实例化出新节点。
• find Finds a node by hierarchy path, the path is case-sensitive....
• 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 限定浮点数的最大最小值。
• clamp01 限定浮点数的取值范围为 0 ~ 1 之间。
• pClamp 返回指定限制区域后的向量。
• pFromSize 快速转换 cc.Size 为 cc.Vec2。
• pCompOp 通过运行指定的数学运算函数来计算指定的向量。
• pLerp 两个点 A 和 B 之间的线性插值。
• pFuzzyEqual 近似判断两个点是否相等。
• pCompMult 计算两个向量的每个分量的乘积， a.x b.x, a.y b.y。
• pAngleSigned 返回两个向量之间带正负号的弧度。
• pAngle 获取当前向量与指定向量之间的弧度角。
• pRotateByAngle 返回给定向量围绕指定轴心顺时针旋转一定弧度后的结果。
• pLineIntersect 如果相交返回 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。
• color 通过该方法来创建一个新的 Color/Color:method 对象。
• colorEqual 判断两个颜色对象的 RGB 部分是否相等，不比较透明度。
• hexToColor 16 进制转换为 Color
• colorToHex Color 转换为 16进制。
• rect 该方法用来快速创建一个新的矩形。
• rectEqualToRect 判断两个矩形是否相等。
• rectContainsRect 检查 rect1 矩形是否包含 rect2 矩形。
• rectGetMaxX 返回矩形在 x 轴上的最大值
• rectGetMidX 返回矩形在 x 轴上的中点。
• rectGetMinX 返回矩形在 x 轴上的最小值。
• rectGetMaxY 返回矩形在 y 轴上的最大值。
• rectGetMidY 返回矩形在 y 轴上的中点。
• rectGetMinY 返回矩形在 y 轴上的最小值。
• rectContainsPoint 检查一个矩形是否包含某个坐标点。
• rectIntersectsRect 检查一个矩形是否与另一个相交。
• rectOverlapsRect 检查一个矩形是否重叠另一个。
• rectUnion 返回一个包含两个指定矩形的最小矩形。
• rectIntersection 返回 2 个矩形重叠的部分。
• size 创建一个 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）

_renderContext

main Canvas 2D/3D Context of game engine

_canvas

Main canvas of game engine

container

The element contains the game canvas

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.

view

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

director

导演类。

winSize

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

game

Integer

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

示例

// in cc.Class
member: {
    default: [],
    type: cc.Integer
}
// ES6 ccclass

Float

Indicates that the elements in array should be type double.

示例

// in cc.Class
member: {
    default: [],
    type: cc.Float
}
// ES6 ccclass

Boolean

Indicates that the elements in array should be type boolean.

示例

// in cc.Class
member: {
    default: [],
    type: cc.Boolean
}
// ES6 ccclass

String

Indicates that the elements in array should be type string.

示例

// in cc.Class
member: {
    default: [],
    type: cc.String
}
// ES6 ccclass

systemEvent

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

方法

_initDebugSetting

设置调试模式。

参数列表

• mode DebugMode

error

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

• 在 Cocos Creator 中，错误信息显示是红色的。
  
• 在 Chrome 中，错误信息有红色的图标以及红色的消息文本。
  

参数列表

• 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 中，警告信息有着黄色的图标以及黄色的消息文本。
  

参数列表

• 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 中。

参数列表

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

speed

修改目标动作的速率。

参数列表

• action ActionInterval
• speed Number

示例

// change the target action speed;
var action = cc.scaleTo(0.2, 1, 0.6);
var newAction = cc.speed(action, 0.5);

follow

追踪目标节点的位置。

参数列表

• followedNode Node
• rect Rect

示例

// 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

参数列表

• points Array

cardinalSplineTo

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

参数列表

• duration Number
• points Array array of control points
• tension Number

示例

//create a cc.CardinalSplineTo
var action1 = cc.cardinalSplineTo(3, array, 0);

updatePosition

update position of target

参数列表

• newPos Vec2

cardinalSplineBy

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

参数列表

• duration Number
• points Array
• tension Number

catmullRomTo

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

参数列表

• dt Number
• points Array

示例

var action1 = cc.catmullRomTo(3, array);

catmullRomBy

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

参数列表

• dt Number
• points Array

示例

var action1 = cc.catmullRomBy(3, array);

show

立即显示。

示例

// example
var showAction = cc.show();

hide

立即隐藏。

示例

// example
var hideAction = cc.hide();

toggleVisibility

显隐状态切换。

示例

// example
var toggleVisibilityAction = cc.toggleVisibility();

removeSelf

从父节点移除自身。

参数列表

• isNeedCleanUp Boolean

示例

// example
var removeSelfAction = cc.removeSelf();

flipX

X轴翻转。

参数列表

• flip Boolean Indicate whether the target should be flipped or not

示例

var flipXAction = cc.flipX(true);

flipY

Y轴翻转。

参数列表

• flip Boolean

示例

var flipYAction = cc.flipY(true);

place

放置在目标位置。

参数列表

• pos Vec2 | Number
• y Number

示例

// example
var placeAction = cc.place(cc.p(200, 200));
var placeAction = cc.place(200, 200);

callFunc

执行回调函数。

参数列表

• 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

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

参数列表

• actionOrActionArray FiniteTimeAction | FiniteTimeAction[]
• tempArray FiniteTimeAction

示例

// example
// create sequence with actions
var seq = cc.sequence(act1, act2);

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

repeat

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

参数列表

• action FiniteTimeAction
• times Number

示例

// example
var rep = cc.repeat(cc.sequence(jump2, jump1), 5);

repeatForever

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

参数列表

• action FiniteTimeAction

示例

// example
var repeat = cc.repeatForever(cc.rotateBy(1.0, 360));

spawn

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

参数列表

• actionOrActionArray FiniteTimeAction | FiniteTimeAction[]
• tempArray FiniteTimeAction

示例

// 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 属性，旋转方向将由最短的角度决定。

参数列表

• duration Number duration in seconds
• deltaAngleX Number deltaAngleX in degrees.
• deltaAngleY Number deltaAngleY in degrees.

示例

// example
var rotateTo = cc.rotateTo(2, 61.0);

rotateBy

旋转指定的角度。

参数列表

• duration Number duration in seconds
• deltaAngleX Number deltaAngleX in degrees
• deltaAngleY Number deltaAngleY in degrees

示例

// example
var actionBy = cc.rotateBy(2, 360);

moveBy

移动指定的距离。

参数列表

• duration Number duration in seconds
• deltaPos Vec2 | Number
• deltaY Number

示例

// example
var actionTo = cc.moveBy(2, cc.p(windowSize.width - 40, windowSize.height - 40));

moveTo

移动到目标位置。

参数列表

• duration Number duration in seconds
• position Vec2 | Number
• y Number

示例

// example
var actionBy = cc.moveTo(2, cc.p(80, 80));

skewTo

偏斜到目标角度。

参数列表

• t Number time in seconds
• sx Number
• sy Number

示例

// example
var actionTo = cc.skewTo(2, 37.2, -37.2);

skewBy

偏斜指定的角度。

参数列表

• 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

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

参数列表

• duration Number
• position Vec2 | Number
• y Number
• height Number
• jumps Number

示例

// example
var actionBy = cc.jumpBy(2, cc.p(300, 0), 50, 4);
var actionBy = cc.jumpBy(2, 300, 0, 50, 4);

jumpTo

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

参数列表

• duration Number
• position Vec2 | Number
• y Number
• height Number
• jumps Number

示例

// example
var actionTo = cc.jumpTo(2, cc.p(300, 300), 50, 4);
var actionTo = cc.jumpTo(2, 300, 300, 50, 4);

bezierBy

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

参数列表

• t Number time in seconds
• c Vec2[] Array of points

示例

// 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

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

参数列表

• t Number
• c Vec2[] Array of points

示例

// 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

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

参数列表

• 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

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

参数列表

• 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);

blink

闪烁（基于透明度）。

参数列表

• duration Number duration in seconds
• blinks Number blinks in times

示例

// example
var action = cc.blink(2, 10);

fadeTo

修改透明度到指定值。

参数列表

• duration Number
• opacity Number 0-255, 0 is transparent

示例

// example
var action = cc.fadeTo(1.0, 0);

fadeIn

渐显效果。

参数列表

• duration Number duration in seconds

示例

//example
var action = cc.fadeIn(1.0);

fadeOut

渐隐效果。

参数列表

• d Number duration in seconds

示例

// example
var action = cc.fadeOut(1.0);

tintTo

修改颜色到指定值。

参数列表

• duration Number
• red Number 0-255
• green Number 0-255
• blue Number 0-255

示例

// example
var action = cc.tintTo(2, 255, 0, 255);

tintBy

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

参数列表

• duration Number duration in seconds
• deltaRed Number
• deltaGreen Number
• deltaBlue Number

示例

// example
var action = cc.tintBy(2, -127, -255, -127);

delayTime

参数列表

• d Number duration in seconds

示例

// example
var delay = cc.delayTime(1);

reverseTime

反转目标动作的时间轴。

参数列表

• action FiniteTimeAction

示例

// example
 var reverse = cc.reverseTime(this);

targetedAction

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

参数列表

• target Node
• action FiniteTimeAction

easeIn

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

参数列表

• rate Number

示例

action.easing(cc.easeIn(3.0));

easeOut

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

参数列表

• rate Number

示例

action.easing(cc.easeOut(3.0));

easeInOut

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

参数列表

• rate Number

示例

action.easing(cc.easeInOut(3.0));

easeExponentialIn

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

示例

action.easing(cc.easeExponentialIn());

easeExponentialOut

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

示例

action.easing(cc.easeExponentialOut());

easeExponentialInOut

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

示例

action.easing(cc.easeExponentialInOut());

easeSineIn

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

示例

action.easing(cc.easeSineIn());

easeSineOut

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

示例

action.easing(cc.easeSineOut());

easeSineInOut

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

示例

action.easing(cc.easeSineInOut());

easeElasticIn

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

参数列表

• period Number

示例

// example
action.easing(cc.easeElasticIn(3.0));

easeElasticOut

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

参数列表

• period Number

示例

// example
action.easing(cc.easeElasticOut(3.0));

easeElasticInOut

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

参数列表

• period Number

示例

// example
action.easing(cc.easeElasticInOut(3.0));

easeBounceIn

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

示例

// example
action.easing(cc.easeBounceIn());

easeBounceOut

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

示例

// example
action.easing(cc.easeBounceOut());

easeBounceInOut

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

示例

// example
action.easing(cc.easeBounceInOut());

easeBackIn

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

示例

// example
action.easing(cc.easeBackIn());

easeBackOut

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

示例

// example
action.easing(cc.easeBackOut());

easeBackInOut

创建 easeBackInOut 缓动对象。

示例

// example
action.easing(cc.easeBackInOut());

easeBezierAction

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

参数列表

• 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

示例

//example
action.easing(cc.easeQuadraticActionIn());

easeQuadraticActionOut

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

示例

//example
action.easing(cc.easeQuadraticActionOut());

easeQuadraticActionInOut

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

示例

//example
action.easing(cc.easeQuadraticActionInOut());

easeQuarticActionIn

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

示例

//example
action.easing(cc.easeQuarticActionIn());

easeQuarticActionOut

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

示例

//example
action.easing(cc.QuarticActionOut());

easeQuarticActionInOut

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

easeQuinticActionIn

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

示例

//example
action.easing(cc.easeQuinticActionIn());

easeQuinticActionOut

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

示例

//example
action.easing(cc.easeQuadraticActionOut());

easeQuinticActionInOut

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

示例

//example
action.easing(cc.easeQuinticActionInOut());

easeCircleActionIn

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

示例

//example
action.easing(cc.easeCircleActionIn());

easeCircleActionOut

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

示例

//example
actioneasing(cc.easeCircleActionOut());

easeCircleActionInOut

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

示例

//example
action.easing(cc.easeCircleActionInOut());

easeCubicActionIn

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

示例

//example
action.easing(cc.easeCubicActionIn());

easeCubicActionOut

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

示例

//example
action.easing(cc.easeCubicActionOut());

easeCubicActionInOut

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

handleTouchesBegin

参数列表

• touches Array

handleTouchesMove

参数列表

• touches Array

handleTouchesEnd

参数列表

• touches Array

handleTouchesCancel

参数列表

• touches Array

getSetOfTouchesEndOrCancel

参数列表

• touches Array

getHTMLElementPosition

参数列表

• element HTMLElement

getPreTouch

参数列表

• touch Touch

setPreTouch

参数列表

• touch Touch

getTouchByXY

参数列表

• tx Number
• ty Number
• pos Vec2

getPointByEvent

参数列表

• event Touch
• pos Vec2

getTouchesByEvent

参数列表

• event Touch
• pos Vec2

registerSystemEvent

参数列表

• element HTMLElement

Class

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

参数列表

• 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

参数列表

• constructor Function

isChildClassOf

Checks whether subclass is child of superclass or equals to superclass

参数列表

• subclass Function
• superclass Function

Enum

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

参数列表

• 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({
        type: cc.Enum(Direction)    // call cc.Enum
    })
    direction: Direction = Direction.Up;
}

getList

参数列表

• enumDef Object the enum type defined from cc.Enum

setAccelerometerEnabled

whether enable accelerometer event

参数列表

• isEnable Boolean

setAccelerometerInterval

set accelerometer interval value

参数列表

• interval Number

handleTouchesBegin

参数列表

• touches Array

handleTouchesMove

参数列表

• touches Array

handleTouchesEnd

参数列表

• touches Array

handleTouchesCancel

参数列表

• touches Array

getSetOfTouchesEndOrCancel

参数列表

• touches Array

getHTMLElementPosition

参数列表

• element HTMLElement

getPreTouch

参数列表

• touch Touch

setPreTouch

参数列表

• touch Touch

getTouchByXY

参数列表

• tx Number
• ty Number
• pos Vec2

getTouchByXY

参数列表

• location Vec2
• pos Vec2
• eventType Number

getPointByEvent

参数列表

• event Touch
• pos Vec2

getTouchesByEvent

参数列表

• event Touch
• pos Vec2

registerSystemEvent

参数列表

• element HTMLElement

update

参数列表

• dt Number

lerp

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

参数列表

• a Number number A
• b Number number B
• r Number ratio between 0 and 1

示例

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

randomMinus1To1

returns a random float between -1 and 1

random0To1

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

degreesToRadians

converts degrees to radians

参数列表

• angle Number

radiansToDegrees

converts radians to degrees

参数列表

• angle Number

nodeDrawSetup

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

参数列表

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

参数列表

• addNumber Number

checkGLErrorDebug

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

isValid

检查该对象是否不为 null 并且尚未销毁。
当一个对象的 destroy 调用以后，会在这一帧结束后才真正销毁。因此从下一帧开始 isValid 就会返回 false，而当前帧内 isValid 仍然会是 true。如果希望判断当前帧是否调用过 destroy，请使用 cc.isValid(obj, true)，不过这往往是特殊的业务需求引起的，通常情况下不需要这样。

参数列表

• value Any
• strictMode Boolean If true, Object called destroy() in this frame will also treated as invalid.

示例

var node = new cc.Node();
cc.log(cc.isValid(node));    // true
node.destroy();
cc.log(cc.isValid(node));    // true, still valid in this frame
// after a frame...
cc.log(cc.isValid(node));    // false, destroyed in the end of last frame

deserialize

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

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

参数列表

• 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 会直接进行浅拷贝，可序列化类型会进行深拷贝。）

参数列表

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

参数列表

• path String
• referenceNode Node

pNeg

返回相反的向量。

参数列表

• point Vec2

示例

cc.pNeg(cc.v2(10, 10));// Vec2 {x: -10, y: -10};

pAdd

返回两个向量的和。

参数列表

• v1 Vec2
• v2 Vec2

示例

cc.pAdd(cc.v2(1, 1), cc.v2(2, 2));// Vec2 {x: 3, y: 3};

pSub

返回两个向量的差。

参数列表

• v1 Vec2
• v2 Vec2

示例

cc.pSub(cc.v2(20, 20), cc.v2(5, 5)); // Vec2 {x: 15, y: 15};

pMult

向量缩放。

参数列表

• point Vec2
• floatVar Number

示例

cc.pMult(cc.v2(5, 5), 4); // Vec2 {x: 20, y: 20};

pMidpoint

两个向量之间的中心点。

参数列表

• v1 Vec2
• v2 Vec2

示例

cc.pMidpoint(cc.v2(10, 10), cc.v2(5, 5)); // Vec2 {x: 7.5, y: 7.5};

pDot

两个向量之间进行点乘。

参数列表

• v1 Vec2
• v2 Vec2

示例

cc.pDot(cc.v2(20, 20), cc.v2(5, 5)); // 200;

pCross

两个向量之间进行叉乘。

参数列表

• v1 Vec2
• v2 Vec2

示例

cc.pCross(cc.v2(20, 20), cc.v2(5, 5)); // 0;

pPerp

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

参数列表

• point Vec2

示例

cc.pPerp(cc.v2(20, 20)); // Vec2 {x: -20, y: 20};

pRPerp

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

参数列表

• point Vec2

示例

cc.pRPerp(cc.v2(20, 20)); // Vec2 {x: 20, y: -20};

pProject

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

参数列表

• v1 Vec2
• v2 Vec2

示例

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

pLengthSQ

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

参数列表

• v Vec2

示例

cc.pLengthSQ(cc.v2(20, 20)); // 800;

pDistanceSQ

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

参数列表

• point1 Vec2
• point2 Vec2

示例

var point1 = cc.v2(20, 20);
var point2 = cc.v2(5, 5);
cc.pDistanceSQ(point1, point2); // 450;

pLength

返回指定向量的长度.

参数列表

• v Vec2

示例

cc.pLength(cc.v2(20, 20)); // 28.284271247461902;

pDistance

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

参数列表

• v1 Vec2
• v2 Vec2

示例

var v1 = cc.v2(20, 20);
var v2 = cc.v2(5, 5);
cc.pDistance(v1, v2); // 21.213203435596427;

pNormalize

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

参数列表

• v Vec2

示例

cc.pNormalize(cc.v2(20, 20)); // Vec2 {x: 0.7071067811865475, y: 0.7071067811865475};

pForAngle

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

参数列表

• a Number

示例

cc.pForAngle(20); // Vec2 {x: 0.40808206181339196, y: 0.9129452507276277};

pToAngle

返回指定向量的弧度。

参数列表

• v Vec2

示例

cc.pToAngle(cc.v2(20, 20)); // 0.7853981633974483;

clampf

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

参数列表

• value Number
• min_inclusive Number
• max_inclusive Number

示例

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 之间。

参数列表

• value Number

示例

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。
否则返回自身。

参数列表

• p Vec2
• min_inclusive Vec2
• max_inclusive Vec2

示例

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。

参数列表

• s Size

示例

cc.pFromSize(new cc.size(20, 20)); // Vec2 {x: 20, y: 20};

pCompOp

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

参数列表

• p Vec2
• opFunc Function

示例

cc.pCompOp(cc.p(-10, -10), Math.abs); // Vec2 {x: 10, y: 10};

pLerp

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

参数列表

• a Vec2
• b Vec2
• alpha Number

示例

cc.pLerp(cc.v2(20, 20), cc.v2(5, 5), 0.5); // Vec2 {x: 12.5, y: 12.5};

pFuzzyEqual

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

参数列表

• a Vec2
• b Vec2
• variance Number

示例

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。

参数列表

• a Vec2
• b Vec2

示例

cc.pCompMult(acc.v2(20, 20), cc.v2(5, 5)); // Vec2 {x: 100, y: 100};

pAngleSigned

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

参数列表

• a Vec2
• b Vec2

pAngle

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

参数列表

• a Vec2
• b Vec2

pRotateByAngle

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

参数列表

• 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 上的比例。

参数列表

• 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 是否相交。

参数列表

• A Vec2
• B Vec2
• C Vec2
• D Vec2

pIntersectPoint

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

参数列表

• A Vec2
• B Vec2
• C Vec2
• D Vec2

pSameAs

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

参数列表

• A Vec2 A ccp a
• B Vec2 B ccp b to be compared

pZeroIn

设置指定向量归 0。

参数列表

• v Vec2

pIn

令 v1 向量等同于 v2。

参数列表

• v1 Vec2
• v2 Vec2

pMultIn

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

参数列表

• point Vec2
• floatVar Number

pSubIn

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

参数列表

• v1 Vec2
• v2 Vec2

pAddIn

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

参数列表

• v1 Vec2
• v2 Vec2

pNormalizeIn

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

参数列表

• v Vec2

color

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

参数列表

• r Number
• g Number
• b Number
• a Number

示例

-----------------------
// 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 部分是否相等，不比较透明度。

参数列表

• color1 Color
• color2 Color

示例

cc.log(cc.colorEqual(cc.Color.RED, new cc.Color(255, 0, 0))); // true

hexToColor

16 进制转换为 Color

参数列表

• hex String

示例

cc.hexToColor("#FFFF33"); // Color {r: 255, g: 255, b: 51, a: 255};

colorToHex

Color 转换为 16进制。

参数列表

• color Color

示例

var color = new cc.Color(255, 6, 255)
cc.colorToHex(color); // #ff06ff;

rect

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

参数列表

• x Number
• y Number
• w Number
• h Number

示例

var a = new cc.Rect(0 , 0, 10, 0);

rectEqualToRect

判断两个矩形是否相等。

参数列表

• rect1 Rect
• rect2 Rect

示例

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

参数列表

• rect1 Rect
• rect2 Rect

示例

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 轴上的最大值

参数列表

• rect Rect

示例

var a = new cc.Rect(10, 0, 20, 20);
cc.rectGetMaxX(a); // 30;

rectGetMidX

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

参数列表

• rect Rect

示例

var a = new cc.Rect(10, 0, 20, 20);
cc.rectGetMidX(a); // 20;

rectGetMinX

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

参数列表

• rect Rect

示例

var a = new cc.Rect(10, 0, 20, 20);
cc.rectGetMinX(a); // 10;

rectGetMaxY

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

参数列表

• rect Rect

示例

var a = new cc.Rect(0, 10, 20, 20);
cc.rectGetMaxY(a); // 30;

rectGetMidY

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

参数列表

• rect Rect

示例

var a = new cc.Rect(0, 10, 20, 20);
cc.rectGetMidY(a); // 20;

rectGetMinY

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

参数列表

• rect Rect

示例

var a = new cc.Rect(0, 10, 20, 20);
cc.rectGetMinY(a); // 10;

rectContainsPoint

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

参数列表

• rect Rect
• point Vec2

示例

var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Vec2(0, 10, 10, 10);
cc.rectContainsPoint(a, b); // true;

rectIntersectsRect

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

参数列表

• rectA Rect
• rectB Rect

示例

var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
cc.rectIntersectsRect(a, b); // true;

rectOverlapsRect

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

参数列表

• rectA Rect
• rectB Rect

示例

var a = new cc.Rect(0, 10, 20, 20);
var b = new cc.Rect(0, 10, 10, 10);
cc.rectOverlapsRect(a, b); // true;

rectUnion

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

参数列表

• rectA Rect
• rectB Rect

示例

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 个矩形重叠的部分。

参数列表

• rectA Rect
• rectB Rect

示例

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。

参数列表

• w Number | Size width or a size object
• h Number height

示例

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 对象是否等于另一个。

参数列表

• size1 Size
• size2 Size

示例

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

V3F_C4B_T2F_QuadCopy

参数列表

• sourceQuad V3F_C4B_T2F_Quad

V3F_C4B_T2F_QuadsCopy

参数列表

• sourceQuads Array

v2

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

参数列表

• x Number | Object
• y Number

示例

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 对象。

参数列表

• x Number | Object a Number or a size object
• y Number

示例

var point1 = cc.p();
var point2 = cc.p(100, 100);
var point3 = cc.p(point2);
var point4 = cc.p({x: 100, y: 100});

pointEqualToPoint

判断两个向量是否相等。

参数列表

• point1 Vec2
• point2 Vec2