CaptureBitmap

Capture function.

The CaptureBitmap function captures an image or an image area in the active window and saves this image in a .BMP file.

Syntax

CaptureBitmap(<filename>[,InArea(<x>,<y>,<height>,<width>)])
or
ret=CaptureBitmap(<filename>[,InArea(<x>,<y>,<height>,<width>)])

Parameters

<filename>, name of the file (extension .BMP) into which the captured image is saved.

InArea : optional keyword if the capture must be done only in a specified area of the active window.

<x>,<y> : coordinates of the top-left corner of the rectangle to be captured inside the specified window.

<height>,<width> : integers specifying the height and the width of the rectangle to capture.

Return value

Ret, numeric return code. When successful, the function returns 0, otherwise 1.

Remarks

Use the Insert/Statement menu and select CaptureBitmap in order to automatically generate this statement.

See also

Capture$

HardCopy

Check functions

Examples

 

UseWindow( "NOTEPAD.EXE|Edit|Untitled - NotePad|1",1 )
CaptureBitmap("C:\save\image.bmp") 'captures the entire active window - note that the UseWindow before is compulsory.

CaptureBitmap("C:\save\image.bmp",InArea(10,10,100,200)) 'captures only the specified area