Instance Property

imageSequenceInitialFrame

The index of the first frame in a particle image animation. Animatable.

Declaration

@property(nonatomic) CGFloat imageSequenceInitialFrame;

Discussion

To specify a sequence of frames for animating each particle, arrange the frames as a grid in a single image, as shown in Figure 1. The total number of frames in an image sequence is the product of multiplying the imageSequenceRowCount and imageSequenceColumnCount properties. Frames are numbered starting at zero, indicating the top left image in the grid.

When you use image sequences for particles, SceneKit interpolates between frames of animation, so a fractional value specifies a partial fade between two animation frames.

The default value is 0.0, specifying that animation begins with the top left image in the grid.

You can animate changes to this property’s value. See Animating SceneKit Content.

See Also

Animating Particle Images

imageSequenceRowCount

The number of rows for treating the particle image as a grid of animation frames.

imageSequenceColumnCount

The number of columns for treating the particle image as a grid of animation frames.

imageSequenceInitialFrameVariation

The range of randomized initial frames for particle image animation. Animatable.

imageSequenceFrameRate

The rate, in frames per second, of particle image animation. Animatable.

imageSequenceFrameRateVariation

The range, in frames per second, of randomized frame rates for particle image animation. Animatable.

imageSequenceAnimationMode

The animation mode for particle image animation.

SCNParticleImageSequenceAnimationMode

Options for animating each particle with a sequence of images, used by the imageSequenceAnimationMode property.