axmol/cocos/scripting/lua-bindings/auto/api/Node.lua

1160 lines
44 KiB
Lua
Raw Normal View History

2014-03-10 14:04:58 +08:00
--------------------------------
-- @module Node
-- @extend Ref
-- @parent_module cc
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, cc.Node, int
-- @overload self, cc.Node
-- @overload self, cc.Node, int, int
-- @overload self, cc.Node, int, string
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] addChild
-- @param self
-- @param #cc.Node child
-- @param #int localZOrder
-- @param #string name
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, cc.Component
-- @overload self, string
-- @function [parent=#Node] removeComponent
2014-03-10 14:04:58 +08:00
-- @param self
-- @param #string name
-- @return bool#bool ret (return value: bool)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Gets the description string. It makes debugging easier.<br>
-- return A string<br>
-- js NA<br>
-- lua NA
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getDescription
-- @param self
-- @return string#string ret (return value: string)
--------------------------------
-- Sets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew.<br>
-- The difference between `setRotationalSkew()` and `setSkew()` is that the first one simulate Flash's skew functionality,<br>
-- while the second one uses the real skew function.<br>
-- 0 is the default rotation angle.<br>
-- Positive values rotate node clockwise, and negative values for anti-clockwise.<br>
-- param rotationY The Y rotation in degrees.<br>
-- warning The physics body doesn't support this.<br>
-- js setRotationY
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setRotationSkewY
-- @param self
-- @param #float rotationY
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setOpacityModifyRGB
-- @param self
-- @param #bool value
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setCascadeOpacityEnabled
-- @param self
-- @param #bool cascadeOpacityEnabled
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self
-- @overload self
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getChildren
-- @param self
-- @return array_table#array_table ret (return value: array_table)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] setOnExitCallback
-- @param self
-- @param #function callback
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Pauses all scheduled selectors, actions and event listeners.<br>
-- This method is called internally by onExit.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] pause
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Converts a local Vec2 to world space coordinates.The result is in Points.<br>
-- treating the returned/received node point as anchor relative.<br>
-- param nodePoint A given coordinate.<br>
-- return A point in world space coordinates, anchor relative.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] convertToWorldSpaceAR
-- @param self
-- @param #vec2_table nodePoint
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Gets whether the anchor point will be (0,0) when you position this node.<br>
-- see `ignoreAnchorPointForPosition(bool)`<br>
-- return true if the anchor point will be (0,0) when you position this node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] isIgnoreAnchorPointForPosition
-- @param self
-- @return bool#bool ret (return value: bool)
--------------------------------
-- Gets a child from the container with its name.<br>
-- param name An identifier to find the child node.<br>
-- return a Node object whose name equals to the input parameter.<br>
-- since v3.2
-- @function [parent=#Node] getChildByName
-- @param self
-- @param #string name
-- @return Node#Node ret (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] updateDisplayedOpacity
-- @param self
-- @param #unsigned char parentOpacity
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] init
-- @param self
-- @return bool#bool ret (return value: bool)
--------------------------------
-- get & set camera mask, the node is visible by the camera whose camera flag & node's camera mask is true
-- @function [parent=#Node] getCameraMask
-- @param self
-- @return unsigned short#unsigned short ret (return value: unsigned short)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the rotation (angle) of the node in degrees.<br>
-- 0 is the default rotation angle.<br>
-- Positive values rotate node clockwise, and negative values for anti-clockwise.<br>
-- param rotation The rotation of the node in degrees.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setRotation
-- @param self
-- @param #float rotation
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Changes the scale factor on Z axis of this node<br>
-- The Default value is 1.0 if you haven't changed it before.<br>
-- param scaleZ The scale factor on Z axis.<br>
-- warning The physics body doesn't support this.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setScaleZ
-- @param self
-- @param #float scaleZ
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the scale (y) of the node.<br>
-- It is a scaling factor that multiplies the height of the node and its children.<br>
-- param scaleY The scale factor on Y axis.<br>
-- warning The physics body doesn't support this.
-- @function [parent=#Node] setScaleY
2014-03-10 14:04:58 +08:00
-- @param self
-- @param #float scaleY
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the scale (x) of the node.<br>
-- It is a scaling factor that multiplies the width of the node and its children.<br>
-- param scaleX The scale factor on X axis.<br>
-- warning The physics body doesn't support this.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setScaleX
-- @param self
-- @param #float scaleX
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the X rotation (angle) of the node in degrees which performs a horizontal rotational skew.<br>
-- The difference between `setRotationalSkew()` and `setSkew()` is that the first one simulate Flash's skew functionality,<br>
-- while the second one uses the real skew function.<br>
-- 0 is the default rotation angle.<br>
-- Positive values rotate node clockwise, and negative values for anti-clockwise.<br>
-- param rotationX The X rotation in degrees which performs a horizontal rotational skew.<br>
-- warning The physics body doesn't support this.<br>
-- js setRotationX
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setRotationSkewX
-- @param self
-- @param #float rotationX
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] setonEnterTransitionDidFinishCallback
-- @param self
-- @param #function callback
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Removes all components
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] removeAllComponents
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] getOpacity
2014-03-10 14:04:58 +08:00
-- @param self
-- @return unsigned char#unsigned char ret (return value: unsigned char)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] setCameraMask
-- @param self
-- @param #unsigned short mask
-- @param #bool applyChildren
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns a tag that is used to identify the node easily.<br>
-- return An integer that identifies the node.<br>
-- Please use `getTag()` instead.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getTag
-- @param self
-- @return int#int ret (return value: int)
--------------------------------
-- / @{/ @name GLProgram<br>
-- Return the GLProgram (shader) currently used for this node.<br>
-- return The GLProgram (shader) currently used for this node.
-- @function [parent=#Node] getGLProgram
2014-03-10 14:04:58 +08:00
-- @param self
-- @return GLProgram#GLProgram ret (return value: cc.GLProgram)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the world affine transform matrix. The matrix is in Pixels.<br>
-- return transformation matrix, in pixels.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getNodeToWorldTransform
-- @param self
-- @return mat4_table#mat4_table ret (return value: mat4_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the position (X,Y,Z) in its parent's coordinate system.<br>
-- return The position (X, Y, and Z) in its parent's coordinate system.<br>
-- js NA
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getPosition3D
-- @param self
-- @return vec3_table#vec3_table ret (return value: vec3_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Removes a child from the container. It will also cleanup all running actions depending on the cleanup parameter.<br>
-- param child The child node which will be removed.<br>
-- param cleanup True if all running actions and callbacks on the child node will be cleanup, false otherwise.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] removeChild
-- @param self
-- @param #cc.Node child
-- @param #bool cleanup
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Converts a Vec2 to world space coordinates. The result is in Points.<br>
-- param nodePoint A given coordinate.<br>
-- return A point in world space coordinates.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] convertToWorldSpace
-- @param self
-- @param #vec2_table nodePoint
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the Scene that contains the Node.<br>
-- It returns `nullptr` if the node doesn't belong to any Scene.<br>
-- This function recursively calls parent->getScene() until parent is a Scene object. The results are not cached. It is that the user caches the results in case this functions is being used inside a loop.<br>
-- return The Scene that contains the node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getScene
-- @param self
-- @return Scene#Scene ret (return value: cc.Scene)
--------------------------------
-- Get the event dispatcher of scene.<br>
-- return The event dispatcher of scene.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getEventDispatcher
-- @param self
-- @return EventDispatcher#EventDispatcher ret (return value: cc.EventDispatcher)
--------------------------------
-- Changes the X skew angle of the node in degrees.<br>
-- The difference between `setRotationalSkew()` and `setSkew()` is that the first one simulate Flash's skew functionality<br>
-- while the second one uses the real skew function.<br>
-- This angle describes the shear distortion in the X direction.<br>
-- Thus, it is the angle between the Y coordinate and the left edge of the shape<br>
-- The default skewX angle is 0. Positive values distort the node in a CW direction.<br>
-- param skewX The X skew angle of the node in degrees.<br>
-- warning The physics body doesn't support this.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setSkewX
-- @param self
-- @param #float skewX
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Set the GLProgramState for this node.<br>
-- param glProgramState The GLProgramState for this node.
-- @function [parent=#Node] setGLProgramState
2014-03-10 14:04:58 +08:00
-- @param self
-- @param #cc.GLProgramState glProgramState
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] setOnEnterCallback
-- @param self
-- @param #function callback
-- @return Node#Node self (return value: cc.Node)
--------------------------------
-- Sets the position (x,y) using values between 0 and 1.<br>
-- The positions in pixels is calculated like the following:<br>
-- code pseudo code<br>
-- void setNormalizedPosition(Vec2 pos) {<br>
-- Size s = getParent()->getContentSize();<br>
-- _position = pos * s;<br>
-- }<br>
-- endcode<br>
-- param position The normalized position (x,y) of the node, using value between 0 and 1.
-- @function [parent=#Node] setNormalizedPosition
-- @param self
-- @param #vec2_table position
-- @return Node#Node self (return value: cc.Node)
--------------------------------
--
-- @function [parent=#Node] setonExitTransitionDidStartCallback
-- @param self
-- @param #function callback
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- convenience methods which take a Touch instead of Vec2.<br>
-- param touch A given touch.<br>
-- return A point in world space coordinates.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] convertTouchToNodeSpace
-- @param self
-- @param #cc.Touch touch
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, bool
-- @overload self
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] removeAllChildrenWithCleanup
-- @param self
-- @param #bool cleanup
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, cc.Node
-- @overload self
-- @function [parent=#Node] getNodeToParentAffineTransform
2014-03-10 14:04:58 +08:00
-- @param self
-- @param #cc.Node ancestor
2014-03-10 14:04:58 +08:00
-- @return AffineTransform#AffineTransform ret (return value: cc.AffineTransform)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] isCascadeOpacityEnabled
-- @param self
-- @return bool#bool ret (return value: bool)
--------------------------------
-- Sets the parent node.<br>
-- param parent A pointer to the parent node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setParent
-- @param self
-- @param #cc.Node parent
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns a string that is used to identify the node.<br>
-- return A string that identifies the node.<br>
-- since v3.2
-- @function [parent=#Node] getName
-- @param self
-- @return string#string ret (return value: string)
--------------------------------
-- Resumes all scheduled selectors, actions and event listeners.<br>
-- This method is called internally by onEnter.
-- @function [parent=#Node] resume
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the rotation (X,Y,Z) in degrees.<br>
-- return The rotation of the node in 3d.<br>
-- js NA
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getRotation3D
-- @param self
-- @return vec3_table#vec3_table ret (return value: vec3_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, cc.Node
-- @overload self
-- @function [parent=#Node] getNodeToParentTransform
2014-03-10 14:04:58 +08:00
-- @param self
-- @param #cc.Node ancestor
-- @return mat4_table#mat4_table ret (return value: mat4_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- converts a Touch (world coordinates) into a local coordinate. This method is AR (Anchor Relative).<br>
-- param touch A given touch.<br>
-- return A point in world space coordinates, anchor relative.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] convertTouchToNodeSpaceAR
-- @param self
-- @param #cc.Touch touch
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Converts a Vec2 to node (local) space coordinates. The result is in Points.<br>
-- param worldPoint A given coordinate.<br>
-- return A point in node (local) space coordinates.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] convertToNodeSpace
-- @param self
-- @param #vec2_table worldPoint
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, float, float
-- @overload self, vec2_table
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setPosition
-- @param self
-- @param #float x
-- @param #float y
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Removes an action from the running action list by its tag.<br>
-- param tag A tag that indicates the action to be removed.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] stopActionByTag
-- @param self
-- @param #int tag
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Reorders a child according to a new z value.<br>
-- param child An already added child node. It MUST be already added.<br>
-- param localZOrder Z order for drawing priority. Please refer to setLocalZOrder(int).
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] reorderChild
-- @param self
-- @param #cc.Node child
-- @param #int localZOrder
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets whether the anchor point will be (0,0) when you position this node.<br>
-- This is an internal method, only used by Layer and Scene. Don't call it outside framework.<br>
-- The default value is false, while in Layer and Scene are true.<br>
-- param ignore true if anchor point will be (0,0) when you position this node.<br>
-- todo This method should be renamed as setIgnoreAnchorPointForPosition(bool) or something with "set".
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] ignoreAnchorPointForPosition
-- @param self
-- @param #bool ignore
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Changes the Y skew angle of the node in degrees.<br>
-- The difference between `setRotationalSkew()` and `setSkew()` is that the first one simulate Flash's skew functionality<br>
-- while the second one uses the real skew function.<br>
-- This angle describes the shear distortion in the Y direction.<br>
-- Thus, it is the angle between the X coordinate and the bottom edge of the shape.<br>
-- The default skewY angle is 0. Positive values distort the node in a CCW direction.<br>
-- param skewY The Y skew angle of the node in degrees.<br>
-- warning The physics body doesn't support this.
-- @function [parent=#Node] setSkewY
-- @param self
-- @param #float skewY
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the 'z' coordinate in the position. It is the OpenGL Z vertex value.<br>
-- The OpenGL depth buffer and depth testing are disabled by default. You need to turn them on.<br>
-- In order to use this property correctly.<br>
-- `setPositionZ()` also sets the `setGlobalZValue()` with the positionZ as value.<br>
-- see `setGlobalZValue()`<br>
-- param positionZ OpenGL Z vertex of this node.<br>
-- js setVertexZ
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setPositionZ
-- @param self
-- @param #float positionZ
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the rotation (X,Y,Z) in degrees.<br>
-- Useful for 3d rotations.<br>
-- warning The physics body doesn't support this.<br>
-- param rotation The rotation of the node in 3d.<br>
-- js NA
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setRotation3D
-- @param self
-- @param #vec3_table rotation
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Gets/Sets x or y coordinate individually for position.<br>
-- These methods are used in Lua and Javascript Bindings<br>
-- Sets the x coordinate of the node in its parent's coordinate system.<br>
-- param x The x coordinate of the node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setPositionX
-- @param self
-- @param #float x
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the transformation matrix manually.<br>
-- param transform A given transformation matrix.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setNodeToParentTransform
-- @param self
-- @param #mat4_table transform
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the anchor point in percent.<br>
-- see `setAnchorPoint(const Vec2&)`<br>
-- return The anchor point of node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getAnchorPoint
-- @param self
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays).<br>
-- Composable actions are counted as 1 action. Example:<br>
-- If you are running 1 Sequence of 7 actions, it will return 1.<br>
-- If you are running 7 Sequences of 2 actions, it will return 7.<br>
-- todo Rename to getNumberOfRunningActions()<br>
-- return The number of actions that are running plus the ones that are schedule to run.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getNumberOfRunningActions
-- @param self
-- @return long#long ret (return value: long)
--------------------------------
-- Calls children's updateTransform() method recursively.<br>
-- This method is moved from Sprite, so it's no longer specific to Sprite.<br>
-- As the result, you apply SpriteBatchNode's optimization on your customed Node.<br>
-- e.g., `batchNode->addChild(myCustomNode)`, while you can only addChild(sprite) before.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] updateTransform
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Determines if the node is visible.<br>
-- see `setVisible(bool)`<br>
-- return true if the node is visible, false if the node is hidden.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] isVisible
-- @param self
-- @return bool#bool ret (return value: bool)
--------------------------------
-- Returns the amount of children.<br>
-- return The amount of children.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getChildrenCount
-- @param self
-- @return long#long ret (return value: long)
--------------------------------
-- Converts a Vec2 to node (local) space coordinates. The result is in Points.<br>
-- treating the returned/received node point as anchor relative.<br>
-- param worldPoint A given coordinate.<br>
-- return A point in node (local) space coordinates, anchor relative.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] convertToNodeSpaceAR
-- @param self
-- @param #vec2_table worldPoint
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Adds a component.<br>
-- param component A given component.<br>
-- return True if added success.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] addComponent
-- @param self
-- @param #cc.Component component
-- @return bool#bool ret (return value: bool)
--------------------------------
-- Executes an action, and returns the action that is executed.<br>
-- This node becomes the action's target. Refer to Action::getTarget().<br>
-- warning Actions don't retain their target.<br>
-- param action An Action pointer.
-- @function [parent=#Node] runAction
-- @param self
-- @param #cc.Action action
-- @return Action#Action ret (return value: cc.Action)
--------------------------------
-- @overload self
-- @overload self, cc.Renderer, mat4_table, unsigned int
-- @function [parent=#Node] visit
-- @param self
-- @param #cc.Renderer renderer
-- @param #mat4_table parentTransform
-- @param #unsigned int parentFlags
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] isOpacityModifyRGB
2014-03-10 14:04:58 +08:00
-- @param self
-- @return bool#bool ret (return value: bool)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the rotation of the node in degrees.<br>
-- see `setRotation(float)`<br>
-- return The rotation of the node in degrees.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getRotation
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Returns the anchorPoint in absolute pixels.<br>
-- warning You can only read it. If you wish to modify it, use anchorPoint instead.<br>
-- see `getAnchorPoint()`<br>
-- return The anchor point in absolute pixels.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getAnchorPointInPoints
-- @param self
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Removes a child from the container by tag value. It will also cleanup all running actions depending on the cleanup parameter.<br>
-- param name A string that identifies a child node.<br>
-- param cleanup True if all running actions and callbacks on the child node will be cleanup, false otherwise.
-- @function [parent=#Node] removeChildByName
-- @param self
-- @param #string name
-- @param #bool cleanup
-- @return Node#Node self (return value: cc.Node)
--------------------------------
-- Return the GLProgramState currently used for this node.<br>
-- return The GLProgramState currently used for this node.
-- @function [parent=#Node] getGLProgramState
-- @param self
-- @return GLProgramState#GLProgramState ret (return value: cc.GLProgramState)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets a Scheduler object that is used to schedule all "updates" and timers.<br>
-- warning If you set a new Scheduler, then previously created timers/update are going to be removed.<br>
-- param scheduler A Shdeduler object that is used to schedule all "update" and timers.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setScheduler
-- @param self
-- @param #cc.Scheduler scheduler
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Stops and removes all actions from the running action list .
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] stopAllActions
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the X skew angle of the node in degrees.<br>
-- see `setSkewX(float)`<br>
-- return The X skew angle of the node in degrees.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getSkewX
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Returns the Y skew angle of the node in degrees.<br>
-- see `setSkewY(float)`<br>
-- return The Y skew angle of the node in degrees.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getSkewY
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getDisplayedColor
-- @param self
-- @return color3b_table#color3b_table ret (return value: color3b_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Gets an action from the running action list by its tag.<br>
-- see `setTag(int)`, `getTag()`.<br>
-- return The action object with the given tag.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getActionByTag
-- @param self
-- @param #int tag
2014-03-10 14:04:58 +08:00
-- @return Action#Action ret (return value: cc.Action)
--------------------------------
-- Changes the name that is used to identify the node easily.<br>
-- param name A string that identifies the node.<br>
-- since v3.2
-- @function [parent=#Node] setName
-- @param self
-- @param #string name
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getDisplayedOpacity
-- @param self
-- @return unsigned char#unsigned char ret (return value: unsigned char)
--------------------------------
-- Gets the local Z order of this node.<br>
-- see `setLocalZOrder(int)`<br>
-- return The local (relative to its siblings) Z order.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getLocalZOrder
-- @param self
-- @return int#int ret (return value: int)
--------------------------------
-- @overload self
-- @overload self
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getScheduler
-- @param self
-- @return Scheduler#Scheduler ret (return value: cc.Scheduler)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getParentToNodeAffineTransform
-- @param self
-- @return AffineTransform#AffineTransform ret (return value: cc.AffineTransform)
--------------------------------
-- Returns the arrival order, indicates which children is added previously.<br>
-- see `setOrderOfArrival(unsigned int)`<br>
-- return The arrival order.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getOrderOfArrival
-- @param self
-- @return int#int ret (return value: int)
--------------------------------
-- Sets the ActionManager object that is used by all actions.<br>
-- warning If you set a new ActionManager, then previously created actions will be removed.<br>
-- param actionManager A ActionManager object that is used by all actions.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setActionManager
-- @param self
-- @param #cc.ActionManager actionManager
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setColor
-- @param self
-- @param #color3b_table color
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns whether or not the node is "running".<br>
-- If the node is running it will accept event callbacks like onEnter(), onExit(), update().<br>
-- return Whether or not the node is running.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] isRunning
-- @param self
-- @return bool#bool ret (return value: bool)
--------------------------------
-- @overload self
-- @overload self
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getParent
-- @param self
-- @return Node#Node ret (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Gets position Z coordinate of this node.<br>
-- see setPositionZ(float)<br>
-- return The position Z coordinate of this node.<br>
-- js getVertexZ
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getPositionZ
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Gets the y coordinate of the node in its parent's coordinate system.<br>
-- return The y coordinate of the node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getPositionY
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Gets the x coordinate of the node in its parent's coordinate system.<br>
-- return The x coordinate of the node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getPositionX
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Removes a child from the container by tag value. It will also cleanup all running actions depending on the cleanup parameter.<br>
-- param tag An interger number that identifies a child node.<br>
-- param cleanup True if all running actions and callbacks on the child node will be cleanup, false otherwise.<br>
-- Please use `removeChildByName` instead.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] removeChildByTag
-- @param self
-- @param #int tag
-- @param #bool cleanup
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the y coordinate of the node in its parent's coordinate system.<br>
-- param y The y coordinate of the node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setPositionY
-- @param self
-- @param #float y
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
-- @function [parent=#Node] getNodeToWorldAffineTransform
-- @param self
-- @return AffineTransform#AffineTransform ret (return value: cc.AffineTransform)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] updateDisplayedColor
-- @param self
-- @param #color3b_table parentColor
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets whether the node is visible.<br>
-- The default value is true, a node is default to visible.<br>
-- param visible true if the node is visible, false if the node is hidden.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setVisible
-- @param self
-- @param #bool visible
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the matrix that transform parent's space coordinates to the node's (local) space coordinates.<br>
-- The matrix is in Pixels.<br>
-- return The transformation matrix.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getParentToNodeTransform
-- @param self
-- @return mat4_table#mat4_table ret (return value: mat4_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Checks whether a lambda function is scheduled.<br>
-- param key key of the callback<br>
-- return Whether the lambda function selector is scheduled.<br>
-- js NA<br>
-- lua NA
-- @function [parent=#Node] isScheduled
-- @param self
-- @param #string key
-- @return bool#bool ret (return value: bool)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Defines the oder in which the nodes are renderer.<br>
-- Nodes that have a Global Z Order lower, are renderer first.<br>
-- In case two or more nodes have the same Global Z Order, the oder is not guaranteed.<br>
-- The only exception if the Nodes have a Global Z Order == 0. In that case, the Scene Graph order is used.<br>
-- By default, all nodes have a Global Z Order = 0. That means that by default, the Scene Graph order is used to render the nodes.<br>
-- Global Z Order is useful when you need to render nodes in an order different than the Scene Graph order.<br>
-- Limitations: Global Z Order can't be used used by Nodes that have SpriteBatchNode as one of their acenstors.<br>
-- And if ClippingNode is one of the ancestors, then "global Z order" will be relative to the ClippingNode.<br>
-- see `setLocalZOrder()`<br>
-- see `setVertexZ()`<br>
-- since v3.0<br>
-- param globalZOrder The global Z order value.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setGlobalZOrder
-- @param self
-- @param #float globalZOrder
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, float, float
-- @overload self, float
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setScale
-- @param self
-- @param #float scaleX
-- @param #float scaleY
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Gets a child from the container with its tag.<br>
-- param tag An identifier to find the child node.<br>
-- return a Node object whose tag equals to the input parameter.<br>
-- Please use `getChildByName()` instead.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getChildByTag
-- @param self
-- @param #int tag
2014-03-10 14:04:58 +08:00
-- @return Node#Node ret (return value: cc.Node)
--------------------------------
-- Sets the arrival order when this node has a same ZOrder with other children.<br>
-- A node which called addChild subsequently will take a larger arrival order,<br>
-- If two children have the same Z order, the child with larger arrival order will be drawn later.<br>
-- warning This method is used internally for localZOrder sorting, don't change this manually<br>
-- param orderOfArrival The arrival order.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setOrderOfArrival
-- @param self
-- @param #int orderOfArrival
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the scale factor on Z axis of this node<br>
-- see `setScaleZ(float)`<br>
-- return The scale factor on Z axis.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getScaleZ
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Returns the scale factor on Y axis of this node<br>
-- see `setScaleY(float)`<br>
-- return The scale factor on Y axis.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getScaleY
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Returns the scale factor on X axis of this node<br>
-- see setScaleX(float)<br>
-- return The scale factor on X axis.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getScaleX
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- LocalZOrder is the 'key' used to sort the node relative to its siblings.<br>
-- The Node's parent will sort all its children based ont the LocalZOrder value.<br>
-- If two nodes have the same LocalZOrder, then the node that was added first to the children's array will be in front of the other node in the array.<br>
-- Also, the Scene Graph is traversed using the "In-Order" tree traversal algorithm ( http:en.wikipedia.org/wiki/Tree_traversal#In-order )<br>
-- And Nodes that have LocalZOder values < 0 are the "left" subtree<br>
-- While Nodes with LocalZOder >=0 are the "right" subtree.<br>
-- see `setGlobalZOrder`<br>
-- see `setVertexZ`<br>
-- param localZOrder The local Z order value.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setLocalZOrder
-- @param self
-- @param #int localZOrder
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getWorldToNodeAffineTransform
-- @param self
-- @return AffineTransform#AffineTransform ret (return value: cc.AffineTransform)
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setCascadeColorEnabled
-- @param self
-- @param #bool cascadeColorEnabled
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setOpacity
-- @param self
-- @param #unsigned char opacity
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Stops all running actions and schedulers
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] cleanup
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- / @{/ @name component functions<br>
-- Gets a component by its name.<br>
-- param name A given name of component.<br>
-- return The Component by name.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getComponent
-- @param self
-- @param #string name
2014-03-10 14:04:58 +08:00
-- @return Component#Component ret (return value: cc.Component)
--------------------------------
-- Returns the untransformed size of the node.<br>
-- see `setContentSize(const Size&)`<br>
-- return The untransformed size of the node.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getContentSize
-- @param self
-- @return size_table#size_table ret (return value: size_table)
--------------------------------
-- Removes all actions from the running action list by its tag.<br>
-- param tag A tag that indicates the action to be removed.
-- @function [parent=#Node] stopAllActionsByTag
-- @param self
-- @param #int tag
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getColor
-- @param self
-- @return color3b_table#color3b_table ret (return value: color3b_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns an AABB (axis-aligned bounding-box) in its parent's coordinate system.<br>
-- return An AABB (axis-aligned bounding-box) in its parent's coordinate system
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getBoundingBox
-- @param self
-- @return rect_table#rect_table ret (return value: rect_table)
--------------------------------
-- Set event dispatcher for scene.<br>
-- param dispatcher The event dispatcher of scene.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setEventDispatcher
-- @param self
-- @param #cc.EventDispatcher dispatcher
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the Node's Global Z Order.<br>
-- see `setGlobalZOrder(int)`<br>
-- return The node's global Z order
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getGlobalZOrder
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- @overload self
-- @overload self, cc.Renderer, mat4_table, unsigned int
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] draw
-- @param self
-- @param #cc.Renderer renderer
-- @param #mat4_table transform
-- @param #unsigned int flags
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns a user assigned Object.<br>
-- Similar to UserData, but instead of holding a void* it holds an object.<br>
-- The UserObject will be retained once in this method,<br>
-- and the previous UserObject (if existed) will be released.<br>
-- The UserObject will be released in Node's destructor.<br>
-- param userObject A user assigned Object.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setUserObject
-- @param self
-- @param #cc.Ref userObject
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self, bool
-- @overload self
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] removeFromParentAndCleanup
-- @param self
-- @param #bool cleanup
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the position (X, Y, and Z) in its parent's coordinate system.<br>
-- param position The position (X, Y, and Z) in its parent's coordinate system.<br>
-- js NA
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setPosition3D
-- @param self
-- @param #vec3_table position
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Update method will be called automatically every frame if "scheduleUpdate" is called, and the node is "live".<br>
-- param delta In seconds.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] update
-- @param self
-- @param #float delta
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sorts the children array once before drawing, instead of every time when a child is added or reordered.<br>
-- This appraoch can improves the performance massively.<br>
-- note Don't call this manually unless a child added needs to be removed in the same frame.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] sortAllChildren
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the inverse world affine transform matrix. The matrix is in Pixels.<br>
-- return The transformation matrix.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getWorldToNodeTransform
-- @param self
-- @return mat4_table#mat4_table ret (return value: mat4_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Sets the shader program for this node<br>
-- Since v2.0, each rendering node must set its shader program.<br>
-- It should be set in initialize phase.<br>
-- code<br>
-- node->setGLrProgram(GLProgramCache::getInstance()->getProgram(GLProgram::SHADER_NAME_POSITION_TEXTURE_COLOR));<br>
-- endcode<br>
-- param glprogram The shader program.
-- @function [parent=#Node] setGLProgram
-- @param self
-- @param #cc.GLProgram glprogram
-- @return Node#Node self (return value: cc.Node)
--------------------------------
-- Gets the scale factor of the node, when X and Y have the same scale factor.<br>
-- warning Assert when `_scaleX != _scaleY`<br>
-- see setScale(float)<br>
-- return The scale factor of the node.
-- @function [parent=#Node] getScale
-- @param self
-- @return float#float ret (return value: float)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Returns the normalized position.<br>
-- return The normalized position.
-- @function [parent=#Node] getNormalizedPosition
2014-03-10 14:04:58 +08:00
-- @param self
-- @return vec2_table#vec2_table ret (return value: vec2_table)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Gets the X rotation (angle) of the node in degrees which performs a horizontal rotation skew.<br>
-- see `setRotationSkewX(float)`<br>
-- return The X rotation in degrees.<br>
-- js getRotationX
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getRotationSkewX
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Gets the Y rotation (angle) of the node in degrees which performs a vertical rotational skew.<br>
-- see `setRotationSkewY(float)`<br>
-- return The Y rotation in degrees.<br>
-- js getRotationY
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getRotationSkewY
-- @param self
-- @return float#float ret (return value: float)
--------------------------------
-- Changes the tag that is used to identify the node easily.<br>
-- Please refer to getTag for the sample code.<br>
-- param tag A integer that identifies the node.<br>
-- Please use `setName()` instead.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] setTag
-- @param self
-- @param #int tag
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
--
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] isCascadeColorEnabled
-- @param self
-- @return bool#bool ret (return value: bool)
--------------------------------
-- Stops and removes an action from the running action list.<br>
-- param action The action object to be removed.
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] stopAction
-- @param self
-- @param #cc.Action action
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
--------------------------------
-- @overload self
-- @overload self
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] getActionManager
-- @param self
-- @return ActionManager#ActionManager ret (return value: cc.ActionManager)
2014-03-10 14:04:58 +08:00
--------------------------------
-- Allocates and initializes a node.<br>
-- return A initialized node which is marked as "autorelease".
2014-03-10 14:04:58 +08:00
-- @function [parent=#Node] create
-- @param self
-- @return Node#Node ret (return value: cc.Node)
--------------------------------
--
-- @function [parent=#Node] Node
-- @param self
-- @return Node#Node self (return value: cc.Node)
2014-03-10 14:04:58 +08:00
return nil