Desaturate  Method

Description         This method will desaturate the image. This function works for only 24 bit per pixel images.

Examples

color                                                           desaturated

The original 900 x 1300 sized color image and desaturated image.

Syntax                 RetVal = [BIIMAGE.]Desaturate  iShowProgress hWnd

Returns               RetVal                    LONGLONG The handle of new DIB, 0 if an error occurred.

Remarks             hDib                       LONGLONG Handle of the source image.

                            iShowProgress       Long                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.

                            hParent                  LONGLONG Handler of the parent window to display preview dialog.

 

The method will not free the input DIB.

 

See Also