COLORINFO structure (winddi.h)
The COLORINFO structure defines a device's colors in CIE coordinate space.
Syntax
typedef struct _COLORINFO {
CIECHROMA Red;
CIECHROMA Green;
CIECHROMA Blue;
CIECHROMA Cyan;
CIECHROMA Magenta;
CIECHROMA Yellow;
CIECHROMA AlignmentWhite;
LDECI4 RedGamma;
LDECI4 GreenGamma;
LDECI4 BlueGamma;
LDECI4 MagentaInCyanDye;
LDECI4 YellowInCyanDye;
LDECI4 CyanInMagentaDye;
LDECI4 YellowInMagentaDye;
LDECI4 CyanInYellowDye;
LDECI4 MagentaInYellowDye;
} COLORINFO, *PCOLORINFO;
Members
Red
Green
Blue
Cyan
Magenta
Yellow
AlignmentWhite
Specify CIECHROMA structures that each define the x-coordinate, y-coordinate, and Y-coordinate (luminance) of the named color.
The Cyan member can have a special meaning for monochrome printers. Cyan.Y must be set to 65534 (0xFFFE) to enable all of the grayscale halftone pattern sizes. For more information, see the following Remarks section.
RedGamma
GreenGamma
BlueGamma
Are the gamma corrections of display devices that permit the display device to display colors between the primary colors with accuracy. The values of these members should be in the range from 0 through 6.5535, which means that the numbers that are actually stored in these members must be in the range from 0 through 65535. For more information about these members and this data type, see the following Remarks section.
MagentaInCyanDye
YellowInCyanDye
CyanInMagentaDye
YellowInMagentaDye
CyanInYellowDye
MagentaInYellowDye
Used for printing devices to describe color purity and concentration. Values should be between zero and one, which means that the numbers actually stored in these members must be in the range 0 through 10000. For more information about this data type, see the following Remarks section.
Remarks
The LDECI4 type is used to represent real numbers to four decimal places. For example, (LDECI4) 10000 represents the real number 1.0000, and (LDECI4) -12345 represents -1.2345.
For a monochrome printer, if you set the luminance for the Cyan member (that is, Cyan.Y) to 65534 (0xFFFE), you can select any of the available halftone pattern sizes. To select a halftone pattern size for a monochrome printer, set the ulHTPatternSize member of the GDIINFO structure to the halftone pattern size that you want. If Cyan.Y is not set to 65534 (0xFFFE), halftone pattern sizes other than HT_PATSIZE_8x8_M or HT_PATSIZE_8x8 are converted to HT_PATSIZE_DEFAULT.
Setting the RedGamma, BlueGamma, and GreenGamma members of this structure to 0xFFFF can affect color management in printers when Image Color Management (ICM) is disabled. In this situation, the GDI halftone module switches from performing its own color management to performing none, which potentially can cause a significant change in the resulting printer output. When ICM is enabled (and RedGamma, BlueGamma, and GreenGamma are set to 0XFFFF), there is no difference in color output. For more information, see Color Management for Printers.
Any values in the COLORINFO structure that are out of the specified range default to the NTSC values.
Requirements
| Requirement | Value |
|---|---|
| Header | winddi.h (include Winddi.h) |