Edit

CompositingQuality enumeration (gdiplusenums.h)

  • Article

The CompositingQuality enumeration specifies whether gamma correction is applied when colors are blended with background colors. This enumeration is used by the Graphics::GetCompositingQuality and Graphics::SetCompositingQuality methods of the Graphics class.

Syntax

typedef enum CompositingQuality {
  CompositingQualityInvalid,
  CompositingQualityDefault,
  CompositingQualityHighSpeed,
  CompositingQualityHighQuality,
  CompositingQualityGammaCorrected,
  CompositingQualityAssumeLinear
} ;

Constants

 
CompositingQualityInvalid
CompositingQualityDefault
Specifies that gamma correction is not applied.
CompositingQualityHighSpeed
Specifies that gamma correction is not applied.
CompositingQualityHighQuality
Specifies that gamma correction is applied.
CompositingQualityGammaCorrected
Specifies that gamma correction is applied.
CompositingQualityAssumeLinear
Specifies that gamma correction is not applied.

Remarks

When you specify that gamma correction should not be applied, the image data to be rendered (blended with the background) is assumed to be in a linear color space with a gamma value of 1.0. As a result, no gamma adjustment is applied to the image data before or after blending the image with the background.

When you specify that gamma correction should be applied, the image data to be rendered (blended with the background) is assumed to be in the sRGB color space with a gamma value of 2.2. To ensure accurate blending, the input image data is transformed into a linear (gamma = 1.0) space before the colors are blended and transformed back into sRGB (gamma = 2.2) space afterward. This mode results in a more accurate blend at the expense of additional processing time.

Requirements

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header gdiplusenums.h (include Gdiplus.h)

See also

Graphics::GetCompositingQuality

Graphics::SetCompositingQuality