drawStagePicture

Syntax: drawStagePicture document, [ rect | topLeftPoint ], [ clipRect], grabOffscreen

Places a screen shot of the stage contents on the current page (or MIAW contents if drawStagePicture is called from a movie-in-a-window).

If a destRect is specified, the stage image will be sized to fit within the rectangle without distortion. If a topLeftPoint is specified, the stage will be drawn at 100% size starting from the specified point.

If a clipRect is specified, only that portion of the stage or MIAW will be grabbed.

Note that drawStagePicture takes a "faithful" screen grab of the stage contents, including the cursor, sprite "trails", and any other windows that might overlap the stage. However, if grabOffscreen is TRUE, the stage picture will be grabbed from Director's off-screen buffer instead, and these extraneous elements will not be included in the resulting picture.

Examples:

drawStagePicture doc, Point(0,0)
drawStagePicture doc, Point(0,0), Rect(0,0,100,300), TRUE