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

论述

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

04-22 14:33