hwISession CaptureAnimationByAreaPercentage
Captures the screen to a movie file.
Syntax
hwISession_handle CaptureAnimationByAreaPercentage type, filename, left, top, right, bottom, [dimension_type, width, height]
Application
HyperWorks Tcl
Description
This command captures the screen to a movie file, first requiring you to specify or resize a window region to be captured. This version takes percentages as parameters for the corners, expressed as decimals between 0 and 1.
Inputs
- type
- The file type that you want the captured movie to be saved as. The file types available are 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 that you want to give the captured movie.
- left
- The left side coordinate of the captured region in terms of screen percentage (a decimal between 0 and 1).
- top
- The top side coordinate of the captured region in terms of screen percentage (a decimal between 0 and 1).
- right
- The right side coordinate of the captured region in terms of screen percentage (a decimal between 0 and 1).
- bottom
- The bottom side coordinate of the captured region in terms of screen percentage (a decimal between 0 and 1).
- 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
hwi GetSessionHandle
sess;
sess CaptureAnimationByAreaPercentage amf MyVideo.amf .25 .25. .25 .25;
sess CaptureAnimationByAreaPercentage gif MyVideo.gif .25 .25 .75 .75 percent 150 150;
sess CaptureAnimationByAreaPercentage gif MyVideo.gif .25 .25 .75 .75 pixels 1280 960;Error
Returns success (0) or an error code.
Keywords
HyperWorks
Tcl
Create