Scene 类型

继承于 Node

模块: cc

cc.Scene 是 cc.Node 的子类,仅作为一个抽象的概念。
cc.Scene 和 cc.Node 有点不同,用户不应直接修改 cc.Scene。

索引

属性(properties)
  • autoReleaseAssets Boolean 指示该场景中直接或间接静态引用到的所有资源是否默认在场景切换后自动释放。
  • groupIndex Integer 节点的分组索引。
  • group String 节点的分组。
  • position Vec2 节点在父节点坐标系中的位置(x, y)。
  • x Number 节点 X 轴坐标。
  • y Number 节点 Y 轴坐标。
  • rotation Number 该节点旋转角度。
  • rotationX Number 该节点 X 轴旋转角度。
  • rotationY Number 该节点 Y 轴旋转角度。
  • scaleX Number 节点 X 轴缩放。
  • scaleY Number 节点 Y 轴缩放。
  • skewX Number 该节点 Y 轴倾斜角度。
  • skewY Number 该节点 X 轴倾斜角度。
  • opacity Number 节点透明度,默认值为 255。
  • cascadeOpacity Boolean 节点的不透明度值是否影响其子节点,默认值为 true。
  • color Color 节点颜色。
  • anchorX Number 节点 X 轴锚点位置。
  • anchorY Number 节点 Y 轴锚点位置。
  • width Number 节点宽度。
  • height Number 节点高度。
  • zIndex Number 该节点渲染排序的 Z 轴深度。
  • _sgNode _ccsg.Node Current scene graph node for this node.
  • _sizeProvider _ccsg.Node Current active size provider for this node....
  • scale Number 节点相对父节点的缩放。
  • _components Component[]
  • _prefab PrefabInfo The PrefabInfo object
  • _persistNode Boolean If true, the node is an persist node which won't be destroyed during scene transition....
  • name String 该节点名称。
  • uuid String 主要用于编辑器的 uuid,在编辑器下可用于持久化存储,在项目构建之后将变成自增的 id。
  • children Node[] 节点的所有子节点。
  • childrenCount Number 节点的子节点数量。
  • active Boolean 当前节点的自身激活状态。
  • activeInHierarchy Boolean 表示此节点是否在场景中激活。
  • tag Number 节点标签。
  • __eventTargets EventTarget[] Register all related EventTargets,...
  • parent Node 该节点的父节点。
  • _name String
  • _objFlags Number
  • isValid Boolean 表示该对象是否可用(被 destroy 后将不可用)。
