本文轉載自：
PDF文檔存儲依賴于分辨率的向量圖形、文本和位圖，并用于程序的一系列指令中。一個PDF文檔可以包含多頁的圖形和文本。PDF可用于創建跨平臺、只讀的文檔，也可用于繪制依賴于分辨率的圖形。
Quartz為所有應用程序創建高保真的PDF文檔，這些文檔保留應用的繪制操作，如圖13-1所示。PDF文檔的結果將通過系統的其它部分或第三方法的產品來有針對性地進行優化。Quartz創建的PDF文檔在Preview和Acrobat中都能正確的顯示。
Figure 13-1 Quartz creates high-quality PDF documents
Quartz不僅僅只使用PDF作為它的數字頁，它同樣包含一些API來顯示和生成PDF文件，及完成一些其它PDF相關的工作。
Quartz提供了CGPDFDocumentRef數據類型來表示PDF文檔。我們可以使用CGPDFDocumentCreateWithProvider或CGPDFDocumentCreateWithURL來創建CGPDFDocument對象。在創建CGPDFDocument對象后，我們可以將其繪制到圖形上下文中。圖13-2顯示了在一個窗體中繪制PDF文檔。
Figure 13-2 A PDF document
代碼清單13-1顯示了如何創建一個CGPDFDocument對象及獲取文檔的頁數。
Listing 13-1 Creating a CGPDFDocument object from a PDF file
CGPDFDocumentRefMyGetPDFDocumentRef(constchar*filename)
{
CFStringRef path;
CFURLRef url;
CGPDFDocumentRef document;
size_tcount;
path = CFStringCreateWithCString (NULL, filename,
kCFStringEncodingUTF8);
url = CFURLCreateWithFileSystemPath (NULL, path,
kCFURLPOSIXPathStyle,0);
CFRelease (path);
document = CGPDFDocumentCreateWithURL (url);
CFRelease(url);
count = CGPDFDocumentGetNumberOfPages (document);
if(count ==0) {
printf("`%s' needs at least one page!", filename);
returnNULL;
}
returndocument;
}
代碼清單顯示了如何將一個PDF頁繪制到圖形上下文中。
Listing 13-2 Drawing a PDF page
void MyDisplayPDFPage(CGContextRef myContext,size_tpageNumber,constchar*filename)
{
CGPDFDocumentRef document;
CGPDFPageRef page;
document = MyGetPDFDocumentRef (filename);
page = CGPDFDocumentGetPage (document, pageNumber);
CGContextDrawPDFPage (myContext, page);
CGPDFDocumentRelease (document);
}
Quartz提供了函數CGPDFPageGetDrawingTransform來創建一個仿射變換，該變換基于將PDF頁的BOX映射到指定的矩形中。函數原型是：
CGAffineTransformCGPDFPageGetDrawingTransform(
CGPPageRef page,
CGPDFBox box,
CGRect rect,
introtate,
boolpreserveAspectRatio
);
該函數通過如下算法來返回一個仿射變換：
將在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來根據當前的窗體大小和旋轉設置計算出適當的轉換。
Figure 13-3 A PDF page rotated 90 degrees to the right
程序清單13-3顯示了為一個PDF頁創建及應用仿射變換，然后繪制PDF。
Listing 13-3 Creating an affine transform for a PDF 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);
}
使用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(CGRect pageRect,const char *filename)
{
CGContextRef pdfContext;
CFStringRef path;
CFURLRef url;
CFDataRef 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("My PDF File"));
CFDictionarySetValue(myDictionary, kCGPDFContextCreator, CFSTR("My Name"));
pdfContext = CGPDFContextCreateWithURL (url, &pageRect, myDictionary);
CFRelease(myDictionary);
CFRelease(url);
pageDictionary = CFDictionaryCreateMutable(NULL,0,
&kCFTypeDictionaryKeyCallBacks,
&kCFTypeDictionaryValueCallBacks);
boxData = CFDataCreate(NULL,(constUInt8 *)&pageRect,sizeof(CGRect));
CFDictionarySetValue(pageDictionary, kCGPDFContextMediaBox, boxData);
CGPDFContextBeginPage (pdfContext, pageDictionary);
myDrawContent (pdfContext);
CGPDFContextEndPage (pdfContext);
CGContextRelease (pdfContext);
CFRelease(pageDictionary);
CFRelease(boxData);
}
我們可以在PDF上下文中添加鏈接和錨點。Quartz提供了三個函數，每個函數都以PDF圖形上下文作為參數，還有鏈接的信息：
CGPDFContextSetURLForRect可以讓我們指定在點擊當前PDF頁中的矩形時打開一個URL。
CGPDFContextSetDestinationForRect指定在點擊當前PDF頁中的矩形區域時設置目標以進行跳轉。我們需要提供一個目標名。
CGPDFContextAddDestinationAtPoint指定在點擊當前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文檔是否被鎖定，及用密碼打開文檔。
