davebenvenuti-prawn 0.11.1.pre

data/examples/security/hello_foo.rb

@@ -0,0 +1,9 @@
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("security_hello_foo.pdf") do
+  text "Hello, world!"
+  encrypt_document :user_password => 'foo', :owner_password => 'bar',
+    :permissions => { :print_document => false }
+end
+

data/examples/table/bill.rb

@@ -0,0 +1,54 @@
+# encoding: utf-8
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+ 
+Prawn::Document.generate("bill.pdf") do 
+
+  self.font_size = 9
+
+  Widths = [50, 90, 170, 90, 90, 50]
+  Headers = ["Date", "Patient Name", "Description", "Charges / Payments", 
+             "Patient Portion Due", "Balance"]
+
+  head = make_table([Headers], :column_widths => Widths)
+
+  data = []
+
+  def row(date, pt, charges, portion_due, balance)
+    rows = charges.map { |c| ["", "", c[0], c[1], "", ""] }
+
+    # Date and Patient Name go on the first line.
+    rows[0][0] = date
+    rows[0][1] = pt
+
+    # Due and Balance go on the last line.
+    rows[-1][4] = portion_due
+    rows[-1][5] = balance
+
+    # Return a Prawn::Table object to be used as a subtable.
+    make_table(rows) do |t|
+      t.column_widths = Widths
+      t.cells.style :borders => [:left, :right], :padding => 2
+      t.columns(4..5).align = :right
+    end
+
+  end
+
+  data << row("1/1/2010", "", [["Balance Forward", ""]], "0.00", "0.00")
+  50.times do
+    data << row("1/1/2010", "John", [["Foo", "Bar"], 
+                                     ["Foo", "Bar"]], "5.00", "0.00")
+  end
+
+
+  # Wrap head and each data element in an Array -- the outer table has only one
+  # column.
+  table([[head], *(data.map{|d| [d]})], :header => true,
+        :row_colors => %w[cccccc ffffff]) do
+    
+    row(0).style :background_color => '000000', :text_color => 'ffffff'
+    cells.style :borders => []
+  end
+
+end

data/examples/table/cell.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+#
+# Low level cell and row implementation, which form the basic building
+# blocks for Prawn tables.  Only necessary to know about if you plan on
+# building your own table implementation from scratch or heavily modify
+# the existing table system.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("cell.pdf") do 
+  cell :content => "test", :padding => 10, :font_style => :bold, :size => 7
+end

data/examples/table/checkerboard.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+
+# Shows how to use the style() method with a block to style each cell with
+# custom code.
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+ 
+Prawn::Document.generate("checkerboard.pdf") do 
+
+  text "Here is a checkerboard:"
+
+  table [[""] * 8] * 8 do |t|
+    t.cells.style :width => 24, :height => 24
+    t.cells.style do |c| 
+      c.background_color = ((c.row + c.column) % 2).zero? ? '000000' : 'ffffff'
+    end
+  end
+
+  move_down 12
+  text "Hope you enjoyed it!"
+
+end

data/examples/table/header.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+ 
+Prawn::Document.generate("header.pdf") do 
+
+  header = %w[Name Occupation]
+  data = ["Bender Bending Rodriguez", "Bender"]
+
+  table([header] + [data] * 50, :header => true) do
+    row(0).style(:font_style => :bold, :background_color => 'cccccc')
+  end
+
+end

data/examples/table/inline_format_table.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+ 
+Prawn::Document.generate("inline_format_table.pdf") do 
+
+  table([%w[foo bar baz<b>baz</b>], %w[baz bar <i>foo</i>foo]], 
+        :cell_style => { :padding => 12, :inline_format => true },
+        :width => bounds.width)
+
+end
+

data/examples/table/multi_page_table.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("multi_page_table.pdf") do
+
+  table([%w[Some data in a table]] * 50)
+
+end

