prawn-graph 0.0.1

data/vendor/prawn-core/examples/column_box/column_box_example.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+#
+# Text should flow between columns before wrapping to the next page, like a printed newspaper.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+paragraphs = []
+paragraphs << <<-ONE
+Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Vivamus vitae risus vitae lorem iaculis placerat. Aliquam sit amet felis. Etiam congue. Donec risus risus, pretium ac, tincidunt eu, tempor eu, quam. Morbi blandit mollis magna. Suspendisse eu tortor. Donec vitae felis nec ligula blandit rhoncus. Ut a pede ac neque mattis facilisis. Nulla nunc ipsum, sodales vitae, hendrerit non, imperdiet ac, ante. Morbi sit amet mi. Ut magna. Curabitur id est. Nulla velit. Sed consectetuer sodales justo. Aliquam dictum gravida libero. Sed eu turpis. Nunc id lorem. Aenean consequat tempor mi. Phasellus in neque. Nunc fermentum convallis ligula.
+ONE
+paragraphs << <<-TWO
+Suspendisse in nulla. Nunc eu ipsum tincidunt risus pellentesque fringilla. Integer iaculis pharetra eros. Nam ut sapien quis arcu ullamcorper cursus. Vestibulum tempor nisi rhoncus eros. Sed iaculis ultricies tellus. Cras pellentesque erat eu urna. Cras malesuada. Quisque congue ultricies neque. Nullam a nisl. Sed convallis turpis a ante. Morbi eu justo sed tortor euismod porttitor. Aenean ut lacus. Maecenas nibh eros, dapibus at, pellentesque in, auctor a, enim. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Aliquam congue pede a ipsum. Sed libero quam, sodales eget, venenatis non, cursus vel, velit. In vulputate.
+TWO
+paragraphs << <<-THREE
+In vehicula. Aenean quam mauris, vehicula non, suscipit at, venenatis sed, arcu. Etiam ornare fermentum felis. Donec ligula metus, placerat quis, blandit at, congue molestie, ante. Donec viverra nibh et dolor. Sed elementum, nunc ac gravida pulvinar, libero ligula vestibulum urna, eget luctus eros ipsum ut velit. Vestibulum at diam. Suspendisse hendrerit. Sed facilisis libero pretium nisl. Morbi eget urna ut mi egestas aliquet. Donec interdum, urna eget semper ultrices, nibh sapien laoreet massa, at laoreet nulla metus sit amet nunc. In augue. Etiam sit amet sapien. Aliquam nulla mi, tincidunt a, ullamcorper pharetra, mollis eu, purus.
+Suspendisse auctor nunc a dolor. Donec elit diam, fringilla nec, cursus a, dapibus ut, justo. Maecenas rhoncus lacinia mi. Sed tempus leo in risus. Quisque vitae est. Integer eu mi vel justo lacinia posuere. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Donec pretium auctor mauris. Cras at risus. Vestibulum ligula purus, venenatis varius, tincidunt aliquam, volutpat ut, felis. In nulla. Suspendisse magna. Fusce ac tortor. Morbi semper hendrerit purus. Donec scelerisque erat quis magna. Vivamus interdum metus at tellus.
+Nam molestie suscipit arcu. Sed sed leo non sapien lobortis gravida. Mauris ultricies imperdiet lacus. Maecenas semper sapien in mauris. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nunc euismod odio eget lectus. Vestibulum nonummy pharetra eros. Donec semper venenatis sapien. Phasellus scelerisque lectus quis tortor. Quisque turpis. Etiam rutrum metus eget nisi. Morbi varius ligula id elit. Ut augue.
+Nulla arcu est, rhoncus non, eleifend ut, imperdiet vel, magna. Sed pretium pulvinar augue. Sed sit amet nulla eget lacus viverra sollicitudin. Nulla facilisi. Proin sed ipsum vel lacus faucibus dignissim. Nulla purus. Nullam sapien elit, elementum eget, consequat vitae, vehicula cursus, pede. Sed quis leo. Praesent tincidunt convallis ligula. Sed purus eros, malesuada eget, posuere a, convallis suscipit, tellus. Proin tincidunt. Suspendisse leo. Suspendisse risus nisi, hendrerit in, ullamcorper id, porta in, pede. Maecenas lectus mi, congue vitae, ullamcorper vitae, bibendum sit amet, dui. Ut volutpat, nibh scelerisque malesuada bibendum, ipsum felis elementum lacus, nec pretium libero neque ut elit. Duis enim. Fusce arcu nulla, sodales eget, rhoncus sed, fermentum a, erat. Donec vitae mi.
+Duis sed nunc a justo egestas tincidunt. Morbi elit. Morbi venenatis fermentum erat. Cras purus orci, imperdiet a, sodales vel, aliquet at, quam. Etiam erat diam, ornare a, nonummy ut, accumsan non, felis. Fusce dignissim. Ut in ligula vitae risus varius viverra. Aenean elit diam, dapibus et, imperdiet in, suscipit at, felis. Curabitur vitae nunc ac mauris tincidunt posuere. Morbi id tortor. Nam sagittis. Sed dolor. Nulla imperdiet magna et lectus. Vivamus sapien diam, condimentum at, ultricies nec, vestibulum sit amet, pede. Nunc non orci vel magna lacinia sodales. In ac nunc vel mauris pharetra pharetra.
+Integer quis orci. Nam ultrices, magna nec ullamcorper tincidunt, enim massa semper arcu, sit amet malesuada velit nibh a enim. Phasellus molestie neque eget lorem semper convallis. Duis eget leo. Maecenas commodo vehicula nisi. In viverra massa sed justo. Vestibulum quis velit. Nunc id nulla. Ut eget sem. Nullam congue placerat ante. Mauris ut leo. Cras semper dolor at odio. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.
+Vivamus quis velit. Aliquam erat volutpat. Praesent malesuada tincidunt purus. Vestibulum quis pede. Praesent luctus, nunc in eleifend fermentum, risus lacus tristique mi, ac mollis metus mi at lectus. Proin tortor. Phasellus erat. Duis cursus nunc non metus. Vivamus hendrerit neque eu felis. Sed interdum metus a enim. Aliquam aliquet vehicula erat. Vivamus tortor neque, ornare ac, cursus id, nonummy ultricies, turpis. Proin tempor nonummy tellus. Praesent metus neque, accumsan eu, tempor sed, porta facilisis, pede. Cras nec nisl in turpis porta congue.
+Maecenas sollicitudin feugiat urna. Maecenas tellus. Vestibulum semper, lacus in blandit blandit, neque lectus ullamcorper nulla, at viverra elit justo ac lacus. Proin gravida enim non neque ultricies dictum. In vulputate mattis lacus. In mollis nibh a lacus. Aenean a ipsum. Vivamus egestas adipiscing eros. Cras gravida suscipit risus. Maecenas varius sagittis velit. Phasellus rhoncus risus. Nunc quis urna at neque convallis hendrerit. Mauris metus. Integer eleifend eros nec nunc venenatis ultrices. Curabitur placerat. Nam eros dui, semper vitae, tincidunt quis, tincidunt eu, risus. Ut in pede a neque condimentum feugiat. Maecenas dictum tortor non neque.
+THREE
+
+
+
+Prawn::Document.generate "column_box.pdf" do
+  font "Helvetica", :size => 12
+   column_box([0,750], :columns => 2, :spacer => 3, :width => bounds.width, :height => 100) do
+      text paragraphs.shift
+   end
+   
+   font "Courier", :size => 10
+   column_box([0,600], :width => bounds.width, :height => 100) do
+      text paragraphs.shift
+   end
+   
+   font "Times-Roman", :size => 16
+   column_box([0,450], :columns => 4, :spacer => font_size * 3, :width => bounds.width) do
+      text paragraphs.shift
+   end
+end
+

data/vendor/prawn-core/examples/example_helper.rb

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

data/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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/vendor/prawn-core/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

data/vendor/prawn-core/examples/general/repeaters.rb

@@ -0,0 +1,47 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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/vendor/prawn-core/examples/general/stamp.rb

@@ -0,0 +1,41 @@
+# encoding: utf-8
+#
+# Demonstrate use of stamps
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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_at([0, 0], :radius => 20)
+    fill_color("000000")
+    fill_circle_at([10, 10], :radius => 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