documentcloud/docsplit — pull request #63 by hderms (2012-11-08 20:54:38+00:00)
Title: Fix issue 62

This fixes an issue I opened on the main repo found at https://github.com/documentcloud/docsplit/issues/62

The feature proposed adds a new option to extracting images via Docsplit.extract_images. If you pass an additional argument in the form :and_return => :images, you receive an array of the paths of extracted images as a return value, instead of the path to the intermediate PDF, in the case of powerpoints.
Example:
```ruby
Docsplit.extract_images('/tmp/some_ppt.ppt', :size => '1000x', :format => [:png, :jpg], :and_return => :images)
```
With a return value of:
```ruby
["/tmp/some_ppt.png", "/tmp/some_ppt.jpg"]
```

The default return-value behavior of this method is preserved when that option is not specified, which is to return an array of PDFs that are returned by ensure_pdfs.

The justification for this feature is that I feel like users would benefit from getting the paths to the images created immediately upon calling the extract_images method. Having them determine these paths themselves seems out of spirit with the nature of this gem.