SpriteFrame 类型

继承于 Asset, EventTarget(mixin)

模块: cc父模块: cc

一个 SpriteFrame 包含:

  • 纹理:会被渲染组件使用的 Texture2D 对象。
  • 矩形:在纹理中的矩形区域。

索引

属性(properties)
  • insetTop Number sprite 的顶部边框
  • insetBottom Number sprite 的底部边框
  • insetLeft Number sprite 的左边边框
  • insetRight Number sprite 的左边边框
  • loaded Boolean 该资源是否已经成功加载
  • nativeUrl String 返回该资源对应的目标平台资源的 URL,如果没有将返回一个空字符串。
  • _native String Serializable url for native asset.
  • _nativeAsset Object The underlying native asset of this asset if one is available….
  • _uuid String
  • _name String
  • _objFlags Number
  • name String 该对象的名称。
  • isValid Boolean 表示该对象是否可用(被 destroy 后将不可用)。
方法
  • constructor SpriteFrame 类的构造函数。
  • textureLoaded 返回是否已加载纹理
  • isRotated 获取 SpriteFrame 是否旋转
  • setRotated 设置 SpriteFrame 是否旋转
  • getRect 获取 SpriteFrame 的纹理矩形区域
  • setRect 设置 SpriteFrame 的纹理矩形区域
  • getOriginalSize 获取修剪前的原始大小
  • setOriginalSize 设置修剪前的原始大小
  • getTexture 获取使用的纹理实例
  • getOffset 获取偏移量
  • setOffset 设置偏移量
  • clone 克隆 SpriteFrame
  • setTexture 通过 Texture,rect,rotated,offset 和 originalSize 设置 SpriteFrame。
  • ensureLoadTexture 当加载中的场景或 Prefab 被标记为 asyncLoadAssets 时,用户在场景中由自定义组件关联到的所有 SpriteFrame 的贴图都不会被提前加载。
  • clearTexture 当你暂时不再使用这个 SpriteFrame 时,可以调用这个方法来保证引用的贴图对象能被 GC。
  • toString Returns the asset's url….
  • serialize 应 AssetDB 要求提供这个方法
  • createNode 使用该资源在场景中创建一个新节点。
  • _setRawAsset Set native file name for this asset.
  • hasEventListener 检查事件目标对象是否有为特定类型的事件注册的回调。
  • on 注册事件目标的特定事件类型回调。
  • off 删除之前用同类型,回调,目标或 useCapture 注册的事件监听器,如果只传递 type,将会删除 type 类型的所有事件监听器。
  • targetOff 在当前 EventTarget 上删除指定目标(target 参数)注册的所有事件监听器。
  • once 注册事件目标的特定事件类型回调,回调会在第一时间被触发后删除自身。
  • emit 通过事件名发送自定义事件
  • dispatchEvent 通过事件对象派发事件
  • 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.

Details

属性(properties)

insetTop
sprite 的顶部边框
metadescription
类型Number
定义于cocos2d/core/assets/CCSpriteFrame.js:99
insetBottom
sprite 的底部边框
metadescription
类型Number
定义于cocos2d/core/assets/CCSpriteFrame.js:118
insetLeft
sprite 的左边边框
metadescription
类型Number
定义于cocos2d/core/assets/CCSpriteFrame.js:137
insetRight
sprite 的左边边框
metadescription
类型Number
定义于cocos2d/core/assets/CCSpriteFrame.js:156
loaded
该资源是否已经成功加载
metadescription
类型Boolean
定义于cocos2d/core/assets/CCAsset.js:57
nativeUrl
返回该资源对应的目标平台资源的 URL,如果没有将返回一个空字符串。
metadescription
类型String
定义于cocos2d/core/assets/CCAsset.js:70
_native
Serializable url for native asset.
metadescription
类型String
定义于cocos2d/core/assets/CCAsset.js:108
_nativeAsset
The underlying native asset of this asset if one is available.This property can be used to access additional details or functionality releated to the asset.This property will be initialized by the loader if _native is available.
metadescription
类型Object
定义于cocos2d/core/assets/CCAsset.js:116
_uuid

metadescription
类型String
定义于cocos2d/core/assets/CCRawAsset.js:46
_name

metadescription
类型String
定义于cocos2d/core/platform/CCObject.js:76
_objFlags

metadescription
类型Number
定义于cocos2d/core/platform/CCObject.js:83
name
该对象的名称。
metadescription
类型String
定义于cocos2d/core/platform/CCObject.js:243
示例
  1. obj.name = "New Obj";
