Instance Property


A dictionary that optionally associates particle properties with objects that animate a property’s value for each particle.


@property(nonatomic, copy) NSDictionary<SCNParticleProperty,SCNParticlePropertyController *> *propertyControllers;


Each key in this dictionary is one of the constants listed in Particle Property Keys, and the value for each key is a SCNParticlePropertyController object responsible for varying that property over time. Use particle property controllers to add efficient animations that change the appearance or behavior of each particle emitted by the system.

To add more complex behavior that cannot be described by a SCNParticlePropertyController object, use the addModifierForProperties:atStage:withBlock: to add a particle modifier block. However, be aware that particle modifier blocks can severely impact rendering performance.

See Also

Modifying Particles Over Time

- addModifierForProperties:atStage:withBlock:

Adds a block that modifies particle properties, to be executed each time SceneKit renders a frame.

- removeModifiersOfStage:

Removes particle modifier blocks for the specified stage of the particle simulation.

- removeAllModifiers

Removes all particle modifier blocks associated with the particle system.


Keys identifying properties of individual particles, used by the propertyControllers dictionary and the handleEvent:forProperties:withBlock: and addModifierForProperties:atStage:withBlock: methods.


Stages of SceneKit’s particle simulation process into which you can insert modifier blocks, used by the addModifierForProperties:atStage:withBlock: method.


The signature for blocks called by SceneKit to modify particle properties on each frame of simulation, used by the addModifierForProperties:atStage:withBlock: method.