继承自 | SKNode:UIResponder:NSObject |
符合 | NSCoding(SKNode) NSCopying(SKNode) NSObject(NSObject) |
框架 | /System/Library/Frameworks/SpriteKit.framework |
可用性 | 可用于iOS 7.0或者更晚的版本 |
声明于 | SKSpriteNode.h |
参考指南 | Sprite Kit Progamming Guide |
概览
重要提示:这是一个初步的API或者开发技术文档。虽然已经审阅了本文档的技术准确性,但是它不是最终的版本。本机密信息仅适用于苹果开发者计划的注册会员。苹果提供这些机密信息来帮助你采用这些技术和编程接口。此信息如果有变更,根据本文档实现的软件应使用操作系统软件和最终文档测试。新版本的文档可能会拥有新的API或者技术。 |
一个SKSpriteNode实例是一个节点,可以绘制带图片,有色方块,经过颜色混合的图片。
类方法
创建一个新的实例
+ spriteNodeWithColor:size: |
创建并返回一个有色的精灵。
+ (id)spriteNodeWithColor:(SKColor *)color size:(CGSize)size
参数 | color:精灵的颜色 size:精灵的大小 |
返回值 | 一个创建好的并初始化好的精灵实例 |
+ spriteNodeWithImageNamed: |
通过图片文件创建并返回一个纹理精灵。
+ (id)spriteNodeWithImageNamed:(NSString *)name
参数 | name:放在项目中的图片文件的名字 |
返回值 | 一个创建好的并初始化好的精灵实例 |
+ spriteNodeWithTexture: |
通过纹理实例创建并返回一个纹理精灵。
+ (id)spriteNodeWithTexture:(SKTexture *)texture
参数 | texture:一个Sprite Kit纹理实例 |
返回值 | 一个创建好的并初始化好的精灵实例 |
+ spriteNodeWithTexture:size: |
通过纹理实例创建并返回一个纹理精灵并制定大小。
+ (id)spriteNodeWithTexture:(SKTexture *)texture size:(CGSize)size
参数 | texture:一个Sprite Kit纹理实例 size:精灵的大小 |
返回值 | 一个创建好的并初始化好的精灵实例 |
实例方法
初始化一个新的实例
- initWithColor:size: |
使用颜色和大小初始化一个精灵。
- (id)initWithColor:(SKColor *)color size:(CGSize)size
参数 | color:精灵的颜色 size:精灵的大小 |
返回值 | 一个新的初始化好的精灵实例 |
论述
通过这个方法返回的精灵实例,它的texture属性值为nil。
- initWithImageNamed: |
使用图片文件初始化一个精灵。
- (id)initWithImageNamed:(NSString *)name
参数 | name:放在项目中的图片文件的名字 |
返回值 | 一个新的初始化好的精灵实例 |
论述
这个方法会创建一个新的纹理实例,并且把这个实例分配给texture属性。精灵的size属性是由图片的大小来决定的。颜色属性为白色(1.0,1.0,1.0)。
- initWithTexture: |
使用一个纹理实例初始化一个精灵。
- (id)initWithTexture:(SKTexture *)texture
参数 | texture:一个Sprite Kit纹理 |
返回值 | 一个新的初始化好的精灵实例 |
论述
精灵的size属性是由纹理的大小来决定的。颜色属性为白色(1.0,1.0,1.0)。
- initWithImageTexture:color:size: |
使用一个纹理实例和一个颜色初始化一个精灵。
- (id)initWithTexture:(SKTexture *)texture color:(SKColor *)color size:(CGSize)size
参数 | texture:一个Sprite Kit纹理 color:精灵的颜色 size:精灵的大小 |
返回值 | 一个新的初始化好的精灵实例 |
论述
要给纹理混合颜色,你还需要设置精灵的colorBlendFactor属性。
属性
查看物理属性
size |
精灵的大小。
@property(atomic) CGSize size
anchorPoint |
精灵的参考点。
@property(atomic) CGPoint anchorPoint
论述
你指定一个位于单元坐标空间的值。默认值为(0.5,0.5),表示精灵的参考点在正中。
查看精灵的纹理
texture |
精灵的纹理
@property(atomic, retain) SKTexture *texture
论述
如果该值为nil,精灵将会使用颜色属性绘制一个颜色矩形。否则,精灵将会绘制这个纹理。相关的属性影响了纹理的应用。
centerRect |
定义了纹理是如何应用到精灵的。
@property(atomic) CGRect centerRect
论述
这个矩形在单元坐标空间中。默认值为(0,0)-(1.0,1.0),表示整个纹理被拉伸到充满精灵。如果指定一个不同的矩形,矩形的坐标会变成一个3X3网格。网格的四个角不经过缩放直接应用。它的上和中下部分将水平缩放,左和中右部分将垂直缩放。中心是所有方向缩放。
colorBlendFactor |
一个浮点point,描述了颜色是怎样与纹理混合的。
@property(atomic) CGFloat colorBlendFactor
论述
该值必须在0.0到1.0之间。默认值为0.0,表示颜色属性将被忽视,纹理的值不做任何改变。如果是一个大于0.0的值,纹理将与颜色混合,然后再绘制到场景。
查看颜色属性
color |
纹理的颜色
@property(atomic, retain) SKColor *color
论述
如果纹理属性非空,那么颜色的红绿蓝值将会混合到纹理,然后绘制到场景,alpha属性将被忽视。如果纹理属性为nil,那么颜色属性将会被用于绘制一个颜色矩形。
blendMode |
将精灵绘制到父缓冲区的混合模式。
@property(atomic) SKBlendMode blendMode
论述
默认值为SKBlendModeAlpha。