SKSpriteNode类

继承自	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。