大网数据广告活动
打印与设备

Color Management and the Print Schema

· 52CE 我爱测

Learn about user configurable keywords in the Print Schema for color management, such as PageColorManagement and PageBlackGenerationProcessing.

This topic is not current. For the most current information, see the Print Schema Specification.

User Configurable Element keywords may either be XPS specific or non-XPS specific. In the case where they are not XPS specific, the keyword may be used for Legacy GDI-based printing. If an application decides to set these keywords in a PrintTicket, it is up to the driver to determine the proper action and behavior to take based on the definitions presented in the Print Schema. Any of these keywords may be used in the context of ICM. For more information, please see the Windows Vista SDK.

Print Schema User Configurable Keyword DEVMODE Equivalent XPS Specific
PageColorManagement dmICMMethod No
PageBlackGenerationProcessing None Yes
PageBlendColorSpace None Yes
PageSourceColorProfile None No
PageDestinationColorProfile None No
PageICMRenderingIntent dmICMIntent No
JobOptimalDestinationColorProfile None No
PageDeviceColorSpaceUsage None Yes

PageColorManagement System Handling

For PageColorManagement, the system provides automatic handling of PrintTicket to DEVMODE or DEVMODE to PrintTicket conversion if necessary. This depends on the specific print path between the application (Win32 or WPF)and the driver (GDI-based or XPSDrv). In the case of printing from a Windows Presentation Foundation application to a Microsoft XPSDrv print driver, a PageColorManagement public option of System SHOULD NOT be advertised in either the PrintTicket or PrintCapabilities document; in this case, color management cannot be handled automatically by the system. Printing from a Win32 application to a Microsoft XPSDrv print driver may result in color management between the application and GDI, however after conversion to XPS-format, there will be no automatic system handling of color management between the XPS document and the driver and/or device, because the XPS-format tags each element with complete color information, and it is up to the driver or the device to process this information.

PageColorManagement Public Options DEVMODE Value
None DMICMMETHOD_NONE
Device DMICMMETHOD_DEVICE
Driver DMICMMETHOD_DRIVER
System DMICMMETHOD_SYSTEM

PageICMRenderingIntent System Handling

For PageICMRenderingIntent, the system provides automatic handling of PrintTicket to DEVMODE or DEVMODE to PrintTicket conversion if necessary. This depends on the specific print path between the application (Win32 or Windows Presentation Foundation) and the driver (GDI-based or XPSDrv).

PageICMRenderingIntent Public Options DEVMODE Value
AbsoluteColorimetric DMICM_ABS_COLORIMETRIC
RelativeColorimetric DMICM_COLORIMETRIC
Photographs DMICM_CONTRAST
BusinessGraphics DMICM_SATURATE

All other Color Management related keywords (besides PageColorManagement or PageICMRenderingIntent) do not have such automatic handling.

JobOptimalDestinationColorProfile and PageDestinationColorProfile Usage

An application MAY decide to query PrintCapabilities document for JobOptimalDestinationColorProfile. This could give an application the optimal color profile given the current device configuration as defined in the PrintCapabilities document. If the application decides it would like the driver to perform color management to the destination color profile specified by JobOptimalDestinationColorProfile, then PageColorManagement and PageDestinationColorProfile would be set to Driver and DriverConfiguration in the PrintTicket respectively. If the application does not want to use the JobOptionalDestinationColorProfile and chooses to use its own, it SHOULD set PageColorManagement to None and also set the PageDestinationColorProfile to Application in the PrintTicket to convey that the application has already performed color management to its specified destination color profile. Another scenario may occur when the application chooses to use the optimal destination color profile returned by the drivers PrintCapabilities but decides to do color management on its own. In this case, PageColorManagement would be set to None and PageDestinationColorProfile would be set to Application.

PageSourceColorProfile Usage

For PageSourceColorProfile, an application MAY specify a source color profile for each page in the PrintTicket, regardless of the option selected for PageColorManagement. Whether it is present or not, it is up to the driver to decide the behavior for each case based on the definitions presented in the Print Schema. For example, an application may set PageColorManagement to None, and then not set PageSourceColorProfile in the PrintTicket. It is also possible for an application to set PageColorManagement to Driver, and then set PageSourceColorProfile in the PrintTicket; the driver in this case is responsible for determining the behavior within the guidelines of the PrintSchema.

PageDeviceColorSpaceUsage

PageDeviceColorSpaceUsage is an XPS specific user configurable element that is set by the application. It provides instructions for the device by setting the appropriate option in the PrintTicket, for color space profile handling associated within an XPS document. The application and/or existing PrintTicket MAY specify this keyword in a PrintTicket sent to the device. Whether it is present or not, it is up to the driver to decide the behavior for each case, based on the definitions presented in the Print Schema.

Print Schema Color Management Example Flow

The following diagram illustrates flow for the most likely scenarios for using Color Management and the Print Schema. For simplicity and readability, only the following user configurable Print Schema keywords were used to demonstrate their usage: PageColorManagement, JobOptimalDestinaionColorProfile, PageSourceColorProfile, and PageDestinationColorProfile. A solid line represents an action that SHOULD occur and a dashed line represents an action that MAY occur. The following scenario is not the guaranteed interaction that will result between the application, driver, and system, however, it represents the most common usage case that will occur.

a diagram that shows how color management settings are processed

Related topics

Print Schema Specification

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。