Option attributes for the ColorMode feature
Important
The modern print platform is Windows' preferred means of communicating with printers. 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 Modern print platform and 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 information about additional option attributes, see Option Attributes for All Features.
Also see Controlling Image Quality.