GrayScaleTopHat  Method

Description         The top-hat filter is used to enhance low contrast high spatial frequency features within an image. The function works for only 8 bit per pixel grayscale images. Morphological top-hat of an image is defined as the difference between the original image and the graylevel opened image.

Examples

8bitgray                                          macskatophat

Syntax                 RetVal = [BiFilter.]GrayScaleTopHat  hDib Mask Mheight Mwidth MPx MPy iShowProgress hWnd

Returns               RetVal                    LONGLONG The handle of new filtered DIB, 0 if an error occurred, or -1 if the BIFilter.dll does not installed.

Remarks             hDib                       LONGLONG Handle of the image to filter.

                            Mask                      short*              This parameter specifies the structuring function used by the filtering.

                            Mheight                  short                Height of structuring matrix.

                            Mwidth                  short                Width of structuring matrix.

                            MPx                        short                X coordinate of structuring matrix origin.

                            MPy                        short                Y coordinate of structuring matrix origin.

                            iShowProgress       short                This parameter specifies the displaying of the progressbar and the preview dialog.

Available values:

DISPLAY_NONE (0) - The progressbar and the preview dialog will not display before filtering.

DISPLAY_PROGRESS (1) - The progressbar will display during filtering procedure.

DISPLAY_DIALOG (2) - The preview dialog will display before filtering. This dialog shows the part of the image before and after filtering.

DISPLAY_BOTH (3) - The progressbar and the preview dialog will display.

IMPORTANT: The preview dialog will only display, if there is BIDlgs32.dll installed.

                            hWnd                     LONGLONG Handler of the parent window.

See Also