Core Graphics 之 PostScript Conversion （十六）

PostScript Conversion

预览应用程序自动将PostScript文件转换为PDF。Quartz 2D API提供了可用于在应用程序中执行PostScript转换的函数。Quartz 2D PostScript转换函数在iOS中不可用。

按照以下步骤将PostScript文档转换为PDF文档:
编写回调。Quartz通过回调来传递每个页面进程的状态。
填满一个回调结构。
创建PostScript转换器对象。
为要转换的PostScript文件创建数据提供程序对象。
为转换产生的PDF创建一个数据使用者对象。
执行转换。
下面各部分将讨论这些步骤。

Writing Callbacks

回调为Quartz提供了一种方法来通知应用程序转换的状态。如果应用程序有用户界面，可以使用状态信息向用户提供反馈，如图15-1所示。

屏幕快照 2018-08-28 下午1.26.30.png

您可以提供回调通知您的应用程序，Quartz 2D是:

开始转换(CGPSConverterBeginDocumentCallback)。Quartz 2D向您的回调传递一个指向您提供的数据的通用指针。
结束转换(CGPSConverterEndDocumentCallback)。Quartz 2D向您的回调传递了一个指向您提供的数据的通用指针和一个表示成功(真)或失败(假)的布尔值。
开始一个页面(CGPSConverterBeginPageCallback)。Quartz 2D向您的回调传递了一个泛型指针，指向您提供的数据、页码和一个CFDictionary对象(目前未使用)。
结束一个页面(CGPSConverterEndPageCallback)。Quartz 2D向您的回调传递了一个指向您提供的数据的通用指针和一个表示成功(真)或失败(假)的布尔值
正在进行转换(CGPSConverterProgressCallback)。在整个转换过程中定期调用此回调。Quartz 2D向您的回调传递一个指向您提供的数据的通用指针。
发送关于进程的消息(CGPSConverterMessageCallback)。在转换过程中可以发送几种类型的消息。最可能的是字体替换消息，以及PostScript代码本身生成的任何消息。写入stdout的所有PostScript消息都将通过此回调路由——通常是调试消息或状态消息。此外，如果文档格式不正确，可能会出现错误消息。
Quartz 2D向您的回调传递了一个指向您提供的数据的通用指针和一个包含转换消息的CFString对象。

释放PostScript转换器对象(CGPSConverterReleaseInfoCallback)。如果您已经提供了数据，那么可以使用这个回调来释放通用指针，并执行任何附加的后处理任务。Quartz 2D向您的回调传递一个指向您提供的数据的通用指针。
下面每个回调的原型请参阅CGPSConverter参考。

Filling In a Callbacks Structure

您需要为CGPSConverterCallbacks数据结构的适当字段分配一个版本号和创建的回调函数(如清单15-1所示)。版本是0。为不提供回调的字段分配NULL。
Listing 15-1 The PostScript converter callbacks data structure

struct CGPSConverterCallbacks {
   unsigned int version;
   CGPSConverterBeginDocumentCallback beginDocument;
   CGPSConverterEndDocumentCallback endDocument;
   CGPSConverterBeginPageCallback beginPage;
   CGPSConverterEndPageCallback endPage;
   CGPSConverterProgressCallback noteProgress;
   CGPSConverterMessageCallback noteMessage;
   CGPSConverterReleaseInfoCallback releaseInfo;
};

Creating a PostScript Converter Object

您可以调用CGPSConverterCreate函数来创建PostScript转换器对象。这个函数有三个参数:

指向要传递给回调的泛型数据的指针。如果不需要提供任何数据，则可以提供NULL。
一个指向填充的CGPSConverterCallbacks数据结构的指针。
NULL。这个字段是预留给将来使用的。

重要提示:尽管CGPSConverterConvert函数是线程安全的(它使用锁来防止在同一进程中同时进行多个转换)，但是对于资源管理器来说，它不是线程安全的。如果应用程序在单独的线程上使用资源管理器，您应该使用锁来防止在使用资源管理器时执行CGPSConverterConvert，或者使用PostScript转换器在单独的进程中执行转换。

Creating Data Provider and Data Consumer Objects

通过调用函数CGDataProviderCreateWithURL，您可以创建一个数据提供程序对象，它提供一个CFURL对象，该对象指定要转换的PostScript文件的地址。

类似地，您可以通过调用函数CGDataConsumerCreateWithURL来创建一个数据使用者对象，它提供一个CFURL对象，指定转换结果为PDF文档的地址。

Performing the Conversion

您可以调用CGPSConverterConvert函数来执行从PostScript到PDF的实际转换。此函数作为参数:

PostScript转换器对象。
提供PostScript数据的数据提供程序对象。
转换后的数据的数据使用者对象。
NULL。此参数保留以供将来使用。
如果转换成功，函数返回true。

您可以调用函数cgpsconverterisconversion来检查转换是否仍在进行。