piglop-prawn 0.10.2.1

data/examples/general/repeaters.rb

@@ -0,0 +1,47 @@
+# encoding: utf-8
+#
+# This example demonstrates how to make use of Prawn's repeating element
+# support.  Note that all repeated elements are generated using XObjects, so
+# they should be pretty efficient.
+#
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate("repeat.pdf", :skip_page_creation => true) do
+
+  repeat :all do
+    draw_text "ALLLLLL", :at => bounds.top_left
+  end
+
+  repeat :odd do
+    draw_text "ODD", :at => [0,0]
+  end
+
+  repeat :even do
+    draw_text "EVEN", :at => [0,0]
+  end
+
+  repeat [1,2] do 
+    draw_text "[1,2]", :at => [100,0]
+  end
+
+  repeat 2..4 do
+    draw_text "2..4", :at => [200,0]
+  end
+
+  repeat(lambda { |pg| pg % 3 == 0 }) do
+    draw_text "Every third", :at => [250, 20]
+  end
+  
+  repeat(:all, :dynamic => true) do
+    draw_text page_number, :at => [500, 0]
+  end
+
+  10.times do 
+    start_new_page
+    draw_text "A wonderful page", :at => [400,400]
+  end
+
+end
+
+

data/examples/general/stamp.rb

@@ -0,0 +1,41 @@
+# encoding: utf-8
+#
+# Demonstrate use of stamps
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate("stamp.pdf", :skip_page_creation => true) do
+
+  create_stamp("odd_page_template") do
+    draw_text "This is the odd page template", 
+            :at => [0, bounds.top - font.height] 
+    draw_text "This is also in the odd page template", :at => [0, 0] 
+  end
+
+  create_stamp("even_page_template") do
+    draw_text "This is the even page template", 
+            :at => [0, bounds.top - font.height] 
+    draw_text "This is also in the even page template", :at => [0, 0] 
+  end
+  
+  start_new_page
+  stamp("odd_page_template")
+
+  create_stamp("MyStamp") do
+    fill_color("ff0000")
+    fill_circle_at([0, 0], :radius => 20)
+    fill_color("000000")
+    fill_circle_at([10, 10], :radius => 20)
+  end
+
+  10.times do |i|
+    10.times do |j|
+      stamp_at("MyStamp", [100 + j * 50, bounds.top - 100 - i * 50])
+    end
+  end
+
+  4.times do |i|
+    start_new_page
+    stamp("#{i % 2 == 0 ? 'even' : 'odd'}_page_template")
+  end
+end

data/examples/general/templates.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+#
+# This sample demonstrates the use of the :template option when generating
+# a new Document. The template PDF file is imported into a new document.
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+filename = "#{Prawn::BASEDIR}/reference_pdfs/curves.pdf"
+
+Prawn::Document.generate("template.pdf", :template => filename) do
+  text "Previous pages and content imported", :size => 18, :align => :center
+  text "This page and content is brand new", :size => 18, :align => :center
+end

data/examples/graphics/basic_images.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+#
+# Demonstrates basic image embedding and positioning functionality.
+# For positioning images alongside flowing text, see the image_flow.rb
+# example.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+   
+Prawn::Document.generate("basic_images.pdf", :page_layout => :landscape) do     
+  stef = "#{Prawn::BASEDIR}/data/images/stef.jpg"
+  image stef, :at => [75, 75] 
+  
+  stef = "#{Prawn::BASEDIR}/data/images/stef.jpg"
+  image stef, :at => [500, 400], :width => 200, :height => 200 
+  
+  draw_text "Please enjoy the pigs", :size => 36, :at => [200,15]   
+  
+  ruport = "#{Prawn::BASEDIR}/data/images/ruport.png"  
+  image ruport, :at => [400,200], :width => 150 
+
+  ruport = "#{Prawn::BASEDIR}/data/images/ruport_transparent.png"  
+  image ruport, :at => [50,525] 
+end

data/examples/graphics/cmyk.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+#
+# Demonstrates Prawn's support for CMYK images and colors.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate("cmyk.pdf", :page_layout => :landscape) do
+  fill_color 50, 100, 0, 0
+  text "Prawn is CYMK Friendly"
+  fractal = "#{Prawn::BASEDIR}/data/images/fractal.jpg"
+  image fractal, :at => [50,450]
+end

