CImage:CreatePixelMaskHigh

The CreatePixelMaskHigh method creates a pixel mask file containing the coordinates of pixels having values above a threshold value.

Syntax

bSuccess = CImage:CreatePixelMaskHigh( sMask, vHigh )

bSuccess = CImage:CreatePixelMaskHigh( sMask, vHigh, CRect )

where

sMask is the name of the text file where the pixel mask will be saved.

vHigh is the high threshold value.

CRect is the target rectangle; if nil, then the entire image is searched.

bSuccess is the returned success code. On success it is true, otherwise false.

This method produces a text file consisting of pixel coordinate pairs, one per line, in the form column, row. This format is described in the topic Pixel Mask File.

Example

The following script makes a pixel mask containing the coordinates of pixel values above 2000. The entire image is sampled because the CRect R is not specified:

I = CImage:new()	-- Create a CImage
I:Open( sPath )	-- Open the image from sPath.
I:CreatePixelMaskHigh(sMaskFile,2000)	-- create the pixel mask