Lingo Dictionary > O-R > puppetTransition |  |

puppetTransition

Syntax

    puppetTransition member whichCastMember
    puppetTransition whichTransition {,time} {, chunkSize} {, changeArea}

Description

Command; performs the specified transition between the current frame and the next frame.

To use an Xtra transition cast member, use `puppetTransition member` followed by the cast member's name or number.

To use a built-in Director transition, replace `whichTransition` with a value in the following table. Replace `time` with the number of quarter seconds used to complete the transition. The minimum value is 0; the maximum is 120 (30 seconds). Replace `chunkSize` with the number of pixels in each chunk of the transition. The minimum value is 1; the maximum is 128. Smaller chunk sizes yield smoother transitions but are slower.

Code | Transition | Code | Transition
01 | Wipe right | 27 | Random rows
02 | Wipe left | 28 | Random columns
03 | Wipe down | 29 | Cover down
04 | Wipe up | 30 | Cover down, left
05 | Center out, horizontal | 31 | Cover down, right
06 | Edges in, horizontal | 32 | Cover left
07 | Center out, vertical | 33 | Cover right
08 | Edges in, vertical | 34 | Cover up
09 | Center out, square | 35 | Cover up, left
10 | Edges in, square | 36 | Cover up, right
11 | Push left | 37 | Venetian blinds
12 | Push right | 38 | Checkerboard
13 | Push down | 39 | Strips on bottom, build left
14 | Push up | 40 | Strips on bottom, build right
15 | Reveal up | 41 | Strips on left, build down
16 | Reveal up, right | 42 | Strips on left, build up
17 | Reveal right | 43 | Strips on right, build down
18 | Reveal down, right | 44 | Strips on right, build up
19 | Reveal down | 45 | Strips on top, build left
20 | Reveal down, left | 46 | Strips on top, build right
21 | Reveal left | 47 | Zoom open
22 | Reveal up, left | 48 | Zoom close
23 | Dissolve, pixels fast* | 49 | Vertical blinds
24 | Dissolve, boxy rectangles | 50 | Dissolve, bits fast*
25 | Dissolve, boxy squares | 51 | Dissolve, pixels*
26 | Dissolve, patterns | 52 | Dissolve, bits*

Transitions marked with an asterisk (*) do not work on monitors set to 32 bits.

There is no direct relationship between a low time value and a fast transition. The actual speed of the transition depends on the relation of `chunkSize` and `time`. For example, if `chunkSize` is 1 pixel, the transition takes longer no matter how low the time value, because the computer has to do a lot of work. To make transitions occur faster, use a larger chunk size, not a shorter time.

Replace `changeArea` with a value that determines whether the transition occurs only in the changing area (`TRUE`) or over the entire Stage (`FALSE`, default). The `changeArea` variable is an area within which sprites have changed.

Example

This statement performs a wipe right transition. Because no value is specified for `changeArea`, the transition occurs over the entire Stage, which is the default.

    puppetTransition 1

This statement performs a wipe left transition that lasts 1 second, has a chunk size of 20, and occurs over the entire Stage:

    puppetTransition 2, 4, 20, FALSE

See also

`puppetTempo`, `puppetSound`, `puppetPalette`