Dragonfly PDF

Dragonfly PDF analysers and processors.

Dependencies

Installation

Add this line to your application's Gemfile:

gem 'dragonfly_pdf'

And then execute:

$ bundle

Or install it yourself as:

$ gem install dragonfly_pdf

Usage

The analyser and processors are added by configuring the plugin

Dragonfly.app.configure do
  plugin :pdf
end

Spreads

PDFs that contain spreads (as when saving with the spreads option in InDesign) require setting the spreads metadata attribute to true:

pdf.meta['spreads'] = true

Analysers

PDF properties

Reads properties from a PDF.

pdf.pdf_properties

It returns a hash of properties:

{
    page_count: 4,
    spread_count: 3,
    page_numbers: [[1], [2, 3], [4]],
    widths: [[210.0], [210.0, 210.0], [210.0]],
    heights: [[297.0], [297.0, 297.0], [297.0]],
    aspect_ratios: [[0.71], [0.71, 0.71], [0.71]],
    info: {

When the spreads metadata is set to true, the analyser assumes the PDF contains 2 real pages per one PDF page and recalculates the PDF properties accordingly (including situations where the PDF begins or ends with a single page). All page arrays (page_numbers, widths, heights, aspect_ratios) are then two dimensional (as illustrated above), representing spreads and nested individual pages.

Processors

Page

Extracts page from PDF.

pdf.page(page_number=1)

Page Thumb

Generates thumbnail of a specified page, in defined density (dpi) and format.

pdf.page_thumb(page_number=1, opts={})

The available options and their default values are:

{
    density: 600,
    format: :png,
}

Contributing

Fork it ( https://github.com/tomasc/dragonfly_pdf/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request