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