### directToStage

Syntax: | `the directToStage of sprite` `whichFlashSprite`
| `the directToStage of member` `whichFlashMember`
Type: | Cast member property; sprite property
Description: | This property controls whether a Flash movie is rendered directly to the stage or drawn offscreen first before being rendered on the stage. Rendering a Flash movie direct to stage provides the fastest onscreen playback, but it requires that the sprite always appear on top of other sprites regardless of its order in the score. Ink effects also do not work on sprites rendered direct to the stage.
| The `directToStage` property can have these values:

| `TRUE` The Flash movie sprite is rendered direct to stage.
| `FALSE` The Flash movie sprite is drawn offscreen and then rendered on the stage.

| The `directToStage` property can be tested and set. The default setting is `FALSE`.
Example: | This sprite script sets up a Flash movie sprite to be rendered direct to stage.

    on beginSprite me
    	set the directToStage of sprite the spriteNum of me = TRUE
    end

Previous | Next