Code Documentation

All public classes of PDFTouch SDK are documented using appledoc. See the documentation for further information.

Requirements

The source code of PDFTouch SDK is developed on Xcode 4.5.1 with iOS Base SDK 6.0. PDFTouch SDK works on a deployment target of iOS 5 or greater on armv7 and armv7s and can be used in ARC and non-ARC projects.

Integration

PDFTouch SDK can be integrated in two ways into your app.

1. Add the binary PDFTouch.framework

• Drag PDFTouch.framework into the "Frameworks" group of your Xcode project.
• Add the required libraries as shown in the screenshot below.
• Add PDFTouch.bundle to your projects resources as shown in the screenshot below.
• Open the Build Settings tab and apply the following changes:
  • Other Linker Flags -> -all_load -ObjC
• Add the following import statement everywhere you want to use PDFTouch SDK: #import <PDFTouch/PDFTouch.h>

2. Add PDFTouch.xcodeproj as a dependency

• Copy the whole PDFTouch folder into your project's root folder.
• Drag PDFTouch.xcodeproj into the "Frameworks" group of your Xcode project.
• Add PDFTouch as a target dependency.
• Add the required libraries as shown in the screenshot below.
• Add PDFTouch.bundle to your projects resources as shown in the screenshot below.
• Open the Build Settings tab and apply the following changes:
  • Other Linker Flags -> -all_load -ObjC
  • Add the following paths to "Header Search Paths":
    • "PDFTouch/**"
• Add the following import statement everywhere you want to use PDFTouch SDK: #import "PDFTouch.h"

Sample Usage

1. Create a YLDocument instance for the PDF file you want to display.

NSString *path = [[NSBundle mainBundle] PathForResource:@"Developers" withExtension:@"pdf"];
YLDocument *document = [[[YLDocument alloc] initWithFilePath:url] autorelease];

2. Create a YLPDFViewController instance and present it as a modal or child view controller.

YLPDFViewController *v = [[YLPDFViewController alloc] initWithDocument:document];
[v setDocumentMode:YLDocumentModeDouble];
[v setDocumentLead:YLDocumentLeadRight];
[v setPageCurlEnabled:YES];
[v setModalPresentationStyle:UIModalPresentationFullScreen];
[v setModalTransitionStyle:UIModalTransitionStyleCoverVertical];
[self.navigationController presentModalViewController:v animated:YES];
[v release];

Features

• Fast multithreaded PDF rendering using Grand Central Dispatch.
• Highly optimized caching algorithm.
• Offline pre-rendering of pdf pages at different sizes integrated with the caching system.
• Thumbnail grid display.
• Pinch to zoom.
• Double tap to zoom in and out.
• Text search with highlighting.
• Outline view (TOC).
• Bookmarks.
• Double page mode with left or right lead.
• Page curl animations.
• Retina Display ready.
• Optimized for both the iPhone and iPad.
• Includes a demo Xcode project demonstrating the common usage of the SDK's features.

Annotations Support

• Page links
• Web links
• Mail links
• Video
• Audio
• Maps
• Web pages
• Custom overlays

Package

• Complete source code of PDFTouch SDK.
• Demo Xcode project.
• Documentation with integration instructions.
• Technical appledoc style documentation.