方法
  • constructor
  • on 在节点上注册指定类型的回调函数,也可以设置 target 用于绑定响应函数的 this 对象。
  • off 删除之前与同类型,回调,目标或 useCapture 注册的回调。
  • targetOff 移除目标上的所有注册事件。
  • pauseSystemEvents 暂停当前节点上注册的所有节点系统事件,节点系统事件包含触摸和鼠标事件。
  • resumeSystemEvents 恢复当前节点上注册的所有节点系统事件,节点系统事件包含触摸和鼠标事件。
  • runAction 执行并返回该执行的动作。
  • pauseAllActions 暂停本节点上所有正在运行的动作。
  • resumeAllActions 恢复运行本节点上所有暂停的动作。
  • stopAllActions 停止并且移除所有正在运行的动作列表。
  • stopAction 停止并移除指定的动作。
  • stopActionByTag 停止并且移除指定标签的动作。
  • getActionByTag 通过标签获取指定动作。
  • getNumberOfRunningActions 获取运行着的动作加上正在调度运行的动作的总数。
  • getPosition 获取节点在父节点坐标系中的位置(x, y)。
  • setPosition 设置节点在父节点坐标系中的位置。
  • getScale 获取节点的缩放。
  • setScale 设置节点的缩放比例,默认值为 1.0。
  • getContentSize 获取节点自身大小,不受该节点是否被缩放或者旋转的影响。
  • setContentSize 设置节点原始大小,不受该节点是否被缩放或者旋转的影响。
  • setOpacityModifyRGB 设置更改透明度时是否修改RGB值,
  • isOpacityModifyRGB 更改透明度时是否修改RGB值。
  • getAnchorPoint 获取节点锚点,用百分比表示。
  • setAnchorPoint 设置锚点的百分比。
  • getAnchorPointInPoints 返回锚点的绝对像素位置。
  • getDisplayedOpacity 显示透明度是基于自身透明度和父节点透明度计算的。
  • getDisplayedColor 显示颜色是基于自身颜色和父节点颜色计算的。
  • getNodeToParentTransformAR 返回这个将节点(局部)的空间坐标系转换成父节点的空间坐标系的矩阵。
  • getBoundingBox 返回父节坐标系下的轴向对齐的包围盒。
  • getBoundingBoxToWorld 返回节点在世界坐标系下的对齐轴向的包围盒(AABB)。
  • getNodeToParentTransform 返回这个将节点(局部)的空间坐标系转换成父节点的空间坐标系的矩阵。
  • getNodeToWorldTransform 返回节点到世界坐标系的仿射变换矩阵。
  • getNodeToWorldTransformAR 返回节点到世界坐标仿射变换矩阵。
  • getParentToNodeTransform 返回将父节点的坐标系转换成节点(局部)的空间坐标系的矩阵。
  • getWorldToNodeTransform
  • convertToNodeSpace 将一个点转换到节点 (局部) 坐标系。
  • convertToWorldSpace 将一个点转换到世界空间坐标系。
  • convertToNodeSpaceAR 将一个点转换到节点 (局部) 空间坐标系。
  • convertToWorldSpaceAR 将一个点转换到世界空间坐标系。
  • convertTouchToNodeSpace 将触摸点转换成本地坐标系中位置。
  • convertTouchToNodeSpaceAR 转换一个 cc.Touch(世界坐标)到一个局部坐标,该方法基于节点坐标。
  • addChild 添加子节点,并且可以修改该节点的 局部 Z 顺序和标签。
  • cleanup 停止所有正在播放的动作和计时器。
  • sortAllChildren 根据子节点的 zIndex 和 arrivalOrder 进行排序,正常情况下开发者不需要手动调用这个函数。
  • getPositionX 获取节点 X 轴坐标。
  • setPositionX 设置节点 X 轴坐标。
  • getPositionY 获取节点 Y 轴坐标。
  • setPositionY 设置节点 Y 轴坐标。
  • getLocalZOrder 获取节点局部 Z 轴顺序。
  • setLocalZOrder LocalZOrder 是 “key” (关键)来分辨节点和它兄弟节点的相关性。
  • isCascadeOpacityEnabled 返回节点的不透明度值是否影响其子节点。
  • setCascadeOpacityEnabled 启用或禁用级连不透明度,如果级连启用,子节点的不透明度将是父不透明度乘上它自己的不透明度。
  • attr 属性配置函数。
  • getChildByTag 通过标签获取节点的子节点。
  • getChildByUuid 通过 uuid 获取节点的子节点。
  • getChildByName 通过名称获取节点的子节点。
  • insertChild 插入子节点到指定位置
  • getSiblingIndex 获取同级索引。
  • setSiblingIndex 设置节点同级索引。
  • removeFromParent 从父节点中删除该节点。
  • removeChild 移除节点中指定的子节点,是否需要清理所有正在运行的行为取决于 cleanup 参数。
  • removeChildByTag 通过标签移除节点中指定的子节点,是否需要清理所有正在运行的行为取决于 cleanup 参数。
  • removeAllChildren 移除节点所有的子节点,是否需要清理所有正在运行的行为取决于 cleanup 参数。
  • isChildOf 是否是指定节点的子节点?
  • getComponent 获取节点上指定类型的组件,如果节点有附加指定类型的组件,则返回,如果没有则为空。
  • getComponents 返回节点上指定类型的所有组件。
  • getComponentInChildren 递归查找所有子节点中第一个匹配指定类型的组件。
  • getComponentsInChildren 递归查找自身或所有子节点中指定类型的组件
  • addComponent 向节点添加一个指定类型的组件类,你还可以通过传入脚本的名称来添加组件。
  • _addComponentAt This api should only used by undo system
  • removeComponent 删除节点上的指定组件,传入参数可以是一个组件构造函数或组件名,也可以是已经获得的组件引用。
  • _getDependComponent
  • destroyAllChildren 销毁所有子节点,并释放所有它们对其它对象的引用。
  • destroy 销毁该对象,并释放所有它对其它对象的引用。
  • _destruct Clear all references in the instance....
  • _onPreDestroy Called before the object being destroyed.
  • _serialize The customized serialization for this object. (Editor Only)
  • _deserialize Init this object from the custom serialized data.
  • once 注册事件目标的特定事件类型回调,回调会在第一时间被触发后删除自身。
  • dispatchEvent 分发事件到事件流中。
  • emit 该对象直接发送事件, 这种方法不会对事件传播到任何其他对象。
事件

Details

属性(properties)

autoReleaseAssets

指示该场景中直接或间接静态引用到的所有资源是否默认在场景切换后自动释放。

meta description
类型 Boolean
定义于 cocos2d/core/CCScene.js:47
groupIndex

节点的分组索引。
节点的分组将关系到节点的碰撞组件可以与哪些碰撞组件相碰撞。

meta description
类型 Integer
定义于 cocos2d/core/CCNode.js:400
group

节点的分组。
节点的分组将关系到节点的碰撞组件可以与哪些碰撞组件相碰撞。

meta description
类型 String
定义于 cocos2d/core/CCNode.js:416
position

节点在父节点坐标系中的位置(x, y)。

meta description
类型 Vec2
定义于 cocos2d/core/CCNode.js:439
示例
cc.log("Node Position: " + node.position);
x

节点 X 轴坐标。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:447
示例
node.x = 100;
cc.log("Node Position X: " + node.x);
y

节点 Y 轴坐标。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:490
示例
node.y = 100;
cc.log("Node Position Y: " + node.y);
rotation

该节点旋转角度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:533
示例
node.rotation = 90;
cc.log("Node Rotation: " + node.rotation);
rotationX

该节点 X 轴旋转角度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:561
示例
node.rotationX = 45;
cc.log("Node Rotation X: " + node.rotationX);
rotationY

该节点 Y 轴旋转角度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:587
示例
node.rotationY = 45;
cc.log("Node Rotation Y: " + node.rotationY);
scaleX

