Skip to content

Latest commit

 

History

History
38 lines (29 loc) · 1.5 KB

README.md

File metadata and controls

38 lines (29 loc) · 1.5 KB

pdf/margins

Build Status

Simple Ruby library to check a PDF for clear margin areas, by rendering to a bitmap, ensuring that the pixel area defined by each margin is empty.

This is a bit of a clumsy technique, but it's faster than parsing and understanding all the permutations of the PDF format that may result in an object being visible in the margins.

It shells out to mudraw, part of [mupdf] 1, for rastering the PDF to PNGs, and then uses [Chunky PNG] 2 to examine each page's margins.

On Ubuntu, you may wish to install mupdf from the [PPA] 3.

Written by [Tom Taylor] 3, [Newspaper Club] 4.

Example

# Accepts a `spreads` option which assumes margin dimensions refer to
# spreads, and so alternates which pages we check left and right margins
# on. Measurements are in mm, defaulting to 0 unless specified.
checker = PDF::Margins::Checker.new('example.pdf', top_margin: 10, 
                                                   right_margin: 10, 
                                                   bottom_margin: 10, 
                                                   left_margin: 10, 
                                                   spreads: true)
puts checker.issues.inspect