CImage:ApplyPixelMask
The ApplyPixelMask method repairs point defects identified by locations stored in a pixel mask file. This is effective for repairing point defects as well as single row and single column artifacts.
bResult = CImage:ApplyPixelMask( nMethod, sMaskFile, CRect=nil )
nMethod is a number corresponding to the repair method (see Remarks).
sMaskFile is the name of the text file containing the pixel mask.
The rectangular region to repair is specified by a CRect, with 1-based coordinates. If omitted, the entire image is repaired.
On success, this method returns true.
On failure, false is returned.
This method replaces point values using a statistic computed from pixels in the neighborhood. The neighborhood method is described in the table below.
Pixel Mask Neighborhood Methods
Method |
Description |
1 |
Replaces the pixel by the mean value from its 4 nearest neighbors. |
2 |
Replaces the pixel by the median value from its 4 nearest neighbors. |
3 |
Replaces the pixel by the median value from its 8 nearest neighbors. Use this method for repairing 1 pixel wide line defects. |
Point locations in need of repair are identified by pixel coordinates in a Pixel Mask File. A related pixel repair method is SetMaskedValue which replaces pixels with a specific value rather than a computed neighborhood value.
Assume that a pixel mask file named sMaskFile exists. The following script repairs point values in the image in a file named sPath using defect coordinates from the pixel mask file. Points in the central 50% of the image are repaired by replacing them with the median of their 8 nearest neighbors:
|
-- Create a CImage |
|
-- Open the image from sPath. |
|
-- get image width and height |
|
-- create a rectangle |
|
-- central 50% of columns and rows |
|
-- apply the pixel mask |
|
-- save the image |
|
-- delete the CImage from memory |
|
-- delete the CRect from memory |
CImage class, SetMaskedValue , Pixel Mask File
Mira Pro x64 Script User's Guide, Copyright Ⓒ 2023 Mirametrics,
Inc. All Rights Reserved.