版本记录
| 版本号 | 时间 |
|---|---|
| V1.0 | 2018.09.08 |
前言
Quartz 2D框架相信大家都知道，也都一直在使用。Quartz 2D的API是纯C语言的，它是一个二维绘图引擎，同时支持iOS和Mac系统。Quartz 2D的API来自于Core Graphics框架，数据类型和函数基本都以CG作为前缀，接下来几篇我们就一起来看一下这个框架。感兴趣可以看上面几篇文章。
1. Quartz 2D编程指南 （一） —— 简介（一）
2. Quartz 2D编程指南 （二） —— Quartz 2D概览（二）
3. Quartz 2D编程指南 （三） —— 图形上下文（三）
4. Quartz 2D编程指南 （四） —— Paths路径（一）
5. Quartz 2D编程指南 （五） —— Paths路径（二）
6. Quartz 2D编程指南 （六） —— 颜色和颜色空间（一）
7. Quartz 2D编程指南 （七） —— 变换（一）
8. Quartz 2D编程指南 （八） —— Patterns图案样式（一）
9. Quartz 2D编程指南 （九） —— 阴影（一）
10. Quartz 2D编程指南 （十） —— 渐变（一）
11. Quartz 2D编程指南 （十一） —— 透明层（一）
12. Quartz 2D编程指南 （十二） —— Quartz 2D中的数据管理（一）
13. Quartz 2D编程指南 （十三） —— 位图图像和图像蒙版（一）
14. Quartz 2D编程指南 （十四） —— 位图图像和图像蒙版（二）
15. Quartz 2D编程指南 （十五） —— Core Graphics图层绘制（一）
16. Quartz 2D编程指南 （十六） —— PDF文档创建，查看和转换（一）
17. Quartz 2D编程指南 （十七） —— PDF文件解析（一）
PostScript Conversion - PostScript转换
注意：
Quartz 2D PostScript转换功能在iOS中不可用。所以不感兴趣的可以略过此篇文章。
预览应用程序自动将PostScript文件转换为PDF。 Quartz 2D API提供了可用于在应用程序中执行PostScript转换的函数。 Quartz 2D PostScript转换功能在iOS中不可用。
按照以下步骤将PostScript文档转换为PDF文档：
- 1） Write callbacks - 写回调。 Quartz通过回调传达每页进程的状态。
- 2） Fill a callbacks structure - 填充回调结构。
- 3） Create a PostScript converter object - 创建PostScript转换器对象。
- 4） Creating a PostScript Converter Object - 为要转换的PostScript文件创建数据提供程序对象。
- 5） Creating Data Provider and Data Consumer Objects - 为转换产生的PDF创建数据使用者对象。
- 6） Performing the Conversion - 执行转换。
以下各节将讨论这些步骤中的每一步。
Writing Callbacks - 写回调
回调为Quartz提供了一种向应用程序通知转换状态的方法。 如果您的应用程序具有用户界面，则可以使用状态信息向用户提供反馈，如图15-1所示。
您可以提供回调以通知您的应用程序Quartz 2D是：
- 开始转换
（CGPSConverterBeginDocumentCallback）。 Quartz 2D将您的回调传递给您提供的数据的通用指针。 - 结束转换
（CGPSConverterEndDocumentCallback）。 Quartz 2D将您的回调传递给您提供的数据的通用指针，以及指示成功（true）或失败（false）的布尔值。 - 启动页面
（CGPSConverterBeginPageCallback）。 Quartz 2D将您的回调传递给您提供的数据的通用指针，页码和当前未使用的CFDictionary对象。 - 结束页面
（CGPSConverterEndPageCallback）。 Quartz 2D将您的回调传递给您提供的数据的通用指针，以及指示成功（true）或失败（false）的布尔值 - 进行转换
（CGPSConverterProgressCallback）。在整个转换过程中会定期调用此回调。 Quartz 2D将您的回调传递给您提供的数据的通用指针。 - 发送有关进程的消息
（CGPSConverterMessageCallback）。在转换过程中可以发送多种消息。最有可能的是字体替换消息，以及PostScript代码本身生成的任何消息。写入stdout的任何PostScript消息都通过此回调进行路由 - 通常这些是调试或状态消息。此外，如果文档格式错误，可能会出现错误消息。Quartz 2D将您的回调传递给您提供的数据的通用指针和包含有关转换的消息的CFString对象。 - 销毁
PostScript转换器对象（CGPSConverterReleaseInfoCallback）。如果您已提供数据并执行任何其他后处理任务，则可以使用此回调来销毁通用指针。 Quartz 2D将您的回调传递给您提供的数据的通用指针。
有关每个回调的原型，请参阅CGPSConverter Reference。
Filling In a Callbacks Structure - 填充回调结构
您需要将您创建的版本号和回调分配给CGPSConverterCallbacks数据结构的相应字段（如Listing 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 - 创建PostScript转换器对象
您调用函数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。
您可以调用函数CGPSConverterIsConverting来检查转换是否仍在进行中。
后记
本篇主要讲述了PostScript转换，感兴趣的给个赞或者关注~~~
