Skip to content

Latest commit

 

History

History
387 lines (325 loc) · 19.3 KB

README.md

File metadata and controls

387 lines (325 loc) · 19.3 KB
Raw

FastPdfKit

This repository contains the FastPdfKit iOS library with some sample projects.

FastPdfKit is a library that let you show pdf documents in iOS applications bypassing all performances and missing features problems related to QuickLook.

Side scrolling, search with highlighted results, preview and thumbnails, text extraction, overlay views, embedded multimedia, optimization for every device, single and double page are just some of countless features included in FastPdfKit.

For more information, see the FastPdfKit website and the Support website.

Interface iPad Search iPad

Interface iPhone Search iPhone

Features

Reading

Multimedia and Annotations

Kiosk

Text

Miscellanous

Opportunities

Targets

In the Xcode project you'll find some targets

  • FastPdfKit: framework with everything needed to add just the reader to your app;
  • FPKKioskApp: a Kiosk project with document download and ready to use reader class;
  • FPKSimpleApp: a basic project with custom reader;
  • FPKReaderLib: a static library with the ReaderViewControllerand its dependencies;
  • FPKKioskLib: a static library with the kiosk classes;
  • FPKioskBundle: bundle of resources for needed for the kiosk;
  • FPReaderBundle: bundle of resources for needed by the ReaderViewController.

In FastPdfKit.framework and FPKReaderLib the libFastPdfKit.athat contains the compiled core rendering engine.

All the other classes are public and can be customized or subclassed at will.

Every target can be compiled and recompiled for your needs.

Usage guide

This guide is also available as screencast number 4.

  • Clone the repository from github or just grab the compressed archive;

  • Open your existing project in Xcode;

  • Open the downloaded folder in the Finder and locate FastPdfKit.embeddedframework;

  • Drag the framework on the Xcode workspace;

  • Inherit the project options: select the Project an from info tab and configurations line choose FastPdfKitFramework from the drop down list;

  • Open the framework's Resource folder and locate the Snippets.txt document;

  • Copy in you controller interface these lines:

      #import <FastPdfKit/FastPdfKit.h>
  @class MFDocumentManager;
  -(IBAction)actionOpenPlainDocument:(id)sender;

  • Copy in your controller implementation these other lines:

      -(IBAction)actionOpenPlainDocument:(id)sender{
      /** Set document name */
      NSString *documentName = @"Manual";

      /** Get temporary directory to save thumbnails */
  	NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);

      /** Set thumbnails path */
      NSString *thumbnailsPath = [[paths objectAtIndex:0] stringByAppendingPathComponent:[NSString stringWithFormat:@"%@",documentName]];

      /** Get document from the App Bundle */
      NSURL *documentUrl = [NSURL fileURLWithPath:[[NSBundle mainBundle]pathForResource:documentName ofType:@"pdf"]];

      /** Instancing the documentManager */
  	MFDocumentManager *documentManager = [[MFDocumentManager alloc]initWithFileUrl:documentUrl];

  	/** Instancing the readerViewController */
      ReaderViewController *pdfViewController = [[ReaderViewController alloc]initWithDocumentManager:documentManager];

      /** Set resources folder on the manager */
      documentManager.resourceFolder = thumbnailsPath;

      /** Set document id for thumbnail generation */
      pdfViewController.documentId = documentName;

  	/** Present the pdf on screen in a modal view */
      [self presentModalViewController:pdfViewController animated:YES]; 

      /** Release the pdf controller*/
      [pdfViewController release];
  }

  • Choose a pdf from the finder and drop it in the project;

  • Change the documentName to the corresponding name;

  • Call the actionOpenPlainDocument method to open the document;

  • Enjoy.

Changelog

Update 3.1 beta5 (November 18th, 2011)

  • Changed font cache management. If you still get problem with [] (notedef) caracter in the text extracted, the cache might be the issue. Set MFDocumentManager's fontCacheEnabled property to NO.

Update 3.1 beta4 (November 17th, 2011)

  • Unicode sequences will now be handled as such and the lib will no try (and fail) to compose them to a single unicode codepoint (it is related to search and extraction of text).

