pdf-wrapper 0.0.4 → 0.0.5

data/CHANGELOG

@@ -1,3 +1,12 @@
+v0.0.5 (27th April 2008)
+- Fix crash when inserting multiple images
+- added PDF::Wrapper#pad
+- added PDF::Wrapper#text_width
+- added support for customisable page margins (thanks to Paweł Kondzior)
+- added support for cubic Bezier spline paths (thanks to Paweł Kondzior)
+- added support for specifying the width of a cell border (thanks to Paweł Kondzior)
+- fixed alignment of text (thanks to Paweł Kondzior)
+
 v0.0.4 (12th March 2008)
 - added support for custom line widths on primitive drawing shapes (circles,
   lines, etc). Thanks Paweł Kondzior

data/Rakefile

@@ -6,7 +6,7 @@ require 'rake/testtask'
 require "rake/gempackagetask"
 require 'spec/rake/spectask'
 
-PKG_VERSION = "0.0.4"
+PKG_VERSION = "0.0.5"
 PKG_NAME = "pdf-wrapper"
 PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
 
@@ -16,7 +16,8 @@ task :default => [ :spec ]
 # run all rspecs
 desc "Run all rspec files"
 Spec::Rake::SpecTask.new("spec") do |t|
-  t.spec_files = FileList['specs/**/*.rb']
+  #t.spec_files = FileList['specs/**/*_spec.rb']
+  t.spec_files = ['specs/load_spec.rb','specs/image_spec.rb','specs/shapes_spec.rb','specs/text_spec.rb','specs/wrapper_spec.rb']
   t.rcov = true
   t.rcov_dir = (ENV['CC_BUILD_ARTIFACTS'] || 'doc') + "/rcov"
   t.rcov_opts = ["--exclude","spec.*\.rb","--exclude",".*cairo.*","--exclude",".*rcov.*","--exclude",".*rspec.*","--exclude",".*pdf-reader.*"]

data/TODO

@@ -1 +1,2 @@
 All TODO's are currently marked inline in the source code
+

data/examples/utf8.rb

@@ -8,5 +8,5 @@ require 'pdf/wrapper'
 pdf = PDF::Wrapper.new(:paper => :A4)
 pdf.default_font("Sans Serif")
 pdf.default_color(:black)
-pdf.text File.read(File.dirname(__FILE__) + "/../specs/data/utf8.txt"), :font => "Monospace", :font_size => 8
+pdf.text File.read(File.dirname(__FILE__) + "/../specs/data/utf8.txt"), :font => "Monospace", :font_size => 8, :alignment => :center
 pdf.render_to_file("wrapper.pdf")

data/lib/pdf/wrapper.rb

@@ -83,7 +83,15 @@ module PDF
     # <tt>:paper</tt>::   The paper size to use (default :A4)
     # <tt>:orientation</tt>::   :portrait (default) or :landscape
     # <tt>:background_color</tt>::   The background colour to use (default :white)
+    # <tt>:margin_top</tt>::   The size of the default top margin (default 5% of page)
+    # <tt>:margin_bottom</tt>::   The size of the default bottom margin (default 5% of page)
+    # <tt>:margin_left</tt>::   The size of the default left margin (default 5% of page)
+    # <tt>:margin_right</tt>::   The size of the default right margin (default 5% of page)
     def initialize(opts={})
