CImage:FiltMax

The FiltMax method applies a 100-th percentile rank selection filter to the image. This filter replaces each pixel with its neighborhood maximum value.

Syntax

bSuccess = CImage:FiltMax( cols, rows )

bSuccess = CImage:FiltMax( cols, rows, CRect )

where

cols is the column length of the filter kernel.

rows is the row length of the filter kernel.

CRect is the rectangle defining the area to process. If omitted, it defaults to nil and the entire image is processed.

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

This method selects the neighborhood values having 100% rank surrounding each point of interest. This produces an image that maximally emphasizes all the local "peaks" in the image.

Example

Suppose an image is displayed in a CImageView named V. The following script applies a 7 x 7 maximum value filter to the [100:300, 400:800] pixel region:

I = V:GetImage()	-- attach the current displayed image
R = NewRect(100,300,400,800)	-- setup the rectangle to process
I:FiltMax(7,7,R)	-- apply the filter
V:Update()	-- update the display after the scale
R:delete()	-- done with the CRect