cc Module

The main namespace of Cocos2d-JS, all engine core classes, functions, properties and constants are defined in this namespace.

Classes

• 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

Enums

• 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

Index

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 is the shared view object.
• director Director Director
• winSize Size cc.winSize is the alias object for the size of the current game window.
• game Game
• systemEvent SystemEvent The System event singleton for global usage
• 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.

Methods

• _initDebugSetting Init Debug setting.
• error Outputs an error message to the Cocos Creator Console (editor) or Web Console (runtime)....
• warn Outputs a warning message to the Cocos Creator Console (editor) or Web Console (runtime).
• log Outputs a message to the Cocos Creator Console (editor) or Web Console (runtime).
• speed or less (speed < 1) time.
• follow Create a follow action which makes its target follows another node.
• setPoints Points setter
• cardinalSplineTo Creates an action with a Cardinal Spline array of points and tension.
• updatePosition update position of target
• cardinalSplineBy Creates an action with a Cardinal Spline array of points and tension.
• catmullRomTo Creates an action with a Cardinal Spline array of points and tension.
• catmullRomBy Creates an action with a Cardinal Spline array of points and tension.
• easeIn Creates the action easing object with the rate parameter.
• easeOut Creates the action easing object with the rate parameter.
• easeInOut Creates the action easing object with the rate parameter.
• easeExponentialIn Creates the action easing object with the rate parameter.
• easeExponentialOut Creates the action easing object.
• easeExponentialInOut Creates an EaseExponentialInOut action easing object.
• easeSineIn Creates an EaseSineIn action.
• easeSineOut Creates an EaseSineOut action easing object.
• easeSineInOut Creates the action easing object.
• easeElasticIn Creates the action easing object with the period in radians (default is 0.3).
• easeElasticOut Creates the action easing object with the period in radians (default is 0.3).
• easeElasticInOut Creates the action easing object with the period in radians (default is 0.3).
• easeBounceIn Creates the action easing object.
• easeBounceOut Creates the action easing object.
• easeBounceInOut Creates the action easing object.
• easeBackIn Creates the action easing object.
• easeBackOut Creates the action easing object.
• easeBackInOut Creates the action easing object.
• easeBezierAction Creates the action easing object.
• easeQuadraticActionIn Creates the action easing object.
• easeQuadraticActionOut Creates the action easing object.
• easeQuadraticActionInOut Creates the action easing object.
• easeQuarticActionIn Creates the action easing object.
• easeQuarticActionOut Creates the action easing object.
• easeQuarticActionInOut Creates the action easing object.
• easeQuinticActionIn Creates the action easing object.
• easeQuinticActionOut Creates the action easing object.
• easeQuinticActionInOut Creates the action easing object.
• easeCircleActionIn Creates the action easing object.
• easeCircleActionOut Creates the action easing object.
• easeCircleActionInOut Creates the action easing object.
• easeCubicActionIn Creates the action easing object.
• easeCubicActionOut Creates the action easing object.
• easeCubicActionInOut Creates the action easing object.
• show Show the Node.
• hide Hide the node.
• toggleVisibility Toggles the visibility of a node.
• removeSelf Create a RemoveSelf object with a flag indicate whether the target should be cleaned up while removing.
• flipX Create a FlipX action to flip or unflip the target.
• flipY Create a FlipY action to flip or unflip the target.
• place Creates a Place action with a position.
• callFunc Creates the action with the callback.
• sequence Helper constructor to create an array of sequenceable actions
• repeat Creates a Repeat action.
• repeatForever Create a acton which repeat forever, as it runs forever, it can't be added into cc.sequence and cc.spawn.
• spawn Create a spawn action which runs several actions in parallel.
• rotateTo Rotates a Node object to a certain angle by modifying its rotation property.
• rotateBy Rotates a Node object clockwise a number of degrees by modifying its rotation property.
• moveBy Moves a Node object x,y pixels by modifying its position property.
• moveTo Moves a Node object to the position x,y.
• skewTo Create a action which skews a Node object to given angles by modifying its skewX and skewY properties.
• skewBy Skews a Node object by skewX and skewY degrees.
• jumpBy Moves a Node object simulating a parabolic jump movement by modifying it's position property.
• jumpTo Moves a Node object to a parabolic position simulating a jump movement by modifying its position property.
• bezierBy An action that moves the target with a cubic Bezier curve by a certain distance.
• bezierTo An action that moves the target with a cubic Bezier curve to a destination point.
• scaleTo Scales a Node object to a zoom factor by modifying it's scale property.
• scaleBy Scales a Node object a zoom factor by modifying it's scale property.
• blink Blinks a Node object by modifying it's visible property.
• fadeTo Fades an object that implements the cc.RGBAProtocol protocol.
• fadeIn Fades In an object that implements the cc.RGBAProtocol protocol.
• fadeOut Fades Out an object that implements the cc.RGBAProtocol protocol.
• tintTo Tints a Node that implements the cc.NodeRGB protocol from current tint to a custom one.
• tintBy Tints a Node that implements the cc.NodeRGB protocol from current tint to a custom one.
• delayTime Delays the action a certain amount of seconds.
• reverseTime Executes an action in reverse order, from time=duration to time=0.
• targetedAction Create an action with the specified action and forced target.
• handleTouchesBegin
• handleTouchesMove
• handleTouchesEnd
• handleTouchesCancel
• getSetOfTouchesEndOrCancel
• getHTMLElementPosition
• getPreTouch
• setPreTouch
• getTouchByXY
• getPointByEvent
• getTouchesByEvent
• registerSystemEvent
• Class Defines a CCClass using the given specification, please see Class for details.
• _isCCClass Checks whether the constructor is created by cc.Class
• isChildClassOf Checks whether subclass is child of superclass or equals to superclass
• Enum Define an enum type.
• 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 When an object's destroy is called, it is actually destroyed after the end of this frame.
• deserialize Deserialize json to cc.Asset
• instantiate Clones the object original and returns the clone, or instantiate a node from the Prefab.
• pNeg Returns opposite of Vec2.
• pAdd Calculates sum of two points.
• pSub Calculates difference of two points.
• pMult Returns point multiplied by given factor.
• pMidpoint Calculates midpoint between two points.
• pDot Calculates dot product of two points.
• pCross Calculates cross product of two points.
• pPerp Calculates perpendicular of v, rotated 90 degrees counter-clockwise -- cross(v, perp(v)) greater than 0.
• pRPerp Calculates perpendicular of v, rotated 90 degrees clockwise -- cross(v, rperp(v)) smaller than 0.
• pProject Calculates the projection of v1 over v2.
• pLengthSQ Calculates the square length of a cc.Vec2 (not calling sqrt() ).
• pDistanceSQ Calculates the square distance between two points (not calling sqrt() ).
• pLength Calculates distance between point an origin.
• pDistance Calculates the distance between two points.
• pNormalize Returns this vector with a magnitude of 1.
• pForAngle Converts radians to a normalized vector.
• pToAngle Converts a vector to radians.
• clampf Clamp a value between from and to.
• clamp01 Clamp a value between 0 and 1.
• pClamp Clamp a point between from and to.
• pFromSize Quickly convert cc.Size to a cc.Vec2.
• pCompOp Run a math operation function on each point component
  ...
