piglop-prawn 0.10.2.1

data/data/pdfs/two_hexagons.pdf

@@ -0,0 +1,90 @@
+%PDF-1.3
+%����
+1 0 obj
+<< /Creator (Prawn)
+/Producer (Prawn)
+>>
+endobj
+2 0 obj
+<< /Count 2
+/Kids [5 0 R 7 0 R]
+/Type /Pages
+>>
+endobj
+3 0 obj
+<< /Type /Catalog
+/Pages 2 0 R
+>>
+endobj
+4 0 obj
+<< /Length 195
+>>
+stream
+0.000 0.000 0.000 rg
+0.000 0.000 0.000 RG
+q
+1.000 0.000 0.000 rg
+136.000 286.000 m
+236.000 336.000 l
+336.000 286.000 l
+336.000 186.000 l
+236.000 136.000 l
+136.000 186.000 l
+136.000 286.000 l
+f
+Q
+
+endstream
+endobj
+5 0 obj
+<< /Contents 4 0 R
+/Parent 2 0 R
+/MediaBox [0 0 612.0 792.0]
+/Type /Page
+>>
+endobj
+6 0 obj
+<< /Length 195
+>>
+stream
+1.000 0.000 0.000 rg
+0.000 0.000 0.000 RG
+q
+1.000 0.000 0.000 rg
+136.000 286.000 m
+236.000 336.000 l
+336.000 286.000 l
+336.000 186.000 l
+236.000 136.000 l
+136.000 186.000 l
+136.000 286.000 l
+f
+Q
+
+endstream
+endobj
+7 0 obj
+<< /Contents 6 0 R
+/Parent 2 0 R
+/MediaBox [0 0 612.0 792.0]
+/Type /Page
+>>
+endobj
+xref
+0 8
+0000000000 65535 f 
+0000000015 00000 n 
+0000000071 00000 n 
+0000000134 00000 n 
+0000000183 00000 n 
+0000000429 00000 n 
+0000000520 00000 n 
+0000000766 00000 n 
+trailer
+<< /Info 1 0 R
+/Root 3 0 R
+/Size 8
+>>
+startxref
+857
+%%EOF

data/data/pdfs/version_1_6.pdf

@@ -0,0 +1,61 @@
+%PDF-1.6
+%????
+1 0 obj
+<< /Creator (Prawn)
+/Producer (Prawn)
+>>
+endobj
+2 0 obj
+<< /Kids [5 0 R]
+/Type /Pages
+/Count 1
+>>
+endobj
+3 0 obj
+<< /Type /Catalog
+/Pages 2 0 R
+>>
+endobj
+4 0 obj
+<< /Length 195
+>>
+stream
+0.000 0.000 0.000 rg
+0.000 0.000 0.000 RG
+q
+1.000 0.000 0.000 rg
+136.000 286.000 m
+236.000 336.000 l
+336.000 286.000 l
+336.000 186.000 l
+236.000 136.000 l
+136.000 186.000 l
+136.000 286.000 l
+f
+Q
+
+endstream
+endobj
+5 0 obj
+<< /Contents 4 0 R
+/Type /Page
+/MediaBox [0 0 612.0 792.0]
+/Parent 2 0 R
+>>
+endobj
+xref
+0 6
+0000000000 65535 f 
+0000000015 00000 n 
+0000000071 00000 n 
+0000000128 00000 n 
+0000000177 00000 n 
+0000000423 00000 n 
+trailer
+<< /Info 1 0 R
+/Size 6
+/Root 3 0 R
+>>
+startxref
+514
+%%EOF

data/data/shift_jis_text.txt

