Adobe 65036570 Scripting Guide - Page 521

ADOBE DIRECTOR 11.0 484 Scripting Dictionary Example This statement makes Rainbow the movie's palette: -- Lingo syntax _movie.puppetPalette("Rainbow") // JavaScript syntax _movie.puppetPalette("Rainbow"); The following statement makes Rainbow the movie's palette. The transition to the Rainbow palette occurs over a time setting of 15, and over 20 frames. -- Lingo syntax _movie.puppetPalette("Rainbow", 15, 20) // JavaScript syntax _movie.puppetPalette("Rainbow", 15, 20); See also Movie puppetSprite() Usage -- Lingo syntax _movie.puppetSprite(intSpriteNum, bool) // JavaScript syntax _movie.puppetSprite(intSpriteNum, bool); Description Movie method; determines whether a sprite channel is a puppet and under script control (TRUE) or not a puppet and under the control of the Score (FALSE). While the playhead is in the same sprite, turning off the sprite channel's puppetting using the syntax puppetSprite(intSpriteNum, FALSE) resets the sprite's properties to those in the Score. The sprite channel's initial properties are whatever the channel's settings are when the puppetSprite() method is executed. You can use script to change sprite properties as follows: • If a sprite channel is a puppet, any changes that script makes to the channel's sprite properties remain in effect after the playhead exits the sprite. • If a sprite channel is not a puppet, any changes that script makes to a sprite last for the life of the current sprite only. The channel must contain a sprite when you use the puppetSprite() method. Making the sprite channel a puppet lets you control many sprite properties-such as member, locH, and width- from script after the playhead exits the sprite. Use the syntax puppetSprite(intSpriteNum, FALSE) to return control to the Score when you finish controlling a sprite channel from script and to avoid unpredictable results that may occur when the playhead is in frames that aren't intended to be puppets.