| 继承自 | SKNode:UIResponder:NSObject |
| 符合 | NSCoding(SKNode) NSCopying(SKNode) NSObject(NSObject) |
| 框架 | /System/Library/Frameworks/SpriteKit.framework |
| 可用性 | 可用于iOS 7.0或者更晚的版本 |
| 声明于 | SKEmitterNode.h |
| 参考指南 | Sprite Kit Progamming Guide |
概览
| 重要提示：这是一个初步的API或者开发技术文档。虽然已经审阅了本文档的技术准确性，但是它不是最终的版本。本机密信息仅适用于苹果开发者计划的注册会员。苹果提供这些机密信息来帮助你采用这些技术和编程接口。此信息如果有变更，根据本文档实现的软件应使用操作系统软件和最终文档测试。新版本的文档可能会拥有新的API或者技术。 |
一个SKEmitterNode实例，是一个自动创建和渲染粒子的节点。粒子有点类似于节点，但是它不能像节点那样访问方法，也不能给它关联上动作。粒子发射器经常被用于创建烟雾，雨，火花等粒子效果。
一个粒子是一个被混合后添加到帧缓冲区的节点，这个节点有质感和颜色。当你配置一个粒子发射器的时候，你需要设置粒子的生产速率以及每个粒子的属性。这些粒子有以下的属性：
| 粒子的位置 |
| 粒子的速度 |
| 粒子的旋转和缩放量 |
| 粒子的颜色以及混合粒子纹理的混合因子 |
| 粒子的alpha值和混合模式 |
| 粒子的生命周期 |
对于每一个属性，你需要配置一个平均的初始值，以及一个值域。粒子发射器会在值域内选择一个随机值。
有一些属性还允许你指定一个速度，或者加速度属性，以便于在粒子的生命周期内修改粒子属性的值。例如，粒子发射器创建了一些粒子，并将这些粒子的alpha值初始为1.0，alpha值的变换速度初始为-0.2，这样的话，这些粒子的alpha值将在5秒内，从1.0变为0.0，也就是说粒子从创建开始到消失，一共花了5秒。你可以使用关键帧序列来实现一些更为复杂的粒子变换。
当粒子创建好之后需要确定的事项
实例方法
| - advanceSimulationTime: |
促进发射器粒子仿真。
- (void)advanceSimulationTime:(NSTimeInterval)sec
| 参数 | sec：粒子仿真所需秒数 |
| 返回值 | void |
论述
一个粒子发射器一旦添加到场景中，将自动的在新的动画帧里创建新的粒子。这个方法允许你人为地促进粒子仿真，使他可以生成新的粒子以及推进现有的粒子。这个方法通常的用法是，通过一个首次添加到场景中的粒子，来预填充粒子发射器节点。
| - resetSimulation |
移除所有已经存在的粒子，并重新启用粒子仿真。
- (void)resetSimulation
论述
重置粒子仿真，清楚粒子仿真的内部状态。
属性
| particleBirthRate |
粒子生产速率。
@property (atomic) CGFloat particleBirthRate
论述
粒子每秒钟产生的数量，默认值为0.0。
| numParticleToEmit |
粒子发射器在停止前需要发射的粒子数量。
@property (atomic) NSUInteger numParticleToEmit
论述
默认值为0，表示粒子发射器将无限发射粒子。如果提供一个非零的值，发射器将发射指定数量的粒子，然后停止。
决定发射粒子的节点
| targetNode |
渲染粒子的目标节点。
@property (atomic, weak) SKNode *targetNode
论述
默认值为nil，这种情况下，粒子就相当于是粒子发射节点的子节点。在未来的帧动画中，粒子的位置将受粒子节点的属性的影响。如果你另外指定一个目标节点，新产生的粒子将受粒子发射器的影响，而其他的粒子则受你指定的那个目标节点的影响。
例如，假设你有一个粒子发射器节点，这个节点是场景节点的子节点，这个节点绕着Z轴旋转。发射器节点的行为将根据目标节点的值来改变。
| 如果targetNode属性为nil，那么粒子的位置只受发射器节点影响。 |
| 如果目标节点指向发射器节点，新产生的粒子随着发射器改变，以前产生的粒子随着目标节点改变。 |
添加到场景中的粒子，将不受发射器的控制而独立的运动。
决定一个粒子的生命周期。
| particleLifetime |
粒子的平均生命周期，以秒为单位。
@property (atomic) CGFloat particleLifetime
论述
默认值为0.0。
| particleLifetimeRange |
粒子的生命周期，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleLifetimeRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的生命周期是一个随机的值，这个值可能在值域的一半左右浮动。
决定一个粒子的初始位置。
| particlePosition |
粒子的平均初始位置。
@property (atomic) CGPoint particlePosition
论述
默认值为(0.0,0.0)。
| particlePositionRange |
粒子的初始位置，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGPoint particlePositionRange
论述
默认值为(0.0,0.0)。如果值为非零的时候，每个粒子的位置是一个随机的值，这个值可能在值域的一半左右浮动。
| particleZPosition |
粒子的平均初始深度。
@property (atomic) CGFloat particleZPosition
论述
默认值为0.0。
| particleZPositionRange |
粒子的初始深度，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleZPositionRange
论述
粒子的初始深度，如果值为非零的时候，每个粒子的位置是一个随机的值，这个值可能在值域的一半左右浮动。
决定一个粒子的速度和加速度。
| particleSpeed |
粒子的平均初始速度。
@property (atomic) CGFloat particleSpeed
论述
默认值为0.0。
| particleSpeedRange |
粒子的初始速度，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleSpeedRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的速度是一个随机的值，这个值可能在值域的一半左右浮动。
| emissionAngle |
粒子的平均初始方向，以弧度表示。
@property (atomic) CGFloat emissionAngle
论述
默认值为0.0。
| emissionAngleRange |
粒子的初始方向，这个值是一个允许的值域范围内的随机值，以弧度表示。
@property (atomic) CGFloat emissionAngle
论述
默认值为0.0。如果值为非零的时候，每个粒子的速度是一个随机的值，这个值可能在值域的一半左右浮动。
| xAcceleration |
粒子的水平加速度。
@property (atomic) CGFloat xAccleration
论述
这个属性在模拟风、重力等效果的时候非常有用。它是平均作用在所有的粒子上面的。默认值为0.0。
| yAcceleration |
粒子的垂直加速度。
@property (atomic) CGFloat yAccleration
论述
这个属性在模拟风、重力等效果的时候非常有用。它是平均作用在所有的粒子上面的。默认值为0.0。
决定一个粒子的旋转。
| particleRatation |
粒子的平均初始旋转，以弧度为单位。
@property (atomic) CGFloat particleRatation
论述
默认值为0.0。
| particleRatationRange |
粒子的初始旋转，这个值是一个允许的值域范围内的随机值，以弧度为单位。
@property (atomic) CGFloat particleRatationRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的旋转是一个随机的值，这个值可能在值域的一半左右浮动。
| particleRatationSpeed |
粒子的旋转速度，以弧度每秒为单位。
@property (atomic) CGFloat particleRatationSpeed
论述
默认值为0.0。它作用于所有粒子，默认值为0.0。
决定一个粒子的缩放因子。
| particleScaleSequence |
一个缩放序列，用于指定粒子的缩放因子。
@property (atomic) SKKeyframeSequence particleScaleSequence
论述
默认值为nil。如果值为非零的时候，particleScale属性，particleScaleRange属性和particleScaleSpeed属性将被忽略。这时候用这个缩放序列来指定粒子的缩放因子。
| particleScale |
粒子的平均缩放因子。
@property (atomic) CGFloat particleScale
论述
默认值为1.0。
| particleScaleRange |
粒子的缩放因子,这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleScaleRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的缩放因子是一个随机的值，这个值可能在值域的一半左右浮动。
| particleScaleSpeed |
粒子的缩放速度。
@property (atomic) CGFloat particleScaleSpeed
论述
默认值为0.0。
设置粒子的纹理和大小。
| particleTexture |
粒子渲染的纹理。
@property (atomic, retain) SKTexture *particleTexture
论述
一个粒子的渲染就类似于一个精灵的渲染。这个属性的默认值为nil，这表示渲染的就是一个带有颜色的矩形。如果是一个非零的值，将会用一个彩色的纹理渲染粒子。
| particleSize |
每个粒子的初始大小。
@property (atomic) CGSize particleSize
论述
默认值为CGSizeZero。如果使用默认值，粒子的大小将会根据纹理的大小来决定。如果粒子还没有纹理，你必须给粒子的大小赋上一个非空的值。
配置粒子的颜色。
| particleColorSequence |
一个颜色序列，用于指定粒子的颜色。
@property (atomic) SKKeyframeSequence *particleColorSequence
论述
默认值为nil。如果该属性为一个非空的值，则particleColor属性，particleColorAlphaRange属性，particleColorRedRange属性，particleColorGreenRange属性,particleColorBlueRange属性，particleColorAlphaSpeed属性，particleColorRedSpeed属性，particleColorGreenSpeed属性，particleColorBlueSpeed属性将被忽略，粒子将通过颜色序列来指定粒子颜色。
| particleColor |
一个粒子的平均初始颜色。
@property (atomic, retain) SKColor *particleColor
论述
默认值为[SKColor clearColor]。一个粒子的颜色通过一个混合因子与纹理混合。具体参见“决定如何混合粒子颜色和纹理”部分。
| particleColorAlphaRange |
粒子颜色的初始alpha值，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleColorAlphaRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的初始alpha值是一个随机的值，这个值可能在值域的一半左右浮动。
| particleColoBlueRange |
粒子颜色的初始蓝色的值，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleColoBlueRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的初始蓝色值是一个随机的值，这个值可能在值域的一半左右浮动。
| particleColoGreenRange |
粒子颜色的初始绿色的值，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleColoGreenRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的初始绿色值是一个随机的值，这个值可能在值域的一半左右浮动。
| particleColoRedRange |
粒子颜色的初始红色的值，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleColoRedRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的初始红色值是一个随机的值，这个值可能在值域的一半左右浮动。
| particleColoAlphaSpeed |
粒子alpha值的变化速度。
@property (atomic) CGFloat particleColoAlphaSpeed
论述
默认值为0.0。
| particleColoBlueSpeed |
粒子蓝色值的变化速度。
@property (atomic) CGFloat particleColoBlueSpeed
论述
默认值为0.0。
| particleColoGreenSpeed |
粒子绿色值的变化速度。
@property (atomic) CGFloat particleColoGreenSpeed
论述
默认值为0.0。
| particleColoRedSpeed |
粒子红色值的变化速度。
@property (atomic) CGFloat particleColoRedSpeed
论述
默认值为0.0。
决定如何混合粒子的颜色和纹理。
| particleColoBlendFactorSequence |
一个混合因子序列，用于混合粒子的颜色和纹理。
@property (atomic) SKKeyframeSequence *particleColoBlendFactorSequence
论述
默认值为0.0。如果该属性为一个非空的值，则particleColorBlendFactor属性，particleColorBlendFactorRange属性和particleColorBlendFactorSpeed属性将被忽略。粒子将通过混合因子序列来混合粒子的颜色和纹理。
| particleColoBlendFactor |
一个平均的初始值，用做颜色混合因子。
@property (atomic) CGFloat particleColoBlendFactor
论述
默认值为0.0，这表示使用纹理，忽略粒子颜色。如果该值为非零，则表示粒子的纹理将与颜色混合。
| particleColoBlendFactorRange |
一个初始值，用做颜色混合因子。这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleColoBlendFactorRange
论述
默认值为0.0，如果值为非零的时候，每个粒子的颜色的混合因子是一个随机的值，这个值可能在值域的一半左右浮动。
| particleColoBlendFactorSpeed |
粒子的混合因子变化的速度。
@property (atomic) CGFloat particleColoBlendFactorSpeed
论述
默认值为0.0。
在帧缓冲区混合粒子。
| particleBlendMode |
混合粒子的模式。
@property (atomic) SKBlendMode particleBlendMode
论述
默认值为SKBlendModeAlpha。
| particleAlphaSequence |
一个alpha序列，用于指定粒子的alpha值。
@property (atomic) SKKeyframeSequence *particleAlphaSequence
论述
默认值为nil。如果值为非空，则particleAlpha属性，particleAlphaRange属性，particleAlphaSpeed属性将被忽略。粒子将通过alpha序列来改变粒子的alpha值。
| particleAlpha |
粒子的平均初始alpha值。
@property (atomic) CGFloat particleAlpha
论述
粒子的alpha属性相当于节点的alpha属性。粒子的颜色alpha值等于粒子颜色和纹理的混合状态乘以粒子的alpha值。然后粒子的颜色将在帧缓冲区混合。默认值为1.0。
| particleAlphaRange |
粒子的alpha值，这个值是一个允许的值域范围内的随机值。
@property (atomic) CGFloat particleAlphaRange
论述
默认值为0.0。如果值为非零的时候，每个粒子的alpha值是一个随机的值，这个值可能在值域的一半左右浮动。
| particleAlphaSpeed |
粒子的alpha值变化速度。
@property (atomic) CGFloat particleAlphaSpeed
论述
默认值为0.0。
为粒子添加动作。
| particleAction |
为新粒子指定一个动作。
@property (atomic, copy) SKAciton *particleAction
论述
为粒子添加复杂的动作，将严重影响粒子发射器的性能。因为粒子不是一个你可以直接操作的节点。你不能在以添加动作的粒子里面删除动作。