• pLerp Linear Interpolation between two points a and b.
  ...
• pFuzzyEqual TODO
• pCompMult Multiplies a nd b components, a.xb.x, a.yb.y.
• pAngleSigned TODO
• pAngle TODO
• pRotateByAngle Rotates a point counter clockwise by the angle around a pivot.
• pLineIntersect A general line-line intersection test
• pSegmentIntersect ccpSegmentIntersect return YES if Segment A-B intersects with segment C-D.
• pIntersectPoint ccpIntersectPoint return the intersection point of line A-B, C-D.
• pSameAs check to see if both points are equal.
• pZeroIn sets the position of the point to 0.
• pIn copies the position of one point to another.
• pMultIn multiplies the point with the given factor (inplace).
• pSubIn subtracts one point from another (inplace).
• pAddIn adds one point to another (inplace).
• pNormalizeIn normalizes the point (inplace).
• color Alpha channel is optional.
• colorEqual returns true if both ccColor3B are equal.
• hexToColor convert a string of color for style to Color.
• colorToHex convert Color to a string of color for style.
• size Helper function that creates a cc.Size....
• sizeEqualToSize Check whether a point's value equals to another.
• rect The convenience method to create a new Rect.
• rectEqualToRect Check whether a rect's value equals to another.
• rectContainsRect Check whether the rect1 contains rect2.
• rectGetMaxX Returns the rightmost x-value of a rect.
• rectGetMidX Return the midpoint x-value of a rect.
• rectGetMinX Returns the leftmost x-value of a rect.
• rectGetMaxY Return the topmost y-value of a rect.
• rectGetMidY Return the midpoint y-value of `rect'.
• rectGetMinY Return the bottommost y-value of a rect.
• rectContainsPoint Check whether a rect contains a point.
• rectIntersectsRect Check whether a rect intersect with another.
• rectOverlapsRect Check whether a rect overlaps another.
• rectUnion Returns the smallest rectangle that contains the two source rectangles.
• rectIntersection Returns the overlapping portion of 2 rectangles.
• V3F_C4B_T2F_QuadZero
• V3F_C4B_T2F_QuadCopy
• V3F_C4B_T2F_QuadsCopy
• v2 The convenience method to create a new cc.Vec2.
• p The convenience method to creates a new cc.Vec2.
• pointEqualToPoint Check whether a point's value equals to another.
• find Finds a node by hierarchy path, the path is case-sensitive.

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 is the shared view object.

director

Director

winSize

cc.winSize is the alias object for the size of the current game window.

game

systemEvent

The System event singleton for global usage

Integer

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

Examples

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

Float

Indicates that the elements in array should be type double.

Examples

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

Boolean

Indicates that the elements in array should be type boolean.

Examples

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

String

Indicates that the elements in array should be type string.

Examples

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

Methods

_initDebugSetting

Init Debug setting.

Parameters

• mode DebugMode

error

Outputs an error message to the Cocos Creator Console (editor) or Web Console (runtime).

• In Cocos Creator, error is red.
  
• In Chrome, error have a red icon along with red message text.
  

Parameters

• 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

Outputs a warning message to the Cocos Creator Console (editor) or Web Console (runtime).

• In Cocos Creator, warning is yellow.
• In Chrome, warning have a yellow warning icon with the message text.

Parameters

• 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

Outputs a message to the Cocos Creator Console (editor) or Web Console (runtime).

Parameters

• 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

Creates the speed action which changes the speed of an action, making it take longer (speed > 1) or less (speed < 1) time.
Useful to simulate 'slow motion' or 'fast forward' effect.

Parameters

• action ActionInterval
• speed Number

Examples

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

follow

Create a follow action which makes its target follows another node.

Parameters

• followedNode Node
• rect Rect

Examples

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

Parameters

• points Array

cardinalSplineTo

Creates an action with a Cardinal Spline array of points and tension.

Parameters

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

Examples

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

updatePosition

update position of target

Parameters

• newPos Vec2

cardinalSplineBy

Creates an action with a Cardinal Spline array of points and tension.

Parameters

• duration Number
• points Array
• tension Number

catmullRomTo

Creates an action with a Cardinal Spline array of points and tension.

Parameters

• dt Number
• points Array

Examples

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

catmullRomBy

Creates an action with a Cardinal Spline array of points and tension.

Parameters

• dt Number
• points Array

Examples

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

easeIn

Creates the action easing object with the rate parameter.
From slow to fast.

Parameters

• rate Number

Examples

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

easeOut

Creates the action easing object with the rate parameter.
From fast to slow.

Parameters

• rate Number

Examples

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

easeInOut

Creates the action easing object with the rate parameter.
Slow to fast then to slow.

Parameters

• rate Number

Examples

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

easeExponentialIn

Creates the action easing object with the rate parameter.
Reference easeInExpo:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

action.easing(cc.easeExponentialIn());

easeExponentialOut

Creates the action easing object.
Reference easeOutExpo:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

action.easing(cc.easeExponentialOut());

easeExponentialInOut

Creates an EaseExponentialInOut action easing object.
Reference easeInOutExpo:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

action.easing(cc.easeExponentialInOut());

easeSineIn

Creates an EaseSineIn action.
Reference easeInSine:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

action.easing(cc.easeSineIn());

easeSineOut

Creates an EaseSineOut action easing object.
Reference easeOutSine:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

action.easing(cc.easeSineOut());

easeSineInOut

Creates the action easing object.
Reference easeInOutSine:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

action.easing(cc.easeSineInOut());

easeElasticIn

Creates the action easing object with the period in radians (default is 0.3).
Reference easeInElastic:
http://www.zhihu.com/question/21981571/answer/19925418

Parameters

• period Number

Examples

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

easeElasticOut

Creates the action easing object with the period in radians (default is 0.3).
Reference easeOutElastic:
http://www.zhihu.com/question/21981571/answer/19925418

Parameters

• period Number

Examples

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

easeElasticInOut

Creates the action easing object with the period in radians (default is 0.3).
Reference easeInOutElastic:
http://www.zhihu.com/question/21981571/answer/19925418

Parameters

• period Number

Examples

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

easeBounceIn

Creates the action easing object.
Eased bounce effect at the beginning.

Examples

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

easeBounceOut

Creates the action easing object.
Eased bounce effect at the ending.

Examples

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

easeBounceInOut

Creates the action easing object.
Eased bounce effect at the begining and ending.

Examples

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

easeBackIn

Creates the action easing object.
In the opposite direction to move slowly, and then accelerated to the right direction.

Examples

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

easeBackOut

Creates the action easing object.
Fast moving more than the finish, and then slowly back to the finish.

Examples

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

easeBackInOut

Creates the action easing object.
Begining of cc.EaseBackIn. Ending of cc.EaseBackOut.

Examples

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

easeBezierAction

Creates the action easing object.
Into the 4 reference point.
To calculate the motion curve.

Parameters

• p0 Number The first bezier parameter
• p1 Number The second bezier parameter
• p2 Number The third bezier parameter
• p3 Number The fourth bezier parameter

Examples

// example
action.easing(cc.easeBezierAction(0.5, 0.5, 1.0, 1.0));

easeQuadraticActionIn

Creates the action easing object.
Reference easeInQuad:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeQuadraticActionOut

Creates the action easing object.
Reference easeOutQuad:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeQuadraticActionInOut

Creates the action easing object.
Reference easeInOutQuad:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeQuarticActionIn

Creates the action easing object.
Reference easeIntQuart:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeQuarticActionOut

Creates the action easing object.
Reference easeOutQuart:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeQuarticActionInOut

Creates the action easing object.
Reference easeInOutQuart:
http://www.zhihu.com/question/21981571/answer/19925418

easeQuinticActionIn

Creates the action easing object.
Reference easeInQuint:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeQuinticActionOut

Creates the action easing object.
Reference easeOutQuint:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeQuinticActionInOut

Creates the action easing object.
Reference easeInOutQuint:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeCircleActionIn

Creates the action easing object.
Reference easeInCirc:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeCircleActionOut

Creates the action easing object.
Reference easeOutCirc:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeCircleActionInOut

Creates the action easing object.
Reference easeInOutCirc:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeCubicActionIn

Creates the action easing object.
Reference easeInCubic:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeCubicActionOut

Creates the action easing object.
Reference easeOutCubic:
http://www.zhihu.com/question/21981571/answer/19925418

Examples

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

easeCubicActionInOut

Creates the action easing object.
Reference easeInOutCubic:
http://www.zhihu.com/question/21981571/answer/19925418

show

Show the Node.

Examples

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

hide

Hide the node.

Examples

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

toggleVisibility

Toggles the visibility of a node.

Examples

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

removeSelf

Create a RemoveSelf object with a flag indicate whether the target should be cleaned up while removing.

Parameters

• isNeedCleanUp Boolean

Examples

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

flipX

Create a FlipX action to flip or unflip the target.

Parameters

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

Examples

var flipXAction = cc.flipX(true);

flipY

Create a FlipY action to flip or unflip the target.

Parameters

• flip Boolean

Examples

var flipYAction = cc.flipY(true);

place

Creates a Place action with a position.

Parameters

• pos Vec2 | Number
• y Number

Examples

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

callFunc

Creates the action with the callback.

Parameters

• selector function
• selectorTarget object
• data Any data for function, it accepts all data types.

Examples

// example
// CallFunc without data
var finish = cc.callFunc(this.removeSprite, this);

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

sequence

Helper constructor to create an array of sequenceable actions The created action will run actions sequentially, one after another.

Parameters

• actionOrActionArray FiniteTimeAction | FiniteTimeAction[]
• tempArray FiniteTimeAction

Examples

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

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

repeat

Creates a Repeat action. Times is an unsigned integer between 1 and pow(2,30)

Parameters

• action FiniteTimeAction
• times Number

Examples

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

repeatForever

Create a acton which repeat forever, as it runs forever, it can't be added into cc.sequence and cc.spawn.

Parameters

• action FiniteTimeAction

Examples

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

spawn

Create a spawn action which runs several actions in parallel.

Parameters

• actionOrActionArray FiniteTimeAction | FiniteTimeAction[]
• tempArray FiniteTimeAction

Examples

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

Rotates a Node object to a certain angle by modifying its rotation property.
The direction will be decided by the shortest angle.

Parameters

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

Examples

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

rotateBy

Rotates a Node object clockwise a number of degrees by modifying its rotation property. Relative to its properties to modify.

Parameters

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

Examples

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

moveBy

Moves a Node object x,y pixels by modifying its position property.
x and y are relative to the position of the object.
Several MoveBy actions can be concurrently called, and the resulting
movement will be the sum of individual movements.

Parameters

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

Examples

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

moveTo

Moves a Node object to the position x,y. x and y are absolute coordinates by modifying its position property.
Several MoveTo actions can be concurrently called, and the resulting
movement will be the sum of individual movements.

Parameters

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

Examples

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

skewTo

Create a action which skews a Node object to given angles by modifying its skewX and skewY properties. Changes to the specified value.

Parameters

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

Examples

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

skewBy

Skews a Node object by skewX and skewY degrees.
Relative to its property modification.

Parameters

• t Number time in seconds
• sx Number sx skew in degrees for X axis
• sy Number sy skew in degrees for Y axis

Examples

// example
var actionBy = cc.skewBy(2, 0, -90);

jumpBy

Moves a Node object simulating a parabolic jump movement by modifying it's position property. Relative to its movement.

Parameters

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

Examples

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

jumpTo

Moves a Node object to a parabolic position simulating a jump movement by modifying its position property.
Jump to the specified location.

Parameters

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

Examples

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

bezierBy

An action that moves the target with a cubic Bezier curve by a certain distance. Relative to its movement.

Parameters

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

Examples

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

An action that moves the target with a cubic Bezier curve to a destination point.

Parameters

• t Number
• c Vec2[] Array of points

Examples

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

Scales a Node object to a zoom factor by modifying it's scale property.

Parameters

• duration Number
• sx Number scale parameter in X
• sy Number scale parameter in Y, if Null equal to sx

Examples

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

Scales a Node object a zoom factor by modifying it's scale property. Relative to its changes.

Parameters

• 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

Examples

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

Blinks a Node object by modifying it's visible property.

Parameters

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

Examples

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

fadeTo

Fades an object that implements the cc.RGBAProtocol protocol. It modifies the opacity from the current value to a custom one.

Parameters

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

Examples

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

fadeIn

Fades In an object that implements the cc.RGBAProtocol protocol. It modifies the opacity from 0 to 255.

Parameters

• duration Number duration in seconds

Examples

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

fadeOut

Fades Out an object that implements the cc.RGBAProtocol protocol. It modifies the opacity from 255 to 0.

Parameters

• d Number duration in seconds

Examples

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

tintTo

Tints a Node that implements the cc.NodeRGB protocol from current tint to a custom one.

Parameters

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

Examples

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

tintBy

Tints a Node that implements the cc.NodeRGB protocol from current tint to a custom one. Relative to their own color change.

Parameters

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

Examples

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

delayTime

Delays the action a certain amount of seconds. 延迟指定的时间量。

Parameters

• d Number duration in seconds

Examples

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

reverseTime

Executes an action in reverse order, from time=duration to time=0.

Parameters

• action FiniteTimeAction

Examples

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

targetedAction

Create an action with the specified action and forced target.

Parameters

• target Node
• action FiniteTimeAction

handleTouchesBegin

Parameters

• touches Array

handleTouchesMove

Parameters

• touches Array

handleTouchesEnd

Parameters

• touches Array

handleTouchesCancel

Parameters

• touches Array

getSetOfTouchesEndOrCancel

Parameters

• touches Array

getHTMLElementPosition

Parameters

• element HTMLElement

getPreTouch

Parameters

• touch Touch

setPreTouch

Parameters

• touch Touch

getTouchByXY

Parameters

• tx Number
• ty Number
• pos Vec2

getPointByEvent

Parameters

• event Touch
• pos Vec2

getTouchesByEvent

Parameters

• event Touch
• pos Vec2

registerSystemEvent

Parameters

• element HTMLElement

Class

Defines a CCClass using the given specification, please see Class for details.

Parameters

• 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

Examples

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

Parameters

• constructor Function

isChildClassOf

Checks whether subclass is child of superclass or equals to superclass

Parameters

• subclass Function
• superclass Function

Enum

Define an enum type.
If a enum item has a value of -1, it will be given an Integer number according to it's order in the list.
Otherwise it will use the value specified by user who writes the enum definition.

Parameters

• obj object a JavaScript literal object containing enum names and values, or a TypeScript enum type

Examples

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

Parameters

• enumDef Object the enum type defined from cc.Enum

setAccelerometerEnabled

whether enable accelerometer event

Parameters

• isEnable Boolean

setAccelerometerInterval

set accelerometer interval value

Parameters

• interval Number

handleTouchesBegin

Parameters

• touches Array

handleTouchesMove

Parameters

• touches Array

handleTouchesEnd

Parameters

• touches Array

handleTouchesCancel

Parameters

• touches Array

getSetOfTouchesEndOrCancel

Parameters

• touches Array

getHTMLElementPosition

Parameters

• element HTMLElement

getPreTouch

Parameters

• touch Touch

setPreTouch

Parameters

• touch Touch

getTouchByXY

Parameters

• tx Number
• ty Number
• pos Vec2

getTouchByXY

Parameters

• location Vec2
• pos Vec2
• eventType Number

getPointByEvent

Parameters

• event Touch
• pos Vec2

getTouchesByEvent

Parameters

• event Touch
• pos Vec2

registerSystemEvent

Parameters

• element HTMLElement

update

Parameters

• dt Number

lerp

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

Parameters

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

Examples

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

Parameters

• angle Number

radiansToDegrees

converts radians to degrees

Parameters

• angle Number

nodeDrawSetup

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

Parameters

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

Parameters

• addNumber Number

checkGLErrorDebug

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

isValid

Checks whether the object is non-nil and not yet destroyed.
When an object's destroy is called, it is actually destroyed after the end of this frame. So isValid will return false from the next frame, while isValid in the current frame will still be true. If you want to determine whether the current frame has called destroy, use cc.isValid(obj, true), but this is often caused by a particular logical requirements, which is not normally required.

Parameters

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

Examples

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

Deserialize json to cc.Asset

Parameters

• data String | Object the serialized cc.Asset json string or json object.
• details Details additional loading result
• options Object

instantiate

Clones the object original and returns the clone, or instantiate a node from the Prefab.

Parameters

• original Prefab | Node | Object An existing object that you want to make a copy of.

Examples

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

pNeg

Returns opposite of Vec2.

Parameters

• point Vec2

Examples

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

pAdd

Calculates sum of two points.

Parameters

• v1 Vec2
• v2 Vec2

Examples

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

pSub

Calculates difference of two points.

Parameters

• v1 Vec2
• v2 Vec2

Examples

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

pMult

Returns point multiplied by given factor.

Parameters

• point Vec2
• floatVar Number

Examples

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

pMidpoint

Calculates midpoint between two points.

Parameters

• v1 Vec2
• v2 Vec2

Examples

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

pDot

Calculates dot product of two points.

Parameters

• v1 Vec2
• v2 Vec2

Examples

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

pCross

Calculates cross product of two points.

Parameters

• v1 Vec2
• v2 Vec2

Examples

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

pPerp

Calculates perpendicular of v, rotated 90 degrees counter-clockwise -- cross(v, perp(v)) greater than 0.

Parameters

• point Vec2

Examples

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

pRPerp

Calculates perpendicular of v, rotated 90 degrees clockwise -- cross(v, rperp(v)) smaller than 0.

Parameters

• point Vec2

Examples

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

pProject

Calculates the projection of v1 over v2.

Parameters

• v1 Vec2
• v2 Vec2

Examples

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

pLengthSQ

Calculates the square length of a cc.Vec2 (not calling sqrt() ).

Parameters

• v Vec2

Examples

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

pDistanceSQ

Calculates the square distance between two points (not calling sqrt() ).

Parameters

• point1 Vec2
• point2 Vec2

Examples

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

pLength

Calculates distance between point an origin.

Parameters

• v Vec2

Examples

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

pDistance

Calculates the distance between two points.

Parameters

• v1 Vec2
• v2 Vec2

Examples

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

pNormalize

Returns this vector with a magnitude of 1.

Parameters

• v Vec2

Examples

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

pForAngle

Converts radians to a normalized vector.

Parameters

• a Number

Examples

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

pToAngle

Converts a vector to radians.

Parameters

• v Vec2

Examples

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

clampf

Clamp a value between from and to.

Parameters

• value Number
• min_inclusive Number
• max_inclusive Number

Examples

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

Clamp a value between 0 and 1.

Parameters

• value Number

Examples

var v1 = cc.clampf(20);  // 1;
var v2 = cc.clampf(-1);  // 0;
var v3 = cc.clampf(0.5); // 0.5;

pClamp

Clamp a point between from and to.

Parameters

• p Vec2
• min_inclusive Vec2
• max_inclusive Vec2

Examples

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

Quickly convert cc.Size to a cc.Vec2.

Parameters

• s Size

Examples

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

pCompOp

Run a math operation function on each point component
Math.abs, Math.fllor, Math.ceil, Math.round.

Parameters

• p Vec2
• opFunc Function

Examples

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

pLerp

Linear Interpolation between two points a and b.
alpha == 0 ? a
alpha == 1 ? b
otherwise a value between a..b.

Parameters

• a Vec2
• b Vec2
• alpha Number

Examples

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

pFuzzyEqual

TODO

Parameters

• a Vec2
• b Vec2
• variance Number

Examples

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

Multiplies a nd b components, a.xb.x, a.yb.y.

Parameters

• a Vec2
• b Vec2

Examples

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

pAngleSigned

TODO

Parameters

• a Vec2
• b Vec2

pAngle

TODO

Parameters

• a Vec2
• b Vec2

pRotateByAngle

Rotates a point counter clockwise by the angle around a pivot.

Parameters

• 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 general line-line intersection test indicating successful intersection of a line
note that to truly test intersection for segments we have to make
sure that s & t lie within [0..1] and for rays, make sure s & t > 0
the hit point is p3 + t (p4 - p3);
the hit point also is p1 + s (p2 - p1);

Parameters

• 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

ccpSegmentIntersect return YES if Segment A-B intersects with segment C-D.

Parameters

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

pIntersectPoint

ccpIntersectPoint return the intersection point of line A-B, C-D.

Parameters

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

pSameAs

check to see if both points are equal.

Parameters

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

pZeroIn

sets the position of the point to 0.

Parameters

• v Vec2

pIn

copies the position of one point to another.

Parameters

• v1 Vec2
• v2 Vec2

pMultIn

multiplies the point with the given factor (inplace).

Parameters

• point Vec2
• floatVar Number

pSubIn

subtracts one point from another (inplace).

Parameters

• v1 Vec2
• v2 Vec2

pAddIn

adds one point to another (inplace).

Parameters

• v1 Vec2
• v2 Vec2

pNormalizeIn

normalizes the point (inplace).

Parameters

• v Vec2

color

The convenience method to create a new Color/Color:method Alpha channel is optional. Default value is 255.

Parameters

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

Examples

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

returns true if both ccColor3B are equal. Otherwise it returns false.

Parameters

• color1 Color
• color2 Color

Examples

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

hexToColor

convert a string of color for style to Color. e.g. "#ff06ff" to : cc.color(255,6,255)。

Parameters

• hex String

Examples

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

colorToHex

convert Color to a string of color for style. e.g. cc.color(255,6,255) to : "#ff06ff"

Parameters

• color Color

Examples

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

size

Helper function that creates a cc.Size.
Please use cc.p or cc.v2 instead, it will soon replace cc.Size.

Parameters

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

Examples

var size1 = cc.size();
var size2 = cc.size(100,100);
var size3 = cc.size(size2);
var size4 = cc.size({width: 100, height: 100});

sizeEqualToSize

Check whether a point's value equals to another.

Parameters

• size1 Size
• size2 Size

Examples

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;

rect

The convenience method to create a new Rect. see Rect/Rect:method

Parameters

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

Examples

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

rectEqualToRect

Check whether a rect's value equals to another.

Parameters

• rect1 Rect
• rect2 Rect

Examples

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

Check whether the rect1 contains rect2.

Parameters

• rect1 Rect
• rect2 Rect

Examples

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

rectGetMaxX

Returns the rightmost x-value of a rect.

Parameters

• rect Rect

Examples

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

rectGetMidX

Return the midpoint x-value of a rect.

Parameters

• rect Rect

Examples

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

rectGetMinX

Returns the leftmost x-value of a rect.

Parameters

• rect Rect

Examples

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

rectGetMaxY

Return the topmost y-value of a rect.

Parameters

• rect Rect

Examples

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

rectGetMidY

Return the midpoint y-value of `rect'.

