prawn 0.11.1 → 0.12.0

data/examples/general/metadata-info.rb

@@ -1,17 +0,0 @@
-# encoding: utf-8
-#
-# Demonstrates how to set metadata properties via the info option
-# It allows one to specify no standard properties
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-Prawn::Document.generate "metadata-info.pdf",
-  :info => {
-    :Title => "My title", :Author => "John Doe", :Subject => "My Subject",
-    :Keywords => "test metadata ruby pdf dry", :Creator => "ACME Soft App", 
-    :Producer => "Prawn", :CreationDate => Time.now, :Grok => "Test Property"
-  } do       
-  text "This is a test of setting metadata properties via the info option"
-  text "It allows one to specify no standard properties like 'Grok'"
-end

data/examples/general/multi_page_layout.rb

@@ -1,19 +0,0 @@
-# encoding: utf-8
-#
-# This demonstrates that Prawn can modify page size, margins and layout for 
-# each individual page, via Document#start_new_page()
-#
-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" 
-   pdf.start_new_page(:layout => :portrait)
-   pdf.text "This is on a portrait page"   
-   pdf.start_new_page(:size => "LEGAL")
-   pdf.text "This is on legal paper size"      
-   pdf.start_new_page(:left_margin => 150, :right_margin => 150)
-   pdf.text "This page has very wide left and right margins, causing a squeeze"
-   pdf.start_new_page(:margin => 300, :right_margin => 0)
-   pdf.text "This page has even wider margins on all sides except for the right side, where it's 0"
-end

data/examples/general/outlines.rb

@@ -1,67 +0,0 @@
-# encoding: utf-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.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-Prawn::Document.generate('outlines.pdf') do
-  text "Page 1. This is the first Chapter. "
-  start_new_page
-  text "Page 2. More in the first Chapter. "
-  start_new_page
-  text "Page 3. This is the second Chapter. It has a subsection. "
-  start_new_page
-  text  "Page 4. More in the second Chapter. "
-  outline.section 'Preface' do
-    outline.page :title => 'Preface' 
-  end
-  outline.define do 
-    section 'Chapter 1', :destination => 1, :closed => true do 
-      page :destination => 1, :title => 'Page 1'
-      page :destination => 2, :title => 'Page 2'
-    end
-    section 'Chapter 2', :destination => 3 do 
-      section 'Chapter 2 Subsection' do
-        page :title => 'Page 3'
-      end
-      page :destination => 4, :title => 'Page 4'
-    end
-  end
-  start_new_page
-  text "Page 5. Appendix"
-  start_new_page 
-  text "Page 6. More in the Appendix"
-  outline.section 'Appendix', :destination => 5 do
-    outline.page :destination => 5, :title => 'Page 5'
-    outline.page :destination => 6, :title => 'Page 6'
-  end
-  go_to_page 4
-  start_new_page 
-  text "inserted before the Appendix"
-  outline.update do 
-    insert_section_after 'Chapter 2' do
-      page :destination => page_number, :title => "Pre-Appendix"
-    end
-  end
-  go_to_page 7
-  start_new_page
-  text "One last page"
-  outline.insert_section_after 'Page 6' do 
-    outline.page :destination => page_number, :title => "Inserted after 6"
-  end 
-  outline.add_subsection_to 'Chapter 1', :first do
-    outline.section 'Inserted subsection', :destination => 1 do
-      outline.page :destination => 1, :title => "Page 1 again" 
-    end
-  end 
-  start_new_page
-  text "Really this is the last page."
-  outline.update do
-    page :destination => page_number, :title => "Last Page" 
-  end 
-  start_new_page
-  text "OK, I lied; this is the very last page."
-  outline.page :destination => page_number, :title => "Very Last Page" 
-end

data/examples/general/page_geometry.rb

@@ -1,32 +0,0 @@
-# encoding: utf-8
-#
-# This demonstrates basic page layout and landscape options for Prawn
-# documents.  The style used here is a bit out of date, see 
-# multi_page_layout.rb for a more modern example.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-def pdf(*options)  
-  Prawn::Document.new(*options)
-end
-                                     
-# defaults to portrait and US letter
-portrait_letter = pdf 
-portrait_letter.render_file "portrait_letter.pdf"
-
-landscape_letter = pdf(:page_layout => :landscape)
-landscape_letter.render_file "landscape_letter.pdf"  
-
-portrait_legal = pdf(:page_size => "LEGAL")
-portrait_legal.render_file "portrait_legal.pdf" 
-
-landscape_legal = pdf(:page_size => "LEGAL", :page_layout => :landscape)
-landscape_legal.render_file "landscape_legal.pdf"
-
-portrait_a4 = pdf(:page_size => "A4")
-portrait_a4.render_file "portrait_a4.pdf"
-
-landscape_a4 = pdf(:page_size => "A4", :page_layout => :landscape)
-landscape_a4.render_file("landscape_a4.pdf")
-

