davebenvenuti-prawn 0.11.1.pre

data/examples/text/hyphenation.rb

@@ -0,0 +1,46 @@
+# encoding: utf-8
+#
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. 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,23 @@
+# encoding: utf-8
+#
+# Example of two ways of indenting paragraphs
+#
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+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)
+
+  # can also indent using a non-breaking space
+  nbsp = Prawn::Text::NBSP
+  pdf.text("\n" * 10 + hello + "\n#{nbsp * 10}" + world)
+end

data/examples/text/inline_format.rb

@@ -0,0 +1,104 @@
+# encoding: utf-8
+#
+# This example shows how to use inline formatting
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("inline_format.pdf") do |pdf|
+  
+  pdf.text("hello <strikethrough><b>world\nhow <i>are</i></b> you?</strikethrough> world, <u>how are you</u> now?",
+       :inline_format => true)
+  pdf.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)
+  pdf.text("right: " + "hello <b>world how <i>are</i></b> you? " * 2,
+       :inline_format => true,
+       :align => :right)
+  pdf.text("center: " + "hello <b>world how <i>are</i></b> you? " * 2,
+       :inline_format => true,
+       :align => :center)
+  pdf.text("\njustify: " + "hello <b>world <i>goodbye</i></b> " * 12 + "the end ",
+       :inline_format => true,
+       :align => :justify)
+  pdf.text("\njustify: " + "hello world goodbye " * 12 + "the end ",
+       :inline_format => true,
+       :align => :justify)
+  pdf.text("\njustify: " + "hello world goodbye " * 12 + "the end ",
+       :align => :justify)
+
+  
+  pdf.text("<color rgb='00ff00'>link: <font size='24' character_spacing='7.5'>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)
+
+  pdf.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"
+  pdf.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" }
+  }
+
+  pdf.font("Action Man")
+  pdf.text("\nhello <b>world\nhow <i>are</i></b> you?",
+           :inline_format => true)
+
+
+  pdf.font("Helvetica")
+
+
+
+  class Highlight
+    def initialize(options)
+      @color = options[:color]
+      @document = options[:document]
+    end
+
+    def render_behind(fragment)
+      original_color = @document.fill_color
+      @document.fill_color = @color
+      @document.fill_rectangle(fragment.top_left,
+                               fragment.width,
+                               fragment.height)
+      @document.fill_color = original_color
+    end
+  end
+
+  class FragmentBorder
+    def initialize(options)
+      @radius = options[:radius]
+      @connect_corners = options[:connect_corners]
+      @document = options[:document]
+    end
+
+    def render_in_front(fragment)
+      box = fragment.bounding_box
+      if @connect_corners
+        @document.stroke_polygon(fragment.top_left, fragment.top_right,
+                                 fragment.bottom_right, fragment.bottom_left)
+      end
+      @document.stroke_circle_at(fragment.top_left, :radius => @radius)
+      @document.stroke_circle_at(fragment.top_right, :radius => @radius)
+      @document.stroke_circle_at(fragment.bottom_right, :radius => @radius)
+      @document.stroke_circle_at(fragment.bottom_left, :radius => @radius)
+    end
+  end
+
+  highlight_callback = Highlight.new(:color => 'ffff00', :document => pdf)
+  border_callback = FragmentBorder.new(:radius => 2.5,
+                                       :connect_corners => true,
+                                       :document => pdf)
+  pdf.formatted_text([
+                      { :text => "\n" },
+                      { :text => "hello   ",
+                        :callback => highlight_callback },
+                      { :text => "world",
+                        :size => 24,
+                        :character_spacing => 0,
+                        :callback => [highlight_callback, border_callback] },
+                      { :text => "   hello" }
+                     ], :indent_paragraphs => 40, :character_spacing => -2)
+end
+

data/examples/text/kerning.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+#
+# Demonstration of enabling and disabling kerning support
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+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

data/examples/text/rotated.rb