data/examples/table/simple_table.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+ 
+Prawn::Document.generate("simple_table.pdf") do 
+
+  table([["foo", "bar " * 15, "baz"], 
+         ["baz", "bar", "foo " * 15]], :cell_style => { :padding => 12 }) do
+    cells.borders = []
+
+    # Use the row() and style() methods to select and style a row.
+    style row(0), :border_width => 2, :borders => [:bottom]
+
+    # The style method can take a block, allowing you to customize properties
+    # per-cell.
+    style(columns(0..1)) { |cell| cell.borders |= [:right] }
+  end
+
+  move_down 12
+
+  table([%w[foo bar bazbaz], %w[baz bar foofoo]], 
+        :cell_style => { :padding => 12 }, :width => bounds.width)
+
+end

data/examples/table/subtable.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+ 
+Prawn::Document.generate("subtable.pdf") do |pdf|
+  
+  subtable = Prawn::Table.new([%w[one two], %w[three four]], pdf)
+
+  pdf.table([["Subtable ->", subtable, "<-"]])
+
+end
+

data/examples/table/widths.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+ 
+Prawn::Document.generate("widths.pdf") do 
+
+  text "Some 300-pt tables:"
+
+  table([%w[A B C]], :width => 300)
+  move_down 12
+
+  table([%w[A B C], %w[D Everything\ under\ the\ sun F]], :width => 300)
+  move_down 12
+
+  # TODO: what should this be doing? Like the current prawn-layout, it does
+  # not attempt to reflow the second column.
+  # table([["A", "Blah " * 20, "C"]], :width => 300)
+  # move_down 12
+
+end

data/examples/text/alignment.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+#
+# This example demonstrates usage of Document#text with the :align option.
+# Available options are :left, :right, and :center, with :left as default.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("alignment.pdf") do
+  text "This text should be left aligned"
+  text "This text should be centered", :align => :center    
+  text "This text should be right aligned", :align => :right
+  
+  pad(20) { text "This is Flowing from the left. " * 20 }
+  
+  pad(20) { text "This is Flowing from the center. " * 20, :align => :center }
+  
+  pad(20) { text "This is Flowing from the right. " * 20, :align => :right }
+end

data/examples/text/character_spacing.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+#
+# Example of character spacing
+#
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "character_spacing.pdf" do |pdf|
+  string = "hello world " * 50
+  pdf.text(string, :character_spacing => 2.5)
+  pdf.text(string)
+end

data/examples/text/dfont.rb

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+DFONT_FILE = "#{Prawn::BASEDIR}/data/fonts/Action Man.dfont"
+puts "There are #{Prawn::Font::DFont.font_count(DFONT_FILE)} fonts in #{DFONT_FILE}:"
+Prawn::Font::DFont.named_fonts(DFONT_FILE).each do |name|
+  puts "* #{name}"
+end
+
+puts
+puts "generating sample document in 'dfont.pdf'..."
+
+Prawn::Document.generate "dfont.pdf" do       
+  fill_color "0000ff"
+
+  font DFONT_FILE, :font => "ActionMan-Bold", :size => 24
+  text "Introducing Action Man!"
+
+  move_text_position 24
+
+  font_families["Action Man"] = {
+    :normal      => { :file => DFONT_FILE, :font => "ActionMan" },
+    :bold        => { :file => DFONT_FILE, :font => "ActionMan-Bold" },
+    :italic      => { :file => DFONT_FILE, :font => "ActionMan-Italic" },
+    :bold_italic => { :file => DFONT_FILE, :font => "ActionMan-BoldItalic" }
+  }
+
+  font "Action Man", :size => 16
+  text "Action Man is feeling normal here."
+
+  move_text_position 16
+
+  font "Action Man", :style => :bold, :size => 16
+  text "Action Man is feeling bold here!"
+
+  move_text_position 16
+
+  font "Action Man", :style => :italic, :size => 16
+  text "Here, we see Action Man feeling italicized. Slick!"
+
+  move_text_position 16
+
+  font "Action Man", :style => :bold_italic, :size => 16
+  text "Lastly, we observe Mr. Action Man being bold AND italicized. Excellent!"
+end
+
+puts "done"

