prawn 1.1.0 → 2.4.0

data/manual/graphics/common_lines.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # Prawn provides helpers for drawing some commonly used lines:
 #
 # <code>vertical_line</code> and <code>horizontal_line</code> do just what their
@@ -8,23 +8,22 @@
 #
 # <code>horizontal_rule</code> draws a horizontal line on the current bounding
 # box from border to border, using the current y position.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
   stroke_axis
 
-  stroke_color "ff0000"
+  stroke_color 'ff0000'
 
   stroke do
     # just lower the current y position
     move_down 50
     horizontal_rule
 
-    vertical_line   100, 300, :at => 50
+    vertical_line 100, 300, at: 50
 
-    horizontal_line 200, 500, :at => 150
+    horizontal_line 200, 500, at: 150
   end
 end

data/manual/graphics/fill_and_stroke.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # There are two drawing primitives in Prawn: <code>fill</code> and
 # <code>stroke</code>.
 #
@@ -17,9 +17,8 @@
 # Most of the methods which define drawing paths have methods of the same name
 # starting with stroke_ and fill_ which create the drawing path and then stroke
 # or fill it.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -34,7 +33,7 @@ Prawn::ManualBuilder::Example.generate(filename) do
 
   # With block
   stroke { line [200, 200], [300, 150] }
-  fill   { rectangle [200, 100], 100, 100 }
+  fill { rectangle [200, 100], 100, 100 }
 
   # Method hook
   stroke_line [400, 200], [500, 150]

data/manual/graphics/fill_rules.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # Prawn's fill operators (<code>fill</code> and <code>fill_and_stroke</code>
 # both accept a <code>:fill_rule</code> option. These rules determine which
 # parts of the page are counted as "inside" vs. "outside" the path. There are
@@ -15,9 +15,8 @@
 #
 # The differences between the fill rules only come into play with complex
 # paths; they are identical for simple shapes.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -26,12 +25,14 @@ Prawn::ManualBuilder::Example.generate(filename) do
   stroke_color 'ff0000'
   line_width 2
 
-  text_box "Nonzero Winding Number", :at => [50, 215], :width => 170,
-           :align => :center
-  polygon(*pentagram.map { |x, y| [x+50, y] })
+  text_box 'Nonzero Winding Number',
+    at: [50, 215],
+    width: 170,
+    align: :center
+  polygon(*pentagram.map { |x, y| [x + 50, y] })
   fill_and_stroke
 
-  text_box "Even-Odd", :at => [330, 215], :width => 170, :align => :center
-  polygon(*pentagram.map { |x, y| [x+330, y] })
-  fill_and_stroke(:fill_rule => :even_odd)
+  text_box 'Even-Odd', at: [330, 215], width: 170, align: :center
+  polygon(*pentagram.map { |x, y| [x + 330, y] })
+  fill_and_stroke(fill_rule: :even_odd)
 end

data/manual/graphics/gradients.rb

@@ -1,37 +1,43 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # Note that because of the way PDF renders radial gradients in order to get
 # solid fill your start circle must be fully inside your end circle.
 # Otherwise you will get triangle fill like illustrated in the example below.
 
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
-  stroke_axis
   self.line_width = 10
 
-  fill_gradient [50, 300], [150, 200], 'ff0000', '0000ff'
-  fill_rectangle [50, 300], 100, 100
+  # Linear Gradients
+  fill_gradient [0, 250], [100, 150], 'ff0000', '0000ff'
+  fill_rectangle [0, 250], 100, 100
+
+  stroke_gradient [150, 150], [250, 250], '00ffff', 'ffff00'
+  stroke_rectangle [150, 250], 100, 100
 
-  stroke_gradient [200, 200], [300, 300], '00ffff', 'ffff00'
-  stroke_rectangle [200, 300], 100, 100
+  fill_gradient [300, 250], [400, 150], 'ff0000', '0000ff'
+  stroke_gradient [300, 150], [400, 250], '00ffff', 'ffff00'
+  fill_and_stroke_rectangle [300, 250], 100, 100
 
-  fill_gradient [350, 300], [450, 200], 'ff0000', '0000ff'
-  stroke_gradient [350, 200], [450, 300], '00ffff', 'ffff00'
-  fill_and_stroke_rectangle [350, 300], 100, 100
+  rotate 45, origin: [500, 200] do
+    stops = { 0 => 'ff0000', 0.6 => '999900', 0.8 => '00cc00', 1 => '4444ff' }
+    fill_gradient from: [460, 240], to: [540, 160], stops: stops
+    fill_rectangle [460, 240], 80, 80
+  end
 
-  fill_gradient [100, 100], 0, [100, 100], 70.71, 'ff0000', '0000ff'
-  fill_rectangle [50, 150], 100, 100
+  # Radial gradients
+  fill_gradient [50, 50], 0, [50, 50], 70.71, 'ff0000', '0000ff'
+  fill_rectangle [0, 100], 100, 100
 
