hwISession CaptureScreenByAreaPercentage
Captures the screen to an image file.
Syntax
hwISession_handle CaptureScreenByAreaPercentage type, filename, left, top, right, bottom
Application
HyperWorks Tcl
Description
This command captures the screen to a file, requiring you to specify or resize the window region to be captured. This version takes percentages as parameters of the screen (expressed as decimals between 0 and 1) for the input.
Inputs
- type
- The file type that you want to save the captured image as. The different file types include: BMP, JPEG, TIFF, PNG or saved to the clipboard.
- filename
- The file 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).
Example
hwi GetSessionHandle sess;
sess CaptureScreenByAreaPercentage png Pic.png .25 .25 .75 .75;
hwi GetSessionHandle sess1
sess1 CaptureScreenByAreaPercentage "clipboard" E:\Scratch\CaptureScreenAPI_Test .25 .25 .75 .75;
Error
Returns success (0) or an error code.
Keywords
HyperWorks
Tcl
Create