piglop-prawn 0.10.2.1

data/examples/m17n/win_ansi_charset.rb

@@ -0,0 +1,54 @@
+# encoding: utf-8
+#
+# Prints a list of all of the glyphs that can be rendered by Adobe's built
+# in fonts, along with their character widths and WinAnsi codes.  Be sure
+# to pass these glyphs as UTF-8, and Prawn will transcode them for you.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+FONT_SIZE = 9.5
+
+Prawn::Document.generate("win-ansi.pdf") do
+  @skip_encoding = true
+
+  x = 0
+  y = bounds.top
+
+  fields = [[20, :right], [8, :left], [12, :center], [30, :right], [8, :left], [0, :left]]
+
+  font "Helvetica", :size => FONT_SIZE
+
+  Prawn::Encoding::WinAnsi::CHARACTERS.each_with_index do |name, index|
+    next if name == ".notdef"
+    y -= FONT_SIZE
+
+    if y < FONT_SIZE
+      y = bounds.top - FONT_SIZE
+      x += 170
+    end
+
+    code = "%d." % index
+    char = index.chr
+
+    width = 1000 * width_of(char, :size => FONT_SIZE) / FONT_SIZE
+    size = "%d" % width
+
+    data = [code, nil, char, size, nil, name]
+    dx = x
+    fields.zip(data).each do |(total_width, align), field|
+      if field
+        width = width_of(field, :size => FONT_SIZE)
+
+        case align
+        when :left then offset = 0
+        when :right then offset = total_width - width
+        when :center then offset = (total_width - width)/2
+        end
+
+        draw_text(field, :at => [dx + offset, y])
+      end
+
+      dx += total_width
+    end
+  end
+end

data/examples/security/hello_foo.rb

