to1bit

to1bit ( integer Input, integer Output )

Use this function to convert an image into a two color binary bitmap. To binarize an image, the function uses a 50% threshold in the image display range.

Parameters

Input

An integer between 0 and 116 specifying the input image frame number. A value of 0 represents the DMA memory buffer of the video device. Values in the range of 100-116 correspond to hidden frames.

Output

An integer between 1 and 116 specifying the output image frame number. Values in the range of 100-116 correspond to hidden frames.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

grabIm (1)

to1bit (1,2)

saveIm (2,"C:\\test1bit.tif")