Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/mindbrix/UIImage-PDF

Simple UIImage PDF renderer category for iOS scalable assets
https://github.com/mindbrix/UIImage-PDF

Last synced: 17 minutes ago
JSON representation

Simple UIImage PDF renderer category for iOS scalable assets

Host: GitHub
URL: https://github.com/mindbrix/UIImage-PDF
Owner: mindbrix
Created: 2011-10-16T13:48:26.000Z (over 12 years ago)
Default Branch: master
Last Pushed: 2023-03-31T17:10:00.000Z (about 1 year ago)
Last Synced: 2024-06-18T20:10:15.859Z (4 days ago)
Language: Objective-C
Homepage: http://blog.mindbrix.co.uk/2012/02/10/ios-scalable-assets/
Size: 2.09 MB
Stars: 1,235
Watchers: 47
Forks: 155
Open Issues: 21
Metadata Files:
- Readme: README.md

Lists

awesome-rank-1000 - UIImage-PDF

README

        UIImage+PDF

===========

`UIImage+PDF` provides a `UIImage` class category method to render a `UIImage` from any PDF stored in the application bundle. The motivation for this was to enable the easy use of scaleable vector assets in `iOS` apps.

Usage

-----

Add the sources files in the `UIImage+PDF` sub folder to your project. Use the following line to import the necessary methods.

	#import "UIImage+PDF.h"

	

Then simply call one of the `UIImage` class methods as shown here:

	UIImage *img = [ UIImage imageWithPDFNamed:@"YingYang.pdf" atSize:CGSizeMake( 40, 40 ) ];

	UIImage *img = [ UIImage imageWithPDFNamed:@"YingYang.pdf" fitSize:CGSizeMake( 90, 50 ) ];

	UIImage *img = [ UIImage imageWithPDFNamed:@"YingYang.pdf" atWidth:60 ];

	UIImage *img = [ UIImage imageWithPDFNamed:@"YingYang.pdf" atHeight:90 ];

	UIImage *img = [ UIImage originalSizeImageWithPDFNamed:@"YingYang.pdf" ];

	

	UIImage *img = [ UIImage imageWithPDFURL:url atSize:CGSizeMake( 60, 60 ) atPage:1 ];

	

	UIImage *img = [ UIImage imageWithPDFData:data atSize:CGSizeMake( 60, 60 ) atPage:1 ];

The `fitSize:`, `atWidth:` and `atHeight:` methods are particularly useful as they preserve the aspect ratio of the source PDF.

For a full API list consult the header file.

An example project is included in this repository. The important code is in `viewDidLoad:` in `UIImage_PDF_exampleViewController.m`.

ARC

---

_**If your project doesn't use ARC**: you must add the `-fobjc-arc` compiler flag to `NSData+MD5.m`, `NSString+MD5.m`, `PDFView.m`, `UIImage+PDF.m` and `UIView+Image.m` in Target Settings ==> Build Phases ==> Compile Sources._

Disk Cacheing 

--------------

`UIImage+PDF` now transparently caches all rendered PDFs in `/Library/Caches/__PDF_CACHE__`. This substantially improves application latency with large PDFs, especially on larger devices. To disable disk cacheing, call:

	[ UIImage setShouldCacheOnDisk:NO ];

	

Memory Cacheing 

--------------

`UIImage+PDF` can now use `NSCache` to cache rendered PDFs in memory. This feature is disabled by default. To enable it call:

	[ UIImage setShouldCacheInMemory:YES ];

PDF file size

-------------

By default Adobe Illustrator saves exported PDFs very inefficiently. For best results, select File -> Save a Copy, select PDF format and then uncheck all the general options. Once you are ready to ship your app, run all your PDF assets through ShrinkIt (see below).

Other vector graphics editors which natively use the OSX Quartz renderer, such as [Sketch](http://www.bohemiancoding.com/sketch/), will create much more compact PDFs.

The amazing devs at [Panic](http://www.panic.com/) have now released a PDF shrinking utility, [ShrinkIt](http://www.panic.com/blog/2010/02/shrinkit-1-0/), which should take a lot of the pain out of a vector asset workflow.

Apps using UIImage+PDF

----------------------

Here is a partial list of the apps using this category. If you want to add your app to this list, please submit a pull request.

* [Vectoria](http://vectoria.co.uk)

* [Tiltoria](https://itunes.apple.com/gb/app/tiltoria/id460391221?mt=8)

* [Video Player+](https://itunes.apple.com/gb/app/video-player+/id575932926?mt=8)

* [UltiScore](http://johnstewart.com/ios/ultiscore)

Licence

-------

Copyright 2012 Nigel Timothy Barber - [@mindbrix](http://twitter.com/mindbrix). All rights reserved.

Permission is given to use this source code file without charge in any project, commercial or otherwise, entirely at your risk, with the condition that any redistribution (in part or whole) of source code must retain this copyright and permission notice. Attribution in compiled projects is appreciated but not required.

Further Reading

---------------

[Matt Gemmell](http://twitter.com/mattgemmell) has an excellent article on his blog explaining [how to use PDF images in iOS apps](http://mattgemmell.com/2012/02/10/using-pdf-images-in-ios-apps/).