@@ -0,0 +1 @@
+���C���y�[�W

data/examples/bounding_box/bounding_boxes.rb

@@ -0,0 +1,43 @@
+# encoding: utf-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"
+
+Prawn::Document.generate("bounding_boxes.pdf") do
+
+  # Generates a box with a top-left of [100,600] and a top-right of [300,600]
+  # The box automatically expands as the cursor moves down the page.  Notice
+  # that the final coordinates are outlined by a top and bottom line drawn
+  # relatively using calculations from +bounds+.
+  #
+  bounding_box [100,600], :width => 200 do
+    move_down 10
+    text "The rain in spain falls mainly on the plains " * 5
+    move_down 20
+    stroke do
+      line bounds.top_left,    bounds.top_right
+      line bounds.bottom_left, bounds.bottom_right
+    end
+  end
+
+  # Generates a bounding box from [100, cursor], [300, cursor - 200],
+  # where cursor is the current y position.
+  #
+  bounding_box [100,cursor], :width => 200, :height => 200 do
+    stroke do
+      circle_at [100,100], :radius => 100
+      line bounds.top_left, bounds.bottom_right
+      line bounds.top_right, bounds.bottom_left
+    end
+    
+    # Generates a nested bonding box and strokes its boundaries.  Note that
+    # this box is anchored relative to its parent bounding box, not the
+    # margin_box 
+    bounding_box [50,150], :width => 100, :height => 100 do
+      stroke_bounds
+    end
+  end
+
+end                 

data/examples/bounding_box/indentation.rb

@@ -0,0 +1,34 @@
+# encoding: utf-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"
+
+Prawn::Document.generate("indentation.pdf") do
+
+  text "No indentation"
+  indent(20) do
+    text "Some indentation"
+    # Generates a box with a top-left of [100,600] and a top-right of [300,600]
+    # The box automatically expands as the cursor moves down the page.  Notice
+    # that the final coordinates are outlined by a top and bottom line drawn
+    # relatively using calculations from +bounds+.
+    #
+    bounding_box [100,600], :width => 200 do
+      text "A little more indentation"
+      indent(20) do
+        text "And some more indentation"
+        indent(20) do
+          text "And some deeper indentation"
+        end
+      end
+    end
+    text "Some indentation"
+  end
+  indent(10) do
+    text "A bit of indentation"
+  end
+  
+  text "No indentation"
+end

data/examples/bounding_box/russian_boxes.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+#
+# This example is mostly just for fun, and shows how nested bounding boxes
+# can simplify calculations.  See the other files in examples/bounding_box
+# for more basic uses.
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+class Array
+  def combine(arr)
+    output = []
+    self.each do |i1|
+      arr.each do |i2|
+        output += [[i1,i2]]
+      end
+    end
+    output
+  end
+end
+
+def recurse_bounding_box(pdf, max_depth=5, depth=1)
+  box = pdf.bounds
+  width = (box.width-15)/2
+  height = (box.height-15)/2
+  left_top_corners = [5, box.right-width-5].combine [box.top-5, height+5]
+  left_top_corners.each do |lt|
+    pdf.bounding_box(lt, :width=>width, :height=>height) do
+      pdf.stroke_bounds
+      recurse_bounding_box(pdf, max_depth, depth+1) if depth<max_depth
+    end
+  end
+end
+
+Prawn::Document.generate("russian_boxes.pdf") do |pdf|
+  recurse_bounding_box(pdf)
+end

data/examples/bounding_box/stretched_nesting.rb

@@ -0,0 +1,67 @@
+# encoding: utf-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"
+
+Prawn::Document.generate("stretched_nesting.pdf", :page_layout => :landscape) do
+
+  def stroke_dashed_bounds
+    dash(1)
+    stroke_bounds
+    undash
+  end
+
+  bounding_box [100,400], :width => 500 do
+
+    bounding_box [0, bounds.top], :width => 200, :height => 100 do
+      stroke_bounds
+    end
+
+    bounding_box [200, bounds.top], :width => 150 do
+      indent(5) do
+        text "This box is longest, so it stretches the parent box. \n"*5
+      end
+    end
+
+    bounding_box [350, bounds.top], :width => 150 do
+      text "I AM SANTA CLAUS!!!"
+    end
+
+    stroke_dashed_bounds
+
+  end
+
+  bounding_box [100, 250], :width => 500 do
+
+    bounding_box [0, bounds.top], :width => 100, :height => 100 do
+      text "1"
+      stroke_bounds
+    end
+
+    bounding_box [125, bounds.top], :width => 50, :height => 25 do
+      text "2"
+      stroke_bounds
+    end
+
+    bounding_box [200, bounds.top - 50], :width => 50, :height => 125 do
+      text "3"
+      stroke_bounds
+    end
+
+    bounding_box [350, bounds.top - 100], :width => 20, :height => 20 do
+      text "4"
+      stroke_bounds
+    end
+
+    bounding_box [400, bounds.height - 150], :width => 100, :height => 100 do
+      text "5"
+      stroke_bounds
+    end
+
+    stroke_dashed_bounds
+
+  end
+
+end

data/examples/example_helper.rb

@@ -0,0 +1,4 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'prawn'
+
+Prawn.debug = true

data/examples/general/background.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+#
+# This example demonstrates the use of the new :background option when
+# 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"
+
+img = "#{Prawn::BASEDIR}/data/images/letterhead.jpg"
+
+Prawn::Document.generate("background.pdf", :background => img, :margin => 100) do
+  text "My report caption", :size => 18, :align => :right
+
+  move_down font.height * 2
+
+  text "Here is my text explaning this report. " * 20, 
+    :size => 12, :align => :left, :leading => 2
+
+  move_down font.height
+
+  text "I'm using a soft background. " * 40,
+    :size => 12, :align => :left, :leading => 2
+end

data/examples/general/canvas.rb

@@ -0,0 +1,15 @@
+# encoding: utf-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"
+
+Prawn::Document.generate("canvas.pdf") do
+  canvas do
+    text "This text should appear at the absolute top left"
+
+    # stroke a line to show that the relative coordinates are the same as absolute
+    stroke_line [bounds.left,bounds.bottom], [bounds.right,bounds.top]
+  end
+end

data/examples/general/context_sensitive_headers.rb

@@ -0,0 +1,37 @@
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+# Ex. Generate a roster of meeting attendees given a set of meetings.
+# Attendees for a meeting may overflow to accross page boundaries but 
+# each meeting starts on a separate page. Each page for any given
+# meeting will have the heading for that meeting. 
+
+#dummying up some meetings
+meetings = []
+5.times do |i|
+  meetings << "Meeting number #{i}"
+end
+
+Prawn::Document.generate('context_sensitive_headers.pdf', :margin => [100, 100], :skip_page_creation => true) do
+  meetings.each_with_index do |meeting,i|
+    
+    create_stamp(meeting.to_s) do
+      canvas do
+        text_box("header for #{meeting}",
+          :at => [bounds.left + 50, bounds.top - 20],
+          :height => 50,
+          :width => margin_box.width)
+      end
+    end
+    on_page_create { stamp(meeting.to_s) }
+
+    start_new_page
+
+    #simulate some meetings with content over multiple pages
+    (15 + 20*i).times do |i|
+      text "#{meeting} attendee #{i}"
+    end
+    
+  end
+
+end
+

data/examples/general/float.rb

@@ -0,0 +1,11 @@
+require "#{File.dirname(__FILE__)}/../example_helper"
+
+Prawn::Document.generate('float.pdf') do
+  float do
+    bounding_box [bounds.width / 2.0, bounds.top], :width => 100 do
+      text "Hello world. " * 50
+    end
+  end
+
+  text "Hello world again"
+end

data/examples/general/margin.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+#
+# This demonstrates the Prawn options for document and page margin, similar to CSS shorthand.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+LOREM = ("Lorem ipsum dolor sit amet, consectetur adipisicing elit, "+
+"sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "+
+"Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris "+
+"nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in "+
+"reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla "+
+"pariatur. Excepteur sint occaecat cupidatat non proident, sunt in " +
+"culpa qui officia deserunt mollit anim id est laborum. ") * 20
+
+Prawn::Document.generate("margin.pdf", :margin => 100) do |pdf|
+
+  pdf.text "100 on all sides", :style => :bold
+  pdf.text LOREM
+  
+  pdf.start_new_page(:margin => 100, :left_margin => 0)
+  pdf.text "100 on all sides but 0 on the left", :style => :bold
+  pdf.text LOREM
+
+  pdf.start_new_page(:margin => [100, 0])
+  pdf.text "100 top and bottom, 0 left and right.", :style => :bold
+  pdf.text LOREM
+  
+  pdf.start_new_page(:margin => [100, 0, 50])
+  pdf.text "100 top, 0 left and right, 50 bottom.", :style => :bold
+  pdf.text LOREM
+  
+  pdf.start_new_page(:margin => [0, 50, 100, 150])
+  pdf.text "0 top, 50 right, 100 bottom, 150 left.", :style => :bold
+  pdf.text LOREM
+
+end

