Class

SKTransition

An object used to perform an animated transition to a new scene.

Declaration

@interface SKTransition : NSObject

Overview

Scenes are the basic building blocks of games. Typically, you design self-contained scenes for the parts of your game, and then transition between these scenes as necessary. For example, you might create different scene classes to represent any or all of the following concepts:

  • A loading scene to display while other content is loaded

  • A main menu scene to choose what kind of game the user wants to play

  • A scene to configure the details of the specific kind of game the user chose

  • A scene that provides the gameplay

  • A scene displayed when gameplay ends

When you present a new scene in a view that is already presenting a scene, you have the option of using a transition to animate the change from the old scene to the new scene. Using a transition provides continuity so that the scene change is not quite so abrupt.

Topics

Creating Transitions

+ crossFadeWithDuration:

Creates a cross fade transition.

+ doorsCloseHorizontalWithDuration:

Creates a transition where the new scene appears as a pair of closing horizontal doors.

+ doorsCloseVerticalWithDuration:

Creates a transition where the new scene appears as a pair of closing vertical doors.

+ doorsOpenHorizontalWithDuration:

Creates a transition where the new scene appears as a pair of opening horizontal doors.

+ doorsOpenVerticalWithDuration:

Creates a transition where the new scene appears as a pair of opening vertical doors.

+ doorwayWithDuration:

Creates a transition where the previous scene disappears as a pair of opening doors.

+ fadeWithColor:duration:

Creates a transition that first fades to a constant color and then fades to the new scene.

+ fadeWithDuration:

Creates a transition that first fades to black and then fades to the new scene.

+ flipHorizontalWithDuration:

Creates a transition where the two scenes are flipped across a horizontal line running through the center of the view.

+ flipVerticalWithDuration:

Creates a transition where the two scenes are flipped across a vertical line running through the center of the view.

+ moveInWithDirection:duration:

Creates a transition where the new scene moves in on top of the old scene.

+ pushWithDirection:duration:

Creates a transition where the new scene moves in, pushing the old scene out of the view.

+ revealWithDirection:duration:

Creates a transition where the old scene moves out of the view, revealing the new scene underneath it.

+ transitionWithCIFilter:duration:

Creates a transition that uses a Core Image filter to perform the transition.

Pausing

pausesIncomingScene

A Boolean value that determines whether the incoming scene is paused during the transition.

pausesOutgoingScene

A Boolean value that determines whether the outgoing scene is paused during the transition.

Constants

SKTransitionDirection

For some transitions, the direction in which the transition is performed.

Relationships

Inherits From

Conforms To

See Also

Displaying a Scene

scene

The scene currently presented by this view.

- presentScene:

Presents a scene.

- presentScene:transition:

Transitions from the current scene to a new scene.