节点 X 轴缩放。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:613
示例
node.scaleX = 0.5;
cc.log("Node Scale X: " + node.scaleX);
scaleY

节点 Y 轴缩放。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:639
示例
node.scaleY = 0.5;
cc.log("Node Scale Y: " + node.scaleY);
skewX

该节点 Y 轴倾斜角度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:665
示例
node.skewX = 0;
cc.log("Node SkewX: " + node.skewX);
skewY

该节点 X 轴倾斜角度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:684
示例
node.skewY = 0;
cc.log("Node SkewY: " + node.skewY);
opacity

节点透明度,默认值为 255。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:703
示例
node.opacity = 255;
cascadeOpacity

节点的不透明度值是否影响其子节点,默认值为 true。

meta description
类型 Boolean
定义于 cocos2d/core/CCNode.js:730
示例
cc.log("CascadeOpacity: " + node.cascadeOpacity);
color

节点颜色。默认为白色,数值为:(255,255,255)。

meta description
类型 Color
定义于 cocos2d/core/CCNode.js:756
示例
node.color = new cc.Color(255, 255, 255);
anchorX

节点 X 轴锚点位置。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:781
示例
node.anchorX = 0;
anchorY

节点 Y 轴锚点位置。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:806
示例
node.anchorY = 0;
width

节点宽度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:831
示例
node.width = 100;
height

节点高度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:870
示例
node.height = 100;
zIndex

该节点渲染排序的 Z 轴深度。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:909
示例
node.zIndex = 1;
cc.log("Node zIndex: " + node.zIndex);
_sgNode

Current scene graph node for this node.

meta description
类型 _ccsg.Node
定义于 cocos2d/core/CCNode.js:943
_sizeProvider

Current active size provider for this node. Size provider can equals to this._sgNode.

meta description
类型 _ccsg.Node
定义于 cocos2d/core/CCNode.js:965
scale

节点相对父节点的缩放。

meta description
类型 Number
定义于 cocos2d/core/CCNode.js:2631
示例
node.scale = 1;
_components
meta description
类型 Component[]
定义于 cocos2d/core/utils/base-node.js:156
_prefab

The PrefabInfo object

meta description
类型 PrefabInfo
定义于 cocos2d/core/utils/base-node.js:165
_persistNode

If true, the node is an persist node which won't be destroyed during scene transition. If false, the node will be destroyed automatically when loading a new scene. Default is false.

meta description
类型 Boolean
定义于 cocos2d/core/utils/base-node.js:173
name

该节点名称。

meta description
类型 String
定义于 cocos2d/core/utils/base-node.js:197
示例
node.name = "New Node";
cc.log("Node Name: " + node.name);
uuid

主要用于编辑器的 uuid,在编辑器下可用于持久化存储,在项目构建之后将变成自增的 id。

meta description
类型 String
定义于 cocos2d/core/utils/base-node.js:224
示例
cc.log("Node Uuid: " + node.uuid);
children

节点的所有子节点。

meta description
类型 Node[]
定义于 cocos2d/core/utils/base-node.js:243
示例
var children = node.children;
for (var i = 0; i < children.length; ++i) {
    cc.log("Node: " + children[i]);
}
childrenCount

节点的子节点数量。

meta description
类型 Number
定义于 cocos2d/core/utils/base-node.js:261
示例
var count = node.childrenCount;
cc.log("Node Children Count: " + count);
active

当前节点的自身激活状态。
值得注意的是,一个节点的父节点如果不被激活,那么即使它自身设为激活,它仍然无法激活。
如果你想检查节点在场景中实际的激活状态可以使用 Node/activeInHierarchy:property。

meta description
类型 Boolean
定义于 cocos2d/core/utils/base-node.js:277
示例
node.active = false;
activeInHierarchy

表示此节点是否在场景中激活。

meta description
类型 Boolean
定义于 cocos2d/core/utils/base-node.js:311
示例
cc.log("activeInHierarchy: " + node.activeInHierarchy);
tag

节点标签。

meta description
类型 Number
定义于 cocos2d/core/utils/base-node.js:325
示例
node.tag = 1001;
__eventTargets

Register all related EventTargets, all event callbacks will be removed in _onPreDestroy

meta description
类型 EventTarget[]
定义于 cocos2d/core/utils/base-node.js:347
parent

该节点的父节点。

meta description
类型 Node
定义于 cocos2d/core/utils/base-node.js:365
示例
node.parent = newNode;
_name
meta description
类型 String
定义于 cocos2d/core/platform/CCObject.js:76
_objFlags
meta description
类型 Number
定义于 cocos2d/core/platform/CCObject.js:83
isValid

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

meta description
类型 Boolean
定义于 cocos2d/core/platform/CCObject.js:261
示例
var node = new cc.Node();
cc.log(node.isValid);    // true
node.destroy();
cc.log(node.isValid);    // true, still valid in this frame
// after a frame...
cc.log(node.isValid);    // false, destroyed in the end of last frame

方法

constructor
meta description
定义于 cocos2d/core/CCNode.js:937
参数列表
on

在节点上注册指定类型的回调函数,也可以设置 target 用于绑定响应函数的 this 对象。
同时您可以将事件派发到父节点或者通过调用 stopPropagation 拦截它。
推荐使用这种方式来监听节点上的触摸或鼠标事件,请不要在节点上直接使用 cc.eventManager。