data/examples/text/family_based_styling.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+#
+# This example demonstrates using the :style option for Document#text.
+# If you are working with TTF fonts, you'll want to check out the 
+# documentation for Document#font_families and register your fonts with it.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("family_style.pdf") do
+  ["Courier","Helvetica","Times-Roman"].each do |f|
+    [:bold,:bold_italic,:italic,:normal].each do |s|
+      font f, :style => s
+      text "I'm writing in #{f} (#{s})"
+    end
+  end
+  
+  font "Helvetica"
+  
+  text "Normal"
+  text "Bold",        :style => :bold
+  text "Bold Italic", :style => :bold_italic
+  text "Italic",      :style => :italic
+  text "Normal"
+end

data/examples/text/font_calculations.rb

@@ -0,0 +1,92 @@
+# encoding: utf-8
+# 
+# This example is a demonstration of how Prawn does its text positioning,
+# meant to assist those that need to do advanced positioning calculations.
+# Run the example for a clearer picture of how things work
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate('font_calculations.pdf') do
+  
+  def demonstration
+    font_size 12
+    move_down 10
+
+    stroke_horizontal_rule
+
+    text "When using flowing text, Prawn will position text\n" +
+         "starting font.ascender below the baseline, and leave\n" +
+         "the y-cursor at the baseline of the next line of text"
+
+    stroke_horizontal_rule
+
+    move_down 20
+
+    bl = y - bounds.absolute_bottom
+
+    stroke_horizontal_rule
+    draw_text "When using text positioned with :at, the baseline is used", :at => [0, bl]
+
+    draw_text "(and the Y-cursor is not moved)", :at => [350, bl]
+
+    colors = { :ascender    => "ff0000", 
+               :descender   => "00ff00",
+               :line_gap    => "0000ff",
+               :font_height => "005500" }
+
+
+    pad(20) do                    
+      text "Calculations Demo", :size => 16
+    end
+
+    fill_color colors[:ascender]
+    text "ASCENDER"
+
+    fill_color colors[:descender]
+    text "DESCENDER"
+
+    fill_color colors[:line_gap]
+    text "LINEGAP" 
+
+    fill_color colors[:font_height]
+    text "FONT_HEIGHT"
+
+    fill_color "000000"
+    font_size 16
+
+    move_down 40
+
+    bl = y - bounds.absolute_bottom
+    draw_text "The quick brown fox jumps over the lazy dog.", :at => [0, bl]
+
+    stroke_color colors[:ascender]
+    stroke_line [0, bl], [0, bl + font.ascender]
+    stroke_line [0, bl + font.ascender], [bounds.width, bl + font.ascender]
+
+    stroke_color colors[:descender]
+    stroke_line [0,bl], [0, bl - font.descender]
+    stroke_line [0, bl - font.descender], [bounds.width, bl - font.descender]
+
+    stroke_color colors[:line_gap]
+    stroke_line [0, bl - font.descender], [0,bl - font.descender - font.line_gap]
+    stroke_line [0, bl - font.descender - font.line_gap], 
+                [bounds.width,bl - font.descender - font.line_gap]
+
+    stroke_color colors[:font_height]
+    stroke_line [bounds.width, bl + font.ascender],
+                [bounds.width, bl - font.descender - font.line_gap]
+                
+    stroke_color "000000"
+    fill_color "000000"
+  end
+  
+  text "Using AFM", :size => 20
+  demonstration
+  
+  move_down 75
+  font "#{Prawn::BASEDIR}/data/fonts/DejaVuSans.ttf"
+  text "Using TTF", :size => 20
+  demonstration
+  
+end

data/examples/text/font_size.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+#
+# This example shows the many ways of setting font sizes in Prawn
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "font_size.pdf", :page_size => "A4" do
+
+  # Explicit global changes
+  font 'Helvetica'
+  self.font_size = 16
+
+  text 'Font at 16 point'
+
+  # Transactional changes rolled back after block exit
+  font_size 9 do
+    text 'Font at 9 point'
+    # single line changes, not persisted.
+    text 'Font at manual override 20 point', :size => 20
+    text 'Font at 9 point'
+  end
+
+  # Transactional changes rolled back after block exit on full fonts.
+  font("Times-Roman", :style => :italic, :size => 12) do
+    text "Font in times at 12"
+    font_size(16) { text "Font in Times at 16" }
+  end
+
+  text 'Font at 16 point'
+
+  font "Courier", :size => 40
+  text "40 pt!"
+end