| |
CImage:FiltClipHigh
The FiltClipHigh method replaces values above a threshold value with a different value. In other words, values above the threshold are "clipped" and replaced with another value.
|
bResult = CImage:FiltClipHigh( nClipValue, nNewValue, CRect=nil ) |
nClipValue is the threshold value, specified by a
number or string.
nNewValue is the replacement value, specified by a
number or string.
The region is
specified by a CRect,
with 1-based coordinates and may be nil.
On success,
this method returns true.
On failure,
false is returned.
This method examines the value of each pixel inside CRect. If value > nClipValue then the pixel is replaced with nNewValue. If CRect is omitted or passed as nil, then the entire image is processed.
If the image has a numeric data type and you pass an rgb string for either value, the rgb string is converted to an equivalent numeric intensity.
The following script fragment opens an image from the file at sPath and replaces values above 32000 with 32767. The clipping region is constrained to the rectangle defined by columns 100:200 and rows 250:350:
|
I = CImage:new() |
-- Create a CImage |
|
I:Open( sPath ) |
-- Open the image from sPath. |
|
R = CRect:new() |
-- create a rectangle |
|
R:Set(100,200,250,350) |
-- columns 100:200, rows 250:350 |
|
I:FiltClipHigh(32000,32767,R) |
-- Clip values above 32000 |
|
I:Save() |
-- save the image |
|
I:delete() |
-- delete the CImage from memory |
|
R:delete() |
-- delete the CRect from memory |