Contents

# encoding: UTF-8
module Grim
  class Page

    attr_reader :number

    # Sets up some instance variables on new instance.
    #
    # pdf - the pdf this page belongs to
    # index - the index of the page in the array of pages
    # options - A Hash of options.
    #           :pdftotext_path - The String path of where to find the pdftotext
    #                             binary to use when extracting text
    #                             (default: "pdftotext").
    #
    def initialize(pdf, index, options = {})
      @pdf    = pdf
      @index  = index
      @number   = index + 1
      @pdftotext_path = options[:pdftotext_path] || 'pdftotext'
    end

    # Extracts the selected page and turns it into an image.
    # Tested on png and jpeg.
    #
    # path - String of the path to save to
    # options - Hash of options to customize the saving of the image
    #           (ie: width, density, and quality)
    #
    # For example:
    #
    #   pdf[1].save(/path/to/save/image.png)
    #   # => true
    #
    # Returns a File.
    #
    def save(path, options={})
      raise PathMissing if path.nil? || path !~ /\S/

      Grim.processor.save(@pdf, @index, path, options)
    end

    # Extracts the text from the selected page, using additional options.
    #
    # For example:
    #
    #   pdf[1].text
    #   # => "This is text from slide 2.\n\nAnd even more text from slide 2."
    #
    #   pdf[1].text({flags: ["-table"]})
    # Returns a String.
    #
    def text(options={})
      flags = options.fetch(:flags, [])
      command_parts = [@pdftotext_path, "-enc", "UTF-8", "-f", @number, "-l", @number]
      command_parts += flags if flags.length > 0
      command_parts += [Shellwords.escape(@pdf.path), "-"]
      command = command_parts.join(' ')
      Grim.logger.debug { "Running pdftotext command" }
      Grim.logger.debug { command }
      `#{command}`
    end
  end
end

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
grim-1.3.5	lib/grim/page.rb
grim-1.3.4	lib/grim/page.rb
grim-1.3.3	lib/grim/page.rb
grim-1.3.2	lib/grim/page.rb
grim-1.3.1	lib/grim/page.rb