prawn 0.11.1.pre → 0.11.1

data/data/pdfs/multipage_template.pdf

@@ -0,0 +1,127 @@
+%PDF-1.3
+%����
+1 0 obj
+<< /Creator <feff0050007200610077006e>
+/Producer <feff0050007200610077006e>
+>>
+endobj
+2 0 obj
+<< /Type /Catalog
+/Pages 3 0 R
+>>
+endobj
+3 0 obj
+<< /Type /Pages
+/Count 3
+/Kids [5 0 R 8 0 R 10 0 R]
+>>
+endobj
+4 0 obj
+<< /Length 92
+>>
+stream
+q
+
+BT
+36 747.384 Td
+/F1.0 12 Tf
+[<546869732069732074656d706c61746520706167652031>] TJ
+ET
+
+Q
+
+endstream
+endobj
+5 0 obj
+<< /Type /Page
+/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI]
+/Font << /F1.0 6 0 R
+>>
+>>
+/Parent 3 0 R
+/Contents 4 0 R
+/MediaBox [0 0 612.0 792.0]
+>>
+endobj
+6 0 obj
+<< /BaseFont /Helvetica
+/Type /Font
+/Encoding /WinAnsiEncoding
+/Subtype /Type1
+>>
+endobj
+7 0 obj
+<< /Length 92
+>>
+stream
+q
+
+BT
+36 747.384 Td
+/F1.0 12 Tf
+[<546869732069732074656d706c61746520706167652032>] TJ
+ET
+
+Q
+
+endstream
+endobj
+8 0 obj
+<< /Type /Page
+/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI]
+/Font << /F1.0 6 0 R
+>>
+>>
+/Parent 3 0 R
+/Contents 7 0 R
+/MediaBox [0 0 612.0 792.0]
+>>
+endobj
+9 0 obj
+<< /Length 92
+>>
+stream
+q
+
+BT
+36 747.384 Td
+/F1.0 12 Tf
+[<546869732069732074656d706c61746520706167652033>] TJ
+ET
+
+Q
+
+endstream
+endobj
+10 0 obj
+<< /Type /Page
+/Resources << /ProcSet [/PDF /Text /ImageB /ImageC /ImageI]
+/Font << /F1.0 6 0 R
+>>
+>>
+/Parent 3 0 R
+/Contents 9 0 R
+/MediaBox [0 0 612.0 792.0]
+>>
+endobj
+xref
+0 11
+0000000000 65535 f 
+0000000015 00000 n 
+0000000109 00000 n 
+0000000158 00000 n 
+0000000228 00000 n 
+0000000370 00000 n 
+0000000548 00000 n 
+0000000645 00000 n 
+0000000787 00000 n 
+0000000965 00000 n 
+0000001107 00000 n 
+trailer
+<< /Size 11
+/Info 1 0 R
+/Root 2 0 R
+>>
+startxref
+1286
+%%EOF

data/examples/bounding_box/bounding_boxes.rb

@@ -3,7 +3,8 @@
 # This example demonstrates the basic functionality of Prawn's bounding boxes.
 # Note that top level bounding boxes are positioned relative to the margin_box.
 # 
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("bounding_boxes.pdf") do
 
@@ -27,7 +28,7 @@ Prawn::Document.generate("bounding_boxes.pdf") do
   #
   bounding_box [100,cursor], :width => 200, :height => 200 do
     stroke do
-      circle_at [100,100], :radius => 100
+      circle [100,100], 100
       line bounds.top_left, bounds.bottom_right
       line bounds.top_right, bounds.bottom_left
     end
@@ -40,4 +41,4 @@ Prawn::Document.generate("bounding_boxes.pdf") do
     end
   end
 
-end                 
+end                 

data/examples/bounding_box/indentation.rb

@@ -3,7 +3,8 @@
 # This example demonstrates the basic functionality of Prawn's bounding boxes.
 # Note that top level bounding boxes are positioned relative to the margin_box.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("indentation.pdf") do
 

data/examples/bounding_box/russian_boxes.rb

@@ -4,7 +4,8 @@
 # can simplify calculations.  See the other files in examples/bounding_box
 # for more basic uses.
 
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 class Array
   def combine(arr)