@@ -0,0 +1,99 @@
+# encoding: utf-8
+#
+# Demonstrates transformations
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "rotated_text.pdf" do |pdf|
+  pdf.line_width = 1
+  width = 150
+  height = 200
+  half_width = width / 2
+  half_height = height / 2
+  angle = 30
+
+
+  # AROUND THE CENTER
+  
+  x = pdf.bounds.width / 2 - half_width
+  y = pdf.bounds.height / 2 + half_height
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.rotate(angle, :origin => [x + half_width, y - half_height]) do
+    pdf.stroke_rectangle([x, y], width, height)
+  end
+  pdf.text_box("rotated around the center " * 10,
+               :at => [x, y],
+               :width => width,
+               :height => height,
+               :rotate => angle,
+               :rotate_around => :center)
+
+  
+  # AROUND THE UPPER_LEFT_CORNER
+  
+  x = pdf.bounds.width - width
+  y = height
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.rotate(angle, :origin => [x, y]) do
+    pdf.stroke_rectangle([x, y], width, height)
+  end
+  pdf.text_box("rotated around upper left corner " * 10,
+               :at => [x, y],
+               :width => width,
+               :height => height,
+               :rotate => angle)
+
+  
+  # AROUND THE UPPER_RIGHT_CORNER
+  
+  x = 0
+  y = height
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.rotate(angle, :origin => [x + width, y]) do
+    pdf.stroke_rectangle([x, y], width, height)
+  end
+  pdf.text_box("rotated around upper right corner " * 10,
+               :at => [x, y],
+               :width => width,
+               :height => height,
+               :rotate => angle,
+               :rotate_around => :upper_right)
+
+  
+  # AROUND THE LOWER_RIGHT_CORNER
+  
+  x = 0
+  y = pdf.bounds.height
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.rotate(angle, :origin => [x + width, y - height]) do
+    pdf.stroke_rectangle([x, y], width, height)
+  end
+  pdf.text_box("rotated around lower right corner " * 10,
+               :at => [x, y],
+               :width => width,
+               :height => height,
+               :rotate => angle,
+               :rotate_around => :lower_right)
+
+  
+  # AROUND THE LOWER_LEFT_CORNER
+  
+  x = pdf.bounds.width - width
+  y = pdf.bounds.height
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.rotate(angle, :origin => [x, y - height]) do
+    pdf.stroke_rectangle([x, y], width, height)
+  end
+  pdf.text_box("rotated around lower left corner " * 10,
+               :at => [x, y],
+               :width => width,
+               :height => height,
+               :rotate => angle,
+               :rotate_around => :lower_left)
+end

data/examples/text/shaped_text_box.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+#
+# Demonstrates extending Text::Box
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "shaped_text_box.pdf" do |pdf|
+  module ShapedBox
+    def available_width
+      height + 25
+    end
+  end
+
+  Prawn::Text::Box.extensions << ShapedBox
+  pdf.stroke_rectangle([10, pdf.bounds.top - 10], 300, 300)
+  pdf.text_box("A" * 500,
+               :at => [10, pdf.bounds.top - 10],
+               :width => 300,
+               :height => 300,
+               :align => :center)
+  
+  Prawn::Text::Formatted::Box.extensions << ShapedBox
+  pdf.stroke_rectangle([10, pdf.bounds.top - 330], 300, 300)
+  pdf.formatted_text_box([:text => "A" * 500,
+                          :color => "009900"],
+                         :at => [10, pdf.bounds.top - 330],
+                         :width => 300,
+                         :height => 300,
+                         :align => :center)
+end
+

data/examples/text/simple_text.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+#
+# An early example of basic text generation at absolute positions.
+# Mostly kept for nostalgia.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "simple_text.pdf" do       
+  fill_color "0000ff"
+  draw_text "Hello World", :at => [200,420], :size => 32, :rotate => 45
+  font "Times-Roman"     
+  fill_color "ff0000"
+  draw_text "Using Another Font", :at => [5,5]    
+  start_new_page        
+  font "Courier"       
+  draw_text "Goodbye World", :at => [288,50]     
+end

