使用 CGPDFDocument、CATiledLayer 和 UIPageViewController 做简单的 PDF 阅读器(一)

0

最近项目中需要给客户看一些比较私密的文件,为了防止盗取和篡改,需要用 PDF 格式,为 app 添加了一个简单的 PDF 阅读模块。

打开 PDF

iOS 打开 PDF 是非常方便的事情,系统原生支持。

- (BOOL)openPDFFile:(NSString*)filePath{
    NSURL* pdfURL = [NSURL fileURLWithPath:filePath];
    CFURLRef cfpdfURL = CFURLCreateWithFileSystemPath(CFAllocatorGetDefault(), CFStringCreateWithCString(CFAllocatorGetDefault(), pdfURL.path.UTF8String, kCFStringEncodingUTF8), kCFURLPOSIXPathStyle, NO);
    _pdfDocument = CGPDFDocumentCreateWithURL(cfpdfURL);
    CFRelease(cfpdfURL);
    if (_pdfDocument == nil) {
        return NO;
    }
    _totalPageNum = CGPDFDocumentGetNumberOfPages(_pdfDocument);
    return YES;
}
CFStringCreateWithCString(CFAllocatorGetDefault(), pdfURL.path.UTF8String, kCFStringEncodingUTF8)

CGPDFDocumentCreateWithURL这里的 path,可以使用 NSURL 的fileURLWithPath:来获取,并用CFStringCreateWithCString转换。

_pdfDocument 是 CGPDFDocumentRef 类型的,在打开 PDF 文件以后,一直持有 PDF 文件的引用。

_totalPageNum = CGPDFDocumentGetNumberOfPages(_pdfDocument);

使用这个方法获取 PDF 总页数,供翻页的时候使用。

- (PDFContentViewController* _Nullable)showPage:(size_t)pageNum{
    if (_totalPageNum > 0 && pageNum <= _totalPageNum && pageNum > 0) {
        if (_currentPage != nil) {
            _currentPage = nil;
        }
        _currentPage = CGPDFDocumentGetPage(_pdfDocument, pageNum);
        PDFContentViewController* pdfContentViewController = [[PDFContentViewController alloc]init];
        [pdfContentViewController showPdfPage:_currentPage];
        pdfContentViewController.pageNumber = pageNum;
        return pdfContentViewController;
    }else{
        return nil;
    }
}

这里使用 CGPDFDocumentGetPage 来获取 PDF 文件中某一页的引用。
第一个参数是对 pdf 文件的引用,第二个参数可以直接取到某一页。这里很奇快的是,page 的下标是从1开始的,向CGPDFDocumentGetPage传入0会直接报错。

PDFContentViewController是一个显示 PDF 页面的类,每个 PDF 页面创建一个类。刚好给 UIPageViewController 做翻页效果使用。UIPageViewController 用起来很坑,这个以后再说。

PDF文件显示

绘制 pdf 文件

绘制 pdf 文件跟平时绘制图片差不多

CGSize pdfPageOriginalPageSize = CGPDFPageGetBoxRect(_pdfPage, PDFContentDefaultPDFBox).size;
    CGSize imageSize = CGSizeMake(self.pdfContentView.bounds.size.width, self.pdfContentView.bounds.size.height);
    UIGraphicsBeginImageContext(imageSize);
    CGContextRef context = UIGraphicsGetCurrentContext();
    CGContextSetFillColorWithColor(context, self.contentBackground.CGColor);
    CGContextSetStrokeColorWithColor(context, self.contentBackground.CGColor);
    CGContextFillRect(context,CGRectMake(0, 0, imageSize.width, imageSize.height));
    CGContextSaveGState(context);
    CGContextTranslateCTM(context, 0, imageSize.height);
    CGContextScaleCTM(context, 1, -1);
    CGContextScaleCTM(context, imageSize.width/(pdfPageOriginalPageSize.width > 0?pdfPageOriginalPageSize.width:imageSize.width), imageSize.height/(pdfPageOriginalPageSize.height > 0?pdfPageOriginalPageSize.height:imageSize.height));
    CGContextDrawPDFPage(context, _pdfPage);
    CGContextRestoreGState(context);
    UIImage* thumbImg = UIGraphicsGetImageFromCurrentImageContext();
    UIGraphicsEndImageContext();
    self.pdfContentView.layer.contents = (__bridge id _Nullable)(thumbImg.CGImage);

关键是这里
CGContextDrawPDFPage(context, _pdfPage);
这里绘制的时候,绘制 context 的 CTM 是相对于 pdf 文件来变换的(跟绘制 Image 到 CGContext 上的变换规则是一样的,想象成绘制图片就好)
如果不变换 CTM 就会绘制一个倒立的图像。并且,上面的代码中,pdf 页面的大小远远大于 UIGraphicsBeginImageContext(imageSize) 生成的 Image,于是就看到一个倒立的,只绘制了一部分的 pdf 文件。
这段代码是绘制了一个 Thumbnail Image,所以就没有绘制高清的图片,如果需要绘制高清的图片,例如在 7s plus 上显示的图片,至少要绘制一个 3x 于屏幕分辨率的图片,缩小后显示出来。

CGContextScaleCTM(context, imageSize.width/(pdfPageOriginalPageSize.width > 0?pdfPageOriginalPageSize.width:imageSize.width), imageSize.height/(pdfPageOriginalPageSize.height > 0?pdfPageOriginalPageSize.height:imageSize.height));

绘制的关键在这里,将整个 pdf 页面,缩放到与即将生成的 image 同样大小,就可以把整个页面都绘制到 image 上面了。

