SKEmitterNode类

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

论述

为粒子添加复杂的动作，将严重影响粒子发射器的性能。因为粒子不是一个你可以直接操作的节点。你不能在以添加动作的粒子里面删除动作。