@@ -0,0 +1,8 @@
+require File.join(File.dirname(__FILE__), "..", "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,53 @@
+# encoding: utf-8
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+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,12 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate("cell.pdf") do 
+  cell :content => "test", :padding => 10, :style => :bold, :size => 7
+end

data/examples/table/checkerboard.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+
+# Shows how to use the style() method with a block to style each cell with
+# custom code.
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+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,14 @@
+# encoding: utf-8
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+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(:style => :bold, :background_color => 'cccccc')
+  end
+
+end

data/examples/table/inline_format_table.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+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,9 @@
+# encoding: utf-8
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,24 @@
+# encoding: utf-8
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+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,12 @@
+# encoding: utf-8
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+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,20 @@
+# encoding: utf-8
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+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,18 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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/dfont.rb

@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,24 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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,91 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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,33 @@
+# encoding: utf-8
+#
+# This example shows the many ways of setting font sizes in Prawn
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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

data/examples/text/hyphenation.rb

@@ -0,0 +1,45 @@
+# encoding: utf-8
+#
+
+require 'examples/example_helper'
+
+Prawn::Document.generate("hyphenation.pdf") do
+  def get_string(i)
+    case i
+    when 0
+      text = "this­is­soft­hyphenated­text­" * 30
+    when 1
+      text = "this-is-hard-hyphenated-text-" * 30
+    when 2
+      text = "this­-is­-soft­-hard­-hyphenated­-text­-" * 30
+    end
+  end
+
+  options = {
+    :width    => bounds.width * 0.3,
+    :height   => bounds.width * 0.3,
+    :overflow => :ellipses,
+    :at       => [0, 0],
+    :align    => :left,
+    :document => self
+  }
+
+  stroke_color("555555")
+  3.times do |i|
+    options[:at][0] = (bounds.width  - options[:width]) * 0.5 * i
+    options[:at][1] = bounds.height * 0.5 + options[:height] + 50
+    box = Prawn::Text::Box.new(get_string(i), options)
+    box.render
+  end
+
+  
+  font("#{Prawn::BASEDIR}/data/fonts/DejaVuSans.ttf")
+
+  stroke_color("555555")
+  3.times do |i|
+    options[:at][0] = (bounds.width  - options[:width]) * 0.5 * i
+    options[:at][1] = bounds.height * 0.5 - 50
+    box = Prawn::Text::Box.new(get_string(i), options)
+    box.render
+  end
+end

data/examples/text/indent_paragraphs.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+#
+# An early example of basic text generation at absolute positions.
+# Mostly kept for nostalgia.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate "indent_paragraphs.pdf" do |pdf|
+  hello = "hello " * 50
+  world = "world " * 50
+  pdf.text(hello + "\n" + world, :indent_paragraphs => 60)
+
+  pdf.move_cursor_to(pdf.font.height)
+  pdf.text(hello + "\n" + world, :indent_paragraphs => 60)
+
+  pdf.move_cursor_to(pdf.font.height * 3)
+  pdf.text(hello + "\n" + world, :indent_paragraphs => 60)
+end

data/examples/text/inline_format.rb

@@ -0,0 +1,72 @@
+# encoding: utf-8
+#
+# This example shows how to use inline formatting
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate "inline_format.pdf" do
+  
+  text("hello <strikethrough><b>world\nhow <i>are</i></b> you?</strikethrough> world, <u>how are you</u> now?",
+       :inline_format => true)
+  text("<font size='14'>left: </font>" + "hello <b>world <font name='Times-Roman' size='28'>how</font> <i>are</i></b> you? <font size='14'><b>Goodbye.</b></font> " * 8,
+       :inline_format => true)
+  text("right: " + "hello <b>world how <i>are</i></b> you? " * 2,
+       :inline_format => true,
+       :align => :right)
+  text("center: " + "hello <b>world how <i>are</i></b> you? " * 2,
+       :inline_format => true,
+       :align => :center)
+  text("\njustify: " + "hello <b>world <i>goodbye</i></b> " * 12 + "the end ",
+       :inline_format => true,
+       :align => :justify)
+  text("\njustify: " + "hello world goodbye " * 12 + "the end ",
+       :inline_format => true,
+       :align => :justify)
+  text("\njustify: " + "hello world goodbye " * 12 + "the end ",
+       :align => :justify)
+
+  
+  text("<color rgb='00ff00'>link: <font size='24'>please make</font> <color rgb='#0000ff'><u><link href='http://wiki.github.com/sandal/prawn/'>this</link></u></color> clickable.</color> Here we have A<color rgb='#0000ff'><sup><link href='http://wiki.github.com/sandal/prawn/'>superscript</link></sup></color> link and A<color rgb='#0000ff'><sub><link href='http://wiki.github.com/sandal/prawn/'> subscript</link></sub></color> link.",
+       :inline_format => true)
+
+  text("<color c='100' m='0' y='0' k='0'><font size='24'>CMYK</font></color>",
+       :inline_format => true)
+
+  file = "#{Prawn::BASEDIR}/data/fonts/Action Man.dfont"
+  font_families["Action Man"] = {
+    :normal      => { :file => file, :font => "ActionMan" },
+    :italic      => { :file => file, :font => "ActionMan-Italic" },
+    :bold        => { :file => file, :font => "ActionMan-Bold" },
+    :bold_italic => { :file => file, :font => "ActionMan-BoldItalic" }
+  }
+
+  font("Action Man")
+  text("\nhello <b>world\nhow <i>are</i></b> you?",
+           :inline_format => true)
+
+  def draw_circles_at_corners(fragment, radius, connect_corners)
+    box = fragment.bounding_box
+    if connect_corners
+      polygon([box[0], box[1]],
+              [box[0], box[3]],
+              [box[2], box[3]],
+              [box[2], box[1]])
+    end
+    stroke_circle_at([box[0], box[1]], :radius => radius)
+    stroke_circle_at([box[0], box[3]], :radius => radius)
+    stroke_circle_at([box[2], box[1]], :radius => radius)
+    stroke_circle_at([box[2], box[3]], :radius => radius)
+  end
+
+  font("Helvetica")
+  formatted_text([
+                      { :text => "\n" },
+                      { :text => "hello   " },
+                      { :text => "world",
+                        :size => 24,
+                        :callback => { :object => self,
+                                       :method => :draw_circles_at_corners,
+                                       :arguments => [2.5, true] }},
+                      { :text => "   hello" }
+                     ], :indent_paragraphs => 40)
+end

data/examples/text/kerning.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+#
+# Demonstration of enabling and disabling kerning support
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate "kerning.pdf" do
+  draw_text "To kern?", :at => [200,720], :size => 24, :kerning => true
+  draw_text "To not kern?", :at => [200,690], :size => 24, :kerning => false 
+  
+  move_down 100
+                                                                     
+  pad(30) do
+    text "To kern and wrap. " * 5, :size => 24, :kerning => true   
+  end
+  
+  text "To not kern and wrap. " * 5, :size => 24, :kerning => false
+
+  font "#{Prawn::BASEDIR}/data/fonts/DejaVuSans.ttf"
+  
+  draw_text "To kern?", :at => [200,660], :size => 24, :kerning => true
+  draw_text "To not kern?", :at => [200,630], :size => 24, :kerning => false     
+  
+  pad(30) do
+    text "To kern and wrap. " * 5, :size => 24, :kerning => true   
+  end
+  
+  text "To not kern and wrap. " * 5, :size => 24, :kerning => false
+  
+end