在计算 scale 的时候,也可以用

CGPDFPageGetDrawingTransform(_PDFPageRef, kCGPDFCropBox, self.bounds, 0, true)

系统会根据第二个参数传入的值,将 pdf 裁剪之后放入第三个参数传入的 Rect 里面。

CGSize pdfPageOriginalPageSize = CGPDFPageGetBoxRect(_pdfPage, PDFContentDefaultPDFBox)

这个需要说明一下,每个 pdf 页面都有一个原始大小。虽然 PDF 格式是矢量图,但是,其中的图片等内容不是矢量的,这个原始大小也就比较容易理解了。第二个参数 CGPDFBox。系统会根据传入的值来返回一个裁剪后的 pdf 页面大小

typedef CF_ENUM (int32_t, CGPDFBox) {
  kCGPDFMediaBox = 0,
  kCGPDFCropBox = 1,
  kCGPDFBleedBox = 2,
  kCGPDFTrimBox = 3,
  kCGPDFArtBox = 4
};

具体的裁剪规则,还没有研究清楚。
此外,需要知道的是,PDF 里面的每个元素都是可以读取到的,iOS 也给我们提供了相应的方法。
如果有打开 pdf 中的 url 之类的需求,可以研究一下这方面的内容。

在回到显示部分,实际浏览时,如果存在放大缩小滑动等动作,就必须重新绘图。用 UIScrollview 的 contentOffset 来计算当前正在显示的区域,并绘制到屏幕上。

但是会产生几个问题:1.如果绘制与 UIScrollView 的 ContentSize 同样大小的图片,那么,当 Scale 非常大的时候,绘制的图片也非常大,最终会内存占用过高而崩溃。
2.手动计算正在显示的区域比较困难。

好在 CATiledLayer可以帮我们解决这个难题,但是 CATiledLayer 也有一些坑。

使用 CATiledLayer 显示 PDF

上面的绘图代码是显示缩略图的绘制代码,由于CATiledLayer 绘制图片是异步的,在绘制过程中,会存在一块一块闪烁的情况,在 CATiledLayer 下面放一个缩略图,效果比较好。
CATiledLayer是 iOS 提供的一个专门显示大图片的类,它可以分块加载,异步加载。并且有自己的内存管理机制,可以把屏幕外的部分及时移除。
在 UIScrollview 上面使用 CATiledLayer 时需要设置
levelsOfDetail 和 levelsOfDetailBias。
levelsOfDetail = 3指的是,UIScrollview 缩放倍数(scale)在1/2 1/4 1/8时使用同样的 scale 重绘屏幕。缩小时节省内存。
levelsOfDetailBias = 3 指的是UIScrollview 缩放倍数(scale)在2 4 8时使用同样的 scale 重绘屏幕。保持清晰度。
简直就是为展示 PDF 文件生的。
只要设置CATiledLayer的 delegate,并且在

- (void)drawLayer:(CALayer *)layer inContext:(CGContextRef)context

里面绘制就可以了,但是不能手动设置CATiledLayer的 content。
这里就是 delegate 的绘制方法

- (void)drawLayer:(CALayer *)layer inContext:(CGContextRef)context{
        PDFContentViewController* strongSelf = self;
        double screenScale = [UIScreen mainScreen].scale;
        CGSize pdfPageOriginalPageSize = CGPDFPageGetBoxRect(strongSelf->_pdfPage, PDFContentDefaultPDFBox).size;
        CGSize imageSize = CGSizeMake(layer.bounds.size.width, layer.bounds.size.height);
        CGContextSetFillColorWithColor(context, [UIColor whiteColor].CGColor);
        CGContextSetStrokeColorWithColor(context, [UIColor whiteColor].CGColor);
        CGContextFillRect(context,CGContextGetClipBoundingBox(context));
        CGContextSaveGState(context);
        CGContextTranslateCTM(context, 0, layer.bounds.size.height);
        CGContextScaleCTM(context, 1, -1);
        
        CGContextScaleCTM(context, imageSize.width/(pdfPageOriginalPageSize.width > 0?pdfPageOriginalPageSize.width:imageSize.width), imageSize.height/(pdfPageOriginalPageSize.height > 0?pdfPageOriginalPageSize.height:imageSize.height));
        CGContextDrawPDFPage(context, strongSelf->_pdfPage);
        CGContextRestoreGState(context);
}

需要注意的是:context在传入这个方法时,已经做过 CTM 变换了,它的 Clip 和 scale 都可以发生了改变。
获取 scale 使用

CGContextGetCTM(context).a

获取 clip 使用

CGContextGetClipBoundingBox(context)

通常情况下,这个 context 描绘的就是当前需要绘制的块,不要改变 scale 和 clip。可以忽略这个变换,直接在这个基础上继续变换 context 即可,就好像在一个普通的 layer 绘制全屏的图像一样。

但是这个地方是多线程的,如果处理不好,可能会引用的已经释放的 self 变量,导致崩溃。这里使用 weak-strong self 的方式进行处理。

20161122211801277-2017215

这本书非常好,看过 PDF 之后已入正收藏。

20161122211953103-2017215

内存占用也比较小。

现在已经完成了 PDF 文件的打开和绘制一个页面,下一步就要进行缩放和翻页等操作了

http://www.cocoachina.com/bbs/read.php?tid-48894-keyword-CATiledLayer.html
http://stackoverflow.com/questions/2295151/catiledlayer-drawing-crash
https://developer.apple.com/library/content//qa/qa1637/_index.html

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容