hwISession CaptureAnimationByArea

Creates a movie file by animating the current page, allowing you to first draw a box and select a sub-rectangle of the page for capture.

Syntax

hwISession_handle CaptureAnimationByArea filetype, filename, left, top, right, bottom, [dimension_type, width, height]

Application

Tcl Query

Description

This command uses the current values for options found in the hwIAVIExportOptions or hwIAMFExportOptions object.

Inputs

filetype
Indicates the format of the output file. The animated formats can be "avi", "amf", and "gif" (one file contains the entire animation) or "png", "jpeg", "bmp" and "tiff" (a numbered series of still image files comprising the entire animation).
filename
The name of the file to be created.
left
The coordinate of the left side of the capture region, in screen percentage.
top
The coordinate of the top of the capture region, in screen percentage.
right
The coordinate of the right side of the capture region, in screen percentage.
bottom
The coordinate of the bottom of the capture region, in screen percentage.
dimension_type
Specifies the width and height units of the final animation, which can be in percent or pixels.
Note: If you specify a dimension_type, you MUST specify BOTH width and height (see below).
width
The number of width units of the final captured animation.
height
The number of height units of the final captured animation.

Example

To generate an animation file of the currently displayed graphics in the GIF format (note that these examples require the graphics area is at least 1050x450) :
hwi GetSessionHandle mySessionName
mySessionName GetGIFExportOptionsHandle myGIF
myGIF SetSize 99
myGIF SetDelay 0.5
mySessionName CaptureAnimationByArea gif c:/temp/fun.gif 0 0 1050 450
mySessionName CaptureAnimationByArea gif c:/temp/fun_75.gif 0 0 1050 450 percent 75 75

Error

Success (0) or an error code.