Option attributes for the ColorMode feature

Important

We recommend that you use Microsoft's IPP inbox class driver, along with Print Support Apps (PSA), to customize the print experience in Windows 10 and 11 for printer device development.

For more information, see the Print support app design guide.

The following table lists the attributes associated with the ColorMode feature. For more information about the ColorMode feature, see Standard Features.

Attribute name	Attribute parameter	Comments
*Color?	TRUE or FALSE, indicating whether the option produces color.	Optional. If not specified, the default value is TRUE for *DrvBPP > 1. To create gray scaling, set to FALSE with *DrvBPP > 1.
*ColorPlaneOrder	LIST indicating the order in which Unidrv should send color plane data. Examples: LIST (YELLOW, MAGENTA, CYAN, BLACK) LIST (RED, GREEN, BLUE) Colors can be repeated in the list.	Required if *DevNumOfPlanes is greater than 1. The number of colors specified must equal *DevNumOfPlanes.
*DevBPP	Numeric value indicating the number of bits per pixel of color data supported by the printer.	Optional. If not specified, the default value is 1.
*DevNumOfPlanes	Numeric value indicating the number of color planes supported by the printer.	Optional. If not specified, the default value is 1. (For color printers, a value of 1 is referred to as pixel mode.)
*DrvBPP	Numeric value indicating the number of bits per pixel that Unidrv should use for its bitmap rendering buffer. The bitmap format is a Windows device-independent bitmap (DIB), and valid values are 1, 4, 8, 16, 24, or 32.	Optional. If not specified, the default value is 1. (For color printers, a value of 1 is referred to as "planar mode".) Windows DIBs always use one color plane.
*IPCallbackID	Positive numeric value, passed to the rendering plug-in's IPrintOemUni::ImageProcessing method as its IPCallbackID argument.	Required if a rendering plug-in is supplied that contains an IPrintOemUn::ImageProcessing method.
*PaletteProgrammable	TRUE or FALSE, indicating whether the color palette is programmable.	Optional. If not specified, the default value is FALSE.
*PaletteSize	Numeric value representing the number of entries in the color palette used with the specified option.	Optional. If not specified, the default value is 2.
*RasterMode	DIRECT or INDEXED, indicating whether the raster data is sent directly to the printer or is indexed through a color palette.	Optional. If not specified, the default value is INDEXED.

For examples, see the sample GPD files.

For information about additional option attributes, see Option Attributes for All Features.

Also see Controlling Image Quality.