@@ -33,4 +34,4 @@ end
 
 Prawn::Document.generate("russian_boxes.pdf") do |pdf|
   recurse_bounding_box(pdf)
-end
+end

data/examples/bounding_box/stretched_nesting.rb

@@ -3,7 +3,8 @@
 # This example demonstrates how nested bounding boxes work when the outer box is
 # stretchy and includes several inner boxes of different sizes.
 
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("stretched_nesting.pdf", :page_layout => :landscape) do
 

data/examples/general/background.rb

@@ -4,7 +4,8 @@
 # generating a new Document.  Image is assumed to be pre-fit for your page
 # size, and will not be rescaled.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 img = "#{Prawn::BASEDIR}/data/images/letterhead.jpg"
 

data/examples/general/canvas.rb

@@ -3,7 +3,8 @@
 # Demonstrates how to enable absolute positioning in Prawn by temporarily
 # removing the margin_box via Document#canvas()
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("canvas.pdf") do
   canvas do

data/examples/general/context_sensitive_headers.rb

@@ -1,4 +1,5 @@
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 # Ex. Generate a roster of meeting attendees given a set of meetings.
 # Attendees for a meeting may overflow to accross page boundaries but 

data/examples/general/float.rb

@@ -1,4 +1,5 @@
-require "#{File.dirname(__FILE__)}/../example_helper"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate('float.pdf') do
   float do

data/examples/general/margin.rb

@@ -2,7 +2,8 @@
 #
 # This demonstrates the Prawn options for document and page margin, similar to CSS shorthand.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 LOREM = ("Lorem ipsum dolor sit amet, consectetur adipisicing elit, "+
 "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "+

data/examples/general/measurement_units.rb

@@ -5,7 +5,8 @@
 # its particular implementation, though some might find that interesting as
 # well.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 require "prawn/measurement_extensions"
 

data/examples/general/metadata-info.rb

