pdf-core 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c82f9b6d4628406f50c582c41acd34a87877665a
-  data.tar.gz: dfc8e85e060c5c4fbfca3f08172237fc76fe6fab
+  metadata.gz: 214a429acbb26d39087be7eaf5df268a5f5b072d
+  data.tar.gz: dcc45ccaf9206b5d2e85922ac9019eb3a23f3bde
 SHA512:
-  metadata.gz: be3d2a5a9f2ae4e13ab6968ebd077bca6c3cac533d6b16572df103e3977d9340197f7c6ad274e3b95c8653d72e6b68f343d56395568b9bb2b66a90e768a8e072
-  data.tar.gz: 829e5ce883da56c582dcdf185388087d98247d13b05952258577dbd472cc25e9cf1b2f0502f70a73e2628d282cecafdd4bde1004674fd24804b759532cddf4c0
+  metadata.gz: ec4be03057a7332b0e92b74b18826140afa8ab5faaafd94d52c009aecab3cda187a59f9d70fc0a36c2f95de071c95f1c49f958ec7bf9c93d779b3f313eca3e61
+  data.tar.gz: a548742fc3a1b06836540855cc832278e10a7dec1bc6ebe56af827894babd59cfe1a2dd36ad6c0c355aa57d60355d0ae6dc0a3c2dd34aae41343532df0b0944e

data/lib/pdf/core.rb

@@ -13,7 +13,6 @@ require_relative "core/document_state"
 require_relative "core/name_tree"
 require_relative "core/graphics_state"
 require_relative "core/page_geometry"
-require_relative "core/outline"
 
 module PDF
   module Core

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pdf-core
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Gregory Brown
@@ -12,7 +12,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-02-20 00:00:00.000000000 Z
+date: 2014-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pdf-reader
@@ -106,7 +106,6 @@ files:
 - lib/pdf/core/literal_string.rb
 - lib/pdf/core/name_tree.rb
 - lib/pdf/core/object_store.rb
-- lib/pdf/core/outline.rb
 - lib/pdf/core/page.rb
 - lib/pdf/core/page_geometry.rb
 - lib/pdf/core/pdf_object.rb
@@ -133,7 +132,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.3.6
 requirements: []
 rubyforge_project: prawn
-rubygems_version: 2.2.0
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: PDF::Core is used by Prawn to render PDF documents

data/lib/pdf/core/outline.rb

