davebenvenuti-prawn 0.11.1.pre

data/examples/graphics/stroke_bounds.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+#
+# Demonstrates Document#stroke_bounds, which will stroke a rectange outlining
+# the boundaries of the current bounding box.  This is useful for debugging
+# and can also be used as a light-weight and lower level alternative to
+# Cells.  
+#
+# Feature borrowed from Josh Knowle's pt at:
+# http://github.com/joshknowles/pt/tree/master
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("stroke_bounds.pdf") do 
+  stroke_bounds
+  
+  bounding_box [100,500], :width => 200, :height => 300 do
+    text "Hey there, here's some text. " * 10
+    stroke_bounds
+  end
+end

data/examples/graphics/stroke_cap_and_join.rb

@@ -0,0 +1,46 @@
+# encoding: utf-8
+#
+# Stroke dashing can be applied to any line or curve
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("stroke_cap_and_join.pdf") do
+  self.line_width = 25
+  x0 = bounds.left + 100
+  x1 = bounds.left + 200
+  x2 = bounds.left + 300
+
+  y = bounds.top - 125
+
+  3.times do |i|
+    case i
+    when 0
+      self.join_style = :miter
+    when 1
+      self.join_style = :round
+    when 2
+      self.join_style = :bevel
+    end
+    stroke do
+      move_to(x0, y)
+      line_to(x1, y + 100)
+      line_to(x2, y)
+    end
+    y -= 100
+  end
+  
+
+  3.times do |i|
+    case i
+    when 0
+      self.cap_style = :butt
+    when 1
+      self.cap_style = :round
+    when 2
+      self.cap_style = :projecting_square
+    end
+    stroke_line([x0, y, x2, y])
+    y -= 30
+  end
+end

data/examples/graphics/stroke_dash.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+#
+# Stroke dashing can be applied to any line or curve
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("stroke_dash.pdf") do
+  self.line_width = 1
+  base_y = bounds.top
+
+  100.times do |i|
+    length = i / 4 + 1
+    # space between dashes same length as dash
+    space = length
+    # start with dash
+    phase = 0
+    case i % 4
+    when 0
+      base_y -= 10
+    when 1
+      # start with space between dashes
+      phase = length
+    when 2
+      base_y -= 10
+      # space between dashes half as long as dash
+      space = length * 0.5
+    when 3
+      # space between dashes half as long as dash
+      space = length * 0.5
+      # start with space between dashes
+      phase = length
+    end
+    dash(length, :space => space, :phase => phase)
+    points = [bounds.left, base_y - 2 * i, bounds.right, base_y - 2 * i]
+    stroke_line(points)
+  end
+  i = 100
+  base_y -= 10
+  undash
+  points = [bounds.left, base_y - 2 * i, bounds.right, base_y - 2 * i]
+  stroke_line(points)
+end

data/examples/graphics/transformations.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+#
+# Demonstrates transformations
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "transformations.pdf" do |pdf|
+  width = 50
+  height = 100
+
+  # ROTATION
+  x = 50
+  y = pdf.bounds.top - 50
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.draw_text("reference rectangle", :at => [x + width, y - height])
+  pdf.rotate(30, :origin => [x, y]) do
+    pdf.stroke_rectangle([x, y], width, height)
+    pdf.draw_text("rectangle rotated around upper-left corner", :at => [x + width, y - height])
+  end
+
+  x = 50
+  y = pdf.bounds.top - 200
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.draw_text("reference rectangle", :at => [x + width, y - height])
+  pdf.rotate(30, :origin => [x + width / 2, y - height / 2]) do
+    pdf.stroke_rectangle([x, y], width, height)
+    pdf.draw_text("rectangle rotated around center", :at => [x + width, y - height])
+  end
+
+  # SCALE
+  x = 0
+  y = pdf.bounds.top - 500
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.draw_text("reference rectangle", :at => [x + width, y - height])
+  pdf.scale(2, :origin => [x, y]) do
+    pdf.stroke_rectangle([x, y], width, height)
+    pdf.draw_text("rectangle scaled from upper-left corner", :at => [x + width, y - height])
+  end
+
+  x = 150
+  y = pdf.bounds.top - 400
+
+  pdf.stroke_rectangle([x, y], width, height)
+  pdf.draw_text("reference rectangle", :at => [x + width, y - height])
+  pdf.scale(2, :origin => [x + width / 2, y - height / 2]) do
+    pdf.stroke_rectangle([x, y], width, height)
+    pdf.draw_text("rectangle scaled from center", :at => [x + width, y - height])
+  end
+end