data/examples/general/measurement_units.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+#
+# Generates a ruler and also demonstrates prawn/measurement_extensions.
+# It's better to run this example and examine its output than to worry about
+# its particular implementation, though some might find that interesting as
+# well.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+require "prawn/measurement_extensions"
+
+# this makes the following units available (Millimeters, Centimeters, Decimeters, Meters, Inches, Foot, Yards, Points)
+# Methodname is the common abbravation for the unit (mm, cm, dm, m, in, ft, yd, pt)
+# Usage: '10.mm'. 
+# This converts 10mm to PDF points, which Prawn uses internally.
+
+pdf = Prawn::Document.new(
+:page_size => "A4", 
+:left_margin => 10.mm,    # different
+:right_margin => 1.cm,    # units
+:top_margin => 0.1.dm,    # work
+:bottom_margin => 0.01.m) # well
+
+pdf.font_size = 6
+pdf.line_width = 0.05
+
+units_long = %w[Millimeters Centimeters Decimeters Inches Foot Points]
+units = %w[mm cm dm in ft pt]
+offset_multiplier = 2.cm
+temp = "Units\n"
+
+units.each_with_index do |unit, unit_index| #iterate through all units that make sense to display on a sheet of paper
+  one_unit_in_pt = eval "1.#{unit}" # calc the width of one unit
+  temp << "1#{unit} => #{one_unit_in_pt}pt\n" #puts converted unit in points
+  
+  offset = offset_multiplier * unit_index
+  pdf.draw_text units[unit_index], :at => [offset + 0.5.mm, pdf.bounds.top - 2.mm]
+  
+  pdf.stroke_line(offset, pdf.bounds.top, offset, pdf.bounds.bottom)
+  
+  0.upto(((pdf.bounds.height - 5.mm) / one_unit_in_pt).to_i) do |i| # checks, how many strokes can be drawn
+    pdf.stroke_line(offset, i * one_unit_in_pt, (i % 5 == 0 ? 6.mm : 3.mm) + offset, i * one_unit_in_pt) # every fifth stroke is twice as large like on a real ruler
+    pdf.draw_text "#{i}#{unit}", :at => [7.mm + offset, i * one_unit_in_pt] unless unit == "mm" && i % 5 != 0 || unit == "pt" && i % 10 != 0 # avoid text too close to each other
+  end    
+end
+
+pdf.text_box temp,
+  :width    => 5.cm, :height => pdf.font.height * units_long.length,
+  :at       => [offset_multiplier * units_long.length, pdf.bounds.top]
+
+pdf.render_file "measurement_units.pdf"