-  stroke_gradient [250, 100], 45, [250, 100], 70.71, '00ffff', 'ffff00'
-  stroke_rectangle [200, 150], 100, 100
+  stroke_gradient [200, 50], 45, [200, 50], 70.71, '00ffff', 'ffff00'
+  stroke_rectangle [150, 100], 100, 100
 
-  stroke_gradient [400, 100], 45, [400, 100], 70.71, '00ffff', 'ffff00'
-  fill_gradient [400, 100], 0, [400, 100], 70.71, 'ff0000', '0000ff'
-  fill_and_stroke_rectangle [350, 150], 100, 100
+  stroke_gradient [350, 50], 45, [350, 50], 70.71, '00ffff', 'ffff00'
+  fill_gradient [350, 50], 0, [350, 50], 70.71, 'ff0000', '0000ff'
+  fill_and_stroke_rectangle [300, 100], 100, 100
 
-  fill_gradient [500, 300], 15, [500, 50], 0, 'ff0000', '0000ff'
-  fill_rectangle [485, 300], 30, 250
+  fill_gradient [500, 100], 50, [500, 0], 0, 'ff0000', '0000ff'
+  fill_rectangle [450, 100], 100, 100
 end

data/manual/graphics/graphics.rb

@@ -1,58 +1,64 @@
-# encoding: utf-8
-#
-# Examples for the Graphics package.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+# frozen_string_literal: true
 
-Prawn::ManualBuilder::Example.generate("graphics.pdf", :page_size => "FOLIO") do
+# Examples for the Graphics package.
 
-  package "graphics" do |p|
+require_relative '../example_helper'
 
-    p.section "Basics" do |s|
-      s.example "helper"
-      s.example "fill_and_stroke"
+filename = File.basename(__FILE__).gsub('.rb', '.pdf')
+Prawn::ManualBuilder::Example.generate(filename, page_size: 'FOLIO') do
+  package 'graphics' do |p|
+    p.section 'Basics' do |s|
+      s.example 'helper'
+      s.example 'fill_and_stroke'
     end
 
-    p.section "Shapes" do |s|
-      s.example "lines_and_curves"
-      s.example "common_lines"
-      s.example "rectangle"
-      s.example "polygon"
-      s.example "circle_and_ellipse"
+    p.section 'Shapes' do |s|
+      s.example 'lines_and_curves'
+      s.example 'common_lines'
+      s.example 'rectangle'
+      s.example 'polygon'
+      s.example 'circle_and_ellipse'
     end
 
-    p.section "Fill and Stroke settings" do |s|
-      s.example "line_width"
-      s.example "stroke_cap"
-      s.example "stroke_join"
-      s.example "stroke_dash"
-      s.example "color"
-      s.example "gradients"
-      s.example "transparency"
-      s.example "soft_masks"
-      s.example "fill_rules"
+    p.section 'Fill and Stroke settings' do |s|
+      s.example 'line_width'
+      s.example 'stroke_cap'
+      s.example 'stroke_join'
+      s.example 'stroke_dash'
+      s.example 'color'
+      s.example 'gradients'
+      s.example 'transparency'
+      s.example 'soft_masks'
+      s.example 'blend_mode'
+      s.example 'fill_rules'
     end
 
-    p.section "Transformations" do |s|
-      s.example "rotate"
-      s.example "translate"
-      s.example "scale"
+    p.section 'Transformations' do |s|
+      s.example 'rotate'
+      s.example 'translate'
+      s.example 'scale'
     end
 
     p.intro do
