pdf-reader 0.5

data/lib/pdf/reader/token.rb

@@ -0,0 +1,41 @@
+################################################################################
+#
+# Copyright (C) 2006 Peter J Jones (pjones@pmade.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+################################################################################
+
+class PDF::Reader
+  ################################################################################
+  # An internal PDF::Reader class that represents a single token from a PDF file.
+  #
+  # Behaves exactly like a Ruby String - it basically exists for convenience.
+  class Token < String
+    ################################################################################
+    # Creates a new token with the specified value
+    def initialize (val)
+      super
+    end
+    ################################################################################
+  end
+  ################################################################################
+end
+################################################################################

data/lib/pdf/reader/xref.rb

@@ -0,0 +1,101 @@
+################################################################################
+#
+# Copyright (C) 2006 Peter J Jones (pjones@pmade.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+################################################################################
+
+class PDF::Reader
+  ################################################################################
+  # An internal PDF::Reader class that represents the Xref table in a PDF file
+  # An Xref table is a map of object identifiers and byte offsets. Any time a particular
+  # object needs to be found, the Xref table is used to find where it is stored in the
+  # file.
+  class XRef
+    ################################################################################
+    # create a new Xref table based on the contents of the supplied PDF::Reader::Buffer object
+    def initialize (buffer)
+      @buffer = buffer
+      @xref = {}
+    end
+    ################################################################################
+    # Read the xref table from the underlying buffer. If offset is specified the table
+    # will be loaded from there, otherwise the default offset will be located and used.
+    #
+    # Will fail silently if there is no xref table at the requested offset.
+    def load (offset = nil)
+      @buffer.seek(offset || @buffer.find_first_xref_offset)
+      token = @buffer.token
+
+      if token == "xref"
+        load_xref_table
+      end
+    end
+    ################################################################################
+    # Return a string containing the contents of an entire PDF object. The object is requested
+    # by specifying a PDF::Reader::Reference object that contains the objects ID and revision
+    # number
+    def object (ref, save_pos = true)
+      pos = @buffer.pos if save_pos
+      parser = Parser.new(@buffer.seek(offset_for(ref)), self).object(ref.id, ref.gen)
+      @buffer.seek(pos) if save_pos
+      parser
+    end
+    ################################################################################
+    # Assumes the underlying buffer is positioned at the start of an Xref table and
+    # processes it into memory.
+    def load_xref_table
+      objid, count = @buffer.token.to_i, @buffer.token.to_i
+
+      count.times do
+        offset = @buffer.token.to_i
+        generation = @buffer.token.to_i
+        state = @buffer.token
+
+        store(objid, generation, offset) if state == "n"
+        objid += 1
+      end
+
+      raise MalformedPDFError, "PDF malformed, missing trailer after cross reference" unless @buffer.token == "trailer"
+      raise MalformedPDFError, "PDF malformed, trailer should be a dictionary" unless @buffer.token == "<<"
+
+      trailer = Parser.new(@buffer, self).dictionary
+      load(trailer['Prev']) if trailer.has_key?('Prev')
+
+      trailer
+    end
+    ################################################################################
+    # returns the byte offset for the specified PDF object.
+    #
+    # ref - a PDF::Reader::Reference object containing an object ID and revision number
+    def offset_for (ref)
+      @xref[ref.id][ref.gen]
+    end
+    ################################################################################
+    # Stores an offset value for a particular PDF object ID and revision number
+    def store (id, gen, offset)
+      (@xref[id] ||= {})[gen] ||= offset
+    end
+    ################################################################################
+  end
+  ################################################################################
+end
+################################################################################

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: pdf-reader
+version: !ruby/object:Gem::Version 
+  version: "0.5"
+date: 2007-12-14 00:00:00 +11:00
+summary: A library for accessing the content of PDF files
+require_paths: 
+- lib
+email: pjones@pmade.com
+homepage: http://software.pmade.com/pdfreader
+rubyforge_project: pdf-reader
+description: The PDF::Reader library implements a PDF parser conforming as much as possible to the PDF specification from Adobe
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Peter Jones
+files: 
+- lib/pdf
+- lib/pdf/reader
+- lib/pdf/reader/explore.rb
+- lib/pdf/reader/reference.rb
+- lib/pdf/reader/name.rb
+- lib/pdf/reader/token.rb
+- lib/pdf/reader/xref.rb
+- lib/pdf/reader/filter.rb
+- lib/pdf/reader/text_receiver.rb
+- lib/pdf/reader/buffer.rb
+- lib/pdf/reader/error.rb
+- lib/pdf/reader/content.rb
+- lib/pdf/reader/parser.rb
+- lib/pdf/reader/register_receiver.rb
+- lib/pdf/reader.rb
+- Rakefile
+- README
+- TODO
+- CHANGELOG
+test_files: []
+
+rdoc_options: 
+- --title
+- PDF::Reader Documentation
+- --main
+- README
+- -q
+extra_rdoc_files: 
+- README
+- TODO
+- CHANGELOG
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+