Instance Property

inputOrigin

A node whose distance to each particle provides input values for the controller’s animation.

Declaration

@property(nonatomic, weak) SCNNode *inputOrigin;

Discussion

This property applies only when the controller’s inputMode value is SCNParticleInputModeOverDistance. When you select that input mode, this property’s value must be a node in the scene containing the particle system; otherwise, SceneKit ignores this property. The default value is nil.

SceneKit calculates the distance between this node’s position vector (converted to the scene’s world coordinate space) and each particle and then uses the resulting value as the input to the controller’s animation. For example, if you use this option to animate particle opacity from 1.0 to 0.0, all particles beyond a certain distance from the inputOrigin node are fully transparent—regardless of any random velocity or direction variations in reaching that distance.

To refine the relationship between a range of distances and a range of input values for the controller’s animation, use the inputBias and inputScale properties.

See Also

Managing the Controller’s Animation

animation

The Core Animation object defining the behavior of the property animation.

inputMode

The mode that determines input values for the property controller’s animation.

inputBias

An offset to add to the input value of the controller’s animation.

inputScale

A factor for multiplying the input value of the controller’s animation.

inputProperty

A particle property that provides input values for this property controller’s animation.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software