Morphology

_ChangeProcessParameters, _CloseColor, _CloseColorGa3, _DetectPeaks, _DetectValleys, _MorphoGradientEx, _MorphoGradientExGa3, _OpenColor, _OpenColorGa3, CloseColor, CloseColorGa3, DetectPeaks, DetectValleys, MorphoGradientEx, MorphoGradientExGa3, OpenColor, OpenColorGa3

CloseColor

Interactive command to this function: Image > Morphology > Close

Description 

 CloseColor(
   int  Count,
   int  MatrixType,
   int  OnIntensity,
   int  NDDimension
);

The CloseColor function performs morphological closing on current color image. An interactive equivalent is the _CloseColor function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

6

int OnIntensity

Selects whether to perform the processing on the intensity component or on color channels (one by one).

0, FALSE

use channels

1, TRUE

use the intensity component

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

Note

Morphological closing is a dilation followed by an erosion of the same amount. The transformation is performed on the intensity component except for multichannel images where it is performed on every selected component. Small dark areas are removed by this transformation. Hue and saturation are not affected. If a structuring element dimension is an even value, there are two enhanced pixels in structuring element depicting centers: one for erosion and the other for dilation.

CloseColorGa3

Description 

 CloseColorGa3(
   int  iCount,
   int  iMatrix,
   int  NDDimension
);

Performs morphological closing on the color image.

Parameters

int iCount

Number of iterations.

int iMatrix

Type of the structuring element used for the processing with the center in the enhanced pixel.

3

4

5

6

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

See Also

DetectPeaks

Interactive command to this function: Image > Detect > Detect Peaks

Description 

 DetectPeaks(
   int  Count,
   int  MatrixType,
   int  ConvertToGray,
   int  AutoContrast,
   int  OnIntensity,
   int  NDDimension
);

The DetectPeaks function enhances small light objects. The function is performed on intensity component of a color image except for multichannel images. For multichannel images, it is performed on every selected component. An interactive equivalent is the _DetectPeaks function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

3

4

5

6

int ConvertToGray

The output image can be converted and displayed in a gray scale.

int AutoContrast

Usage of some kernels may result in pixel values which it is impossible to display within the image (negative values, high values). Such values would be clipped to fit the acceptable range (0-255 for 8bit images), and you could loose certain amount of image information because such pixels would turn black/white. However, you can prevent this image distortion by using this option. It maps all the computed values to the acceptable range so it can be displayed correctly.

0, FALSE

Do not apply auto contrast

1, TRUE

Apply auto contrast

int OnIntensity

Selects whether to perform the processing on the intensity component or on color channels (one by one).

0, FALSE

use channels

1, TRUE

use the intensity component

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

Note

The Detect Peaks command enhances small light objects by Top Hat morphologic transformation. The size of objects selected is determined by the size of the used structuring element, which depends both on MatrixType and Count parameters. This function enables the specific segmentation of small objects to the exclusion of larger objects and also can help you in the case of non-homogeneous background. If Count < 0, auto contrast on the result image is performed. If MatrixType < 0, then result image is converted to gray one.

See Also 
_DetectPeaks, DetectValleys, _DetectValleys, _DetectPeaks

DetectValleys

Interactive command to this function: Image > Detect > Detect Valleys

Description 

 DetectValleys(
   int  Count,
   int  MatrixType,
   int  ConvertToGray,
   int  AutoContrast,
   int  OnIntensity,
   int  NDDimension
);

This function enhances small dark objects. The function is performed on intensity component of a color image except for multichannel images. For multichannel images, it is performed on every selected component. An interactive equivalent is the _DetectValleys function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

3

4

5

6

int ConvertToGray

The output image can be converted and displayed in a gray scale.

int AutoContrast

Usage of some kernels may result in pixel values which it is impossible to display within the image (negative values, high values). Such values would be clipped to fit the acceptable range (0-255 for 8bit images), and you could loose certain amount of image information because such pixels would turn black/white. However, you can prevent this image distortion by using this option. It maps all the computed values to the acceptable range so it can be displayed correctly.

0, FALSE

Do not apply auto contrast

1, TRUE

Apply auto contrast

int OnIntensity

Selects whether to perform the processing on the intensity component or on color channels (one by one).

0, FALSE

use channels

1, TRUE

use the intensity component

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

Note

The Detect Valleys command enhances small dark objects by Top Hat morphologic transformation. The size of the objects selected is determined by level of the transformation, which depends on MatrixType and Count of steps. This command enables the specific segmentation of small objects to the exclusion of larger objects and also can help you in the case of non-homogeneous background. If Count < 0, auto contrast on the result image is performed. If MatrixType < 0, then result image is converted to gray one.

See Also 
_DetectValleys, DetectPeaks, _DetectPeaks

MorphoGradientEx

Interactive command to this function: Image > Detect > Gradient Morpho