meta description
返回 Function
定义于 cocos2d/core/CCNode.js:1182
参数列表
  • type String A string representing the event type to listen for.
                     See <a href="../classes/Node.html#event_position-changed" class="crosslink">Node Events</a> for all builtin events.
    
  • callback Function The callback that will be invoked when the event is dispatched.
                           The callback is ignored if it is a duplicate (the callbacks are unique).
    
  • target Object The target (this object) to invoke the callback, can be null
  • useCapture Boolean When set to true, the capture argument prevents callback
                           from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE.
                           When false, callback will NOT be invoked when event's eventPhase attribute value is CAPTURING_PHASE.
                           Either way, callback will be invoked when event's eventPhase attribute value is AT_TARGET.
    
示例
this.node.on(cc.Node.EventType.TOUCH_START, this.memberFunction, this);  // if "this" is component and the "memberFunction" declared in CCClass.
node.on(cc.Node.EventType.TOUCH_START, callback, this.node);
node.on(cc.Node.EventType.TOUCH_MOVE, callback, this.node);
node.on(cc.Node.EventType.TOUCH_END, callback, this.node);
node.on(cc.Node.EventType.TOUCH_CANCEL, callback, this.node);
node.on("anchor-changed", callback, this);
off

删除之前与同类型,回调,目标或 useCapture 注册的回调。

meta description
定义于 cocos2d/core/CCNode.js:1261
参数列表
  • type String A string representing the event type being removed.
  • callback Function The callback to remove.
  • target Object The target (this object) to invoke the callback, if it's not given, only callback without target will be removed
  • useCapture Boolean Specifies whether the callback being removed was registered as a capturing callback or not.
                           If not specified, useCapture defaults to false. If a callback was registered twice,
                           one with capture and one without, each must be removed separately. Removal of a capturing callback
                           does not affect a non-capturing version of the same listener, and vice versa.
    
示例
this.node.off(cc.Node.EventType.TOUCH_START, this.memberFunction, this);
node.off(cc.Node.EventType.TOUCH_START, callback, this.node);
node.off("anchor-changed", callback, this);
targetOff

移除目标上的所有注册事件。

meta description
定义于 cocos2d/core/CCNode.js:1290
参数列表
  • target Object The target to be searched for all related callbacks
示例
node.targetOff(target);
pauseSystemEvents

暂停当前节点上注册的所有节点系统事件,节点系统事件包含触摸和鼠标事件。 如果传递 recursive 为 true,那么这个 API 将暂停本节点和它的子树上所有节点的节点系统事件。 参考:http://cocos.com/docs/creator/scripting/internal-events.html

meta description
定义于 cocos2d/core/CCNode.js:1305
参数列表
  • recursive Boolean Whether to pause node system events on the sub node tree.
示例
node.pauseSystemEvents(true);
resumeSystemEvents

恢复当前节点上注册的所有节点系统事件,节点系统事件包含触摸和鼠标事件。 如果传递 recursive 为 true,那么这个 API 将恢复本节点和它的子树上所有节点的节点系统事件。 参考:http://cocos.com/docs/creator/scripting/internal-events.html

meta description
定义于 cocos2d/core/CCNode.js:1321
参数列表
  • recursive Boolean Whether to resume node system events on the sub node tree.
示例
node.resumeSystemEvents(true);
runAction

执行并返回该执行的动作。该节点将会变成动作的目标。
调用 runAction 时,节点自身处于不激活状态将不会有任何效果。
注意:你不应该修改 runAction 后的动作,将无法发挥作用,如果想进行修改,请在定义 action 时加入。

meta description
返回 Action
定义于 cocos2d/core/CCNode.js:1459
参数列表
示例
var action = cc.scaleTo(0.2, 1, 0.6);
node.runAction(action);
node.runAction(action).repeatForever(); // fail
node.runAction(action.repeatForever()); // right
pauseAllActions

暂停本节点上所有正在运行的动作。和 cc.director.getActionManager().pauseTarget(node); 等价。

meta description
定义于 cocos2d/core/CCNode.js:1491
示例
node.pauseAllActions();
resumeAllActions

恢复运行本节点上所有暂停的动作。和 cc.director.getActionManager().resumeTarget(node); 等价。

meta description
定义于 cocos2d/core/CCNode.js:1502
示例
node.resumeAllActions();
stopAllActions

停止并且移除所有正在运行的动作列表。

meta description
定义于 cocos2d/core/CCNode.js:1513
示例
node.stopAllActions();
stopAction

停止并移除指定的动作。

meta description
定义于 cocos2d/core/CCNode.js:1524
参数列表
  • action Action An action object to be removed.
示例
var action = cc.scaleTo(0.2, 1, 0.6);
node.stopAction(action);
stopActionByTag

停止并且移除指定标签的动作。

meta description
定义于 cocos2d/core/CCNode.js:1537
参数列表
  • tag Number A tag that indicates the action to be removed.
示例
node.stopAction(1);
getActionByTag

通过标签获取指定动作。

meta description
返回 Action
定义于 cocos2d/core/CCNode.js:1553
参数列表
示例
var action = node.getActionByTag(1);
getNumberOfRunningActions