data/examples/graphics/curves.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+#
+# Demonstrates simple curve and circle usage
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+pdf = Prawn::Document.new
+pdf.move_to [100,100]
+pdf.stroke_curve_to [50,50], :bounds => [[60,90], [60, 90]]  
+pdf.fill_circle_at [200,200], :radius => 10
+pdf.render_file "curves.pdf"

data/examples/graphics/hexagon.rb

@@ -0,0 +1,13 @@
+# encoding: utf-8
+#
+# Draws and fills a Hexagon using Document#polygon
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+pdf = Prawn::Document.new
+                        
+pdf.fill_color "ff0000"
+pdf.fill_polygon [100, 250], [200, 300], [300, 250],
+                 [300, 150], [200, 100], [100, 150]            
+
+pdf.render_file "hexagon.pdf"

data/examples/graphics/image_fit.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+#
+# Demonstrates fitting an image within a rectangular width and height.
+# The image will be scaled down to fit within the box, while preserving
+# the aspect ratio.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+   
+Prawn::Document.generate("image_fit.pdf", :page_layout => :landscape) do
+
+  pigs = "#{Prawn::BASEDIR}/data/images/pigs.jpg" 
+  stroke_rectangle [50,450], 200, 200
+  image pigs, :at => [50,450], :fit => [200,200]
+
+end

data/examples/graphics/image_flow.rb

@@ -0,0 +1,37 @@
+# encoding: utf-8
+#
+# Demonstrates automated flowing and positioning of images, as well as
+# aligining images along the x-axis via the :position argument.  This is
+# useful when used in combination with flowing text, where the exact final
+# position of the image is not known ahead of time.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+   
+Prawn::Document.generate("image-flow.pdf", :page_layout => :landscape) do  
+  self.font_size = 8                           
+  stef = "#{Prawn::BASEDIR}/data/images/stef.jpg"  
+  
+  text "Image at default position with no arguments"
+  
+  move_down 10
+  
+  image stef 
+  
+  text "Centered image flowing" 
+  
+  image stef, :position => :center   
+  
+  text "Right aligned image flowing"
+                 
+  image stef, :position => :right  
+  
+  text "Explicitly left aligned image flowing"
+                 
+  move_down 10                 
+                 
+  image stef, :position => :left     
+  
+  text "Flowing image at x=50"     
+  
+  image stef, :position => 50
+end

data/examples/graphics/image_position.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+#
+# Demonstrates vertical and horizontal positioning of images.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+   
+Prawn::Document.generate("image_position.pdf", :page_layout => :landscape) do
+
+  dice = "#{Prawn::BASEDIR}/data/images/dice.png"
+
+  image dice, :scale => 0.2, :position => :left,   :vposition => :top
+  image dice, :scale => 0.2, :position => :right,  :vposition => :top
+  image dice, :scale => 0.2, :position => :center, :vposition => :top
+  image dice, :scale => 0.2, :position => :center, :vposition => :center
+  image dice, :scale => 0.2, :position => :center, :vposition => :bottom
+  
+end

data/examples/graphics/line.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+#
+# The very first Prawn example.  Here for nostalgia's sake.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+ 
+pdf = Prawn::Document.new   
+pdf.line_width = 10    
+
+[[100,741,100,641], 
+ [100,691,150,691],
+ [150,741,150,641],
+ [200,741,200,641],   
+ [100,600,100,500],
+ [100,600,150,550],
+ [100,550,150,550],
+ [175,600,175,500], 
+ [175,600,225,550], 
+ [175,550,225,550],
+ [175,550,225,500],
+ [275,600,250,500],
+ [275,600,300,500],   
+ [250,550,300,550],
+ [315,600,350,500],
+ [350,500,365,550], 
+ [365,550,380,500],
+ [380,500,415,600], 
+ [430,600,430,500],
+ [430,600,465,500],
+ [465,600,465,500]].each { |points| pdf.stroke_line(*points) }
+
+pdf.render_file "lines.pdf"

