| 继承自 | NSObject |
| 符合 | NSCoding NSCopying NSObject(NSObject) |
| 框架 | /System/Library/Frameworks/SpriteKit.framework |
| 可用性 | 可用于iOS 7.0或者更晚的版本 |
| 声明于 | SKTexture.h |
| 参考指南 | Sprite Kit Progamming Guide |
概览
| 重要提示：这是一个初步的API或者开发技术文档。虽然已经审阅了本文档的技术准确性，但是它不是最终的版本。本机密信息仅适用于苹果开发者计划的注册会员。苹果提供这些机密信息来帮助你采用这些技术和编程接口。此信息如果有变更，根据本文档实现的软件应使用操作系统软件和最终文档测试。新版本的文档可能会拥有新的API或者技术。 |
一个SKTexture实例代表一个可复用的图片，通常用在SKSpriteNode中。重用纹理实例使Sprite Kit处理和渲染精灵更有效率。
你可以通过保存在app包中的图片文件，Quartz图片，原始像素数据来创建纹理。你也可以通过使用一个CG滤镜在原纹理的基础上创建一个新的纹理，或者用一个纹理的部分区域创建新纹理。
如果你频繁地使用一组纹理，不要分开加载这些图片。你可以使用一个纹理集来创建这些纹理。使用纹理集通常可以降低总内存以及提升渲染性能。
子类注意事项
这个类不能被继承。
方法
类方法
创建一个新的纹理实例。
| + textureWithImageNamed: |
通过一个在app包中的图片文件创建纹理。
+ (SKTexture *)textureWithImageNamed:(NSString *)name
| 参数 | name:图片文件的名字 |
| 返回值 | 一个新的纹理实例 |
论述
纹理第一次渲染到场景的时候，纹理图片的数据自动加载。
Sprite Kit根据一个指定的文件名，在app包中寻找这个图片。如果找不到这个图片，Sprite Kit在app包得中任何一个纹理集中寻找。如果包中的任何位置都找不到这个图片，Sprite Kit将创建一个图片占位符。
| + textureWithImage: |
通过一个NSImage实例创建纹理。
+ (SKTexture *)textureWithImage:(NSImage *)image
| 参数 | image:一个NSImage实例 |
| 返回值 | 一个新的纹理实例 |
| + textureWithCGImage: |
通过一个Quartz 2D图片创建纹理。
+ (SKTexture *)textureWithCGImage:(CGImageRef)image
| 参数 | image:一个CGImageRef实例 |
| 返回值 | 一个新的纹理实例 |
论述
图片数据将会被复制到新的纹理实例中。
| + textureWithData:size: |
通过原始像素数据创建纹理。
+ (SKTexture *)textureWithData:(NSData *)pixelData size:(CGSize)size
| 参数 | pixelData:一个NSData实例，必须是32色，颜色应该已乘过alpha size:纹理的大小 |
| 返回值 | 一个新的纹理实例 |
论述
图片数据将会被复制到新的纹理实例中。
| + textureWithData:size:rowLength:alignment: |
通过自定义格式的原始像素数据创建纹理。
实例方法
创建一个新的纹理实例
| - textureByApplyingCIFilter: |
- (SKTexture *)textureByApplyingCIFilter:(CIFilter *)filter
| 参数 | filter:一个CG滤镜需要一个单独的输入图片和单独的输出图片 |
| 返回值 | 一个新的纹理实例 |
查看纹理的属性
| - size |
纹理的大小。
- (CGSize)size
| 参数 | |
| 返回值 | 纹理的尺寸 |
| - textureRect |
一个矩形，定义了纹理用于渲染的部分。
- (CGRect)textureRect
| 参数 | |
| 返回值 | 一个矩形，以单元坐标空间表示 |
论述
默认值是矩形覆盖整个纹理(0,0)-(1,1)。你可以直接设置这个值。如果只是要使用纹理的一部分，调用textureWithRect:inTexture:方法来创建一个新的纹理。
加载和卸载纹理
| - preload |
预加载纹理图片。
- (void)preload
论述
当精灵绘制一个纹理时，纹理实例自动加载图片数据然后使图形硬件可用它。然而，这个加载过程是需要时间的。如果一帧中需要加载的纹理太多，这一帧将会花费很长时间来渲染，帧速率会降低。使用预加载可以使纹理加载遍布一系列的帧中。当一个纹理在不久的将来使用时，可以使用这个方法。
常量
typedef NS_ENUM(NSInteger,
SKTextureFilteringMode){
SKTextureFilteringNearest,
SKTextureFilteringLinear,
}
| SKTextureFilteringNearest | 每个像素点使用最近的像素点绘制，速度较快，结果通常是像素化的。 |
| SKTextureFilteringLinear | 每个像素使用一个多个像素的线性滤镜，质量较高，速度较慢。 |