获取运行着的动作加上正在调度运行的动作的总数。
例如:

  • 如果你正在运行 7 个动作中的 1 个 Sequence,它将返回 1。
  • 如果你正在运行 2 个动作中的 7 个 Sequence,它将返回 7。
meta description
返回 Number
定义于 cocos2d/core/CCNode.js:1573
示例
var count = node.getNumberOfRunningActions();
cc.log("Running Action Count: " + count);
getPosition

获取节点在父节点坐标系中的位置(x, y)。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:1602
示例
cc.log("Node Position: " + node.getPosition());
setPosition

设置节点在父节点坐标系中的位置。
可以通过两种方式设置坐标点:

  1. 传入 2 个数值 x 和 y。
  2. 传入 cc.v2(x, y) 类型为 cc.Vec2 的对象。
meta description
定义于 cocos2d/core/CCNode.js:1614
参数列表
  • newPosOrX Vec2 | Number X coordinate for position or the position (x, y) of the node in coordinates
  • y Number Y coordinate for position
示例
node.setPosition(cc.v2(0, 0));
node.setPosition(0, 0);
getScale

获取节点的缩放。当 X 轴和 Y 轴有相同的缩放数值时。

meta description
返回 Number
定义于 cocos2d/core/CCNode.js:1676
示例
cc.log("Node Scale: " + node.getScale());
setScale

设置节点的缩放比例,默认值为 1.0。这个函数可以在同一时间修改 X 和 Y 缩放。

meta description
定义于 cocos2d/core/CCNode.js:1692
参数列表
示例
node.setScale(cc.v2(1, 1));
node.setScale(1, 1);
getContentSize

获取节点自身大小,不受该节点是否被缩放或者旋转的影响。

meta description
返回 Size
定义于 cocos2d/core/CCNode.js:1722
参数列表
  • ignoreSizeProvider Boolean true if you need to get the original size of the node
示例
cc.log("Content Size: " + node.getContentSize());
setContentSize

设置节点原始大小,不受该节点是否被缩放或者旋转的影响。

meta description
定义于 cocos2d/core/CCNode.js:1745
参数列表
  • size Size | Number The untransformed size of the node or The untransformed size's width of the node.
  • height Number The untransformed size's height of the node.
示例
node.setContentSize(cc.size(100, 100));
node.setContentSize(100, 100);
setOpacityModifyRGB

设置更改透明度时是否修改RGB值,

meta description
定义于 cocos2d/core/CCNode.js:1789
参数列表
示例
node.setOpacityModifyRGB(true);
isOpacityModifyRGB

更改透明度时是否修改RGB值。

meta description
返回 Boolean
定义于 cocos2d/core/CCNode.js:1810
示例
var hasChange = node.isOpacityModifyRGB();
getAnchorPoint

获取节点锚点,用百分比表示。
锚点应用于所有变换和坐标点的操作,它就像在节点上连接其父节点的大头针。
锚点是标准化的,就像百分比一样。(0,0) 表示左下角,(1,1) 表示右上角。
但是你可以使用比(1,1)更高的值或者比(0,0)更低的值。
默认的锚点是(0.5,0.5),因此它开始于节点的中心位置。
注意:Creator 中的锚点仅用于定位所在的节点,子节点的定位不受影响。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:1872
示例
cc.log("Node AnchorPoint: " + node.getAnchorPoint());
setAnchorPoint

设置锚点的百分比。
锚点应用于所有变换和坐标点的操作,它就像在节点上连接其父节点的大头针。
锚点是标准化的,就像百分比一样。(0,0) 表示左下角,(1,1) 表示右上角。
但是你可以使用比(1,1)更高的值或者比(0,0)更低的值。
默认的锚点是(0.5,0.5),因此它开始于节点的中心位置。
注意:Creator 中的锚点仅用于定位所在的节点,子节点的定位不受影响。

meta description
定义于 cocos2d/core/CCNode.js:1896
参数列表
  • point Vec2 | Number The anchor point of node or The x axis anchor of node.
  • y Number The y axis anchor of node.
示例
node.setAnchorPoint(cc.v2(1, 1));
node.setAnchorPoint(1, 1);
getAnchorPointInPoints

返回锚点的绝对像素位置。
你只能读它。如果您要修改它,使用 setAnchorPoint。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:1938
示例
cc.log("AnchorPointInPoints: " + node.getAnchorPointInPoints());
getDisplayedOpacity

获取节点显示透明度, 显示透明度和透明度之间的不同之处在于当启用级连透明度时, 显示透明度是基于自身透明度和父节点透明度计算的。

meta description
返回 number
定义于 cocos2d/core/CCNode.js:1955
示例
var displayOpacity = node.getDisplayedOpacity();
getDisplayedColor

获取节点的显示颜色, 显示颜色和颜色之间的不同之处在于当启用级连颜色时, 显示颜色是基于自身颜色和父节点颜色计算的。

meta description
返回 Color
定义于 cocos2d/core/CCNode.js:1985
示例
var displayColor = node.getDisplayedColor();
getNodeToParentTransformAR

返回这个将节点(局部)的空间坐标系转换成父节点的空间坐标系的矩阵。
这个矩阵以像素为单位。
该方法基于节点坐标。

meta description
返回 AffineTransform
定义于 cocos2d/core/CCNode.js:2003
示例
var affineTransform = node.getNodeToParentTransformAR();
getBoundingBox