isValid
表示该对象是否可用(被 destroy 后将不可用)。当一个对象的 destroy 调用以后,会在这一帧结束后才真正销毁。因此从下一帧开始 isValid 就会返回 false,而当前帧内 isValid 仍然会是 true。如果希望判断当前帧是否调用过 destroy,请使用 cc.isValid(obj, true),不过这往往是特殊的业务需求引起的,通常情况下不需要这样。
metadescription
类型Boolean
定义于cocos2d/core/platform/CCObject.js:261
示例
  1. var node = new cc.Node();
  2. cc.log(node.isValid); // true
  3. node.destroy();
  4. cc.log(node.isValid); // true, still valid in this frame
  5. // after a frame...
  6. cc.log(node.isValid); // false, destroyed in the end of last frame

方法

constructor

SpriteFrame 类的构造函数。

metadescription
定义于cocos2d/core/assets/CCSpriteFrame.js:176
参数列表
  • filename String | Texture2D
  • rect Rect
  • rotated Boolean Whether the frame is rotated in the texture
  • offset Vec2 The offset of the frame in the texture
  • originalSize Size The size of the frame in the texture
textureLoaded

返回是否已加载纹理

metadescription
返回boolean
定义于cocos2d/core/assets/CCSpriteFrame.js:234
isRotated

获取 SpriteFrame 是否旋转

metadescription
返回Boolean
定义于cocos2d/core/assets/CCSpriteFrame.js:244
setRotated

设置 SpriteFrame 是否旋转

metadescription
定义于cocos2d/core/assets/CCSpriteFrame.js:254
参数列表
getRect

获取 SpriteFrame 的纹理矩形区域

metadescription
返回Rect
定义于cocos2d/core/assets/CCSpriteFrame.js:266
setRect

设置 SpriteFrame 的纹理矩形区域

metadescription
定义于cocos2d/core/assets/CCSpriteFrame.js:276
参数列表
getOriginalSize

获取修剪前的原始大小

metadescription
返回Size
定义于cocos2d/core/assets/CCSpriteFrame.js:288
setOriginalSize

设置修剪前的原始大小

metadescription
定义于cocos2d/core/assets/CCSpriteFrame.js:298
参数列表
getTexture

获取使用的纹理实例

metadescription
返回Texture2D
定义于cocos2d/core/assets/CCSpriteFrame.js:313
getOffset

获取偏移量

metadescription
返回Vec2
定义于cocos2d/core/assets/CCSpriteFrame.js:378
setOffset

设置偏移量

metadescription
定义于cocos2d/core/assets/CCSpriteFrame.js:388
参数列表
clone

克隆 SpriteFrame

metadescription
返回SpriteFrame
定义于cocos2d/core/assets/CCSpriteFrame.js:398
setTexture

通过 Texture,rect,rotated,offset 和 originalSize 设置 SpriteFrame。

metadescription
返回Boolean
定义于cocos2d/core/assets/CCSpriteFrame.js:408
参数列表
ensureLoadTexture

当加载中的场景或 Prefab 被标记为 asyncLoadAssets 时,用户在场景中由自定义组件关联到的所有 SpriteFrame 的贴图都不会被提前加载。只有当 Sprite 组件要渲染这些 SpriteFrame 时,才会检查贴图是否加载。如果你希望加载过程提前,你可以手工调用这个方法。

metadescription
定义于cocos2d/core/assets/CCSpriteFrame.js:463
示例
  1. if (spriteFrame.textureLoaded()) {
  2. this._onSpriteFrameLoaded();
  3. }
  4. else {
  5. spriteFrame.once('load', this._onSpriteFrameLoaded, this);
  6. spriteFrame.ensureLoadTexture();
  7. }
clearTexture

当你暂时不再使用这个 SpriteFrame 时,可以调用这个方法来保证引用的贴图对象能被 GC。然后当你要渲染 SpriteFrame 时,你需要手动调用 ensureLoadTexture 来重新加载贴图。

metadescription
定义于cocos2d/core/assets/CCSpriteFrame.js:495
示例
  1. spriteFrame.clearTexture();
  2. // when you need the SpriteFrame again...
  3. spriteFrame.once('load', onSpriteFrameLoaded);
  4. spriteFrame.ensureLoadTexture();
toString

Returns the asset's url.

