Edit

Share via

TintParams structure (gdipluseffects.h)

  • Article

A TintParams structure contains members that specify the nature of a tint adjustment to a bitmap.

You can adjust the tint of a bitmap by following these steps.

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

Syntax

struct TintParams {
  INT hue;
  INT amount;
};

Members

hue

Type: INT

Integer in the range -180 through 180 that specifies the hue to be strengthened or weakened. A value of 0 specifies blue. A positive value specifies a clockwise angle on the color wheel. For example, positive 60 specifies cyan and positive 120 specifies green. A negative value specifies a counter-clockwise angle on the color wheel. For example, negative 60 specifies magenta and negative 120 specifies red.

amount

Type: INT

Integer in the range -100 through 100 that specifies how much the hue (given by the hue parameter) is strengthened or weakened. A value of 0 specifies no change. Positive values specify that the hue is strengthened and negative values specify that the hue is weakened.

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)