iOS开发CoreGraphics核心图形框架之九——PDF文件的渲染与建立

iOS开发CoreGraphics核心图形框架之九——PDF文件的渲染与建立

1、渲染已有的PDF文档

    在CoreGraphics框架中，有两个类型与PDF文档的渲染有关，分别为CGPDFDocumentRef与CGPDFPageRef。其中，CGPDFDocumentRef对应整个PDF文档，里面封装了许多文档相关的信息，CGPDFPageRef对应PDF文档中某一页的内容，经过它开发者能够将PDF内容经过CGContext上下文渲染到指定目标上。

    以下代码演示了在自定义View的drawRect:方法中进行PDF文档的绘制：

-(void)drawRect:(CGRect)rect{
    //因为坐标系不一样，须要进行翻转
    CGContextRef contextRef = UIGraphicsGetCurrentContext();
    //进行坐标系的翻转
    CGContextTranslateCTM(contextRef, 0, rect.size.height);
    CGContextScaleCTM(contextRef, 1.0, -1.0);
    //获取pdf文件的路径
    NSString * path = [[NSBundle mainBundle] pathForResource:@"MyText" ofType:@"pdf"];
    CFStringRef pathString = CFStringCreateWithCString(NULL, [path cStringUsingEncoding:NSUTF8StringEncoding], kCFStringEncodingUTF8);
    //建立url
    CFURLRef url = CFURLCreateWithFileSystemPath(NULL, pathString, kCFURLPOSIXPathStyle, 0);
    CFRelease(pathString);
    //进行CGPDFDocumentRef引用的建立
    CGPDFDocumentRef document = CGPDFDocumentCreateWithURL(url);
    CFRelease(url);
    //获取文档的第1页
    CGPDFPageRef page1 = CGPDFDocumentGetPage(document, 1);
    //进行绘制
    CGContextDrawPDFPage(contextRef, page1);
    CGPDFPageRelease(page1);
    CGPDFDocumentRelease(document);
}

效果以下：

CGPDFDocument中提供的方法解析以下：

//经过数据提供者类来建立PDF文档对象
CGPDFDocumentRef  CGPDFDocumentCreateWithProvider(CGDataProviderRef cg_nullable provider);
//经过url来建立PDF文档
CGPDFDocumentRef  CGPDFDocumentCreateWithURL(CFURLRef cg_nullable url);
//进行引用计数+1
CGPDFDocumentRef  CGPDFDocumentRetain(CGPDFDocumentRef cg_nullable document);
//进行引用计数-1,须要注意，其做用和CFRelease()类似，不一样的是若是document为NULL，不是发生crash
void CGPDFDocumentRelease(CGPDFDocumentRef cg_nullable document);
//获取PDF文档的版本
void CGPDFDocumentGetVersion(CGPDFDocumentRef cg_nullable document, int *  majorVersion, int *  minorVersion);
//判断文档是不是加密的
bool CGPDFDocumentIsEncrypted(CGPDFDocumentRef cg_nullable document);
//使用密码对PDF文档进行解密 返回值为1表示解密成功
bool CGPDFDocumentUnlockWithPassword(CGPDFDocumentRef cg_nullable document, const char *  password);
//判断PDF文档是否已经解锁
bool CGPDFDocumentIsUnlocked(CGPDFDocumentRef cg_nullable document);
//获取此PDF文档是否容许绘制
bool CGPDFDocumentAllowsPrinting(CGPDFDocumentRef cg_nullable document);
//获取此文档是否容许拷贝
bool CGPDFDocumentAllowsCopying(CGPDFDocumentRef cg_nullable document);
//获取PDF文档的总页数
size_t CGPDFDocumentGetNumberOfPages(CGPDFDocumentRef cg_nullable document);
//获取文档中某页数据
CGPDFPageRef __nullable CGPDFDocumentGetPage(CGPDFDocumentRef cg_nullable document, size_t pageNumber);
//获取文档的目录信息
CGPDFDictionaryRef __nullable CGPDFDocumentGetCatalog(CGPDFDocumentRef cg_nullable document);
//获取文档详情信息
CGPDFDictionaryRef __nullable CGPDFDocumentGetInfo(CGPDFDocumentRef cg_nullable document);
//获取文档id
CGPDFArrayRef __nullable CGPDFDocumentGetID(CGPDFDocumentRef cg_nullable document);
//获取CGPDFDocument类在CoreGraphics框架中的id
CFTypeID CGPDFDocumentGetTypeID(void);

CGPDFDocument中还有一些已经弃用的方法，这些方法如今封装在CGPDFPage中，弃用的方法以下：

CGRect CGPDFDocumentGetMediaBox(CGPDFDocumentRef cg_nullable document,int page);
CGRect CGPDFDocumentGetCropBox(CGPDFDocumentRef cg_nullable document, int page);
CGRect CGPDFDocumentGetBleedBox(CGPDFDocumentRef cg_nullable document, int page);
CGRect CGPDFDocumentGetTrimBox(CGPDFDocumentRef cg_nullable document, int page);
CGRect CGPDFDocumentGetArtBox(CGPDFDocumentRef cg_nullable document, int page);
int CGPDFDocumentGetRotationAngle(CGPDFDocumentRef cg_nullable document, int page);

CGPDFPage中的主要方法列举以下：