data/examples/graphics/transparency.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+#
+# Demonstrate use of transparency
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("transparency.pdf") do
+  fill_color("ff0000")
+  fill_circle_at([200, 200], :radius => 200)
+  transparent(0.5, 1) do
+    fill_color("000000")
+    stroke_color("ffffff")
+    fill_and_stroke_circle_at([300, 300], :radius => 200)
+    fill_color("ffffff")
+    text "transparency " * 150, :size => 18
+  end
+  
+  start_new_page
+
+  fill_color("000000")
+  fill_rectangle([0, bounds.top], 200, 100)
+  transparent(0.5) do
+    fill_color("ff0000")
+    fill_rectangle([100, bounds.top - 50], 200, 100)
+  end
+end

data/examples/grid/bounding_boxes.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8    
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate('bounding_box_grid.pdf') do |p|
+  p.define_grid(:columns => 5, :rows => 8, :gutter => 10)
+  
+  p.stroke_color = "ff0000"
+  
+  p.grid.rows.times do |i|
+    p.grid.columns.times do |j|
+      p.grid(i,j).bounding_box do
+        p.text p.grid(i,j).name
+        p.stroke do
+          p.rectangle(p.bounds.top_left, p.bounds.width, p.bounds.height)
+        end
+      end
+    end
+  end
+end
+

data/examples/grid/column_gutter_grid.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8    
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate('column_gutter_grid.pdf') do |p|
+  p.define_grid(:columns => 3, :rows => 10, :column_gutter => 10)
+  
+  p.grid.rows.times do |i|
+    p.grid.columns.times do |j|
+      b = p.grid(i,j)
+      p.bounding_box b.top_left, :width => b.width, :height => b.height do
+        p.text b.name
+        p.stroke do
+          p.rectangle(p.bounds.top_left, b.width, b.height)
+        end
+      end
+    end
+  end
+end
+

data/examples/grid/multi_boxes.rb

@@ -0,0 +1,52 @@
+# encoding: utf-8    
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate('multi_boxes.pdf') do |p|
+  p.define_grid(:columns => 5, :rows => 8, :gutter => 10)
+  
+  p.grid.rows.times do |i|
+    p.grid.columns.times do |j|
+      p.grid(i,j).bounding_box do
+        p.text p.grid(i,j).name
+        p.stroke_color = "cccccc"
+        p.stroke do
+          p.rectangle(p.bounds.top_left, p.bounds.width, p.bounds.height)
+        end
+      end
+    end
+  end
+  
+  g = p.grid([0,0], [1,1])
+  g.bounding_box do
+    p.move_down 12
+    p.text g.name
+    p.stroke_color = "333333"
+    p.stroke do
+      p.rectangle(p.bounds.top_left, p.bounds.width, p.bounds.height)
+    end
+  end
+ 
+  g = p.grid([3,0], [3,3])
+  g.bounding_box do
+    p.move_down 12
+    p.text g.name
+    p.stroke_color = "333333"
+    p.stroke do
+      p.rectangle(p.bounds.top_left, p.bounds.width, p.bounds.height)
+    end
+  end
+ 
+  g = p.grid([4,0], [5,1])
+  g.bounding_box do
+    p.move_down 12
+    p.text g.name
+    p.stroke_color = "333333"
+    p.stroke do
+      p.rectangle(p.bounds.top_left, p.bounds.width, p.bounds.height)
+    end
+  end
+ 
+end
+