@@ -1,317 +0,0 @@
-require "forwardable"
-
-module PDF
-  module Core
-    # The Outline class organizes the outline tree items for the document.
-    # Note that the prev and parent instance variables are adjusted while navigating
-    # through the nested blocks. These variables along with the presence or absense
-    # of blocks are the primary means by which the relations for the various
-    # OutlineItems and the OutlineRoot are set. Unfortunately, the best way to
-    # understand how this works is to follow the method calls through a real example.
-    #
-    # Some ideas for the organization of this class were gleaned from name_tree. In
-    # particular the way in which the OutlineItems are finally rendered into document
-    # objects in PdfObject through a hash.
-    #
-    class Outline
-
-      extend Forwardable
-      def_delegator :@document, :page_number
-
-      attr_accessor :parent
-      attr_accessor :prev
-      attr_accessor :document
-      attr_accessor :items
-
-      def initialize(document)
-        @document = document
-        @parent = root
-        @prev = nil
-        @items = {}
-      end
-
-      # Defines/Updates an outline for the document.
-      # The outline is an optional nested index that appears on the side of a PDF
-      # document usually with direct links to pages. The outline DSL is defined by nested
-      # blocks involving two methods: section and page; see the documentation on those methods
-      # for their arguments and options. Note that one can also use outline#update
-      # to add more sections to the end of the outline tree using the same syntax and scope.
-      #
-      # The syntax is best illustrated with an example:
-      #
-      # Prawn::Document.generate(outlined_document.pdf) do
-      #   text "Page 1. This is the first Chapter. "
-      #   start_new_page
-      #   text "Page 2. More in the first Chapter. "
-      #   start_new_page
-      #   outline.define do
-      #     section 'Chapter 1', :destination => 1, :closed => true do
-      #       page :destination => 1, :title => 'Page 1'
-      #       page :destination => 2, :title => 'Page 2'
-      #     end
-      #   end
-      #   start_new_page do
-      #   outline.update do
-      #     section 'Chapter 2', :destination =>  2, do
-      #       page :destination => 3, :title => 'Page 3'
-      #     end
-      #   end
-      # end
-      #
-      def define(&block)
-        instance_eval(&block)  if block
-      end
-
-      alias :update :define
-
-      # Inserts an outline section to the outline tree (see outline#define).
-      # Although you will probably choose to exclusively use outline#define so
-      # that your outline tree is contained and easy to manage, this method
-      # gives you the option to insert sections to the outline tree at any point
-      # during document generation. This method allows you to add a child subsection
-      # to any other item at any level in the outline tree.
-      # Currently the only way to locate the place of entry is with the title for the
-      # item. If your title names are not unique consider using define_outline.
-      # The method takes the following arguments:
-      #   title: a string that must match an outline title to add the subsection to
-      #   position: either :first or :last(the default) where the subsection will be placed relative
-      #      to other child elements. If you need to position your subsection in between
-      #      other elements then consider using #insert_section_after
-      #   block: uses the same DSL syntax as outline#define, for example:
-      #
-      # Consider using this method inside of outline.update if you want to have the outline object
-      # to be scoped as self (see #insert_section_after example).
-      #
-      #   go_to_page 2
-      #   start_new_page
-      #   text "Inserted Page"
-      #   outline.add_subsection_to :title => 'Page 2', :first do
-      #     outline.page :destination => page_number, :title => "Inserted Page"
-      #   end
-      #
-      def add_subsection_to(title, position = :last, &block)
-        @parent = items[title]
-        raise Prawn::Errors::UnknownOutlineTitle,
-          "\n No outline item with title: '#{title}' exists in the outline tree" unless @parent
-        @prev = position == :first ? nil : @parent.data.last
-        nxt = position == :first ? @parent.data.first : nil
-        insert_section(nxt, &block)
-      end
-
-      # Inserts an outline section to the outline tree (see outline#define).
-      # Although you will probably choose to exclusively use outline#define so
-      # that your outline tree is contained and easy to manage, this method
-      # gives you the option to insert sections to the outline tree at any point
-      # during document generation. Unlike outline.add_section, this method allows
-      # you to enter a section after any other item at any level in the outline tree.
-      # Currently the only way to locate the place of entry is with the title for the
-      # item. If your title names are not unique consider using define_outline.
-      # The method takes the following arguments:
-      #   title: the title of other section or page to insert new section after
-      #   block: uses the same DSL syntax as outline#define, for example:
-      #
-      #   go_to_page 2
-      #   start_new_page
-      #   text "Inserted Page"
-      #   update_outline do
-      #     insert_section_after :title => 'Page 2' do
-      #       page :destination => page_number, :title => "Inserted Page"
-      #     end
-      #   end
-      #
-      def insert_section_after(title, &block)
-        @prev = items[title]
-        raise Prawn::Errors::UnknownOutlineTitle,
-          "\n No outline item with title: '#{title}' exists in the outline tree" unless @prev
-        @parent = @prev.data.parent
-        nxt = @prev.data.next
-        insert_section(nxt, &block)
-      end
-
-      # See outline#define above for documentation on how this is used in that context
-      #
-      # Adds an outine section to the outline tree.
-      # Although you will probably choose to exclusively use outline#define so
-      # that your outline tree is contained and easy to manage, this method
-      # gives you the option to add sections to the outline tree at any point
-      # during document generation. When not being called from within another #section block
-      # the section will be added at the top level after the other root elements of the outline.
-      # For more flexible placement try using outline#insert_section_after and/or
-      # outline#add_subsection_to
-      # Takes the following arguments:
-      #   title: the outline text that appears for the section.
-      #   options: destination - optional integer defining the page number for a destination link
-      #                          to the top of the page (using a :FIT destination).
-      #                 - or an array with a custom destination (see the #dest_* methods of the
-      #                   PDF::Destination module)
-      #            closed - whether the section should show its nested outline elements.
-      #                   - defaults to false.
-      #            block: more nested subsections and/or page blocks
-      #
-      # example usage:
-      #
-      #   outline.section 'Added Section', :destination => 3 do
-      #     outline.page :destionation => 3, :title => 'Page 3'
-      #   end
-      def section(title, options = {}, &block)
-        add_outline_item(title, options, &block)
-      end
-
-      # See Outline#define above for more documentation on how it is used in that context
-      #
-      # Adds a page to the outline.
-      # Although you will probably choose to exclusively use outline#define so
-      # that your outline tree is contained and easy to manage, this method also
-      # gives you the option to add pages to the root of outline tree at any point
-      # during document generation. Note that the page will be added at the
-      # top level after the other root outline elements. For more flexible placement try
-      # using outline#insert_section_after and/or outline#add_subsection_to.
-      #
-      # Takes the following arguments:
-      #     options:
-      #            title - REQUIRED. The outline text that appears for the page.
-      #            destination - optional integer defining the page number for a destination link
-      #                          to the top of the page (using a :FIT destination).
-      #                 - or an array with a custom destination (see the #dest_* methods of the
-      #                   PDF::Destination module)
-      #            closed - whether the section should show its nested outline elements.
-      #                   - defaults to false.
-      # example usage:
-      #
-      #   outline.page :title => "Very Last Page"
-      # Note: this method is almost identical to section except that it does not accept a block
-      # thereby defining the outline item as a leaf on the outline tree structure.
-      def page(options = {})
-        if options[:title]
-          title = options[:title]
-        else
-          raise Prawn::Errors::RequiredOption,
-            "\nTitle is a required option for page"
-        end
-        add_outline_item(title, options)
-      end
-
-    private
-
-      # The Outline dictionary (12.3.3) for this document.  It is
-      # lazily initialized, so that documents that do not have an outline
-      # do not incur the additional overhead.
-      def root
-        document.state.store.root.data[:Outlines] ||= document.ref!(OutlineRoot.new)
-      end
-
-      def add_outline_item(title, options, &block)
-        outline_item = create_outline_item(title, options)
-        set_relations(outline_item)
-        increase_count
-        set_variables_for_block(outline_item, block)
-        block.call if block
-        reset_parent(outline_item)
-      end
-
-      def create_outline_item(title, options)
-        outline_item = OutlineItem.new(title, parent, options)
-
-        case options[:destination]
-        when Integer
-          page_index = options[:destination] - 1
-          outline_item.dest = [document.state.pages[page_index].dictionary, :Fit]
-        when Array
-          outline_item.dest = options[:destination]
-        end
-
-        outline_item.prev = prev if @prev
-        items[title] = document.ref!(outline_item)
-      end
-
-      def set_relations(outline_item)
-        prev.data.next = outline_item if prev
-        parent.data.first = outline_item unless prev
-        parent.data.last = outline_item
-      end
-
-      def increase_count
-        counting_parent = parent
-        while counting_parent
-          counting_parent.data.count += 1
-          if counting_parent == root
-            counting_parent = nil
-          else
-            counting_parent = counting_parent.data.parent
-          end
-        end
-      end
-
-      def set_variables_for_block(outline_item, block)
-        self.prev = block ? nil : outline_item
-        self.parent = outline_item if block
-      end
-
-      def reset_parent(outline_item)
-        if parent == outline_item
-          self.prev = outline_item
-          self.parent = outline_item.data.parent
-        end
-      end
-
-      def insert_section(nxt, &block)
-        last = @parent.data.last
-        if block
-          block.call
-        end
-        adjust_relations(nxt, last)
-        reset_root_positioning
-      end
-
-      def adjust_relations(nxt, last)
-        if nxt
-          nxt.data.prev = @prev
-          @prev.data.next = nxt
-          @parent.data.last = last
-        end
-      end
-
-      def reset_root_positioning
-        @parent = root
-        @prev = root.data.last
-      end
-
-    end
-
-    class OutlineRoot #:nodoc:
-      attr_accessor :count, :first, :last
-
-      def initialize
-        @count = 0
-      end
-
-      def to_hash
-        {:Type => :Outlines, :Count => count, :First => first, :Last => last}
-      end
-    end
-
-    class OutlineItem #:nodoc:
-      attr_accessor :count, :first, :last, :next, :prev, :parent, :title, :dest, :closed
-
-      def initialize(title, parent, options)
-        @closed = options[:closed]
-        @title = title
-        @parent = parent
-        @count = 0
-      end
-
-      def to_hash
-        hash = { :Title => title,
-                 :Parent => parent,
-                 :Count => closed ? -count : count }
-        [{:First => first}, {:Last => last}, {:Next => defined?(@next) && @next},
-         {:Prev => prev}, {:Dest => dest}].each do |h|
-          unless h.values.first.nil?
-            hash.merge!(h)
-          end
-        end
-        hash
-      end
-    end
-  end
-end