data/examples/general/metadata-info.rb

@@ -0,0 +1,16 @@
+# encoding: utf-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"
+
+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

@@ -0,0 +1,18 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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

@@ -0,0 +1,50 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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. "
+  define_outline do
+    section 'Chapter 1', :page => 1, :closed => true do 
+      page 1, :title => 'Page 1'
+      page 2, :title => 'Page 2'
+    end
+    section 'Chapter 2', :page => 3 do 
+      section 'Chapter 2 Subsection' do
+        page nil,  :title => 'Page 3'
+      end
+      page 4, :title => 'Page 4'
+    end
+  end
+  start_new_page
+  text "Page 5. Appendix"
+  start_new_page 
+  text "Page 6. More in the Appendix"
+  outline.add_section do
+    section 'Appendix', :page => 5 do
+      page 5, :title => 'Page 5'
+      page 6, :title => 'Page 6'
+    end
+  end
+  go_to_page 4
+  start_new_page 
+  text "inserted before the Appendix"
+  outline.insert_section_after 'Chapter 2' do
+    page page_number, :title => "Pre-Appendix"
+  end
+  go_to_page 7
+  start_new_page
+  text "One last page"
+  outline.insert_section_after 'Page 6' do 
+    page page_number, :title => "Inserted after 6"
+  end
+end

data/examples/general/page_geometry.rb

@@ -0,0 +1,31 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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

@@ -0,0 +1,15 @@
+# encoding: utf-8
+#
+# This example demonstrates how to add a "page k of n"
+# template to your documents.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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>", [bounds.right - 50, 0]  
+end