HueSaturationLightnessParams structure (gdipluseffects.h)

The HueSaturationLightnessParams structure contains members that specify hue, saturation and lightness adjustments to a bitmap.

You can adjust the hue, saturation, and lightness of a bitmap by following these steps.

  1. Create and initialize a HueSaturationLightnessParams structure.
  2. Pass the address of the HueSaturationLightnessParams structure to the HueSaturationLightness::SetParameters method of a HueSaturationLightness object.
  3. Pass the address of the HueSaturationLightness object to the Graphics::DrawImage method or to the Bitmap::ApplyEffect method.

Syntax

struct HueSaturationLightnessParams {
  INT hueLevel;
  INT saturationLevel;
  INT lightnessLevel;
};

Members

hueLevel

Type: INT

Integer in the range -180 through 180 that specifies the change in hue. A value of 0 specifies no change. Positive values specify counterclockwise rotation on the color wheel. Negative values specify clockwise rotation on the color wheel.

saturationLevel

Type: INT

Integer in the range -100 through 100 that specifies the change in saturation. A value of 0 specifies no change. Positive values specify increased saturation and negative values specify decreased saturation.

lightnessLevel

Type: INT

Integer in the range -100 through 100 that specifies the change in lightness. A value of 0 specifies no change. Positive values specify increased lightness and negative values specify decreased lightness.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Header gdipluseffects.h (include Gdiplus.h)