data/examples/general/page_numbering.rb

@@ -1,40 +0,0 @@
-# encoding: utf-8
-#
-# This example demonstrates how to add a "page k of n"
-# template to your documents.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-Prawn::Document.generate("page_with_numbering.pdf") do
-  text "Hai"
-  start_new_page
-  text "bai"
-  start_new_page
-  text "-- Hai again"
-  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

@@ -1,20 +0,0 @@
-# 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

@@ -1,48 +0,0 @@
-# encoding: utf-8
-#
-# This example demonstrates how to make use of Prawn's repeating element
-# support.  Note that all repeated elements are generated using XObjects, so
-# they should be pretty efficient.
-#
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-Prawn::Document.generate("repeat.pdf", :skip_page_creation => true) do
-
-  repeat :all do
-    draw_text "ALLLLLL", :at => bounds.top_left
-  end
-
-  repeat :odd do
-    draw_text "ODD", :at => [0,0]
-  end
-
-  repeat :even do
-    draw_text "EVEN", :at => [0,0]
-  end
-
-  repeat [1,2] do 
-    draw_text "[1,2]", :at => [100,0]
-  end
-
-  repeat 2..4 do
-    draw_text "2..4", :at => [200,0]
-  end
-
-  repeat(lambda { |pg| pg % 3 == 0 }) do
-    draw_text "Every third", :at => [250, 20]
-  end
-  
-  repeat(:all, :dynamic => true) do
-    draw_text page_number, :at => [500, 0]
-  end
-
-  10.times do 
-    start_new_page
-    draw_text "A wonderful page", :at => [400,400]
-  end
-
-end
-
-

data/examples/general/stamp.rb

@@ -1,42 +0,0 @@
-# encoding: utf-8
-#
-# Demonstrate use of stamps
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-Prawn::Document.generate("stamp.pdf", :skip_page_creation => true) do
-
-  create_stamp("odd_page_template") do
-    draw_text "This is the odd page template", 
-            :at => [0, bounds.top - font.height] 
-    draw_text "This is also in the odd page template", :at => [0, 0] 
-  end
-
-  create_stamp("even_page_template") do
-    draw_text "This is the even page template", 
-            :at => [0, bounds.top - font.height] 
-    draw_text "This is also in the even page template", :at => [0, 0] 
-  end
-  
-  start_new_page
-  stamp("odd_page_template")
-
-  create_stamp("MyStamp") do
-    fill_color("ff0000")
-    fill_circle([0, 0], 20)
-    fill_color("000000")
-    fill_circle([10, 10], 20)
-  end
-
-  10.times do |i|
-    10.times do |j|
-      stamp_at("MyStamp", [100 + j * 50, bounds.top - 100 - i * 50])
-    end
-  end
-
-  4.times do |i|
-    start_new_page
-    stamp("#{i % 2 == 0 ? 'even' : 'odd'}_page_template")
-  end
-end

data/examples/general/templates.rb

@@ -1,14 +0,0 @@
-# encoding: utf-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.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-filename = "#{Prawn::BASEDIR}/reference_pdfs/curves.pdf"
-
-Prawn::Document.generate("template.pdf", :template => filename) do
-  text "Previous pages and content imported", :size => 18, :align => :center
-  text "This page and content is brand new", :size => 18, :align => :center
-end

data/examples/graphics/basic_images.rb

@@ -1,24 +0,0 @@
-# encoding: utf-8
-#
-# Demonstrates basic image embedding and positioning functionality.
-# For positioning images alongside flowing text, see the image_flow.rb
-# example.
-#
-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"
-  image stef, :at => [75, 75] 
-  
-  stef = "#{Prawn::BASEDIR}/data/images/stef.jpg"
-  image stef, :at => [500, 400], :width => 200, :height => 200 
-  
-  draw_text "Please enjoy the pigs", :size => 36, :at => [200,15]   
-  
-  ruport = "#{Prawn::BASEDIR}/data/images/ruport.png"  
-  image ruport, :at => [400,200], :width => 150 
-
-  ruport = "#{Prawn::BASEDIR}/data/images/ruport_transparent.png"  
-  image ruport, :at => [50,525] 
-end

