ultErode
Top  Previous  Next

ultErode ( integer Input, integer Output, integer Probe )

Use this function to reduce objects in a binary image to single points or small groups of connected points. The function works by applying the multiple
erode to the image, while preventing the small blobs from disappearing. The size and shape of the neighborhood kernel used in the operation is selected with the Probe parameter. The function creates a multiphase output image, in which the index of each point or blob equals to the maximum distance from the boundary of the related object in the original image.

Parameters
 
Input  
 
An integer between 1 and 116 specifying the input image frame number. Values in the range of 100-116 correspond to hidden frames.  
 
Output  
 
An integer between 1 and 116 specifying the output image frame number. Values in the range of 100-116 correspond to hidden frames.  
 
Probe  
 
An enumerated integer that describes the shape and size of the kernel used in the operation. The value is determined as a combination of four basic shapes constructed of 3 pixels:  
 
PR_VBAR=1 – vertical bar  
PR_BKSLASH=2 – diagonal bar (top left – bottom right)  
PR_HBAR=4 – horizontal bar  
PR_FWSLASH=8 –diagonal bar (bottom left – top right)  
 
The following frequently used shapes represent combinations of the basic shapes:  
 
PR_CROSS=5 – cross 3x3  
PR_DCROSS=10 – diagonal cross 3x3  
PR_SQUARE=15 – square 3x3  
 
You can also assign one kernel of size 5x5:  
 
PR_CIRCLE=16 – circle 5x5  
 
Error flags

ERR_OK  
 
The flag set if successful.  
 
ERR_FAILED  
 
The flag set if failed.  

Example

This set of statements binarizes a sample image and performs the ultimate erosion:  
 
setCurDir ("samples")  
loadIm(1,"sample4.IWD")  
threshGauss(1,1,0,1,0)  
ultErode(1,2, PR_CROSS)