The Asset object overrides the toString() method of the Object object.For Asset objects, the toString() method returns a string representation of the object.JavaScript calls the toString() method automatically when an asset is to be represented as a text value or when a texture is referred to in a string concatenation.

metadescription
返回String
定义于cocos2d/core/assets/CCAsset.js:165
serialize

应 AssetDB 要求提供这个方法

metadescription
返回String
定义于cocos2d/core/assets/CCAsset.js:179
createNode

使用该资源在场景中创建一个新节点。如果这类资源没有相应的节点类型,该方法应该是空的。

metadescription
定义于cocos2d/core/assets/CCAsset.js:190
参数列表
_setRawAsset

Set native file name for this asset.

metadescription
定义于cocos2d/core/assets/CCAsset.js:205
参数列表
hasEventListener

检查事件目标对象是否有为特定类型的事件注册的回调。

metadescription
返回Boolean
定义于cocos2d/core/event/event-target.js:68
参数列表
  • type String The type of event.
on

注册事件目标的特定事件类型回调。这种类型的事件应该被 emit 触发。

metadescription
返回Function
定义于cocos2d/core/event/event-target.js:76
参数列表
  • type String A string representing the event type to listen for.
  • callback Function The callback that will be invoked when the event is dispatched.
  1. The callback is ignored if it is a duplicate (the callbacks are unique).
  • arg1 Any arg1
  • arg2 Any arg2
  • arg3 Any arg3
  • arg4 Any arg4
  • arg5 Any arg5
    • target Object The target (this object) to invoke the callback, can be null
示例
  1. eventTarget.on('fire', function () {
  2. cc.log("fire in the hole");
  3. }, node);
off

删除之前用同类型,回调,目标或 useCapture 注册的事件监听器,如果只传递 type,将会删除 type 类型的所有事件监听器。

metadescription
定义于cocos2d/core/event/event-target.js:116
参数列表
  • 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
示例
  1. // register fire eventListener
  2. var callback = eventTarget.on('fire', function () {
  3. cc.log("fire in the hole");
  4. }, target);
  5. // remove fire event listener
  6. eventTarget.off('fire', callback, target);
  7. // remove all fire event listeners
  8. eventTarget.off('fire');
targetOff

在当前 EventTarget 上删除指定目标(target 参数)注册的所有事件监听器。这个函数无法删除当前 EventTarget 的所有事件监听器,也无法删除 target 参数所注册的所有事件监听器。这个函数只能删除 target 参数在当前 EventTarget 上注册的所有事件监听器。

metadescription
定义于cocos2d/core/event/event-target.js:150
参数列表
  • target Object The target to be searched for all related listeners
once

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

metadescription
定义于cocos2d/core/event/event-target.js:163
参数列表
  • type String A string representing the event type to listen for.
  • callback Function The callback that will be invoked when the event is dispatched.
  1. The callback is ignored if it is a duplicate (the callbacks are unique).
  • arg1 Any arg1
  • arg2 Any arg2
  • arg3 Any arg3
  • arg4 Any arg4
  • arg5 Any arg5
    • target Object The target (this object) to invoke the callback, can be null
示例
  1. eventTarget.once('fire', function () {
  2. cc.log("this is the callback and will be invoked only once");
  3. }, node);
emit

通过事件名发送自定义事件

metadescription
定义于cocos2d/core/event/event-target.js:200
参数列表
  • type String event type
  • arg1 Any First argument
  • arg2 Any Second argument
  • arg3 Any Third argument
  • arg4 Any Fourth argument
  • arg5 Any Fifth argument
示例
  1. eventTarget.emit('fire', event);
  2. eventTarget.emit('fire', message, emitter);
dispatchEvent

通过事件对象派发事件

metadescription
定义于cocos2d/core/event/event-target.js:220
参数列表
destroy

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

metadescription
返回Boolean
定义于cocos2d/core/platform/CCObject.js:296
示例
  1. 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; } } }

metadescription
定义于cocos2d/core/platform/CCObject.js:430
_onPreDestroy

Called before the object being destroyed.

metadescription
定义于cocos2d/core/platform/CCObject.js:463
_serialize

The customized serialization for this object. (Editor Only)

metadescription
返回object
定义于cocos2d/core/platform/CCObject.js:488
参数列表
_deserialize

Init this object from the custom serialized data.

metadescription
定义于cocos2d/core/platform/CCObject.js:498
参数列表
  • data Object the serialized json data
  • ctx _Deserializer