data/examples/graphics/curves.rb

@@ -1,12 +0,0 @@
-# encoding: utf-8
-#
-# Demonstrates simple curve and circle usage
-#
-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 [200,200], 10
-pdf.render_file "curves.pdf"

data/examples/graphics/hexagon.rb

@@ -1,14 +0,0 @@
-# encoding: utf-8
-#
-# Draws and fills a Hexagon using Document#polygon
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-pdf = Prawn::Document.new
-                        
-pdf.fill_color "ff0000"
-pdf.fill_polygon [100, 250], [200, 300], [300, 250],
-                 [300, 150], [200, 100], [100, 150]            
-
-pdf.render_file "hexagon.pdf"

data/examples/graphics/image_fit.rb

@@ -1,16 +0,0 @@
-# encoding: utf-8
-#
-# Demonstrates fitting an image within a rectangular width and height.
-# The image will be scaled down to fit within the box, while preserving
-# the aspect ratio.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-   
-Prawn::Document.generate("image_fit.pdf", :page_layout => :landscape) do
-
-  pigs = "#{Prawn::BASEDIR}/data/images/pigs.jpg" 
-  stroke_rectangle [50,450], 200, 200
-  image pigs, :at => [50,450], :fit => [200,200]
-
-end

data/examples/graphics/image_flow.rb

@@ -1,38 +0,0 @@
-# encoding: utf-8
-#
-# Demonstrates automated flowing and positioning of images, as well as
-# aligining images along the x-axis via the :position argument.  This is
-# useful when used in combination with flowing text, where the exact final
-# position of the image is not known ahead of time.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-   
-Prawn::Document.generate("image-flow.pdf", :page_layout => :landscape) do  
-  self.font_size = 8                           
-  stef = "#{Prawn::BASEDIR}/data/images/stef.jpg"  
-  
-  text "Image at default position with no arguments"
-  
-  move_down 10
-  
-  image stef 
-  
-  text "Centered image flowing" 
-  
-  image stef, :position => :center   
-  
-  text "Right aligned image flowing"
-                 
-  image stef, :position => :right  
-  
-  text "Explicitly left aligned image flowing"
-                 
-  move_down 10                 
-                 
-  image stef, :position => :left     
-  
-  text "Flowing image at x=50"     
-  
-  image stef, :position => 50
-end

data/examples/graphics/image_position.rb

@@ -1,18 +0,0 @@
-# encoding: utf-8
-#
-# Demonstrates vertical and horizontal positioning of images.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
-
-Prawn::Document.generate("image_position.pdf", :page_layout => :landscape) do
-
-  dice = "#{Prawn::BASEDIR}/data/images/dice.png"
-
-  image dice, :scale => 0.2, :position => :left,   :vposition => :top
-  image dice, :scale => 0.2, :position => :right,  :vposition => :top
-  image dice, :scale => 0.2, :position => :center, :vposition => :top
-  image dice, :scale => 0.2, :position => :center, :vposition => :center
-  image dice, :scale => 0.2, :position => :center, :vposition => :bottom
-  
-end

data/examples/graphics/line.rb

@@ -1,33 +0,0 @@
-# encoding: utf-8
-#
-# The very first Prawn example.  Here for nostalgia's sake.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
- 
-pdf = Prawn::Document.new   
-pdf.line_width = 10    
-
-[[100,741,100,641], 
- [100,691,150,691],
- [150,741,150,641],
- [200,741,200,641],   
- [100,600,100,500],
- [100,600,150,550],
- [100,550,150,550],
- [175,600,175,500], 
- [175,600,225,550], 
- [175,550,225,550],
- [175,550,225,500],
- [275,600,250,500],
- [275,600,300,500],   
- [250,550,300,550],
- [315,600,350,500],
- [350,500,365,550], 
- [365,550,380,500],
- [380,500,415,600], 
- [430,600,430,500],
- [430,600,465,500],
- [465,600,465,500]].each { |points| pdf.stroke_line(*points) }
-
-pdf.render_file "lines.pdf"