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