-      prose("Here we show all the drawing methods provided by Prawn. Use them to draw the most beautiful imaginable things.
+      prose <<-TEXT
+        Here we show all the drawing methods provided by Prawn. Use them to draw
+        the most beautiful imaginable things.
 
-      Most of the content that you'll add to your pdf document will use the graphics package. Even text is rendered on a page just like a rectangle so even if you never use any of the shapes described here you should at least read the basic examples.
+        Most of the content that you'll add to your pdf document will use the
+        graphics package. Even text is rendered on a page just like a rectangle
+        so even if you never use any of the shapes described here you should at
+        least read the basic examples.
 
-      The examples show:")
+        The examples show:
+      TEXT
 
-      list( "All the possible ways that you can fill or stroke shapes on a page",
-            "How to draw all the shapes that Prawn has to offer from a measly line to a mighty polygon or ellipse",
-            "The configuration options for stroking lines and filling shapes",
-            "How to apply transformations to your drawing space"
-          )
+      list(
+        'All the possible ways that you can fill or stroke shapes on a page',
+        'How to draw all the shapes that Prawn has to offer from a measly '\
+          'line to a mighty polygon or ellipse',
+        'The configuration options for stroking lines and filling shapes',
+        'How to apply transformations to your drawing space'
+      )
     end
-
   end
 end

data/manual/graphics/helper.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # To produce this manual we use the <code>stroke_axis</code> helper method
 # within the examples.
 #
@@ -10,15 +10,25 @@
 # Note that the examples define a custom <code>:height</code> option so that
 # only the example canvas is used (as seen with the output of the first line of
 # the example code).
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
   stroke_axis
-  stroke_axis(:at => [70, 70], :height => 200, :step_length => 50,
-              :negative_axes_length => 5, :color => '0000FF')
-  stroke_axis(:at => [140, 140], :width => 200, :height => cursor.to_i - 140,
-              :step_length => 20, :negative_axes_length => 40, :color => 'FF00')
+  stroke_axis(
+    at: [70, 70],
+    height: 200,
+    step_length: 50,
+    negative_axes_length: 5,
+    color: '0000FF'
+  )
+  stroke_axis(
+    at: [140, 140],
+    width: 200,
+    height: cursor.to_i - 140,
+    step_length: 20,
+    negative_axes_length: 40,
+    color: 'FF0000'
+  )
 end

data/manual/graphics/line_width.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # The <code>line_width=</code> method sets the stroke width for subsequent
 # stroke calls.
 #
@@ -7,9 +7,9 @@
 # assignment is a local temporary, rather than a setter method, if you are using
 # the block call to <code>Prawn::Document.generate</code> without passing params
 # you will need to call <code>line_width</code> on self.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+# rubocop: disable Lint/UselessAssignment
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -19,13 +19,13 @@ Prawn::ManualBuilder::Example.generate(filename) do
 
   3.times do |i|
     case i
-    when 0 then line_width = 10        # This call will have no effect
+    when 0 then line_width = 10 # This call will have no effect
     when 1 then self.line_width = 10
     when 2 then self.line_width = 25
     end
 
     stroke do
-      horizontal_line 50, 150, :at => y
+      horizontal_line 50, 150, at: y
       rectangle [275, y + 25], 50, 50
       circle [500, y], 25
     end
@@ -33,3 +33,4 @@ Prawn::ManualBuilder::Example.generate(filename) do
     y -= 100
   end
 end
+# rubocop: enable Lint/UselessAssignment

data/manual/graphics/lines_and_curves.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # Prawn supports drawing both lines and curves starting either at the current
 # position, or from a specified starting position.
 #
@@ -14,9 +14,8 @@
 #
 # Both curve methods define a Bezier curve bounded by two aditional points
 # provided as the <code>:bounds</code> param.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -29,13 +28,13 @@ Prawn::ManualBuilder::Example.generate(filename) do
     line_to 100, 100
     line_to 0, 100
 
-    curve_to [150, 250], :bounds => [[20, 200], [120, 200]]
-    curve_to [200, 0],   :bounds => [[150, 200], [450, 10]]
+    curve_to [150, 250], bounds: [[20, 200], [120, 200]]
+    curve_to [200, 0], bounds: [[150, 200], [450, 10]]
   end
 
   # line and curve
   stroke do
-    line [300,200], [400,50]
-    curve [500, 0], [400, 200], :bounds => [[600, 300], [300, 390]]
+    line [300, 200], [400, 50]
+    curve [500, 0], [400, 200], bounds: [[600, 300], [300, 390]]
   end
 end

data/manual/graphics/polygon.rb

@@ -1,14 +1,13 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # Drawing polygons in Prawn is easy, just pass a sequence of points to one of
 # the polygon family of methods.
 #
 # Just like <code>rounded_rectangle</code> we also have
 # <code>rounded_polygon</code>. The only difference is the radius param comes
 # before the polygon points.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -18,12 +17,11 @@ Prawn::ManualBuilder::Example.generate(filename) do
   stroke_polygon [50, 200], [50, 300], [150, 300]
 
   # Hexagon
-  fill_polygon [50, 150], [150, 200], [250, 150],
-               [250, 50], [150, 0], [50, 50]
+  fill_polygon [50, 150], [150, 200], [250, 150], [250, 50], [150, 0], [50, 50]
 
   # Pentagram
   pentagon_points = [500, 100], [430, 5], [319, 41], [319, 159], [430, 195]
-  pentagram_points = [0, 2, 4, 1, 3].map{ |i| pentagon_points[i] }
+  pentagram_points = [0, 2, 4, 1, 3].map { |i| pentagon_points[i] }
 
   stroke_rounded_polygon(20, *pentagram_points)
 end

data/manual/graphics/rectangle.rb

@@ -1,13 +1,12 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # To draw a rectangle, just provide the upper-left corner, width and height to
 # the <code>rectangle</code> method.
 #
 # There's also <code>rounded_rectangle</code>. Just provide an additional radius
 # value for the rounded corners.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do

data/manual/graphics/rotate.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # This transformation is used to rotate the user space. Give it an angle
 # and an <code>:origin</code> point about which to rotate and a block.
 # Everything inside the block will be drawn with the rotated coordinates.
@@ -7,9 +7,8 @@
 # The angle is in degrees.
 #
 # If you omit the <code>:origin</code> option the page origin will be used.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -18,11 +17,9 @@ Prawn::ManualBuilder::Example.generate(filename) do
   fill_circle [250, 200], 2
 
   12.times do |i|
-
-    rotate(i * 30, :origin => [250, 200]) do
-
+    rotate(i * 30, origin: [250, 200]) do
       stroke_rectangle [350, 225], 100, 50
-      draw_text "Rotated #{i * 30}°", :size => 10, :at => [360, 205]
+      draw_text "Rotated #{i * 30}°", size: 10, at: [360, 205]
     end
   end
 end

data/manual/graphics/scale.rb

@@ -1,13 +1,12 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # This transformation is used to scale the user space. Give it an scale factor
 # and an <code>:origin</code> point and everything inside the block will be
 # scaled using the origin point as reference.
 #
 # If you omit the <code>:origin</code> option the page origin will be used.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -20,22 +19,24 @@ Prawn::ManualBuilder::Example.generate(filename) do
   y = 200
 
   stroke_rectangle [x, y], width, height
-  text_box "reference rectangle", :at => [x + 10, y - 10], :width => width - 20
+  text_box 'reference rectangle', at: [x + 10, y - 10], width: width - 20
 
-  scale(2, :origin => [x, y]) do
+  scale(2, origin: [x, y]) do
     stroke_rectangle [x, y], width, height
-    text_box "rectangle scaled from upper-left corner",
-              :at => [x, y - height - 5], :width => width
+    text_box 'rectangle scaled from upper-left corner',
+      at: [x, y - height - 5],
+      width: width
   end
 
   x = 350
 
   stroke_rectangle [x, y], width, height
-  text_box "reference rectangle", :at => [x + 10, y - 10], :width => width - 20
+  text_box 'reference rectangle', at: [x + 10, y - 10], width: width - 20
 
-  scale(2, :origin => [x + width / 2, y - height / 2]) do
+  scale(2, origin: [x + width / 2, y - height / 2]) do
     stroke_rectangle [x, y], width, height
-    text_box "rectangle scaled from center",
-              :at => [x, y - height - 5], :width => width
+    text_box 'rectangle scaled from center',
+      at: [x, y - height - 5],
+      width: width
   end
 end

data/manual/graphics/soft_masks.rb

@@ -1,6 +1,6 @@
-# encoding: utf-8
-#
-# Soft masks are user for more complex alpha channel manipulations. You can use
+# frozen_string_literal: true
+
+# Soft masks are used for more complex alpha channel manipulations. You can use
 # arbitrary drawing functions for creation of soft masks. The resulting alpha
 # channel is made of greyscale version of the drawing (luminosity channel to be
 # precise). So while you can use any combination of colors for soft masks it's
@@ -11,8 +11,7 @@
 # only to a part of page you need to enclose drawing instructions in
 # <code>save_graphics_state</code> block.
 
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -42,5 +41,4 @@ Prawn::ManualBuilder::Example.generate(filename) do
     fill_color '61bb46'
     fill_rectangle [0, 160], 600, 20
   end
-
 end

data/manual/graphics/stroke_cap.rb

@@ -1,5 +1,5 @@
-# encoding: utf-8
-#
+# frozen_string_literal: true
+
 # The cap style defines how the edge of a line or curve will be drawn. There are
 # three types: <code>:butt</code> (the default), <code>:round</code> and
 # <code>:projecting_square</code>
@@ -11,9 +11,8 @@
 #
 # Just like <code>line_width=</code> the <code>cap_style=</code> method needs an
 # explicit receiver to work.
-#
-require File.expand_path(File.join(File.dirname(__FILE__),
-                                   %w[.. example_helper]))
+
+require_relative '../example_helper'
 
 filename = File.basename(__FILE__).gsub('.rb', '.pdf')
 Prawn::ManualBuilder::Example.generate(filename) do
@@ -21,11 +20,11 @@ Prawn::ManualBuilder::Example.generate(filename) do
 
   self.line_width = 25
 
-  [:butt, :round, :projecting_square].each_with_index do |cap, i|
+  %i[butt round projecting_square].each_with_index do |cap, i|
     self.cap_style = cap
 
-    y = 250 - i*100
-    stroke_horizontal_line 100, 300, :at => y
+    y = 250 - i * 100
+    stroke_horizontal_line 100, 300, at: y
     stroke_circle [400, y], 15
   end
 end