Table of contents
TOC
Collapse the table of content
Expand the table of content

Color Attributes

Last Updated: 9/16/2016

Color attributes are general printing attributes that specify characteristics for controlling color printing.

The following table lists the color attributes.

Attribute NameAttribute ParameterComments

ChangeColorModeOnDoc?

TRUE or FALSE. Indicates whether a printer's color mode can be changed between pages of a document without side effects.

Optional. If not specified, the default value is TRUE. Unidrv uses this value to optimize printing speed. For additional information, see Note following this table.

CyanInMagentaDye

Numeric value, from 0 to 1000, indicating the percentage of cyan contamination in magenta dye. The value is the contamination percentage times 100. For example, 8.4% contamination is specified as 840 and 10% is 1000.

Optional. If not specified, a Unidrv-supplied default value is used.

CyanInYellowDye

Numeric value, from 0 to 1000, indicating the percentage of cyan contamination in yellow dye. The value is the contamination percentage times 100. For example, 8.4% contamination is specified as 840 and 10% is 1000.

Optional. If not specified, a Unidrv-supplied default value is used.

EnableGDIColorMapping

TRUE or FALSE. Indicates whether GDI should perform gamut mapping from display to printer color space.

Optional. If not specified, the default value is FALSE. If TRUE, Unidrv sets the HT_FLAG_DO_DEVCLR_XFORM flag in the GDIINFO structure.

MagentaInCyanDye

Numeric value, from 0 to 1000, indicating the percentage of magenta contamination in cyan dye. The value is the contamination percentage times 100. For example, 8.4% contamination is specified as 840 and 10% is 1000.

Optional. If not specified, a Unidrv-supplied default value is used.

MagentaInYellowDye

Numeric value, from 0 to 1000, indicating the percentage of magenta contamination in yellow dye. The value is the contamination percentage times 100. For example, 8.4% contamination is specified as 840 and 10% is 1000.

Optional. If not specified, a Unidrv-supplied default value is used.

YellowInCyanDye

Numeric value, from 0 to 1000, indicating the percentage of yellow contamination in cyan dye. The value is the contamination percentage times 100. For example, 8.4% contamination is specified as 840 and 10% is 1000.

Optional. If not specified, a Unidrv-supplied default value is used.

YellowInMagentaDye

Numeric value, from 0 to 1000, indicating the percentage of yellow contamination in magenta dye. The value is the contamination percentage times 100. For example, 8.4% contamination is specified as 840 and 10% is 1000.

Optional. If not specified, a Unidrv-supplied default value is used.

Note When the *ChangeColorModeOnDoc? color attribute is set to TRUE, color optimization is enabled. When this attribute is set to FALSE, no optimization is performed. When color optimization is enabled, the presence of color in the spool file causes the spool file to be played in color; the lack of color in the spool file causes the spool file to be played in monochrome. If you are creating a Unidrv rendering plug-in to generate color watermarks, be advised that color optimization causes color watermarks to be printed in black and white when they are printed on black-and-white documents. To ensure that color watermarks print correctly with color and black-and-white documents, disable color optimization.

The color optimization controlled by the *ChangeColorModeOnDoc? color attribute can also be controlled by setting the dwColorOptimization member of the ATTRIBUTE_INFO_2 or ATTRIBUTE_INFO_3 structures. Color optimization also can be controlled by using the GdiEndPageEMF function.

For examples of the color attributes listed on this page, see the sample GPD files.


Send comments about this topic to Microsoft

© 2016 Microsoft