CaptureImage

(Engine-Level Function)

Description:	Creates an image handle from a GUIStretch operation
Returns:	Bitmap handle
Usage:	Script Only.
Function Groups:	Graphics
Related to:	SaveImage |
Format:	CaptureImage(Object, Left, Bottom, Right, Top);
Parameters:

Object

The object whose image is being captured

Left

The left coordinate of the capture.

Bottom

The bottom coordinate of the capture.

Right

The right coordinate of the capture.

Top

The top coordinate of the capture.

Comments:

Creates an image capture of anything drawn by the object or its children within the provided (optional) coordinates. This image is stored in a bitmap handle identical to the output of the MakeBitmap function, meaning that it can be modified, displayed or saved.

Examples:

{ GUIStretch calling a module }
  GUITransform(296, 736, 469, 563,
               1, 1, 1, 1, 1 { Scaling              },
               0, 0          { Movement             },
               1, 2          { Visibility, Reserved },
               0, 0, 0       { Selectability        },
               Obj = MyModule("GUIStretch of MyModule"));

  { Capture an image of the module every second }
  If TimeOut(1, 1);
  [
     CapturedImage = CaptureImage(Obj);
  ]