Contents

animate(with:timePerFrame:resize:restore:)

Creates an action that animates changes to a sprite’s texture, possibly resizing the sprite.

Declaration

class func animate(with textures: [SKTexture], timePerFrame sec: TimeInterval, resize: Bool, restore: Bool) -> SKAction

Parameters

  • textures:

    An array of textures to use when animating a sprite.

  • sec:

    The amount of time, in seconds, that each texture is displayed.

  • resize:

    If True, the sprite is resized to match each new texture. If False, the size of the sprite remains at a constant size.

  • restore:

    When the action completes, the sprite’s texture is restored to the texture it had before the action completed. (If the resize parameter is True, the sprite is resized to match the size of the original texture.)

    When the action completes, the sprite’s texture remains set to the final texture in the array.

Return Value

A new action object.

Discussion

This action can only be executed by an SKSpriteNode object. When the action executes, the sprite’s texture property animates through the array of textures. The sprite’s texture property is changed to the next texture in the array. The action then pauses for the specified time before continuing. The action continues until it has finished animating through all of the textures in the array. The total duration of the action is the number of textures multiplied by the frame interval.

This action is reversible; the resulting action animates through the same textures from last to first.

See Also

Animating a Node’s Texture