ColorHueSaturation  Method

Description         This method will modify the hue, intensity and saturation values of the image. This function works for only 24 bit per pixel images.

Examples

color                                                           hsi

The original 900 x 1300 sized color image and the Hue/Saturation/Intensity operated image with Hue = 45, Saturation = -16, Intensity = 61, Min = 0 and Max = 360 parameter values.

Syntax                 RetVal = [BIIMAGE.]ColorHueSaturation  hDib hue saturation intensity min max iShowProgress hWnd

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

Remarks             hDib                       LONGLONG Handle of the source image.

                            hue                          short                Value of hue [-180 - 180].

                            saturation               short                Value of saturation [-255 - 255].

                            intensity                  short                Value of intensity [-255 - 255].

                            min                         short                The minimum value of the range of hue [0 - 360].

                            max                         short                The maximum value of the range of hue [0 - 360].

                            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.

 

Rules:

If min < 0 or min > 360 or max < 0 or max > 360 or min = max the method returns NULL, and the error code will be CCINVALIDPARAMETER.

If min < max, the range of hue will be [min, max],

If min > max, the range of hue will be [0, max] and [min, 360].

If min = max = 0, the intervallum will be [0, 360].

See Also