App Support for OpenXPS Printing

OpenXPS is the Open XML Paper Specification format for documents, and it’s based on the European Carton Makers Association (ECMA) standard specification.

Windows 8 provides full support for OpenXPS printing via the v4 print driver model, side-by-side with continued support for the Microsoft XPS format. And this topic focuses on the portion of this support that is relevant to Windows application developers. For information about driver requirements for OpenXPS support, see Driver Support for OpenXPS.

Sending XPS data to the Print System

We recommend that you use IPrintDocumentPackageTarget for sending all XPS print jobs to the print system. IPrintDocumentPackageTarget accepts the XPS object model (OM) without serialization, and that helps to improve the overall performance.

Here's a brief summary of the IPrintDocumentPackageTarget interface:

  • This interface supports printing from tailored solutions as well as desktop applications.

  • For desktops apps, this can be used in place of StartXpsPrintJob1.

  • Available on Windows 7 with Service Pack 1 (SP1) + Platform Update, and Windows 8.

  • Include DocumentTarget.h in projects to use these APIs.

Applications that consume OpenXPS documents should note that the MIME type for OpenXPS is as follows:

application\oxps

Sending OpenXPS data to the XPS Print API

Specific to OpenXPS, XPS OM accepts both MSXPS and OpenXPS, and provides methods for conversion and serialization to either format. This allows application developers to be agnostic of the target driver, if they want. This also means that app developers can always submit print jobs as XPS OM to either StartXpsPrintJob1 or IDocumentPackageTarget, knowing that the print system will handle any necessary conversion.

Of course, preventing conversion between XPS formats will improve end-to-end performance. From the application, the developer can check the following registry key to determine the preferred XPS format of the targeted print driver:

HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Print\Printers\[PrintDriverName]\PrintDriverData\XpsFormat

Once the preferred XPS format has been determined, the application can provide XPS OM objects that will not require conversion. Of particular note is the use of HD Photo in MSXPS and JPEGXR in OpenXPS. Converting from JPEGXR to HD Photo is relatively lightweight since the primary difference in this conversion is that HD Photo ignores 4 control bits that JPEGXR requires. However, converting from HD Photo to JPEGXR requires the entire image to be re-encoded in order to generate the required control bits. Thus, providing JPEGXR images for high-resolution images will ensure compatibility with OpenXPS and minimize the conversion cost of the image for MSXPS.

The Xpsobjectmodel_1.h header defines the additional APIs and objects for OpenXPS. And the IXpsOMObjectFactory1 interface provides additional methods for image conversion. Here's the syntax:


IXpsOMObjectFactory1->ConvertHDPhotoToJpegXR(IXpsOMImageResource *imageResource);

IXpsOMObjectFactory1->ConvertJpegXRToHDPhoto(IXpsOMImageResource *imageResource);


Windows 8 provides the following new and updated enumerations.

New enumeration:

XPS_DOCUMENT_TYPE

Updated enumeration

XPS_IMAGE_TYPE

The new GetDocumentType methods allow an application to determine the XPS format of documents. These are available in IXpsOMObjectFactory1, IXpsOMPackage1, and IXpsOMPage1. Here's a list of the methods.

IXpsOMObjectFactory1::GetDocumentTypeFromFile

IXpsOMObjectFactory1::GetDocumentTypeFromStream

IXpsOMPackage1::GetDocumentType

IXpsOMPage1::GetDocumentType

Windows 8 provides the following new error codes in support of OpenXPS:

XPS_E_MISMATCHED_NAMESPACE.

This error is returned, if there is a mismatched namespace.

XPS_E_ABSOLUTE_REFERENCE.

This error is returned if MSXPS uses absolute URIs in internal references, or attempts to use internal references to serialize in the stream. That is because XPS OM generates relative URIs. And although MSXPS supports both relative and absolute URIs, OpenXPS requires relative URIs.

Related topics

Driver Support for OpenXPS
IPrintDocumentPackageTarget
IXpsOMObjectFactory1::GetDocumentTypeFromFile
IXpsOMObjectFactory1::GetDocumentTypeFromStream
IXpsOMPackage1::GetDocumentType
IXpsOMPage1::GetDocumentType
XPS_DOCUMENT_TYPE
XPS_IMAGE_TYPE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft