Error getting tags :
error 404Error getting tags :
error 404 import snapshot | revDocs | RunRev
Welcome Guest (Log in)
Product Edition
import snapshot
Expander triangle

import snapshot [from rect[angle] rectangle] [of object]

Platform Support
MacOS,Mac OS X,Windows,Linux
Creates an image of a portion of the screen, portion of a stack or a specific object.

import snapshot
import snapshot from rectangle 100,100,500,400
import snapshot from rectangle (the rect of group "Picture")
import snapshot from rect myRect of window 91373124
import snapshot from the selectedObject
import snapshot from rectangle 0,0,100,100 of field 1 of card "Test" of stack "Test Stack"

Additional Comments
Expander triangle

Use the import snapshot command to place a screenshot in the current stack.


The rectangle specifies the edges of the rectangle to be imported, separated by commas, in the same order as the rectangle property (left, top, right, bottom).

Important! If a window, stack or object is specified, the rectangle is given in relative (window) coordinates; otherwise, it is given in absolute coordinates.

To import a snapshot for a portion of a stack you use the form:

import snapshot from rect[angle] of window windowId

Where windowId is the windowId property of the required stack.

To import a snapshot of a specific (non-stack) object, use the form:

import snapshot from [rect[angle] ] of chunk

Where chunk is any chunk expression resolving to a control, or any expression evaluating to a control reference.


The import snapshot command creates a new image in the center of the current card and places the snapshot in the image.

If you don't specify a rectangle or an object, Revolution displays a crosshairs cursor. Click at one corner of the rectangle to be imported and drag to the opposite corner to select the area.

If taking a snapshot of an object, the rectangle's coordinates are relative to the top left corner of the card containing the object. The object is rendered into an image as if no other objects existed around it, the snapshot is taken without applying the object's blendlevel or ink. You can take a snapshot of an object regardless of its visibility or open status - in particular, snapshots can be taken of objects that are not on the current card or in stacks that are not open.

If taking a snapshot of a stack the rectangle's coordinates are relative to the top left corner of the window you specify. However, if the window is partly overlapped by another window, whatever is visible on the screen within that rectangle is placed in the snapshot. In other words, you cannot take a snapshot of a part of a window that is hidden by another overlapping window.

While you take the snapshot, Revolution hides its own windows (such as the Tools palette).

The format of the resulting image depends on the current setting of the paintCompression property.

User Comments
Expander triangle