alphasights-prawn 0.10.0

data/examples/text/shaped_text_box.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+#
+# Demonstrates extending Text::Box
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,17 @@
+# encoding: utf-8
+#
+# An early example of basic text generation at absolute positions.
+# Mostly kept for nostalgia.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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,17 @@
+# encoding: utf-8
+#
+# An early example of TTF font embedding.  Mostly kept for nostalgia's sake.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+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/text_box.rb

@@ -0,0 +1,88 @@
+# encoding: utf-8
+#
+
+require 'examples/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

data/examples/text/text_box_returning_excess.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+#
+# A text box is positioned by a top-left corner, width, and height and is
+# essentially an invisible rectangle that the text will flow within.  If the
+# text exceeds the boundaries, it is either truncated, replaced with some
+# ellipses, or set to expand beyond the bottom boundary.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+Prawn::Document.generate("text_box_returning_excess.pdf") do
+
+  # Note that without the initial space in p_break, newlines may be eaten by
+  # the wrap/unwrap process that happens inside the text box.
+  p_break = " \n\n"
+  callout = "Lorem ipsum dolor sit amet"
+  lorem   = "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.#{p_break}Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.#{p_break}Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
+
+  box_height = font.height * 5
+
+  # Add a callout box that the rest of the text should flow around
+  font_size(18) do
+    text_box callout, {
+      :width    => 100,
+      :height   => font.height * 3,
+      :overflow => :truncate,
+      :at       => [100, bounds.top - box_height - 4]
+    }
+  end
+
+  excess_text = text_box lorem + p_break + lorem, {
+    :width    => 300,
+    :height   => box_height,
+    :overflow => :truncate,
+    :at       => [100, bounds.top],
+  }
+
+  excess_text = text_box excess_text, {
+    :width    => 200,
+    :height   => box_height,
+    :overflow => :truncate,
+    :at       => [200, bounds.top - box_height],
+  }
+
+  text_box excess_text, {
+    :width    => 300,
+    :height   => box_height,
+    :overflow => :expand,
+    :at       => [100, bounds.top - box_height * 2],
+  }
+
+end

data/examples/text/text_flow.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+# 
+# Basic text flowing example including the use of bounding boxes.  A somewhat
+# old example, mostly retained for nostalgia.
+#
+require "#{File.dirname(__FILE__)}/../example_helper.rb"
+
+content = <<-EOS
+How does
+Prawn    deal     with
+   white
+     space 
+     
+       and
+       
+       line
+       breaks?
+EOS
+
+poem = <<-EOS
+GOOD-BYE
+
+Good-bye, proud world! I'm going home: Thou art not my friend, and I'm not thine. Long through thy weary crowds I roam; A river-ark on the ocean brine, Long I've been tossed like the driven foam: But now, proud world! I'm going home.
+
+Good-bye to Flattery's fawning face; To Grandeur with his wise grimace; To upstart Wealth's averted eye; To supple Office, low and high; To crowded halls, to court and street; To frozen hearts and hasting feet; To those who go, and those who come; Good-bye, proud world! I'm going home.
+
+I am going to my own hearth-stone, Bosomed in yon green hills alone,-- secret nook in a pleasant land, Whose groves the frolic fairies planned; Where arches green, the livelong day, Echo the blackbird's roundelay, And vulgar feet have never trod A spot that is sacred to thought and God.
+
+O, when I am safe in my sylvan home, I tread on the pride of Greece and Rome; And when I am stretched beneath the pines, Where the evening star so holy shines, I laugh at the lore and the pride of man, At the sophist schools and the learned clan; For what are they all, in their high conceit, When man in the bush with God may meet?
+EOS
+
+overflow = "This text should flow gracefully onto the next page, like a stream"+
+           " flows elegantly from a mountain lake down into the village below."
+
+Prawn::Document.generate("flow.pdf") do |pdf|
+
+  pdf.font "Times-Roman"
+  pdf.stroke_line [pdf.bounds.left,  pdf.bounds.top],
+                  [pdf.bounds.right, pdf.bounds.top]
+  
+  pdf.text content, :size => 10
+               
+  pdf.bounding_box([100,600], :width => 200, :height => 525) do
+    pdf.stroke_line [pdf.bounds.left,  pdf.bounds.top],
+                    [pdf.bounds.right, pdf.bounds.top]
+    pdf.text poem, :size => 12
+  end
+  
+  pdf.bounding_box([325,600], :width => 200, :height => 525) do
+    pdf.stroke_line [pdf.bounds.left,  pdf.bounds.top],
+                    [pdf.bounds.right, pdf.bounds.top]
+    pdf.text poem.reverse, :size => 12
+  end
+  
+  pdf.text overflow * 10, :size => 14
+  
+  pdf.text "Hooray! We've conquered the evil PDF gods", :size => 36
+               
+  pdf.bounding_box([100,450], :width => 300) do
+    pdf.stroke_line [pdf.bounds.left,  pdf.bounds.top],
+                    [pdf.bounds.right, pdf.bounds.top]
+    pdf.text poem, :size => 10, :leading => 5
+  end
+  
+  pdf.text "And this text automatically goes below the poem", :size => 18
+  
+end

data/lib/prawn.rb

