openKernel

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

Use this function to separate narrowly connected bright objects and remove small ones. The function works by applying the erode function followed by dilate. . 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.

Error flags

ERR_OK

The flag set if successful.

ERR_FAILED

The flag set if failed.

Example

This set of statements uses morphological opening with a custom 9x9 circular kernel to remove speckles from a 16-bit grayscale sample image.

setCurDir ("samples")

loadIm (1,"sample11.iwd")

setDisplayRange(1,0,1000)

setCurDir ("kernels")

loadIm (2,"circle9.tif")

openKernel (1,2,3,1)