data/examples/grid/show_grid.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8    
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate('show_grid.pdf') do |p|
+  p.define_grid(:columns => 5, :rows => 8, :gutter => 10)
+  
+  p.grid.show_all
+  
+  p.grid(2,4).show("FF0000")
+  p.grid([3,0], [5,3]).show("0000FF")
+end
+

data/examples/grid/simple_grid.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8    
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate('simple_grid.pdf') do |p|
+  p.define_grid(:columns => 5, :rows => 8, :gutter => 10)
+  
+  p.grid.rows.times do |i|
+    p.grid.columns.times do |j|
+      b = p.grid(i,j)
+      p.bounding_box b.top_left, :width => b.width, :height => b.height do
+        p.text b.name
+        p.stroke do
+          p.rectangle(p.bounds.top_left, b.width, b.height)
+        end
+      end
+    end
+  end
+end
+

data/examples/m17n/chinese_text_wrapping.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+#
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+start = Time.now
+Prawn::Document.generate("chinese_flow.pdf") do  
+  font "#{Prawn::BASEDIR}/data/fonts/gkai00mp.ttf"   
+  font_size 16
+
+  long_text = "更可怕的是，同质化竞争对手可以按照URL中后面这个ID来遍历您的DB中的内容，写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事，这样的话，你就非常被动了。写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事写个小爬虫把你的页面上的关键信息顺次爬下来也不是什么难事"                                                       
+  text long_text
+  
+  # be sure to restore space based wrapping when dealing with latin scripts
+  long_text = "Text with some spaces " * 25
+  text long_text
+end

data/examples/m17n/euro.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+#
+# As of Prawn 0.3, it is possible to generate a Euro using the built-in
+# AFM files.  However, you need to be sure to manually add spacing around it,
+# as its calculated width in the AFM files seem to be wrong.
+#
+# We are investigating this issue, but it does not seem to be Prawn specific.
+# If you need precision spacing, use a TTF file instead and the issue will
+# go away.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate "euro.pdf" do
+  text "A Euro! € ©", :size => 32
+end

data/examples/m17n/sjis.rb

@@ -0,0 +1,29 @@
+# encoding: utf-8
+#
+# FIXME: Introducing TTFunk into Prawn broke this example and a cooresponding
+# test.  Ticket: #139
+#
+# Tests passing non utf-8 data into Prawns text function. Should
+# be transparently converted to utf-8 and rendered as usual.
+# 
+# NOTE: only works on ruby1.9 compatible VMs, and requires the current
+#       font to include japanese glyphs. On 1.8.x comaptible VMs, an exception
+#       will be raised.
+
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+begin
+  ruby_19 do  
+    datafile = File.join(File.dirname(__FILE__), "..", "..", "data", 
+      "shift_jis_text.txt")
+    sjis_str = File.open(datafile, "r:shift_jis") { |f| f.gets }
+
+    Prawn::Document.generate("sjis.pdf") do
+      font "#{Prawn::BASEDIR}/data/fonts/gkai00mp.ttf"
+      text sjis_str
+    end       
+  end
+rescue
+  puts "\n FIXME: SJIS Broken due to TTFunk integration."
+end

data/examples/m17n/utf8.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8
+#
+# Shows that Prawn works out of the box with UTF-8 text, so long as you use
+# a TTF file with the necessary glyphs for your content.
+#
+require File.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+Prawn::Document.generate("utf8.pdf") do
+  font "#{Prawn::BASEDIR}/data/fonts/DejaVuSans.ttf"
+  text "ὕαλον ϕαγεῖν δύναμαι· τοῦτο οὔ με βλάπτει." * 20
+end
+
+      

data/examples/m17n/win_ansi_charset.rb

@@ -0,0 +1,55 @@
+# 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.expand_path(File.join(File.dirname(__FILE__),
+                                   %w[.. example_helper]))
+
+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