poIPost CaptureImageByRegion
Renders a specific region of the current HyperView window to an off-screen image.
Syntax
poIPost_handle CaptureImageByRegion regionType filename quality
Application
HyperView Tcl Modify
Description
This command renders the current HyperView window, crops the rendering to the specified region, and then writes it to an off-screen image.
Inputs
- regionType
- The region of the window which will be saved. MODELSONLY specifies that the window will be cropped so that only the models will be visible.
- filename
- The name of the file.
- quality
- The image quality (1-4, with 1 as the default).
Example
To render the current HyperView window and specify that the
window will be cropped so that only the models are
visible:
variable t [expr rand()];
hwi GetActiveCleintHandle post$t
post$t CaptureImageByRegion MODELSONLY C:/image.jpg 4
post$t ReleaseHandle
Error
Returns 0 if successful, otherwise an error code.