@@ -0,0 +1,27 @@
+# Welcome to Prawn, the best PDF Generation library ever.
+# This documentation covers user level functionality.
+#
+# Those looking to contribute code or write extensions should look
+# into the lib/prawn/core/* source tree.
+#
+module Prawn #:nodoc:
+end
+
+require "prawn/core"
+require "prawn/chunkable"
+require "prawn/canvas"
+require "prawn/text"
+require "prawn/graphics"
+require "prawn/images"
+require "prawn/images/jpg"
+require "prawn/images/png"
+require "prawn/stamp"
+require "prawn/security"
+require "prawn/document"
+require "prawn/font"
+require "prawn/encoding"
+require "prawn/measurements"
+require "prawn/repeater"
+require "prawn/outline"
+require "prawn/table"
+require "prawn/document_builder"

data/lib/prawn/canvas.rb

@@ -0,0 +1,119 @@
+module Prawn
+  class Canvas
+    include Prawn::Chunkable
+
+    def initialize
+      @chunks = []
+    end
+
+    attr_accessor :chunks
+
+    chunk_methods :move_to, :line_to, :line, :stroke, :fill,
+                  :curve_to, :curve, :rectangle, :ellipse, :circle
+
+    def move_to!(params)
+      chunk(:move_to, params) do |c|
+        "%.3f %.3f m" % c[:point]
+      end
+    end
+
+    def line_to!(params)
+      chunk(:line_to, params) do |c|
+        "%.3f %.3f l" % c[:point]
+      end
+    end
+
+    def curve_to!(params)
+      unless params[:bound1] && params[:bound2]
+        raise Prawn::Errors::InvalidGraphicsPath
+      end
+
+      chunk(:curve_to, params) do |c|
+        "%.3f %.3f %.3f %.3f %.3f %.3f c" % (c[:bound1] + c[:bound2] + c[:point])
+      end
+    end
+
+    def curve!(params)
+      chunk(:curve, params) do |c|
+        [ move_to!(:point => params[:point1]),
+          curve_to!(:point  => params[:point2],
+                    :bound1 => params[:bound1],
+                    :bound2 => params[:bound2]) ]
+
+      end
+    end
+    
+    KAPPA = 4.0 * ((Math.sqrt(2) - 1.0) / 3.0)
+
+    def ellipse!(params)
+      chunk(:ellipse, params) do |c|
+        x, y = c[:point]
+        r1   = c[:x_radius]
+        r2   = c[:y_radius]
+
+        l1 = r1 * KAPPA
+        l2 = r2 * KAPPA
+
+        start          =  move_to!(:point => [x + r1, y])
+
+        to_upper_right = curve_to!(:point  => [x,  y + r2],
+                                   :bound1 => [x + r1, y + l1], 
+                                   :bound2 => [x + l2, y + r2])
+        to_upper_left = curve_to!(:point => [x - r1, y],
+                                  :bound1 => [x - l2, y + r2],
+                                  :bound2 => [x - r1, y + l1])
+        
+        to_lower_left = curve_to!(:point => [x, y - r2],
+                                  :bound1 => [x - r1, y - l1], 
+                                  :bound2 => [x - l2, y - r2])
+
+        to_lower_right = curve_to!(:point  => [x + r1, y],
+                                   :bound1 => [x + l2, y - r2], 
+                                   :bound2 => [x + r1, y - l1])
+
+        back_to_start = move_to!(:point => [x,y])
+
+        [start, to_upper_right, to_upper_left,
+                to_lower_left,  to_lower_right, back_to_start]
+      end
+    end
+
+    def circle!(params)
+      chunk(:circle, params) do
+        ellipse!(:point    => params[:point],
+                 :x_radius => params[:radius],
+                 :y_radius => params[:radius]) 
+                    
+      end
+    end
+
+    def line!(params)
+      chunk(:line, params) do |c|
+        [ move_to!(:point => c.params[:point1]), 
+          line_to!(:point => c.params[:point2]) ]
+      end
+    end
+
+    def stroke!
+      chunk(:stroke) { "S" }
+    end
+
+    def fill!
+      chunk(:fill) { "F" }
+    end
+
+    def fill_and_stroke!
+      chunk(:fill_and_stroke) { "b" }
+    end
+     
+    def rectangle!(params)
+      chunk(:rectangle, params) do |c|
+        x,y = params[:point]
+        y  -= params[:height]
+
+        "%.3f %.3f %.3f %.3f re" % [ x, y, params[:width], params[:height] ]
+      end
+    end
+
+  end
+end

data/lib/prawn/chunkable.rb

@@ -0,0 +1,37 @@
+module Prawn
+  module Chunkable
+    def chunk(*a, &b)
+      Prawn::Core::Chunk.new(*a, &b)
+    end
+
+    def find_chunks(params)
+      if params[:command]
+        chunks.select { |c| c.command == params[:command] }
+      end
+    end
+
+    def to_pdf
+      rendered = @chunks.map do |chunk| 
+        chunk.to_pdf
+      end
+      
+      rendered.join("\n")
+    end
+
+    module ClassMethods
+      def chunk_methods(*names)
+        names.each do |name|
+          module_eval %{
+            def #{name}(*a, &b)
+              chunks << #{name}!(*a, &b)
+            end
+          }
+        end
+      end
+    end
+
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+  end
+end