alphasights-prawn 0.10.0

data/examples/graphics/chunkable.rb

@@ -0,0 +1,38 @@
+$LOAD_PATH.unshift "#{File.dirname(__FILE__)}/../../lib"
+require "rubygems"
+require "prawn"
+
+def paint(canvas, filename)
+  doc = Prawn::Document.new
+  doc.add_content(canvas.to_pdf)
+  doc.render_file(filename)
+end
+
+canvas = Prawn::Canvas.new
+canvas.line(:point1 => [100,100], :point2 => [150,175])
+
+canvas.curve(:point1 => [100,100],
+             :point2 => [50,50], 
+             :bound1 => [60,90],
+             :bound2 => [60,90])
+
+canvas.rectangle(:point => [200,200], :width => 50, :height => 75)
+
+canvas.stroke
+
+canvas.ellipse(:point => [200,200], :x_radius => 10, :y_radius => 20)
+
+canvas.fill
+
+circle = canvas.circle!(:point => [250,200], :radius => 20)
+puts circle.to_pdf
+circle[:radius] = 50
+
+canvas.chunks << circle
+
+canvas.stroke
+
+paint(canvas, "x.pdf")
+
+canvas.find_chunks(:command => :line).first[:point2] = [150, 300]
+paint(canvas, "y.pdf")

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