CImage:CreatePixelMask

The CreatePixelMask method creates a pixel mask file containing the coordinates of pixels that exceed an upper or lower threshold. Compared with CreatePixelMaskHigh and CreatePixelMaskLow, this method tests both thresholds.

Syntax

bSuccess = CImage:CreatePixelMask( sMask, vHigh, vLow )

bSuccess = CImage:CreatePixelMask( sMask, vHigh, vLow, CRect )

where

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

vHigh is the high threshold value, and may be a number or a string.

vLow is the low value threshold, and may be a number or a string.

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. To examine only the upper threshold or lower threshold use one of the other methods, CreatePixelMaskHigh or CreatePixelMaskLow.

Example

The following script makes a pixel mask containing the coordinates of pixel values above 32000 and below -32000 in the central 50% of the image:

I = CImage:new()	-- Create a CImage
I:Open( sPath )	-- Open the image from sPath.
R = NewRect()	-- create a rectangle
w = I:Cols() ; h = I:Rows()	-- get the image size
R:Set( 0.25w, 0.75w, 0.25h, 0.25h )	-- central 50% of columns and rows
low = -32000 ; high= 32000	-- set the threshold values
I:CreatePixelMask(sMaskFile,high,low,R)	-- create the pixel mask