以下各節(jié)將討論這些步驟中的每一步。

Writing Callbacks - 寫回調(diào)

回調(diào)為Quartz提供了一種向應(yīng)用程序通知轉(zhuǎn)換狀態(tài)的方法。 如果您的應(yīng)用程序具有用戶界面，則可以使用狀態(tài)信息向用戶提供反饋，如圖15-1所示。

Figure 15-1 A status message for a PostScript conversion application

您可以提供回調(diào)以通知您的應(yīng)用程序Quartz 2D是：

• 開始轉(zhuǎn)換（CGPSConverterBeginDocumentCallback）。 Quartz 2D將您的回調(diào)傳遞給您提供的數(shù)據(jù)的通用指針。
• 結(jié)束轉(zhuǎn)換（CGPSConverterEndDocumentCallback）。 Quartz 2D將您的回調(diào)傳遞給您提供的數(shù)據(jù)的通用指針，以及指示成功（true）或失敗（false）的布爾值。
• 啟動(dòng)頁面（CGPSConverterBeginPageCallback）。 Quartz 2D將您的回調(diào)傳遞給您提供的數(shù)據(jù)的通用指針，頁碼和當(dāng)前未使用的CFDictionary對(duì)象。
• 結(jié)束頁面（CGPSConverterEndPageCallback）。 Quartz 2D將您的回調(diào)傳遞給您提供的數(shù)據(jù)的通用指針，以及指示成功（true）或失敗（false）的布爾值
• 進(jìn)行轉(zhuǎn)換（CGPSConverterProgressCallback）。在整個(gè)轉(zhuǎn)換過程中會(huì)定期調(diào)用此回調(diào)。 Quartz 2D將您的回調(diào)傳遞給您提供的數(shù)據(jù)的通用指針。
• 發(fā)送有關(guān)進(jìn)程的消息（CGPSConverterMessageCallback）。在轉(zhuǎn)換過程中可以發(fā)送多種消息。最有可能的是字體替換消息，以及PostScript代碼本身生成的任何消息。寫入stdout的任何PostScript消息都通過此回調(diào)進(jìn)行路由 - 通常這些是調(diào)試或狀態(tài)消息。此外，如果文檔格式錯(cuò)誤，可能會(huì)出現(xiàn)錯(cuò)誤消息。Quartz 2D將您的回調(diào)傳遞給您提供的數(shù)據(jù)的通用指針和包含有關(guān)轉(zhuǎn)換的消息的CFString對(duì)象。
• 銷毀PostScript轉(zhuǎn)換器對(duì)象（CGPSConverterReleaseInfoCallback）。如果您已提供數(shù)據(jù)并執(zhí)行任何其他后處理任務(wù)，則可以使用此回調(diào)來銷毀通用指針。 Quartz 2D將您的回調(diào)傳遞給您提供的數(shù)據(jù)的通用指針。

有關(guān)每個(gè)回調(diào)的原型，請(qǐng)參閱CGPSConverter Reference。

Filling In a Callbacks Structure - 填充回調(diào)結(jié)構(gòu)

您需要將您創(chuàng)建的版本號(hào)和回調(diào)分配給CGPSConverterCallbacks數(shù)據(jù)結(jié)構(gòu)的相應(yīng)字段（如Listing 15-1所示）。 版本為0，為您不提供回調(diào)的字段分配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 - 創(chuàng)建PostScript轉(zhuǎn)換器對(duì)象

您調(diào)用函數(shù)CGPSConverterCreate來創(chuàng)建PostScript轉(zhuǎn)換器對(duì)象。 該函數(shù)有三個(gè)參數(shù)：

• 指向要傳遞給回調(diào)的通用數(shù)據(jù)的指針。 如果您不需要提供任何數(shù)據(jù)，則可以提供NULL。
• 指向已填寫的CGPSConverterCallbacks數(shù)據(jù)結(jié)構(gòu)的指針。
• NULL。 該字段留作將來使用。

重要說明：雖然CGPSConverterConvert函數(shù)是線程安全的（它使用鎖來防止同一進(jìn)程中一次進(jìn)行多次轉(zhuǎn)換），但它對(duì)資源管理器來說不是線程安全的。 如果您的應(yīng)用程序在單獨(dú)的線程上使用資源管理器，您應(yīng)該使用鎖來防止在使用資源管理器期間執(zhí)行CGPSConverterConvert，或者您應(yīng)該在單獨(dú)的進(jìn)程中使用PostScript轉(zhuǎn)換器執(zhí)行轉(zhuǎn)換。

Creating Data Provider and Data Consumer Objects - 創(chuàng)建數(shù)據(jù)提供者和數(shù)據(jù)使用者對(duì)象

您可以通過調(diào)用函數(shù)CGDataProviderCreateWithURL來創(chuàng)建數(shù)據(jù)提供程序?qū)ο螅瑥亩峁?code>CFURL對(duì)象，該對(duì)象指定要轉(zhuǎn)換的PostScript文件的地址。

類似地，通過調(diào)用函數(shù)CGDataConsumerCreateWithURL創(chuàng)建數(shù)據(jù)使用者對(duì)象，提供CFURL對(duì)象，該對(duì)象指定轉(zhuǎn)換產(chǎn)生的PDF文檔的地址。

Performing the Conversion - 進(jìn)行轉(zhuǎn)換

您調(diào)用函數(shù)CGPSConverterConvert來執(zhí)行從PostScript到PDF的實(shí)際轉(zhuǎn)換。 該函數(shù)作為參數(shù)：

• PostScript轉(zhuǎn)換器對(duì)象。
• 提供PostScript數(shù)據(jù)的數(shù)據(jù)提供程序?qū)ο蟆?/li>
• 轉(zhuǎn)換數(shù)據(jù)的數(shù)據(jù)使用者對(duì)象。
• NULL。 此參數(shù)保留供將來使用。

如果轉(zhuǎn)換成功，則該函數(shù)返回true。

您可以調(diào)用函數(shù)CGPSConverterIsConverting來檢查轉(zhuǎn)換是否仍在進(jìn)行中。

后記

本篇主要講述了PostScript轉(zhuǎn)換，感興趣的給個(gè)贊或者關(guān)注~~~