Update 3.1 beta3 (November 16th, 2011)

  • Lib will now attemp to compose multibyte characted to a single codepoint for search and extraction.
  • Added support to 14 (-2) Adobe Standard Fonts. If you get page empty, blank pages at text extraction check the simulator log and if the font marked as uncompleted is named like one of the files in the FPKCore/standard14fonts folder add that font to your application bundle.

Update 3.1 beta2 (November 15th, 2011)

  • Font cache re-enabled. This time seems to work as expected.
  • Default zoom not being set fixed (again).
  • Search and extraction will not crash when certain characters are found. Instead a .notdef (usually it looks like an empty rect) value with be appended to the text.

Update 3.1 beta (November 11th, 2011)

  • Enhanced search and extraction with Unicode composition and decomposition.
  • Added search match modes:
    • Return an array of MFTextItem representing the matches of teh search term on the page passed as arguments. It is a good choice running this method in a secondary thread.
    • FPKSearchMode has the following values:
    • FPKSearchModeHard - if you search for 'bèzier' it will match 'bèzier' only but not 'bezier'. If you search for 'bezier' it will match 'bezier' only.
    • FPKSearchModeSoft - if you search for term 'bèzier' it will match both 'bezier' and 'bèzier'. Same if you search for 'bezier'.
    • FPKSearchModeSmart - if you search for term 'bezier', it will also match 'bèzier', but if you search for 'bèzier' it will match 'bèzier' only.
    • Ignore case is self explanatory.
    • Default parameters are FPKSearchModeSmart and ignoreCase to YES.

Update 3.0 (November 4th, 2011)

  • Internal changes of the view hierarchy to provide more flexibility and overlay transitions.
  • Revamped ReaderViewController user interface.
  • Better thumbnail scroll view and generation.
  • Added support to video overlay control parameters in the uri.
  • Search now works for terms of unitary length.
  • Added a method to retrieve annotations from the document and provide them as overlays.
  • Slightly changes to MFDocumentViewControllerDelegate callbacks.
  • New activation method with key FPKLicenseKey from Info.plist: no need to pull to get the activated version.

Update 2.1.3 (September 27th, 2011)

Disabled the 2.1.1 font cache due to an implementation oversight. Will be re-introduced as soon as it will behave as expected.

Update 2.1.2 (September 21th, 2011)

  • Cleaned up text search and extraction a little bit. More fixes incoming.

Update 2.1.1 (September 15th, 2011)

  • Added a font cache system for text extraction and search, which should give sensible improvement in search speed especially on documents with a large amount of different fonts.

Update 2.1.0 (September 14th, 2011)

  • Added Overflow page mode to previous Single and Double. Basically, the pdf page will now fill the screen along its width, overflowing under the bottom of the screen if necessary.
  • Added autoMode property. It will tell the MFDocumentViewController to what mode switch when in landscape if automodeOnRotation is YES. Default is MFAutoModeDouble, other option are MFAutoModeSingle and MFAutoModeOverflow.

Update 2.0.3 (August 10th, 2011)

  • Fixed a bug in the transformation returned on double page mode for page with an angle not equal to 0.
  • Added guard to iOS 4.x only methods.

Update 2.0.2 (August 09th, 2011)

  • Added support to link annotation with Remote Go-To actions.
  • Updated manual with latest methods.
  • Added methods to convert points and rect to and from different coordinate systems. Take a look at the MFDocumentViewController for details.
  • Documented the method to get the cropbox and rotation angle for each document page.
  • Finally fixed the bad behavior of the detail (tiled) view on retina device.
  • Fixed a bug involving rendering of the preview pages at low res on retina display introduced a few updates ago.
  • The -didGoToPage callback is now called once when a page is changed on user scroll input.

Update 2.0.1 (July 21th, 2011)

  • Bleeding of the pdf cover images fixed.
  • The embedded UIWebView is now embedded a bit better.

Update 2.0.0-devel (July 12th, 2011)

  • Multimedia support
  • Reorganized project
  • Many other improvements

If you have any other question please post it in the Support Site