Description 

 MorphoGradientEx(
   int  Count,
   int  MatrixType,
   int  ConvertToGray,
   int  AutoContrast,
   int  OnIntensity,
   int  NDDimension
);

This function detects edges by morphologic transformation. The operation is performed on image Intensity values except for multichannel images. For multichannel images, it is performed on every selected component. An interactive equivalent is the _MorphoGradientEx function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

3

4

5

6

int ConvertToGray

The output image can be converted and displayed in a gray scale.

int AutoContrast

Usage of some kernels may result in pixel values which it is impossible to display within the image (negative values, high values). Such values would be clipped to fit the acceptable range (0-255 for 8bit images), and you could loose certain amount of image information because such pixels would turn black/white. However, you can prevent this image distortion by using this option. It maps all the computed values to the acceptable range so it can be displayed correctly.

0, FALSE

Do not apply auto contrast

1, TRUE

Apply auto contrast

int OnIntensity

Selects whether to perform the processing on the intensity component or on color channels (one by one).

0, FALSE

use channels

1, TRUE

use the intensity component

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

Note

Morphologic gradient is the difference of dilated and eroded images. It enhances edges. If Count < 0, auto contrast on the result image is performed. If MatrixType < 0, then result image is converted to gray one.

See Also 
_MorphoGradientEx, EdgesDetect, _MorphoGradientEx

MorphoGradientExGa3

Description 

 MorphoGradientExGa3(
   int  iCount,
   int  iMatrix,
   int  NDDimension
);

Detects edges by morphological transformations of color images.

Parameters

int iCount

Number of iterations.

int iMatrix

Type of the structuring element used for the processing with the center in the enhanced pixel.

3

4

5

6

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

OpenColor

Interactive command to this function: Image > Morphology > Open

Description 

 OpenColor(
   int  Count,
   int  MatrixType,
   int  OnIntensity,
   int  NDDimension
);

The OpenColor function performs morphological opening on current color image. An interactive equivalent is the _OpenColor function.

Parameters

int Count

Number of iterations.

int MatrixType

Type of the structuring element used for the processing with the center in the enhanced pixel.

2

3

4

5

6

int OnIntensity

Selects whether to perform the processing on the intensity component or on color channels (one by one).

0, FALSE

use channels

1, TRUE

use the intensity component

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

Note

Morphological opening is erosion followed by a dilation of the same amount. The transformation is performed on the intensity component except for multichannel images where it is performed on every selected component and removes small light objects. If a structuring element dimension is an even value, there are two enhanced pixels in structuring element depicting centers: one for erosion and the other for dilation.

OpenColorGa3

Description 

 OpenColorGa3(
   int  Count,
   int  iMatrix,
   int  NDDimension
);

Performs morphological opening on the color image.

Parameters

int Count

Number of iterations.

int iMatrix

Type of the structuring element used for the processing with the center in the enhanced pixel.

3

4

5

6

int NDDimension

Frame selection of the ND document.

0

Current frame

1

Time dimension

2

Multipoint dimension

4

Z dimension

15

All frames (the whole ND document).

16

Selection - the frames/dimensions selected by mouse within the ND control bar will be affected.

Note

Value combination is also possible (e.g.: M+T=3, Z+T=5, M+Z=6).

_CloseColor

This function runs the Image > Morphology > Close command.

Description 

 _CloseColor();

The function displays the Close on Color Image dialog box.

_CloseColorGa3

Description 

 _CloseColorGa3();

This function opens the Close Color dialog window.

See Also 
CloseColorGa3

_DetectPeaks

This function runs the Image > Detect > Detect Peaks command.

Description 

 _DetectPeaks();

This function displays the Detect Peaks dialog box.

See Also 
DetectPeaks, DetectValleys, _DetectValleys

_DetectValleys

This function runs the Image > Detect > Detect Valleys command.

Description 

 _DetectValleys();

This function displays the Detect Valleys dialog box.

See Also 
DetectValleys, DetectPeaks, _DetectPeaks

_ChangeProcessParameters

Description 

 _ChangeProcessParameters(
   char *ProcName
);

If DetectValleys is entered into the parameter field, the function _DetectValleys is called.

Parameters

char *ProcName

Name of the procedure.

See Also 
_DetectValleys

_MorphoGradientEx

This function runs the Image > Detect > Gradient Morpho command.

Description 

 _MorphoGradientEx();

The function displays the Morphologic Gradient on Color Image dialog box.

See Also 
MorphoGradientEx

_MorphoGradientExGa3

Description 

 _MorphoGradientExGa3();

The function opens the Morphologic Gradient.

See Also 
MorphoGradientExGa3

_OpenColor

This function runs the Image > Morphology > Open command.

Description 

 _OpenColor();

The function displays the Open on Color Image dialog box.

See Also 
OpenColor

_OpenColorGa3

Description 

 _OpenColorGa3();

Displays the Open Color dialog window.

See Also 
OpenColorGa3