+
+      # ensure we have recentish cairo bindings
+      raise "Ruby Cairo bindings version #{Cairo::BINDINGS_VERSION.join(".")} is too low. At least 1.5 is required" if Cairo::BINDINGS_VERSION.to_s < "150"
+
       options = {:paper => :A4,
                   :orientation => :portrait,
                   :background_color => :white
@@ -91,7 +99,8 @@ module PDF
       options.merge!(opts)
 
       # test for invalid options
-      options.assert_valid_keys(:paper, :orientation, :background_color)
+      options.assert_valid_keys(:paper, :orientation, :background_color, :margin_left, :margin_right, :margin_top, :margin_bottom)
+      options[:paper] = options[:paper].to_sym
       raise ArgumentError, "Invalid paper option" unless PAGE_SIZES.include?(options[:paper])
 
       # set page dimensions
@@ -106,11 +115,10 @@ module PDF
       end
 
       # set page margins and dimensions of usable canvas
-      # TODO: add options for customising the margins. ATM they're always 5% of the page dimensions
-      @margin_left = (@page_width * 0.05).ceil
-      @margin_right = (@page_width * 0.05).ceil
-      @margin_top = (@page_height * 0.05).ceil
-      @margin_bottom = (@page_height * 0.05).ceil
+      @margin_left = options[:margin_left] || (@page_width * 0.05).ceil
+      @margin_right = options[:margin_right] || (@page_width * 0.05).ceil
+      @margin_top = options[:margin_top] || (@page_height * 0.05).ceil
+      @margin_bottom = options[:margin_bottom] || (@page_height * 0.05).ceil
 
       # initialize some cairo objects to draw on
       @output = StringIO.new
@@ -265,7 +273,7 @@ module PDF
     # <tt>:border</tt>::   Which sides of the cell should have a border? A string with any combination the letters tblr (top, bottom, left, right). Nil for no border, defaults to all sides.
     # <tt>:border_width</tt>::  How wide should the border be?
     # <tt>:border_color</tt>::  What color should the border be?
-    # <tt>:bgcolor</tt>::  A background color for the cell. Defaults to none.
+    # <tt>:fill_color</tt>::  A background color for the cell. Defaults to none.
     # <tt>:padding</tt>::  The number of points to leave between the inside of the border and text. Defaults to 3.
     def cell(str, x, y, w, h, opts={})
       # TODO: add support for pango markup (see http://ruby-gnome2.sourceforge.jp/hiki.cgi?pango-markup)
@@ -274,12 +282,12 @@ module PDF
       # TODO: add an option to draw a border with rounded corners
 
       options = default_text_options
-      options.merge!({:border => "tblr", :border_width => 1, :border_color => :black, :bgcolor => nil, :padding => 3})
+      options.merge!({:border => "tblr", :border_width => @default_line_width, :border_color => :black, :fill_color => nil, :padding => 3})
       options.merge!(opts)
-      options.assert_valid_keys(default_text_options.keys + [:width, :border, :border_width, :border_color, :bgcolor, :padding])
+      options.assert_valid_keys(default_text_options.keys + [:width, :border, :border_width, :border_color, :fill_color, :padding])
 
       # apply padding
-      textw = x - (options[:padding] * 2)
+      textw = w - (options[:padding] * 2)
       texth = h - (options[:padding] * 2)
       textx = x + options[:padding]
       texty = y + options[:padding]
@@ -291,7 +299,7 @@ module PDF
       origx, origy = current_point
 
       # TODO: raise an exception if the box coords or dimensions will place it off the canvas
-      rectangle(x,y,w,h, :color => options[:bgcolor], :fill_color => options[:bgcolor]) if options[:bgcolor]
+      rectangle(x,y,w,h, :color => options[:fill_color], :fill_color => options[:fill_color]) if options[:fill_color]
 
       layout = build_pango_layout(str.to_s, textw, options)
 
@@ -301,11 +309,10 @@ module PDF
       render_layout(layout, textx, texty, texth, :auto_new_page => false)
 
       # draw a border around the cell
-      # TODO: obey options[:border_width]
-      line(x,y,x+w,y, :color => options[:border_color])     if options[:border].include?("t")
-      line(x,y+h,x+w,y+h, :color => options[:border_color]) if options[:border].include?("b")
-      line(x,y,x,y+h, :color => options[:border_color])     if options[:border].include?("l")
-      line(x+w,y,x+w,y+h, :color => options[:border_color]) if options[:border].include?("r")
+      line(x,y,x+w,y, :color => options[:border_color], :line_width => options[:border_width])     if options[:border].include?("t")
+      line(x,y+h,x+w,y+h, :color => options[:border_color], :line_width => options[:border_width]) if options[:border].include?("b")
+      line(x,y,x,y+h, :color => options[:border_color], :line_width => options[:border_width])     if options[:border].include?("l")
+      line(x+w,y,x+w,y+h, :color => options[:border_color], :line_width => options[:border_width]) if options[:border].include?("r")
 
       # restore the cursor position
       move_to(origx, origy)
@@ -421,6 +428,19 @@ module PDF
       return height / Pango::SCALE
     end
 
+    # Returns the amount of horizontal space needed to display the supplied text with the requested options
+    # opts is an options hash that specifies various attributes of the text. See the text function for more information.
+    # The text is assumed to not wrap.
+    def text_width(str, opts = {})
+      options = default_text_options.merge!(opts)
+      options.assert_valid_keys(default_text_options.keys)
+
+      layout = build_pango_layout(str.to_s, -1, options)
+      width, height = layout.size
+
+      return width / Pango::SCALE
+    end
+
     #####################################################
     # Functions relating to working with graphics
     #####################################################
@@ -484,6 +504,27 @@ module PDF
       move_to(origx, origy)
     end
 
+    # Adds a cubic Bezier spline to the path from the  (x0, y0) to position (x3, y3) 
+    # in user-space coordinates, using (x1, y1) and (x2, y2) as the control points. 
+    # Options:
+    # <tt>:color</tt>::   The colour of the line
+    # <tt>:line_width</tt>::   The width of line. Defaults to 2.0
+    def curve(x0, y0, x1, y1, x2, y2, x3, y3, opts = {})
+      options = {:color => @default_color, :line_width => @default_line_width }
+      options.merge!(opts)
+      options.assert_valid_keys(:color, :line_width)
+      origx, origy = current_point
+
+      set_color(options[:color])
+      @context.set_line_width(options[:line_width])
+      move_to(x0,y0)
+      @context.curve_to(x1, y1, x2, y2, x3, y3).stroke
+
+      # restore the cursor position
+      move_to(origx, origy)
+    end
+  
+
     # draw a rectangle starting at x,y with w,h dimensions.
     # Parameters:
     # <tt>:x</tt>::   The x co-ordinate of the top left of the rectangle.
@@ -630,6 +671,12 @@ module PDF
     # Misc Functions
     #####################################################
 
+    def pad(n)
+      x, y = current_point
+      move_to(x, y + n)
+      y + n
+    end
+
     # move the cursor to an arbitary position on the current page
     def move_to(x,y)
       raise ArgumentError, 'x cannot be larger than the width of the page' if x > page_width
@@ -715,7 +762,11 @@ module PDF
       # create a new Pango layout that our text will be added to
       layout = @context.create_pango_layout
       layout.text = str.to_s
-      layout.width = w * Pango::SCALE
+      if w == -1
+        layout.width = -1
+      else
+        layout.width = w * Pango::SCALE
+      end
       layout.spacing = options[:spacing] * Pango::SCALE
 
       # set the alignment of the text in the layout
@@ -830,7 +881,7 @@ module PDF
         @context.scale(width / w, height / h)
         @context.render_poppler_page(page)
       end
-      move_to(x, y + height)
+      move_to(opts[:left] || x, (opts[:top] || y) + height)
     end
 
     def draw_pixbuf(filename, opts = {})
@@ -845,7 +896,7 @@ module PDF
         @context.set_source_pixbuf(pixbuf, 0, 0)
         @context.paint
       end
-      move_to(x, y + height)
+      move_to(opts[:left] || x, (opts[:top] || y) + height)
     end
 
     def draw_png(filename, opts = {})
@@ -859,7 +910,7 @@ module PDF
         @context.set_source(img_surface, 0, 0)
         @context.paint
       end
-      move_to(x, y + height)
+      move_to(opts[:left] || x, (opts[:top] || y) + height)
     end
 
     def draw_svg(filename, opts = {})
@@ -874,7 +925,7 @@ module PDF
         @context.render_rsvg_handle(handle)
         #@context.paint
       end
-      move_to(x, y + height)
+      move_to(opts[:left] || x, (opts[:top] || y) + height)
     end
 
     # adds a single table row to the canvas. Top left of the row will be at the current x,y
@@ -990,11 +1041,35 @@ module PDF
       # adding text at the same co-ords
       orig_x = x
       orig_y = y
-
       # for each line in the layout
-      layout.lines.each do |line|
-        #calculate where the next line starts
-        ink_rect, logical_rect = line.extents
+#      layout.alignment = Pango::Layout::ALIGN_RIGHT
+#      layout.lines.each do |line|
+#        #calculate where the next line starts
+#        ink_rect, logical_rect = line.extents
+#        y = y + (logical_rect.height / Pango::SCALE * (3.0/4.0)) + 1
+#        if y >= (orig_y + h)
+#          # our text is using the maximum amount of vertical space we want it to
+#          if options[:auto_new_page]
+#            # create a new page and we can continue adding text
+#            start_new_page
+#            x = orig_x
+#            y = orig_y
+#          else
+#            # the user doesn't want us to continue on the next page, so
+#            # stop adding lines to the canvas
+#            break
+#          end
+#        end
+#
+#        # move to the start of the next line
+#        move_to(x, y)
+#        # draw the line on the canvas
+#        @context.show_pango_layout_line(line)
+#      end
+      iter = layout.iter
+      loop do 
+        line = iter.line
+        ink_rect, logical_rect = iter.line_extents
         y = y + (logical_rect.height / Pango::SCALE * (3.0/4.0)) + 1
         if y >= (orig_y + h)
           # our text is using the maximum amount of vertical space we want it to
@@ -1011,10 +1086,15 @@ module PDF
         end
 
         # move to the start of the next line
-        move_to(x, y)
+        #move_to(x, y)
+        baseline = iter.baseline / Pango::SCALE
+        @context.move_to(x + logical_rect.x / Pango::SCALE, y + baseline)
+
         # draw the line on the canvas
         @context.show_pango_layout_line(line)
-      end
+
+        break unless iter.next_line!
+      end 
 
       # return the y co-ord we finished on
       return y

data/specs/image_spec.rb

@@ -0,0 +1,22 @@
+# coding: utf-8
+
+require File.dirname(__FILE__) + '/spec_helper'
+
+context "The PDF::Wrapper class" do
+  specify "should be able to detect the filetype of an image" do
+    pdf = PDF::Wrapper.new
+    pdf.detect_image_type(File.dirname(__FILE__) + "/data/google.png").should eql(:png)
+    pdf.detect_image_type(File.dirname(__FILE__) + "/data/zits.gif").should eql(:gif)
+    pdf.detect_image_type(File.dirname(__FILE__) + "/data/orc.svg").should eql(:svg)
+    pdf.detect_image_type(File.dirname(__FILE__) + "/data/utf8-long.pdf").should eql(:pdf)
+    pdf.detect_image_type(File.dirname(__FILE__) + "/data/shipsail.jpg").should eql(:jpg)
+  end
+
+  specify "should be able to calculate image dimensions correctly" do
+    pdf = PDF::Wrapper.new
+    pdf.calc_image_dimensions(100, 100, 200, 200).should eql([100.0,100.0])
+    pdf.calc_image_dimensions(nil, nil, 200, 200).should eql([200.0,200.0])
+    pdf.calc_image_dimensions(150, 200, 200, 200, true).should eql([150.0,150.0])
+    pdf.calc_image_dimensions(300, 250, 200, 200, true).should eql([250.0,250.0])
+  end
+end

data/specs/load_spec.rb

@@ -0,0 +1,31 @@
+# coding: utf-8
+
+require File.dirname(__FILE__) + '/spec_helper'
+
+context "The PDF::Wrapper class" do
+  specify "should load external libs correctly" do
+    pdf = PDF::Wrapper.new
+
+    # lib gdkpixbuf
+    ::Object.const_defined?(:Gdk).should eql(false)
+    pdf.load_libpixbuf
+    ::Object.const_defined?(:Gdk).should eql(true)
+    ::Gdk.const_defined?(:Pixbuf).should eql(true)
+
+    # pango
+    ::Object.const_defined?(:Pango).should eql(false)
+    pdf.load_libpango
+    ::Object.const_defined?(:Pango).should eql(true)
+
+    # libpoppler
+    ::Object.const_defined?(:Poppler).should eql(false)
+    pdf.load_libpoppler
+    ::Object.const_defined?(:Poppler).should eql(true)
+
+    # librsvg
+    ::Object.const_defined?(:RSVG).should eql(false)
+    pdf.load_librsvg
+    ::Object.const_defined?(:RSVG).should eql(true)
+
+  end
+end

data/specs/shapes_spec.rb

@@ -0,0 +1,194 @@
+# coding: utf-8
+
+require File.dirname(__FILE__) + '/spec_helper'
+
+context "The PDF::Wrapper class" do
+  specify "should be able to draw a single line onto the canvas" do
+    x0 = y0 = 100
+    x1 = y1 = 200
+    pdf = PDF::Wrapper.new
+    pdf.line(x0,y0,x1,y1)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # the begin_new_subpath command specifies the start of the line, append line specifies the end
+    receiver.count(:begin_new_subpath).should eql(1)
+    receiver.count(:append_line).should eql(1)
+    receiver.first_occurance_of(:begin_new_subpath)[:args].should eql([x0.to_f, 741.89])
+    receiver.first_occurance_of(:append_line)[:args].should eql([x1.to_f, 641.89])
+  end
+
+  specify "should be able to draw a single line onto the canvas with a width of 5" do
+    x0 = y0 = 100
+    x1 = y1 = 200
+    width = 5
+    pdf = PDF::Wrapper.new
+    pdf.line(x0,y0,x1,y1, :line_width => width)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # the begin_new_subpath command specifies the start of the line, append line specifies the end
+    receiver.count(:set_line_width).should eql(1)
+    receiver.count(:begin_new_subpath).should eql(1)
+    receiver.count(:append_line).should eql(1)
+    receiver.first_occurance_of(:set_line_width)[:args].should eql([width.to_f])
+    receiver.first_occurance_of(:begin_new_subpath)[:args].should eql([x0.to_f, 741.89])
+    receiver.first_occurance_of(:append_line)[:args].should eql([x1.to_f, 641.89])
+  end
+
+  specify "should be able to draw a cubic bezier spline onto the canvas"
+
+  specify "should be able to draw an empty rectangle onto the canvas" do
+    x = y = 100
+    w = h = 200
+    pdf = PDF::Wrapper.new
+    pdf.rectangle(x,y,w,h)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # the begin_new_subpath command specifies the start of the line, append line specifies the end
+    callbacks = receiver.all(:append_rectangle)
+    callbacks.size.should eql(2)
+    # don't care about the first rectangel, it just goes around the outside of the page
+    callbacks.shift
+    callbacks.shift[:args].should eql([100.0, 741.89, 200.0, -200.0])
+  end
+
+  specify "should be able to draw an empty rectangle onto the canvas with a line width of 5" do
+    x = y = 100
+    w = h = 200
+    width = 5
+    pdf = PDF::Wrapper.new
+    pdf.rectangle(x,y,w,h, :line_width => width)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # ensure the line width was set correctly
+    receiver.count(:set_line_width).should eql(1)
+    receiver.first_occurance_of(:set_line_width)[:args].should eql([width.to_f])
+
+    # the begin_new_subpath command specifies the start of the line, append line specifies the end
+    callbacks = receiver.all(:append_rectangle)
+    callbacks.size.should eql(2)
+    # don't care about the first rectangel, it just goes around the outside of the page
+    callbacks.shift
+    callbacks.shift[:args].should eql([100.0, 741.89, 200.0, -200.0])
+  end
+
+  specify "should be able to draw a filled rectangle onto the canvas"
+=begin
+  do
+    x = y = 100
+    w = h = 200
+    pdf = PDF::Wrapper.new
+    pdf.rectangle(x,y,w,h, :fill_color => :red)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the appropriate pattern of callbacks
+  end
+=end
+
+  specify "should be able to draw an empty rounded rectangle onto the canvas"
+=begin
+  do
+    x = y = 100
+    w = h = 200
+    r = 5
+    pdf = PDF::Wrapper.new
+    pdf.rounded_rectangle(x,y,w,h,r)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the appropriate pattern of callbacks
+  end
+=end
+
+  specify "should be able to draw an empty rounded rectangle onto the canvas with a line width of 5"
+=begin
+  do
+    x = y = 100
+    w = h = 200
+    r = 5
+    w = 5
+    pdf = PDF::Wrapper.new
+    pdf.rounded_rectangle(x,y,w,h,r, :line_width => w)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the appropriate pattern of callbacks
+  end
+=end
+
+  specify "should be able to draw a filled rounded rectangle onto the canvas"
+=begin
+  do
+    x = y = 100
+    w = h = 200
+    r = 5
+    pdf = PDF::Wrapper.new
+    pdf.rounded_rectangle(x,y,w,h,r, :fill_color => :red)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the appropriate pattern of callbacks
+  end
+=end
+
+  specify "should be able to draw an empty circle onto the canvas"
+=begin
+  do
+    x = 100
+    y = 200
+    r = 5
+    pdf = PDF::Wrapper.new
+    pdf.circle(x,y,r)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the appropriate pattern of callbacks
+  end
+=end
+
+  specify "should be able to draw an empty circle onto the canvas with a line width of 5"
+=begin
+  do
+    x = 100
+    y = 200
+    r = 5
+    w = 5
+    pdf = PDF::Wrapper.new
+    pdf.circle(x,y,r, :line_width => w)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the appropriate pattern of callbacks
+  end
+=end
+
+  specify "should be able to draw a filled circle onto the canvas"
+=begin
+  do
+    x = 100
+    y = 200
+    r = 5
+    pdf = PDF::Wrapper.new
+    pdf.circle(x,y,r, :fill_color => :red)
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the appropriate pattern of callbacks
+  end
+=end
+end

data/specs/spec_helper.rb

@@ -0,0 +1,70 @@
+# coding: utf-8
+
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib')
+
+require 'pdf/wrapper'
+require 'tempfile'
+require 'rubygems'
+
+gem "pdf-reader", ">=0.6.1"
+
+require 'pdf/reader'
+
+# make some private methods of PDF::Wrapper public for testing
+class PDF::Wrapper
+  public :build_pango_layout
+  public :calc_image_dimensions
+  public :load_librsvg
+  public :load_libpixbuf
+  public :load_libpango
+  public :load_libpoppler
+  public :default_text_options
+  public :detect_image_type
+  public :draw_pdf
+  public :draw_pixbuf
+  public :draw_png
+  public :draw_svg
+  public :validate_color
+end
+
+# a helper class for couting the number of pages in a PDF
+class PageReceiver
+  attr_accessor :page_count
+
+  def initialize
+    @page_count = 0
+  end
+
+  # Called when page parsing ends
+  def end_page
+    @page_count += 1
+  end
+end
+
+class PageTextReceiver
+  attr_accessor :content
+
+  def initialize
+    @content = []
+  end
+
+  # Called when page parsing starts
+  def begin_page(arg = nil)
+    @content << ""
+  end
+
+  def show_text(string, *params)
+    @content.last << string.strip
+  end
+
+  # there's a few text callbacks, so make sure we process them all
+  alias :super_show_text :show_text
+  alias :move_to_next_line_and_show_text :show_text
+  alias :set_spacing_next_line_show_text :show_text
+
+  def show_text_with_positioning(*params)
+    params = params.first
+    params.each { |str| show_text(str) if str.kind_of?(String) }
+  end
+
+end

data/specs/text_spec.rb

@@ -0,0 +1,153 @@
+# coding: utf-8
+
+require File.dirname(__FILE__) + '/spec_helper'
+
+context "The PDF::Wrapper class" do
+  specify "should be able to add ascii text to the canvas" do
+    msg = "Chunky Bacon"
+    pdf = PDF::Wrapper.new
+    pdf.text msg
+
+    receiver = PageTextReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the text is in the appropriate location on the page
+    receiver.content.first.should eql(msg)
+  end
+
+  specify "should be able to add unicode text to the canvas" do
+    msg = "メインページ"
+    pdf = PDF::Wrapper.new
+    pdf.text msg
+
+    receiver = PageTextReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the text is in the appropriate location on the page
+    receiver.content.first.should eql(msg)
+  end
+
+  specify "should be align text on the left when using the text method" do
+    msg = "Chunky Bacon"
+    pdf = PDF::Wrapper.new
+    pdf.text msg, :alignment => :left
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # set_text_matrix_and_text_line_matrix - [10.666992, 0.0, 0.0, 10.666992, 265.0, 788.89]
+
+    # ensure the text is placed in the right location
+    params = receiver.first_occurance_of(:set_text_matrix_and_text_line_matrix)[:args]
+    params[4].should eql(pdf.margin_left.to_f)
+  end
+
+  specify "should be align text in the centre when using the text method" do
+    msg = "Chunky Bacon"
+    pdf = PDF::Wrapper.new
+    pdf.text msg, :alignment => :center
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # ensure the text is placed in the right location - the left
+    # egde should be less than half way across the page, but not on the left margin
+    params = receiver.first_occurance_of(:set_text_matrix_and_text_line_matrix)[:args]
+    (params[4] < pdf.absolute_x_middle).should be_true
+    (params[4] > pdf.absolute_x_middle - 100).should be_true
+  end
+
+  specify "should be align text on the right when using the text method" do
+    msg = "Chunky Bacon"
+    pdf = PDF::Wrapper.new
+    pdf.text msg, :alignment => :right
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # ensure the text is placed in the right location - the left
+    # egde should be more than half way across the page, but not on the right margin
+    params = receiver.first_occurance_of(:set_text_matrix_and_text_line_matrix)[:args]
+    (params[4] > pdf.absolute_x_middle).should be_true
+    (params[4] < pdf.absolute_right_margin).should be_true
+  end
+
+  specify "should be able to add text to the canvas in a bounding box using the cell method" do
+    msg = "メインページ"
+    pdf = PDF::Wrapper.new
+    pdf.cell msg, 100, 100, 200, 200
+
+    receiver = PageTextReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    # TODO: test for the text is in the appropriate location on the page
+    receiver.content.first.should eql(msg)
+  end
+
+  specify "should keep all text for a cell inside the cell boundaries" do
+    msg = "This is a text cell, added by James"
+    pdf = PDF::Wrapper.new
+    x = y = 100
+    w = h = 200
+    pdf.cell msg, x, y, w, h
+
+    receiver = PDF::Reader::RegisterReceiver.new
+    reader = PDF::Reader.string(pdf.render, receiver)
+
+    receiver.all(:set_text_matrix_and_text_line_matrix).each do |cb|
+      # horizontal location
+      # TODO: we're only testing the it doesn't start past the right boundary of the cell
+      #       should also test that it doesn't start in the cell but overrun it
+      (cb[:args][4] >= x).should     be_true
+      (cb[:args][4] <= x + w).should be_true
+
+      # vertical location
+      # TODO: we're only testing the it doesn't start past the bottom boundary of the cell
+      #       should also test that it doesn't start in the cell but overrun it
+      cell_top_bound = pdf.page_height - y
+      (cb[:args][5] <= cell_top_bound).should     be_true
+      (cb[:args][5] >= cell_top_bound - h).should be_true
+    end
+  end
+
+  specify "should be able to calculate the height of a string of text" do
+    str   = "This is a medium length string\nthat is also multi line. one two three four."
+    pdf = PDF::Wrapper.new
+    opts = {:font_size => 16, :font => "Sans Serif", :alignment => :left, :justify => false }
+    pdf.text_height(str, pdf.body_width, opts).should eql(49)
+  end
+
+  specify "should be able to calculate the width of a string of text" do
+    str  = "James Healy"
+    str2 = "James Healy is a Ruby dev that lives in Melbourne, Australia. His day job mostly involved Ruby on Rails."
+    pdf = PDF::Wrapper.new
+    opts = {:font_size => 16, :font => "Sans Serif"}
+    pdf.text(str, opts)
+    pdf.text_width(str, opts).should eql(131)
+    pdf.text_width(str2, opts).should eql(1107)
+  end
+
+  specify "should raise an exception if build_pango_layout is passed anything other than a string" do
+    pdf = PDF::Wrapper.new
+    lambda { pdf.build_pango_layout(10) }.should raise_error(ArgumentError)
+  end
+
+  if RUBY_VERSION >= "1.9"
+    specify "should accept non UTF-8 strings to build_pango_layout and convert them on the fly" do
+      pdf = PDF::Wrapper.new
+
+      # all three of these files have the same content, but in different encodings
+      iso2022_str  = File.open(File.dirname(__FILE__) + "/data/shift_jis.txt", "r:ISO-2022-JP") { |f| f.read }.strip!
+      shiftjis_str = File.open(File.dirname(__FILE__) + "/data/iso-2022-jp.txt", "r:Shift_JIS") { |f| f.read }.strip!
+      utf8_str     = File.open(File.dirname(__FILE__) + "/data/utf8.txt", "r:UTF-8") { |f| f.read }.strip!
+
+      pdf.build_pango_layout(shiftjis_str)
+      pdf.build_pango_layout(iso2022_str)
+
+      # TODO: improve this spec using mocks. Atm, I'm assume that if build_pango_layout didn't raise an exception when
+      #       passed in the non UTF-8 strings, then all worked fine. yuck.
+    end
+
+    specify "should raise an error when a string that isn't convertable to UTF-8 is passed into build_pango_layout()"
+  end
+end

data/specs/wrapper_spec.rb

@@ -1,108 +1,9 @@
 # coding: utf-8
 
-$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib')
-
-require 'pdf/wrapper'
-require 'tempfile'
-require 'rubygems'
-
-gem "pdf-reader", ">=0.6.1"
-
-require 'pdf/reader'
-
-# make some private methods of PDF::Wrapper public for testing
-class PDF::Wrapper
-  public :build_pango_layout
-  public :calc_image_dimensions
-  public :load_librsvg
-  public :load_libpixbuf
-  public :load_libpango
-  public :load_libpoppler
-  public :default_text_options
-  public :detect_image_type
-  public :draw_pdf
-  public :draw_pixbuf
-  public :draw_png
-  public :draw_svg
-  public :validate_color
-end
-
-# a helper class for couting the number of pages in a PDF
-class PageReceiver
-  attr_accessor :page_count
-
-  def initialize
-    @page_count = 0
-  end
-
-  # Called when page parsing ends
-  def end_page
-    @page_count += 1
-  end
-end
-
-class PageTextReceiver
-  attr_accessor :content
-
-  def initialize
-    @content = []
-  end
-
-  # Called when page parsing starts
-  def begin_page(arg = nil)
-    @content << ""
-  end
-
-  def show_text(string, *params)
-    @content.last << string.strip
-  end
-
-  # there's a few text callbacks, so make sure we process them all
-  alias :super_show_text :show_text
-  alias :move_to_next_line_and_show_text :show_text
-  alias :set_spacing_next_line_show_text :show_text
-
-  def show_text_with_positioning(*params)
-    params = params.first
-    params.each { |str| show_text(str) if str.kind_of?(String) }
-  end
-
-end
+require File.dirname(__FILE__) + '/spec_helper'
 
 context "The PDF::Wrapper class" do
 
-  setup do
-    #@file = File.new(File.dirname(__FILE__) + "/data/cairo-basic.pdf")
-    @shortstr = "Chunky Bacon"
-    @medstr   = "This is a medium length string\nthat is also multi line. one two three four."
-  end
-
-  specify "should load external libs correctly" do
-    pdf = PDF::Wrapper.new
-
-    # lib gdkpixbuf
-    ::Object.const_defined?(:Gdk).should eql(false)
-    pdf.load_libpixbuf
-    ::Object.const_defined?(:Gdk).should eql(true)
-    ::Gdk.const_defined?(:Pixbuf).should eql(true)
-
-    # pango
-    ::Object.const_defined?(:Pango).should eql(false)
-    pdf.load_libpango
-    ::Object.const_defined?(:Pango).should eql(true)
-
-    # libpoppler
-    ::Object.const_defined?(:Poppler).should eql(false)
-    pdf.load_libpoppler
-    ::Object.const_defined?(:Poppler).should eql(true)
-
-    # librsvg
-    ::Object.const_defined?(:RSVG).should eql(false)
-    pdf.load_librsvg
-    ::Object.const_defined?(:RSVG).should eql(true)
-
-  end
-
   specify "should initilize with the correct default paper size and orientation" do
     pdf = PDF::Wrapper.new
     pdf.page_width.should eql(PDF::Wrapper::PAGE_SIZES[:A4].first)
@@ -211,6 +112,16 @@ context "The PDF::Wrapper class" do
     lambda {pdf.move_to(100, PDF::Wrapper::PAGE_SIZES[:A4].last + 10)}.should raise_error(ArgumentError)
   end
 
+  specify "should be able to shift the y position of the cursor using pad" do
+    pdf = PDF::Wrapper.new
+    pdf.move_to(100,100)
+    newy = pdf.pad(25)
+    x,y = pdf.current_point
+    x.to_i.should eql(100)
+    y.to_i.should eql(125)
+    newy.should eql(125.0)
+  end
+
   specify "should add additional pages at the users request" do
     pdf = PDF::Wrapper.new
     pdf.move_to(100,100)
@@ -225,79 +136,6 @@ context "The PDF::Wrapper class" do
     receiver.page_count.should eql(2)
   end
 
-  specify "should be able to draw a single line onto the canvas" do
-    x0 = y0 = 100
-    x1 = y1 = 200
-    pdf = PDF::Wrapper.new
-    pdf.line(x0,y0,x1,y1)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # the begin_new_subpath command specifies the start of the line, append line specifies the end
-    receiver.count(:begin_new_subpath).should eql(1)
-    receiver.count(:append_line).should eql(1)
-    receiver.first_occurance_of(:begin_new_subpath)[:args].should eql([x0.to_f, y0.to_f])
-    receiver.first_occurance_of(:append_line)[:args].should eql([x1.to_f, y1.to_f])
-  end
-
-  specify "should be able to draw a single line onto the canvas with a width of 5" do
-    x0 = y0 = 100
-    x1 = y1 = 200
-    width = 5
-    pdf = PDF::Wrapper.new
-    pdf.line(x0,y0,x1,y1, :line_width => width)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # the begin_new_subpath command specifies the start of the line, append line specifies the end
-    receiver.count(:set_line_width).should eql(1)
-    receiver.count(:begin_new_subpath).should eql(1)
-    receiver.count(:append_line).should eql(1)
-    receiver.first_occurance_of(:set_line_width)[:args].should eql([width.to_f])
-    receiver.first_occurance_of(:begin_new_subpath)[:args].should eql([x0.to_f, y0.to_f])
-    receiver.first_occurance_of(:append_line)[:args].should eql([x1.to_f, y1.to_f])
-  end
-
-  specify "should be able to draw an empty rectangle onto the canvas" do
-    x = y = 100
-    w = h = 200
-    pdf = PDF::Wrapper.new
-    pdf.rectangle(x,y,w,h)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # the begin_new_subpath command specifies the start of the line, append line specifies the end
-    callbacks = receiver.series(:begin_new_subpath, :append_line,:append_line,:append_line, :close_subpath)
-    callbacks.shift[:args].should eql([x.to_f, y.to_f])
-    callbacks.shift[:args].should eql([(x+w).to_f, y.to_f])
-    callbacks.shift[:args].should eql([(x+w).to_f, (y+h).to_f])
-    callbacks.shift[:args].should eql([x.to_f, (y+h).to_f])
-  end
-
-  specify "should be able to draw an empty rectangle onto the canvas with a line width of 5" do
-    x = y = 100
-    w = h = 200
-    width = 5
-    pdf = PDF::Wrapper.new
-    pdf.rectangle(x,y,w,h, :line_width => width)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # ensure the line width was set correctly
-    receiver.count(:set_line_width).should eql(1)
-    receiver.first_occurance_of(:set_line_width)[:args].should eql([width.to_f])
-
-    # the begin_new_subpath command specifies the start of the line, append line specifies the end
-    callbacks = receiver.series(:begin_new_subpath, :append_line,:append_line,:append_line, :close_subpath)
-    callbacks.shift[:args].should eql([x.to_f, y.to_f])
-    callbacks.shift[:args].should eql([(x+w).to_f, y.to_f])
-    callbacks.shift[:args].should eql([(x+w).to_f, (y+h).to_f])
-    callbacks.shift[:args].should eql([x.to_f, (y+h).to_f])
-  end
 
   specify "should leave the cursor in the bottom left of a layout when new text is added" do
     pdf = PDF::Wrapper.new
@@ -309,185 +147,10 @@ context "The PDF::Wrapper class" do
     newx, newy = pdf.current_point
 
     newx.should eql(x)
-		# the top of our text box, plus its height
+    # the top of our text box, plus its height
     newy.should eql(y + height)
   end
 
-  specify "should be able to draw a filled rectangle onto the canvas"
-=begin
-  do
-    x = y = 100
-    w = h = 200
-    pdf = PDF::Wrapper.new
-    pdf.rectangle(x,y,w,h, :fill_color => :red)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the appropriate pattern of callbacks
-  end
-=end
-
-  specify "should be able to draw an empty rounded rectangle onto the canvas"
-=begin
-  do
-    x = y = 100
-    w = h = 200
-    r = 5
-    pdf = PDF::Wrapper.new
-    pdf.rounded_rectangle(x,y,w,h,r)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the appropriate pattern of callbacks
-  end
-=end
-
-  specify "should be able to draw an empty rounded rectangle onto the canvas with a line width of 5"
-=begin
-  do
-    x = y = 100
-    w = h = 200
-    r = 5
-    w = 5
-    pdf = PDF::Wrapper.new
-    pdf.rounded_rectangle(x,y,w,h,r, :line_width => w)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the appropriate pattern of callbacks
-  end
-=end
-
-  specify "should be able to draw a filled rounded rectangle onto the canvas"
-=begin
-  do
-    x = y = 100
-    w = h = 200
-    r = 5
-    pdf = PDF::Wrapper.new
-    pdf.rounded_rectangle(x,y,w,h,r, :fill_color => :red)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the appropriate pattern of callbacks
-  end
-=end
-
-  specify "should be able to draw an empty circle onto the canvas"
-=begin
-  do
-    x = 100
-    y = 200
-    r = 5
-    pdf = PDF::Wrapper.new
-    pdf.circle(x,y,r)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the appropriate pattern of callbacks
-  end
-=end
-
-  specify "should be able to draw an empty circle onto the canvas with a line width of 5"
-=begin
-  do
-    x = 100
-    y = 200
-    r = 5
-    w = 5
-    pdf = PDF::Wrapper.new
-    pdf.circle(x,y,r, :line_width => w)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the appropriate pattern of callbacks
-  end
-=end
-
-  specify "should be able to draw a filled circle onto the canvas"
-=begin
-  do
-    x = 100
-    y = 200
-    r = 5
-    pdf = PDF::Wrapper.new
-    pdf.circle(x,y,r, :fill_color => :red)
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the appropriate pattern of callbacks
-  end
-=end
-
-  specify "should be able to add ascii text to the canvas" do
-    msg = "Chunky Bacon"
-    pdf = PDF::Wrapper.new
-    pdf.text msg
-
-    receiver = PageTextReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the text is in the appropriate location on the page
-    receiver.content.first.should eql(msg)
-  end
-
-  specify "should be able to add unicode text to the canvas" do
-    msg = "メインページ"
-    pdf = PDF::Wrapper.new
-    pdf.text msg
-
-    receiver = PageTextReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the text is in the appropriate location on the page
-    receiver.content.first.should eql(msg)
-  end
-
-  specify "should be able to add text to the canvas in a bounding box using the cell method" do
-    msg = "メインページ"
-    pdf = PDF::Wrapper.new
-    pdf.cell msg, 100, 100, 200, 200
-
-    receiver = PageTextReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    # TODO: test for the text is in the appropriate location on the page
-    receiver.content.first.should eql(msg)
-  end
-
-  specify "should keep all text for a cell inside the cell boundaries" do
-    msg = "This is a text cell, added by James"
-    pdf = PDF::Wrapper.new
-    x = y = 100
-    w = h = 200
-    pdf.cell msg, x, y, w, h
-
-    receiver = PDF::Reader::RegisterReceiver.new
-    reader = PDF::Reader.string(pdf.render, receiver)
-
-    receiver.all(:set_text_matrix_and_text_line_matrix).each do |cb|
-      # horizontal location
-      # TODO: we're only testing the it doesn't start past the right boundary of the cell
-      #       should also test that it doesn't start in the cell but overrun it
-      (cb[:args][4] >= x).should     be_true
-      (cb[:args][4] <= x + w).should be_true
-
-      # vertical location
-      # TODO: we're only testing the it doesn't start past the bottom boundary of the cell
-      #       should also test that it doesn't start in the cell but overrun it
-      cell_top_bound = pdf.page_height - y
-      (cb[:args][5] <= cell_top_bound).should     be_true
-      (cb[:args][5] >= cell_top_bound - h).should be_true
-    end
-  end
-
   specify "should be able to render to a file" do
     # generate a PDF
     msg = "Chunky Bacon"
@@ -508,21 +171,6 @@ context "The PDF::Wrapper class" do
     tmp.unlink
   end
 
-  specify "should be able to detect the filetype of an image" do
-    pdf = PDF::Wrapper.new
-    pdf.detect_image_type(File.dirname(__FILE__) + "/data/google.png").should eql(:png)
-    pdf.detect_image_type(File.dirname(__FILE__) + "/data/zits.gif").should eql(:gif)
-    pdf.detect_image_type(File.dirname(__FILE__) + "/data/orc.svg").should eql(:svg)
-    pdf.detect_image_type(File.dirname(__FILE__) + "/data/utf8-long.pdf").should eql(:pdf)
-    pdf.detect_image_type(File.dirname(__FILE__) + "/data/shipsail.jpg").should eql(:jpg)
-  end
-
-  specify "should be able to calculate the height of a string of text" do
-    pdf = PDF::Wrapper.new
-    opts = {:font_size => 16, :font => "Sans Serif", :alignment => :left, :justify => false }
-    pdf.text_height(@medstr, pdf.body_width, opts).should eql(49)
-  end
-
   specify "should be able to draw a table on the canvas"
 
   specify "should leave the cursor in the bottom left when adding a table" do
@@ -541,31 +189,6 @@ context "The PDF::Wrapper class" do
     x.to_i.should eql(100)
   end
 
-  specify "should raise an exception if build_pango_layout is passed anything other than a string" do
-    pdf = PDF::Wrapper.new
-    lambda { pdf.build_pango_layout(10) }.should raise_error(ArgumentError)
-
-  end
-
-  if RUBY_VERSION >= "1.9"
-    specify "should accept non UTF-8 strings to build_pango_layout and convert them on the fly" do
-      pdf = PDF::Wrapper.new
-
-      # all three of these files have the same content, but in different encodings
-      iso2022_str  = File.open(File.dirname(__FILE__) + "/data/shift_jis.txt", "r:ISO-2022-JP") { |f| f.read }.strip!
-      shiftjis_str = File.open(File.dirname(__FILE__) + "/data/iso-2022-jp.txt", "r:Shift_JIS") { |f| f.read }.strip!
-      utf8_str     = File.open(File.dirname(__FILE__) + "/data/utf8.txt", "r:UTF-8") { |f| f.read }.strip!
-
-      pdf.build_pango_layout(shiftjis_str)
-      pdf.build_pango_layout(iso2022_str)
-
-      # TODO: improve this spec using mocks. Atm, I'm assume that if build_pango_layout didn't raise an exception when
-      #       passed in the non UTF-8 strings, then all worked fine. yuck.
-    end
-
-    specify "should raise an error when a string that isn't convertable to UTF-8 is passed into build_pango_layout()"
-  end
-
   specify "should be able to determine if a requested colour is valid or not" do
     pdf = PDF::Wrapper.new
     pdf.validate_color(:black).should be_true
@@ -794,12 +417,4 @@ context "The PDF::Wrapper class" do
     lambda { pdf.rounded_rectangle(100,100,100,100,10, :ponies => true)}.should raise_error(ArgumentError)
     lambda { pdf.image(File.dirname(__FILE__) + "/data/orc.svg", :ponies => true)}.should raise_error(ArgumentError)
   end
-
-  specify "should be able to calculate image dimensions correctly" do
-    pdf = PDF::Wrapper.new
-    pdf.calc_image_dimensions(100, 100, 200, 200).should eql([100.0,100.0])
-    pdf.calc_image_dimensions(nil, nil, 200, 200).should eql([200.0,200.0])
-    pdf.calc_image_dimensions(150, 200, 200, 200, true).should eql([150.0,150.0])
-    pdf.calc_image_dimensions(300, 250, 200, 200, true).should eql([250.0,250.0])
-  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: pdf-wrapper
 version: !ruby/object:Gem::Version 
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors: 
 - James Healy
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-03-12 00:00:00 +11:00
+date: 2008-04-27 00:00:00 +10:00
 default_executable: 
 dependencies: []
 
@@ -24,28 +24,33 @@ extra_rdoc_files:
 - CHANGELOG
 - TODO
 files: 
-- examples/repeating.rb
 - examples/cell.rb
 - examples/image.rb
-- examples/utf8-long.rb
-- examples/table.rb
+- examples/repeating.rb
 - examples/shapes.rb
+- examples/table.rb
+- examples/utf8-long.rb
 - examples/utf8.rb
 - lib/pdf
-- lib/pdf/wrapper.rb
 - lib/pdf/core.rb
+- lib/pdf/wrapper.rb
 - specs/data
-- specs/data/shift_jis.txt
 - specs/data/google.png
-- specs/data/utf8-long.txt
 - specs/data/iso-2022-jp.txt
-- specs/data/utf8.txt
-- specs/data/shipsail.jpg
-- specs/data/zits.gif
 - specs/data/orc.svg
+- specs/data/shift_jis.txt
+- specs/data/shipsail.jpg
 - specs/data/stef.jpg
 - specs/data/utf8-long.pdf
+- specs/data/utf8-long.txt
+- specs/data/utf8.txt
+- specs/data/zits.gif
 - specs/wrapper_spec.rb
+- specs/load_spec.rb
+- specs/shapes_spec.rb
+- specs/text_spec.rb
+- specs/spec_helper.rb
+- specs/image_spec.rb
 - Rakefile
 - README
 - CHANGELOG