Quartz 2D編程指南(13) －

PDF文檔存儲依賴於分辨率的向量圖形、文本和位圖，並用於程序的一系列指令中。一個PDF文檔可以包含多頁的圖形和文本。PDF可用於創建跨平臺、只讀的文檔，也可用於繪製依賴於分辨率的圖形。
Quartz爲所有應用程序創建高保真的PDF文檔，這些文檔保留應用的繪製操作，如圖13-1所示。PDF文檔的結果將通過系統的其它部分或第三方法的產品來有針對性地進行優化。Quartz創建的PDF文檔在Preview和Acrobat中都能正確的顯示。

Quartz不僅僅只使用PDF作爲它的數字頁，它同樣包含一些API來顯示和生成PDF文件，及完成一些其它PDF相關的工作。

打開和查看PDF
Quartz提供了CGPDFDocumentRef數據類型來表示PDF文檔。我們可以使用CGPDFDocumentCreateWithProvider或CGPDFDocumentCreateWithURL來創建CGPDFDocument對象。在創建CGPDFDocument對象後，我們可以將其繪製到圖形上下文中。圖13-2顯示了在一個窗體中繪製PDF文檔。

代碼清單13-1顯示瞭如何創建一個CGPDFDocument對象及獲取文檔的頁數。

複製代碼

CGPDFDocumentRefMyGetPDFDocumentRef (const char *filename)
{
CFStringRef path;
CFURLRef url;
CGPDFDocumentRef document;
size_t count;
path = CFStringCreateWithCString (NULL, filename, kCFStringEncodingUTF8);
url = CFURLCreateWithFileSystemPath (NULL, path, kCFURLPOSIXPathStyle,0); // 1 創建CFURL對象
CFRelease (path);
document = CGPDFDocumentCreateWithURL (url); // 2 創建CFPDFDocument對象
CFRelease(url);
count = CGPDFDocumentGetNumberOfPages (document); // 3 獲取文檔頁數
if (count == 0) {
printf("`%s' needs at least onepage!", filename);
return NULL;
}
return document;
}

代碼清單顯示瞭如何將一個PDF頁繪製到圖形上下文中。

複製代碼

void MyDisplayPDFPage (CGContextRefmyContext, size_t pageNumber, const char *filename)
{
CGPDFDocumentRef document;
CGPDFPageRef page;
document = MyGetPDFDocumentRef (filename); // 1 創建PDFDocument對象
page = CGPDFDocumentGetPage (document, pageNumber); // 2 獲取指定頁的PDF文檔
CGContextDrawPDFPage (myContext, page); // 3 將PDF繪製到圖形上下文中
CGPDFDocumentRelease (document);
}

爲PDF頁創建一個轉換
Quartz提供了函數CGPDFPageGetDrawingTransform來創建一個仿射變換，該變換基於將PDF頁的BOX映射到指定的矩形中。函數原型是：

複製代碼

CGAffineTransformCGPDFPageGetDrawingTransform (
CGPPageRef page,
CGPDFBox box,
CGRect rect,
int rotate,
bool preserveAspectRatio
);

該函數通過如下算法來返回一個仿射變換：
· 將在box參數中指定的PDF box的類型相關的矩形(media, crop, bleed, trim, art)與指定的PDF頁的/MediaBox入口求交集。相交的部分即爲一個有效的矩形(effectiverectangle)。
· 將effective rectangle旋轉參數/Rotate入口指定的角度。
· 將得到的矩形放到rect參數指定的中間。
· 如果rotate參數是一個非零且是90的倍數，函數將effective rectangel旋轉該值指定的角度。正值往右旋轉；負值往左旋轉。需要注意的是我們傳入的是角度，而不是弧度。記住PDF頁的/Rotate入口也包含一個旋轉，我們提供的rotate參數是與/Rotate入口接合在一起的。
· 如果需要，可以縮放矩形，從而與我們提供的矩形保持一致。
· 如果我們通過傳遞true值給preserveAspectRadio參數以指定保持長寬比，則最後的矩形將與rect參數的矩形的邊一致。

【注：上面這段翻譯得不是很好】

例如，我們可以使用這個函數來創建一個與圖13-3類似的PDF瀏覽程序。如果我們提供一個Rotate Left/Rotate Right屬性，則可以調用CGPDFPageGetDrawingTransform來根據當前的窗體大小和旋轉設置計算出適當的轉換。

程序清單13-3顯示了爲一個PDF頁創建及應用仿射變換，然後繪製PDF。

複製代碼