data/examples/text/simple_text_ttf.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+#
+# An early example of TTF font embedding.  Mostly kept for nostalgia's sake.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "simple_text_ttf.pdf" do       
+  fill_color "0000ff"
+  font "#{Prawn::BASEDIR}/data/fonts/comicsans.ttf" 
+  draw_text "Hello World", :at => [200,720], :size => 32         
+
+  font "#{Prawn::BASEDIR}/data/fonts/Chalkboard.ttf"
+
+  pad(20) do
+    text "This is chalkboard wrapping " * 20
+  end
+end

data/examples/text/span.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+#
+# Demonstration of Document#span, which is used for generating flowing
+# columns of text.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("span.pdf") do
+  
+  # Spans will typically be used outside of bounding boxes as a way to build
+  # single columns of flowing text that span across pages.
+  #
+  span(350, :position => :center) do
+    text "Here's some centered text in a 350 point column. " * 100
+  end
+  
+  # Spans are not really compatible with bounding boxes because they break
+  # the nesting chain and also may position text outside of the bounding box
+  # boundaries, but sometimes you may wish to use them anyway for convenience
+  # Here's an example of how to do that dynamically.
+  # 
+  bounding_box([50,300], :width => 400) do
+    text "Here's some default bounding box text. " * 10 
+    span(bounds.width, 
+      :position => bounds.absolute_left - margin_box.absolute_left) do
+      text "The rain in spain falls mainly on the plains. " * 300
+    end
+  end
+end

data/examples/text/text_box.rb

@@ -0,0 +1,89 @@
+# encoding: utf-8
+#
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("text_box.pdf") do
+  def get_string(i, j)      
+    case i
+    when 0
+      text = "this is left text " * 30
+      text.insert(48, "\n\n")
+    when 1
+      text = "this is center text " * 30
+      text.insert(54, "\n\n")
+    when 2
+      text = "this is right text " * 30
+      text.insert(51, "\n\n")
+    end
+    
+    case j
+    when 0
+      text.split(" ").slice(0..47).join(" ")
+    when 3
+      text.delete(" ")
+    else
+      text
+    end
+  end
+
+  def get_options(i, j)
+    options = {
+      :width    => bounds.width * 0.3,
+      :height   => bounds.width * 0.3,
+      :overflow => :ellipses,
+      :at       => [0, 0],
+      :align    => :left,
+      :document => self
+    }
+    
+    case i
+    when 0
+      options[:valign] = :top if j == 0
+    when 1
+      options[:align] = :center
+      options[:valign] = :center if j == 0
+    when 2
+      options[:align] = :right
+      options[:valign] = :bottom if j == 0
+    end
+    
+    case j
+    when 1
+      options[:overflow] = :shrink_to_fit
+    when 2
+      options[:leading] = font.height * 0.5
+      options[:overflow] = :truncate
+    end
+    options
+  end
+
+  stroke_color("555555")
+  3.times do |i|
+    4.times do |j|
+      options = get_options(i, j)
+      options[:at][0] = (bounds.width  - options[:width]) * 0.5 * i
+      options[:at][1] = bounds.top - (bounds.height - options[:height]) * 0.33 * j
+      box = Prawn::Text::Box.new(get_string(i, j), options)
+
+      fill_color("ffeeee")
+      if i == 1
+        # bound with a box of a particular size, regardless of how
+        # much text it contains
+        fill_and_stroke_rectangle(options[:at],
+                                  options[:width],
+                                  options[:height])
+      else
+        # bound with a box that exactly fits the printed text using
+        # dry_run look-ahead
+        box.render(:dry_run => true)
+        fill_and_stroke_rectangle(options[:at],
+                                  options[:width],
+                                  box.height)
+      end
+      fill_color("000000")
+      box.render
+    end
+  end
+end