data/examples/graphics/png_types.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+#
+# PNG files come in different flavours - 5 of them. This example embeds
+# one of each type as proof that they all work.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+images = [
+          ["Type 0", "#{Prawn::BASEDIR}/data/images/web-links.png"],
+          ["Type 2", "#{Prawn::BASEDIR}/data/images/ruport.png"],
+          ["Type 3", "#{Prawn::BASEDIR}/data/images/rails.png"],
+          ["Type 4", "#{Prawn::BASEDIR}/data/images/page_white_text.png"],
+          ["Type 6", "#{Prawn::BASEDIR}/data/images/dice.png"],
+]
+
+Prawn::Document.generate("png_types.pdf", :page_size => "A5") do
+  images.each do |header, file|
+    start_new_page unless header.include?("0")
+    text header
+    image file, :at => [50,450]
+  end
+end

data/examples/graphics/polygons.rb

@@ -0,0 +1,16 @@
+# encoding: utf-8
+# 
+# Basic polygon drawing example.  See also: hexagon.rb
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+pdf = Prawn::Document.new
+
+10.times do |i|
+  pdf.stroke_polygon [ 50 + i*25,   50 + i*25], 
+                     [100 + i*25,   50 + i*25],
+                     [100 + i*25,  100 + i*25] 
+  pdf.stroke_rectangle [0,600], 5*i, 10*i  
+end
+
+pdf.render_file "pretty_polygons.pdf"

data/examples/graphics/remote_images.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+#
+# Demonstrates how to use open-uri and Document#image to embed remote image
+# files.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+require "open-uri"
+
+Prawn::Document.generate("remote_images.pdf") do 
+  image open("http://prawn.majesticseacreature.com/media/prawn_logo.png")
+end

data/examples/graphics/rounded_polygons.rb

@@ -0,0 +1,19 @@
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+def radian(degree)
+  Math::PI/180*degree
+end
+
+def point_on_circle(center, radius, degrees)
+  [center[0] + radius*(Math.cos(radian(degrees))), center[1] - radius*(Math.sin(radian(degrees)))]
+end
+
+pdf = Prawn::Document.new
+
+pentagon_points = (0..4).map{|i| point_on_circle([200, 400], 100, i * 72)}
+pentagram_points = [0, 2, 4, 1, 3].map{|i| pentagon_points[i]}
+pdf.stroke_rounded_polygon(20, *pentagram_points)
+pdf.fill_and_stroke_rounded_polygon(10, [100, 250], [200, 300], [300, 250],
+                 [300, 150], [200, 100], [100, 150])
+
+pdf.render_file "rounded_polygon.pdf"

data/examples/graphics/rounded_rectangle.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+# 
+# Rounded rectangle example demonstrating both stroke and stroke and fill. 
+# A rectangle with rounded join_style is added just for comparison.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+pdf = Prawn::Document.new
+pdf.font_size 8
+pdf.draw_text "a stroked rounded rectangle:", :at => [30, 575]
+pdf.stroke_rounded_rectangle([50, 550], 50, 100, 10)
+pdf.draw_text "a stroked and filled rounded rectangle:", :at => [180, 575]
+pdf.fill_and_stroke_rounded_rectangle([200, 550], 50, 100, 10)
+pdf.draw_text "a regular rectangle with rounded join style;", :at => [330, 575]
+pdf.draw_text "needs thick line width for similar result:", :at => [330, 565]
+pdf.join_style :round
+pdf.line_width 10
+pdf.stroke_rectangle([350, 550], 50, 100)
+
+pdf.render_file "rounded_rectangle.pdf"

data/examples/graphics/ruport_style_helpers.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+#
+# These helpers will be familiar to Ruport users, and now are supported
+# directly in Prawn.   Run the example to see how they work.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+# Demonstrates some features stolen from Ruport::Formatter::PDF
+Prawn::Document.generate("ruport.pdf") do
+  move_down 50
+  # TODO: Figure out where to set the y cursor to.
+  stroke_horizontal_rule
+  text "Hi there"
+  pad(50) { text "I'm Padded" }
+  text "I'm far away"
+  stroke_horizontal_line 50, 100
+  stroke_horizontal_line 50, 100, :at => 300
+  stroke_vertical_line 300, 50, :at => 250
+end

data/examples/graphics/stroke_bounds.rb

@@ -0,0 +1,20 @@
+# 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.dirname(__FILE__)}/../example_helper.rb"
+
+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,45 @@
+# encoding: utf-8
+#
+# Stroke dashing can be applied to any line or curve
+
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,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/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
+
+