//进行引用计数+1
CGPDFPageRef CGPDFPageRetain(CGPDFPageRef cg_nullable page);
//进行引用计数-1
void CGPDFPageRelease(CGPDFPageRef cg_nullable page);
//获取对应的PDF文档对象
CGPDFDocumentRef __nullable CGPDFPageGetDocument(CGPDFPageRef cg_nullable page);
//获取当前页是文档中的第几页
size_t CGPDFPageGetPageNumber(CGPDFPageRef cg_nullable page);
//获取与文档此页相关联的媒体区域
/*
typedef CF_ENUM (int32_t, CGPDFBox) {
  kCGPDFMediaBox = 0,
  kCGPDFCropBox = 1,
  kCGPDFBleedBox = 2,
  kCGPDFTrimBox = 3,
  kCGPDFArtBox = 4
};
*/
CGRect CGPDFPageGetBoxRect(CGPDFPageRef cg_nullable page, CGPDFBox box);
//获取此页的旋转角度
int CGPDFPageGetRotationAngle(CGPDFPageRef cg_nullable page);
//transform变换
CGAffineTransform CGPDFPageGetDrawingTransform(CGPDFPageRef cg_nullable page, CGPDFBox box, CGRect rect, int rotate, bool preserveAspectRatio);

2、使用代码建立PDF文件

    以下示例代码演示了建立PDF文档的过程：

-(void)creatPDF{
    //绘图上下文
    CGContextRef pdfContext;
    CFStringRef path;
    CFURLRef url;
    CFDataRef boxData = NULL;
    CFMutableDictionaryRef myDictionary = NULL;
    CFMutableDictionaryRef pageDictionary = NULL;
    //文件存放的路径
    NSString * filePath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, true).firstObject;
    NSLog(@"%@",filePath);
    const char * filename = [[NSString stringWithFormat:@"%@/MyText",filePath] cStringUsingEncoding:kCFStringEncodingUTF8];
    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"));
    //设置文档尺寸
    CGRect pageRect = CGRectMake(0, 0, 200, 200);
    //建立文档
    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, pageDictionary);
    CGFloat  colors[4] = {1,0,0,1};
    CGContextSetFillColorSpace(pdfContext, CGColorSpaceCreateWithName(kCGColorSpaceGenericRGB));
    CGContextSetFillColor(pdfContext, colors);
    CGContextFillRect(pdfContext, CGRectMake(0, 0, 100, 100));
    //结束此页的渲染
    CGPDFContextEndPage (pdfContext);
    //开始新一页内容的渲染
    CGPDFContextBeginPage (pdfContext, pageDictionary);
    CGContextSetFillColorSpace(pdfContext, CGColorSpaceCreateWithName(kCGColorSpaceGenericRGB));
    CGContextSetFillColor(pdfContext, colors);
    CGContextFillRect(pdfContext, CGRectMake(0, 0, 100, 100));
    CGPDFContextEndPage (pdfContext);
    CGContextRelease (pdfContext);
    CFRelease(pageDictionary);
    CFRelease(boxData);

}

上面代码建立出的PDF文件以下图所示：

在建立PDF文档时，开发者还可使用以下列举的方法来对文档进行超连接添加，内容信息设置等：

//关闭文档上下文，关闭后将不能再次写入
void CGPDFContextClose(CGContextRef cg_nullable context);
//开启新一页内容的绘制
void CGPDFContextBeginPage(CGContextRef cg_nullable context, CFDictionaryRef __nullable pageInfo);
//结束当前页内容的绘制
void CGPDFContextEndPage(CGContextRef cg_nullable context);
//添加元数据
void CGPDFContextAddDocumentMetadata(CGContextRef cg_nullable context, CFDataRef __nullable metadata);
//为某个区域添加超连接
void CGPDFContextSetURLForRect(CGContextRef cg_nullable context, CFURLRef  url, CGRect rect);
//在文档的某个点添加一个目标
void CGPDFContextAddDestinationAtPoint(CGContextRef cg_nullable context, CFStringRef  name, CGPoint point);
//为某个区域添加跳转目标功能
void CGPDFContextSetDestinationForRect(CGContextRef cg_nullable context, CFStringRef  name, CGRect rect);

在设置文档信息字典时，支持的经常使用键以下：

//设置文档标题 可选设置
const CFStringRef  kCGPDFContextTitle;
//设置文档的做者 可选设置
const CFStringRef  kCGPDFContextAuthor;
//设置文档的副标题 可选设置
const CFStringRef  kCGPDFContextSubject;
//为文档设置关键字 可选设置 能够设置为一个数组 设置多个关键字
const CFStringRef  kCGPDFContextKeywords;
//设置文档的建立者
const CFStringRef  kCGPDFContextCreator;
//为文档设置全部者密码
const CFStringRef  kCGPDFContextOwnerPassword;
//为文档设置用户密码
const CFStringRef  kCGPDFContextUserPassword;
//设置加密密钥长度
const CFStringRef  kCGPDFContextEncryptionKeyLength;
//设置是否容许绘制
const CFStringRef  kCGPDFContextAllowsPrinting;
//设置是否容许复制
const CFStringRef  kCGPDFContextAllowsCopying;

专一技术，热爱生活，交流技术，也作朋友。

——珲少 QQ群：203317592