prawn 0.2.1 → 0.2.2

data/Rakefile

@@ -4,7 +4,7 @@ require 'rake/testtask'
 require "rake/rdoctask"
 require "rake/gempackagetask"  
 
-PRAWN_VERSION = "0.2.1" 
+PRAWN_VERSION = "0.2.2" 
 
 task :default => [:test]
        

data/examples/remote_images.rb

@@ -0,0 +1,7 @@
+$LOAD_PATH << File.join(File.dirname(__FILE__), '..', 'lib')
+require "prawn"
+require "open-uri"
+
+Prawn::Document.generate("remote_images.pdf") do 
+  image open("http://prawn.majesticseacreature.com/media/prawn_logo.png")
+end

data/lib/prawn.rb

@@ -20,7 +20,7 @@ module Prawn
   # The base source directory for Prawn as installed on the system
   BASEDIR = File.expand_path(File.join(dir, '..'))  
   
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
   
   extend self
   

data/lib/prawn/document/span.rb

@@ -1,5 +1,21 @@
 module Prawn
   class Document
+    # A span is a special purpose bounding box that allows a column of 
+    # elements to be positioned relative to the margin_box.  
+    #
+    # Arguments:
+    # +width+:: The width of the column in PDF points
+    #
+    # Options:
+    # <tt>:position</tt>:: One of :left, :center, :right or an x offset
+    #
+    # This method is typically used for flowing a column of text from one 
+    # page to the next.
+    #
+    #  span(350, :position => :center) do
+    #    text "Here's some centered text in a 350 point column. " * 100
+    #  end
+    #  
     def span(width, options={})
       Prawn.verify_options [:position], options
       original_position = self.y      

data/lib/prawn/images.rb

@@ -15,14 +15,14 @@ module Prawn
     # JPG and PNG files are supported.
     #
     # Arguments:
-    # <tt>filename</tt>:: the path to the file to be embedded
+    # <tt>file</tt>:: path to file or an object that responds to #read
     #
     # Options:
     # <tt>:at</tt>:: the location of the top left corner of the image.
     # <tt>:position</tt>::  One of (:left, :center, :right) or an x-offset
     # <tt>:height</tt>:: the height of the image [actual height of the image]
     # <tt>:width</tt>:: the width of the image [actual width of the image]
-    # <tt>:scale</tt>:: scale the dimensions of the image proportionally      
+    # <tt>:scale</tt>:: scale the dimensions of the image proportionally   
     # 
     #   Prawn::Document.generate("image2.pdf", :page_layout => :landscape) do     
     #     pigs = "#{Prawn::BASEDIR}/data/images/pigs.jpg" 
@@ -36,10 +36,24 @@ module Prawn
     # proportionally.  When both are provided, the image will be stretched to 
     # fit the dimensions without maintaining the aspect ratio.
     #
+    # If instead of an explicit filename, an object with a read method is
+    # passed as +file+, you can embed images from IO objects and things
+    # that act like them (including Tempfiles and open-uri objects).
+    #
+    #   require "open-uri"
+    #
+    #   Prawn::Document.generate("remote_images.pdf") do 
+    #     image open("http://prawn.majesticseacreature.com/media/prawn_logo.png")
+    #   end
+    #
+    # This method returns an image info object which can be used to check the
+    # dimensions of an image object if needed. 
+    # (See also: Prawn::Images::PNG , Prawn::Images::JPG)
+    # 
     def image(file, options={})     
       Prawn.verify_options [:at,:position, :height, :width, :scale], options
       
-      if file.kind_of?(IO)
+      if file.respond_to?(:read)
         image_content = file.read
       else      
         raise ArgumentError, "#{file} not found" unless File.file?(file)  

data/lib/prawn/images/jpg.rb

@@ -12,7 +12,7 @@ module Prawn
   module Images
     # A convenience class that wraps the logic for extracting the parts
     # of a PNG image that we need to embed them in a PDF
-    class JPG #:nodoc:
+    class JPG 
       attr_reader :width, :height, :bits, :channels
 
       JPEG_SOF_BLOCKS = %W(\xc0 \xc1 \xc2 \xc3 \xc5 \xc6 \xc7 \xc9 \xca \xcb \xcd \xce \xcf)
@@ -21,6 +21,7 @@ module Prawn
       # Process a new JPG image
       #
       # <tt>:data</tt>:: A string containing a full PNG file
+      #
       def initialize(data)
         data = StringIO.new(data.dup)
 

data/lib/prawn/images/png.rb

@@ -14,7 +14,7 @@ module Prawn
   module Images
     # A convenience class that wraps the logic for extracting the parts
     # of a PNG image that we need to embed them in a PDF
-    class PNG #:nodoc:
+    class PNG 
       attr_reader :palette, :img_data, :transparency
       attr_reader :width, :height, :bits
       attr_reader :color_type, :compression_method, :filter_method
@@ -23,6 +23,7 @@ module Prawn
       # Process a new PNG image
       #
       # <tt>:data</tt>:: A string containing a full PNG file
+      #
       def initialize(data)
         data = StringIO.new(data.dup)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: prawn
 version: !ruby/object:Gem::Version 
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors: 
 - Gregory Brown
@@ -47,6 +47,7 @@ files:
 - examples/page_geometry.rb
 - examples/png_types.rb
 - examples/polygons.rb
+- examples/remote_images.rb
 - examples/ruport_formatter.rb
 - examples/ruport_helpers.rb
 - examples/russian_boxes.rb