LOGCOLORSPACE

The LOGCOLORSPACE structure contains information that defines a logical color space.

typedef struct tagLOGCOLORSPACE {
DWORD lcsSignature;

DWORD lcsVersion;

DWORD lcsSize;

LCSCSTYPE lcsCSType;

LCSGAMUTMATCH lcsIntent;

CIEXYZTRIPLE lcsEndpoints;
DWORD lcsGammaRed;
DWORD lcsGammaGreen;

DWORD lcsGammaBlue;
TCHAR lcsFilename[MAX_PATH];

} LOGCOLORSPACE, *LPLOGCOLORSPACE;

Members

lcsSignature

Color space signature.

lcsVersion

Version number; must be 0x400.

lcsSize

Size of this structure, in bytes.

lcsCSType

Color space type. Can be one of the following values:

Value Meaning
LCS_DEVICE_RGB Color values are device RGB values. The values are passed to the device without translation.
LCS_DEVICE_CMYK Color values are device CMYK values. The values are passed to the device without translation
LCS_CALIBRATED_RGB Color values are calibrated RGB values. The values are translated using the endpoints specified by the lcsEndpoints member before being passed to the device.

If LCS_CALIBRATED_RGB is not specified, the lcsEndpoints member is ignored.

lcsIntent

The gamut matching method. Can be one of the following values:

Value Meaning
LCS_GM_BUSINESS Maintain saturation. Used for business charts and other situations in which undithered colors are required.
LCS_GM_GRAPHICS Maintain colormetric match. Used for graphic designs and named colors.
LCS_GM_IMAGES Maintain contrast. Used for photographs and natural images.

lcsEndpoints

Red, green, blue endpoints.

lcsGammaRed

Scale of the red coordinate.

lcsGammaGreen

Scale of the green coordinate.

lcsGammaBlue

Scale of the blue coordinate.

lcsFilename

A null-terminated string that names a color profile file. This member is typically set to zero, but may be used to set the color space to be exactly as specified by the color profile. This is useful for devices that input color values for a specific printer, or when using an installable image color matcher. If a color profile is specified, all other members of this structure should be set to reasonable values, even if the values are not 100 percent accurate.

See Also

RGB, CMYK