closeKernel
Top  Previous  Next

closeKernel ( integer Input, integer Probe, integer Output, integer Iterations )

Use this function to fill gaps in bright objects and connect objects that are close together. The function works by applying the
dilate function followed by erode. A neighborhood pattern is supplied to the function as a grayscale or binary image with pixel values set to 1s for active elements of the kernel and to 0s for elements to be ignored.

Parameters
 
Input  
 
An integer between 0 and 116 specifying the input image frame number. A value of 0 represents the DMA memory buffer of the video device. Values in the range of 100-116 correspond to hidden frames.  
 
Probe  
 
An integer between 1 and 116 specifying the frame number of the grayscale or multiphase image that contains the structuring element for the operation. Values in the range of 100-116 correspond to hidden frames.  
The size of the kernel in each dimension must not exceed 2*Overscan+1. The Overscan setting is defined in ImageWarp Preferences.  
 
Output  
 
An integer between 1 and 116 specifying the output image frame number. Values in the range of 100-116 correspond to hidden frames.  
 
Iterations  
 
A positive integer specifying how many times the operation will be applied.  
 
Output  
 
An integer between 1 and 116 specifying the output image frame number. Values in the range of 100-116 correspond to hidden frames.  
 
Iterations  
 
A positive integer specifying how many times the operation will be applied.  
 
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 applies two steps of morphological closing with a 11x11 circular kernel loaded from a file.  
 
setCurDir ("samples")  
loadIm (1,"sample4.iwd")  
threshold(1,1,M_PRESET,0.,113.,TRUE,FALSE)  
loadIm (2,"circle9.tif")  
closeKernel (1,2,3,2)