返回父节坐标系下的轴向对齐的包围盒。

meta description
返回 Rect
定义于 cocos2d/core/CCNode.js:2030
示例
var boundingBox = node.getBoundingBox();
getBoundingBoxToWorld

返回节点在世界坐标系下的对齐轴向的包围盒(AABB)。
该边框包含自身和已激活的子节点的世界边框。

meta description
返回 Rect
定义于 cocos2d/core/CCNode.js:2046
示例
var newRect = node.getBoundingBoxToWorld();
getNodeToParentTransform

返回这个将节点(局部)的空间坐标系转换成父节点的空间坐标系的矩阵。这个矩阵以像素为单位。

meta description
返回 AffineTransform
定义于 cocos2d/core/CCNode.js:2091
示例
var affineTransform = node.getNodeToParentTransform();
getNodeToWorldTransform

返回节点到世界坐标系的仿射变换矩阵。矩阵单位是像素。

meta description
返回 AffineTransform
定义于 cocos2d/core/CCNode.js:2114
示例
var affineTransform = node.getNodeToWorldTransform();
getNodeToWorldTransformAR

返回节点到世界坐标仿射变换矩阵。矩阵单位是像素。
该方法基于节点坐标。

meta description
返回 AffineTransform
定义于 cocos2d/core/CCNode.js:2143
示例
var mat = node.getNodeToWorldTransformAR();
getParentToNodeTransform

返回将父节点的坐标系转换成节点(局部)的空间坐标系的矩阵。
该矩阵以像素为单位。返回的矩阵是只读的,不能更改。

meta description
返回 AffineTransform
定义于 cocos2d/core/CCNode.js:2174
示例
var affineTransform = node.getParentToNodeTransform();
getWorldToNodeTransform
meta description
返回 AffineTransform
定义于 cocos2d/core/CCNode.js:2190
示例
var affineTransform = node.getWorldToNodeTransform();
convertToNodeSpace

将一个点转换到节点 (局部) 坐标系。结果以 Vec2 为单位。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:2220
参数列表
示例
var newVec2 = node.convertToNodeSpace(cc.v2(100, 100));
convertToWorldSpace

将一个点转换到世界空间坐标系。结果以 Vec2 为单位。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:2238
参数列表
示例
var newVec2 = node.convertToWorldSpace(cc.v2(100, 100));
convertToNodeSpaceAR

将一个点转换到节点 (局部) 空间坐标系。结果以 Vec2 为单位。
返回值将基于节点坐标。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:2257
参数列表
示例
var newVec2 = node.convertToNodeSpaceAR(cc.v2(100, 100));
convertToWorldSpaceAR

将一个点转换到世界空间坐标系。结果以 Vec2 为单位。
返回值将基于世界坐标。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:2284
参数列表
示例
var newVec2 = node.convertToWorldSpaceAR(cc.v2(100, 100));
convertTouchToNodeSpace

将触摸点转换成本地坐标系中位置。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:2311
参数列表
  • touch Touch The touch object
示例
var newVec2 = node.convertTouchToNodeSpace(touch);
convertTouchToNodeSpaceAR

转换一个 cc.Touch(世界坐标)到一个局部坐标,该方法基于节点坐标。

meta description
返回 Vec2
定义于 cocos2d/core/CCNode.js:2324
参数列表
  • touch Touch The touch object
示例
var newVec2 = node.convertTouchToNodeSpaceAR(touch);
addChild

添加子节点,并且可以修改该节点的 局部 Z 顺序和标签。

meta description
定义于 cocos2d/core/CCNode.js:2341
参数列表
  • child Node A child node
  • localZOrder Number Z order for drawing priority. Please refer to setZOrder(int)
  • tag Number | String An integer or a name to identify the node easily. Please refer to setTag(int) and setName(string)
示例
node.addChild(newNode, 1, 1001);
cleanup

停止所有正在播放的动作和计时器。

meta description
定义于 cocos2d/core/CCNode.js:2383
示例
node.cleanup();
sortAllChildren

根据子节点的 zIndex 和 arrivalOrder 进行排序,正常情况下开发者不需要手动调用这个函数。

meta description
定义于 cocos2d/core/CCNode.js:2405
getPositionX

获取节点 X 轴坐标。

meta description
返回 Number
定义于 cocos2d/core/CCNode.js:2640
示例
var posX = node.getPositionX();
setPositionX

设置节点 X 轴坐标。

meta description
定义于 cocos2d/core/CCNode.js:2649
参数列表
示例
node.setPositionX(1);
getPositionY

获取节点 Y 轴坐标。

meta description
返回 Number
定义于 cocos2d/core/CCNode.js:2658
示例
var posY = node.getPositionY();
setPositionY

设置节点 Y 轴坐标。

meta description
定义于 cocos2d/core/CCNode.js:2667
参数列表
  • y Number The new position in y axis
示例
node.setPositionY(100);
getLocalZOrder

获取节点局部 Z 轴顺序。

meta description
返回 Number
定义于 cocos2d/core/CCNode.js:2676
示例
var localZorder = node.getLocalZOrder();
setLocalZOrder