Parameters

• rect Rect

Examples

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

rectGetMinY

Return the bottommost y-value of a rect.

Parameters

• rect Rect

Examples

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

rectContainsPoint

Check whether a rect contains a point.

Parameters

• rect Rect
• point Vec2

Examples

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

rectIntersectsRect

Check whether a rect intersect with another.

Parameters

• rectA Rect
• rectB Rect

Examples

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

rectOverlapsRect

Check whether a rect overlaps another.

Parameters

• rectA Rect
• rectB Rect

Examples

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

rectUnion

Returns the smallest rectangle that contains the two source rectangles.

Parameters

• rectA Rect
• rectB Rect

Examples

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

Returns the overlapping portion of 2 rectangles.

Parameters

• rectA Rect
• rectB Rect

Examples

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

V3F_C4B_T2F_QuadZero

V3F_C4B_T2F_QuadCopy

Parameters

• sourceQuad V3F_C4B_T2F_Quad

V3F_C4B_T2F_QuadsCopy

Parameters

• sourceQuads Array

v2

The convenience method to create a new cc.Vec2.

Parameters

• x Number | Object
• y Number

Examples

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

p

The convenience method to creates a new cc.Vec2.

Parameters

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

Examples

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

pointEqualToPoint

Check whether a point's value equals to another.

Parameters

• point1 Vec2
• point2 Vec2

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.

Parameters

• path String
• referenceNode Node