prawn 0.8.4 → 0.11.1.pre

data/examples/graphics/stroke_dash.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+#
+# Stroke dashing can be applied to any line or curve
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,52 @@
+# encoding: utf-8
+#
+# Demonstrates transformations
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,26 @@
+# encoding: utf-8
+#
+# Demonstrate use of transparency
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,21 @@
+# encoding: utf-8    
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,20 @@
+# encoding: utf-8    
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,51 @@
+# encoding: utf-8    
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,13 @@
+# encoding: utf-8    
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,20 @@
+# encoding: utf-8    
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,17 @@
+# encoding: utf-8
+#
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,15 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate "euro.pdf" do
+  text "A Euro! € ©", :size => 32
+end

data/examples/m17n/sjis.rb

@@ -0,0 +1,28 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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,13 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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,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