Listing 13-3 Creating an affine transform for aPDF page
void MyDrawPDFPageInRect(CGContextRef context, CGPDFPageRef page, CGPDFBox box, CGRect rect, int rotation, bool preserveAspectRatio)
{
CGAffineTransform m;
m = CGPDFPageGetDrawingTransform (page, box, rect, rotation, preserveAspectRato);
CGContextSaveGState (context);
CGContextConcatCTM (context, m);
CGContextClipToRect (context,CGPDFPageGetBoxRect (page, box));
CGContextDrawPDFPage (context, page);
CGContextRestoreGState (context);
｝

創建PDF文件
使用Quartz創建PDF與繪製其它圖形上下文一下簡單。我們指定一個PDF文件地址，設置一個PDF圖形上下文，並使用與其它圖形上下文一樣的繪製程序。如代碼清單13-4所示的MyCreatePDFFile函數，顯示了創建一個PDF的所有工作。
注意，代碼在CGPDFContextBeginPage和CGPDFContextEndPage中來繪製PDF。我們可以傳遞一個CFDictionary對象來指定頁屬性，包括media, crop, bleed,trim和art boxes。
Listing 13-4 Creating a PDF file

複製代碼

void MyCreatePDFFile (CGRectpageRect, const char *filename)
{
CGContextRef pdfContext;
CFStringRef path;
CFURLRef url;
CFData boxData = NULL;
CFMutableDictionaryRef myDictionary = NULL;
CFMutableDictionaryRef pageDictionary = NULL;
path = CFStringCreateWithCString (NULL, filename, kCFStringEncodingUTF8);
url = CFURLCreateWithFileSystemPath (NULL, path, kCFURLPOSIXPathStyle, 0);
CFRelease (path);
myDictionary = CFDictionaryCreateMutable(NULL, 0, &kCFTypeDictionaryKeyCallBacks, &kCFTypeDictionaryValueCallBacks);
CFDictionarySetValue(myDictionary, kCGPDFContextTitle, CFSTR("MyPDF File"));
CFDictionarySetValue(myDictionary, kCGPDFContextCreator, CFSTR("MyName"));
pdfContext = CGPDFContextCreateWithURL (url, &pageRect,myDictionary);
CFRelease(myDictionary);
CFRelease(url);
pageDictionary = CFDictionaryCreateMutable(NULL, 0, &kCFTypeDictionaryKeyCallBacks, &kCFTypeDictionaryValueCallBacks);
boxData = CFDataCreate(NULL,(const UInt8 *)&pageRect, sizeof(CGRect));
CFDictionarySetValue(pageDictionary, kCGPDFContextMediaBox, boxData);
CGPDFContextBeginPage (pdfContext, &pageRect);
myDrawContent (pdfContext);
CGPDFContextEndPage (pdfContext);
CGContextRelease (pdfContext);
CFRelease(pageDictionary);
CFRelease(boxData);
}

添加鏈接
我們可以在PDF上下文中添加鏈接和錨點。Quartz提供了三個函數，每個函數都以PDF圖形上下文作爲參數，還有鏈接的信息：
· CGPDFContextSetURLForRect可以讓我們指定在點擊當前PDF頁中的矩形時打開一個URL。
· CGPDFContextSetDestinationForRect指定在點擊當前PDF頁中的矩形區域時設置目標以進行跳轉。我們需要提供一個目標名。
· CGPDFContextAddDestinationAtPoint指定在點擊當前PDF頁中的一個點時設置目標以進行跳轉。我們需要提供一個目標名。

保護PDF內容
爲了保護PDF內容，我們可以在輔助字典中指定一些安全選項並傳遞給CGPDFContextCreate。我們可以通過包含如下關鍵字來設置所有者密碼、用戶密碼、PDF是否可以被打印或拷貝：
· kCGPDFContextOwnerPassword: 定義PDF文檔的所有者密碼。如果指定該值，則文檔使用所有者密碼來加密；否則文檔不加密。該關鍵字的值必須是ASCII編碼的CFString對象。只有前32位是用於密碼的。該值沒有默認值。如果該值不能表示成ASCII，則無法創建文檔並返回NULL。Quartz使用40-bit加密。
· kCGPDFContextUserPassword: 定義PDF文檔的用戶密碼。如果文檔加密了，則該值是文檔的用戶密碼。如果沒有指定，則用戶密碼爲空。該關鍵字的值必須是ASCII編碼的CFString對象。只有前32位是用於密碼的。如果該值不能表示成ASCII，則無法創建文檔並返回NULL。
· kCGPDFContextAllowsPrinting:指定當使用用戶密碼鎖定時文檔是否可以打印。該值必須是CFBoolean對象。默認值是kCGBooleanTrue。
· kCGPDFContextAllowsCopying: 指定當使用用戶密碼鎖定時文檔是否可以拷貝。該值必須是CFBoolean對象。默認值是kCGBooleanTrue。
代碼清單14-4(下一章)顯示了確認PDF文檔是否被鎖定，及用密碼打開文檔。