LocalZOrder 是 “key” (关键)来分辨节点和它兄弟节点的相关性。 父节点将会通过 LocalZOrder 的值来分辨所有的子节点。 如果两个节点有同样的 LocalZOrder,那么先加入子节点数组的节点将会显示在后加入的节点的前面。 同样的,场景图使用 “In-Order(按顺序)” 遍历数算法来遍历 ( http://en.wikipedia.org/wiki/Tree_traversal#In-order ) 并且拥有小于 0 的 LocalZOrder 的值的节点是 “ left ” 子树(左子树) 所以拥有大于 0 的 LocalZOrder 的值得节点是 “ right ”子树(右子树)。

meta description
定义于 cocos2d/core/CCNode.js:2685
参数列表
示例
node.setLocalZOrder(1);
isCascadeOpacityEnabled

返回节点的不透明度值是否影响其子节点。

meta description
返回 Boolean
定义于 cocos2d/core/CCNode.js:2708
示例
cc.log(node.isCascadeOpacityEnabled());
setCascadeOpacityEnabled

启用或禁用级连不透明度,如果级连启用,子节点的不透明度将是父不透明度乘上它自己的不透明度。

meta description
定义于 cocos2d/core/CCNode.js:2717
参数列表
示例
node.setCascadeOpacityEnabled(true);
attr

属性配置函数。在 attrs 的所有属性将被设置为节点属性。

meta description
定义于 cocos2d/core/utils/base-node.js:436
参数列表
  • attrs Object Properties to be set to node
示例
var attrs = { key: 0, num: 100 };
node.attr(attrs);
getChildByTag

通过标签获取节点的子节点。

meta description
返回 Node
定义于 cocos2d/core/utils/base-node.js:455
参数列表
  • aTag Number An identifier to find the child node.
示例
var child = node.getChildByTag(1001);
getChildByUuid

通过 uuid 获取节点的子节点。

meta description
返回 Node
定义于 cocos2d/core/utils/base-node.js:476
参数列表
  • uuid String The uuid to find the child node.
示例
var child = node.getChildByUuid(uuid);
getChildByName

通过名称获取节点的子节点。

meta description
返回 Node
定义于 cocos2d/core/utils/base-node.js:499
参数列表
  • name String A name to find the child node.
示例
var child = node.getChildByName("Test Node");
insertChild

插入子节点到指定位置

meta description
定义于 cocos2d/core/utils/base-node.js:537
参数列表
  • child Node the child node to be inserted
  • siblingIndex Number the sibling index to place the child in
示例
node.insertChild(child, 2);
getSiblingIndex

获取同级索引。

meta description
返回 number
定义于 cocos2d/core/utils/base-node.js:555
示例
var index = node.getSiblingIndex();
setSiblingIndex

设置节点同级索引。

meta description
定义于 cocos2d/core/utils/base-node.js:572
参数列表
示例
node.setSiblingIndex(1);
removeFromParent

从父节点中删除该节点。如果不传入 cleanup 参数或者传入 true,那么这个节点上所有绑定的事件、action 都会被删除。
因此建议调用这个 API 时总是传入 false 参数。
如果这个节点是一个孤节点,那么什么都不会发生。

meta description
定义于 cocos2d/core/utils/base-node.js:607
参数列表
  • cleanup Boolean true if all actions and callbacks on this node should be removed, false otherwise.
示例
node.removeFromParent();
node.removeFromParent(false);
removeChild

移除节点中指定的子节点,是否需要清理所有正在运行的行为取决于 cleanup 参数。
如果 cleanup 参数不传入,默认为 true 表示清理。

meta description
定义于 cocos2d/core/utils/base-node.js:631
参数列表
  • child Node The child node which will be removed.
  • cleanup Boolean true if all running actions and callbacks on the child node will be cleanup, false otherwise.
示例
node.removeChild(newNode);
node.removeChild(newNode, false);
removeChildByTag

通过标签移除节点中指定的子节点,是否需要清理所有正在运行的行为取决于 cleanup 参数。
如果 cleanup 参数不传入,默认为 true 表示清理。

meta description
定义于 cocos2d/core/utils/base-node.js:659
参数列表
  • tag Number An integer number that identifies a child node
  • cleanup Boolean true if all running actions and callbacks on the child node will be cleanup, false otherwise.
示例
node.removeChildByTag(1001);
node.removeChildByTag(1001, false);
removeAllChildren

移除节点所有的子节点,是否需要清理所有正在运行的行为取决于 cleanup 参数。
如果 cleanup 参数不传入,默认为 true 表示清理。

meta description
定义于 cocos2d/core/utils/base-node.js:685
参数列表
  • cleanup Boolean true if all running actions on all children nodes should be cleanup, false otherwise.
示例
node.removeAllChildren();
node.removeAllChildren(false);
isChildOf

是否是指定节点的子节点?

meta description
返回 Boolean
定义于 cocos2d/core/utils/base-node.js:721
参数列表
示例
node.isChildOf(newNode);
getComponent

获取节点上指定类型的组件,如果节点有附加指定类型的组件,则返回,如果没有则为空。
传入参数也可以是脚本的名称。

meta description
返回 Component
定义于 cocos2d/core/utils/base-node.js:744
参数列表
示例
// get sprite component.
var sprite = node.getComponent(cc.Sprite);
// get custom test calss.
var test = node.getComponent("Test");
getComponents

返回节点上指定类型的所有组件。

meta description
返回 Component[]
定义于 cocos2d/core/utils/base-node.js:771
参数列表
示例
var sprites = node.getComponents(cc.Sprite);
var tests = node.getComponents("Test");
getComponentInChildren

递归查找所有子节点中第一个匹配指定类型的组件。

meta description
返回 Component
定义于 cocos2d/core/utils/base-node.js:792
参数列表
示例
var sprite = node.getComponentInChildren(cc.Sprite);
var Test = node.getComponentInChildren("Test");
getComponentsInChildren

递归查找自身或所有子节点中指定类型的组件

meta description
返回 Component[]
定义于 cocos2d/core/utils/base-node.js:813
参数列表
示例
var sprites = node.getComponentsInChildren(cc.Sprite);
var tests = node.getComponentsInChildren("Test");
addComponent

向节点添加一个指定类型的组件类,你还可以通过传入脚本的名称来添加组件。

meta description
返回 Component
定义于 cocos2d/core/utils/base-node.js:849
参数列表
  • typeOrClassName Function | String The constructor or the class name of the component to add
示例
var sprite = node.addComponent(cc.Sprite);
var test = node.addComponent("Test");
_addComponentAt

This api should only used by undo system

meta description
定义于 cocos2d/core/utils/base-node.js:937
参数列表
removeComponent

删除节点上的指定组件,传入参数可以是一个组件构造函数或组件名,也可以是已经获得的组件引用。 如果你已经获得组件引用,你也可以直接调用 component.destroy()

meta description
定义于 cocos2d/core/utils/base-node.js:983
废弃(Deprecated) please destroy the component to remove it.
参数列表
示例
node.removeComponent(cc.Sprite);
var Test = require("Test");
node.removeComponent(Test);
_getDependComponent
meta description
返回 Component
定义于 cocos2d/core/utils/base-node.js:1011
参数列表
destroyAllChildren

销毁所有子节点,并释放所有它们对其它对象的引用。
实际销毁操作会延迟到当前帧渲染前执行。

meta description
定义于 cocos2d/core/utils/base-node.js:1075
示例
node.destroyAllChildren();
destroy

销毁该对象,并释放所有它对其它对象的引用。
实际销毁操作会延迟到当前帧渲染前执行。从下一帧开始,该对象将不再可用。 您可以在访问对象之前使用 cc.isValid(obj) 来检查对象是否已被销毁。

meta description
返回 Boolean
定义于 cocos2d/core/platform/CCObject.js:296
示例
obj.destroy();
_destruct

Clear all references in the instance.

NOTE: this method will not clear the getter or setter functions which defined in the instance of CCObject. You can override the _destruct method if you need, for example: _destruct: function () { for (var key in this) { if (this.hasOwnProperty(key)) { switch (typeof this[key]) { case 'string': this[key] = ''; break; case 'object': case 'function': this[key] = null; break; } } }

meta description
定义于 cocos2d/core/platform/CCObject.js:428
_onPreDestroy

Called before the object being destroyed.

meta description
定义于 cocos2d/core/platform/CCObject.js:461
_serialize

The customized serialization for this object. (Editor Only)

meta description
返回 object
定义于 cocos2d/core/platform/CCObject.js:486
参数列表
_deserialize

Init this object from the custom serialized data.

meta description
定义于 cocos2d/core/platform/CCObject.js:496
参数列表
  • data Object the serialized json data
  • ctx _Deserializer
once

注册事件目标的特定事件类型回调,回调会在第一时间被触发后删除自身。

meta description
定义于 cocos2d/core/event/event-target.js:352
参数列表
  • type String A string representing the event type to listen for.
  • callback Function The callback that will be invoked when the event is dispatched.
                           The callback is ignored if it is a duplicate (the callbacks are unique).
    
  • target Object The target (this object) to invoke the callback, can be null
  • useCapture Boolean When set to true, the capture argument prevents callback
                           from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE.
                           When false, callback will NOT be invoked when event's eventPhase attribute value is CAPTURING_PHASE.
                           Either way, callback will be invoked when event's eventPhase attribute value is AT_TARGET.
    
示例
node.once(cc.Node.EventType.TOUCH_END, function (event) {
    cc.log("this is callback");
}, node);
dispatchEvent

分发事件到事件流中。

meta description
定义于 cocos2d/core/event/event-target.js:397
参数列表
  • event Event The Event object that is dispatched into the event flow
emit

该对象直接发送事件, 这种方法不会对事件传播到任何其他对象。

meta description
定义于 cocos2d/core/event/event-target.js:411
参数列表
  • message String the message to send
  • detail Any whatever argument the message needs

事件

position-changed Event

模块: cc

索引

Details

size-changed Event

模块: cc

索引

Details

anchor-changed Event

模块: cc

索引

Details

child-added Event

模块: cc

索引

Details

child-removed Event

模块: cc

索引

Details

child-reorder Event

模块: cc

索引

Details

group-changed Event

模块: cc

索引

Details

touchstart Event

模块: cc

索引

Details

active-in-hierarchy-changed Event

模块: cc 父模块: cc

注意:此节点激活时,此事件仅从最顶部的节点发出。

索引

Details

results matching ""

    No results matching ""