@@ -3,7 +3,8 @@
 # Demonstrates how to set metadata properties via the info option
 # It allows one to specify no standard properties
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate "metadata-info.pdf",
   :info => {

data/examples/general/multi_page_layout.rb

@@ -3,7 +3,8 @@
 # This demonstrates that Prawn can modify page size, margins and layout for 
 # each individual page, via Document#start_new_page()
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("multi-layout.pdf", :page_layout => :landscape) do |pdf|
    pdf.text "This is on a landscaped page" 

data/examples/general/outlines.rb

@@ -3,7 +3,8 @@
 # This example demonstrates the use of the the outlines option for a new document
 # it sets an initial outline item with a title
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate('outlines.pdf') do
   text "Page 1. This is the first Chapter. "

data/examples/general/page_geometry.rb

@@ -4,7 +4,8 @@
 # documents.  The style used here is a bit out of date, see 
 # multi_page_layout.rb for a more modern example.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 def pdf(*options)  
   Prawn::Document.new(*options)

data/examples/general/page_numbering.rb

@@ -3,7 +3,8 @@
 # This example demonstrates how to add a "page k of n"
 # template to your documents.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("page_with_numbering.pdf") do
   text "Hai"
@@ -11,5 +12,29 @@ Prawn::Document.generate("page_with_numbering.pdf") do
   text "bai"
   start_new_page
   text "-- Hai again"
-  number_pages "<page> in a total of <total>", [bounds.right - 50, 0]  
+  number_pages "<page> in a total of <total>", :at => [bounds.right - 100, 20],
+                                               :width => 150,
+                                               :page_filter => :all
+end
+
+Prawn::Document.generate("page_with_numbering_extra_options.pdf") do
+  text "Hai"
+  start_new_page :layout => :landscape
+  text "bai"
+  start_new_page :layout => :portrait
+  text "-- Hai again"
+  number_pages "<page> in a total of <total>", :at => [bounds.right - 150, 20],
+                                               :width => 150,
+                                               :align => :right,
+                                               :page_filter => :odd,
+                                               :start_count_at => 12,
+                                               :total_pages => 15
+                                               
+  number_pages "<page> in a total of <total>", :at => [bounds.left + 50, 20],
+                                               :width => 150,
+                                               :align => :left,
+                                               :page_filter => :even,
+                                               :start_count_at => 13,
+                                               :total_pages => 15,
+                                               :color => "FF0000"
 end

data/examples/general/page_templates.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+#
+# This sample demonstrates the use of the :template option when using #start_new_page to add a
+# new page. Only one page of the template is currently imported for the template and which page of 
+# the pdf template is used can be specified with the :template_page option which defaults to 1.
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+filename = "#{Prawn::BASEDIR}/data/pdfs/multipage_template.pdf"
+
+Prawn::Document.generate("page_template.pdf") do
+  text "This is the first page and content is brand new", :size => 18, :align => :center
+  start_new_page(:template => filename, :template_page => 2)
+  move_down 20
+  text "Here is some content that has been added to the page template", :size => 18, :align => :center
+  start_new_page(:template => filename, :template_page => 3)
+  move_down 20
+  text "Here is content that has been added to page 3 of the template", :size => 18, :align => :center
+end

data/examples/general/repeaters.rb

@@ -5,7 +5,8 @@
 # they should be pretty efficient.
 #
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("repeat.pdf", :skip_page_creation => true) do
 

data/examples/general/stamp.rb

@@ -2,7 +2,8 @@
 #
 # Demonstrate use of stamps
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("stamp.pdf", :skip_page_creation => true) do
 
@@ -23,9 +24,9 @@ Prawn::Document.generate("stamp.pdf", :skip_page_creation => true) do
 
   create_stamp("MyStamp") do
     fill_color("ff0000")
-    fill_circle_at([0, 0], :radius => 20)
+    fill_circle([0, 0], 20)
     fill_color("000000")
-    fill_circle_at([10, 10], :radius => 20)
+    fill_circle([10, 10], 20)
   end
 
   10.times do |i|

data/examples/general/templates.rb

@@ -3,7 +3,8 @@
 # This sample demonstrates the use of the :template option when generating
 # a new Document. The template PDF file is imported into a new document.
 
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 filename = "#{Prawn::BASEDIR}/reference_pdfs/curves.pdf"
 

data/examples/graphics/basic_images.rb

@@ -4,7 +4,8 @@
 # For positioning images alongside flowing text, see the image_flow.rb
 # example.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
    
 Prawn::Document.generate("basic_images.pdf", :page_layout => :landscape) do     
   stef = "#{Prawn::BASEDIR}/data/images/stef.jpg"

data/examples/graphics/cmyk.rb

@@ -2,7 +2,8 @@
 #
 # Demonstrates Prawn's support for CMYK images and colors.
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 Prawn::Document.generate("cmyk.pdf", :page_layout => :landscape) do
   fill_color 50, 100, 0, 0

data/examples/graphics/curves.rb

@@ -2,10 +2,11 @@
 #
 # Demonstrates simple curve and circle usage
 #
-require "#{File.dirname(__FILE__)}/../example_helper.rb"
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
 
 pdf = Prawn::Document.new
 pdf.move_to [100,100]
 pdf.stroke_curve_to [50,50], :bounds => [[60,90], [60, 90]]  
-pdf.fill_circle_at [200,200], :radius => 10
-pdf.render_file "curves.pdf"
+pdf.fill_circle [200,200], 10
+pdf.render_file "curves.pdf"

data/examples/graphics/gradient.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+#
+# Demonstrate use of gradients
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+pdf = Prawn::Document.new(:margin => 0)
+
+pdf.stroke_gradient [0, pdf.bounds.height], pdf.bounds.width, pdf.bounds.height/2, '69CD31', '0000FF'
+pdf.fill_gradient [0, pdf.bounds.height], pdf.bounds.width, pdf.bounds.height/2, 'FF0000', '00FF00'
+
+pdf.rectangle [10, pdf.bounds.height-10], 100, pdf.bounds.height-20
+pdf.line_width 20
+pdf.fill_and_stroke
+
+pdf.fill_gradient [150, 250], 400, 70, 'F0FF00', '0000FF'
+pdf.bounding_box [150, 250], :width => 450, :height => 150 do
+  pdf.text "Gradient!", :size => 80
+end
+
+pdf.render_file 'gradient.pdf'
+