squib 0.14.2 → 0.14.3.pre1

data/lib/squib/api/image.rb

@@ -1,49 +1,49 @@
-require_relative '../args/card_range'
-require_relative '../args/paint'
-require_relative '../args/scale_box'
-require_relative '../args/transform'
-require_relative '../args/input_file'
-require_relative '../args/svg_special'
-
-module Squib
-  class Deck
-
-    # DSL method. See http://squib.readthedocs.io
-    def png(opts = {})
-      Dir.chdir(img_dir) do
-        range = Args::CardRange.new(opts[:range], deck_size: size)
-        paint = Args::Paint.new(custom_colors).load!(opts, expand_by: size, layout: layout)
-        box   = Args::ScaleBox.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-        trans = Args::Transform.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-        ifile = Args::InputFile.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-        @progress_bar.start('Loading PNG(s)', range.size) do |bar|
-          range.each do |i|
-            @cards[i].png(ifile[i].file, box[i], paint[i], trans[i])
-            bar.increment
-          end
-        end
-      end
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def svg(opts = {})
-      Dir.chdir(img_dir) do
-        range = Args::CardRange.new(opts[:range], deck_size: size)
-        paint = Args::Paint.new(custom_colors).load!(opts, expand_by: size, layout: layout)
-        box   = Args::ScaleBox.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-        trans = Args::Transform.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-        ifile = Args::InputFile.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-        svg_args = Args::SvgSpecial.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-        @progress_bar.start('Loading SVG(s)', range.size) do |bar|
-          range.each do |i|
-            if svg_args.render?(i)
-              @cards[i].svg(ifile[i].file, svg_args[i], box[i], paint[i], trans[i])
-            end
-            bar.increment
-          end
-        end
-      end
-    end
-
-  end
-end
+require_relative '../args/card_range'
+require_relative '../args/paint'
+require_relative '../args/scale_box'
+require_relative '../args/transform'
+require_relative '../args/input_file'
+require_relative '../args/svg_special'
+
+module Squib
+  class Deck
+
+    # DSL method. See http://squib.readthedocs.io
+    def png(opts = {})
+      Dir.chdir(img_dir) do
+        range = Args::CardRange.new(opts[:range], deck_size: size)
+        paint = Args::Paint.new(custom_colors).load!(opts, expand_by: size, layout: layout)
+        box   = Args::ScaleBox.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+        trans = Args::Transform.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+        ifile = Args::InputFile.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+        @progress_bar.start('Loading PNG(s)', range.size) do |bar|
+          range.each do |i|
+            @cards[i].png(ifile[i].file, box[i], paint[i], trans[i])
+            bar.increment
+          end
+        end
+      end
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def svg(opts = {})
+      Dir.chdir(img_dir) do
+        range = Args::CardRange.new(opts[:range], deck_size: size)
+        paint = Args::Paint.new(custom_colors).load!(opts, expand_by: size, layout: layout)
+        box   = Args::ScaleBox.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+        trans = Args::Transform.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+        ifile = Args::InputFile.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+        svg_args = Args::SvgSpecial.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+        @progress_bar.start('Loading SVG(s)', range.size) do |bar|
+          range.each do |i|
+            if svg_args.render?(i)
+              @cards[i].svg(ifile[i].file, svg_args[i], box[i], paint[i], trans[i])
+            end
+            bar.increment
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/squib/api/save.rb

@@ -1,83 +1,83 @@
-require_relative '../args/card_range'
-require_relative '../args/hand_special'
-require_relative '../args/save_batch'
-require_relative '../args/sheet'
-require_relative '../args/showcase_special'
-require_relative '../args/sprue_file'
-require_relative '../graphics/save_pdf'
-require_relative '../graphics/save_sprue'
-require_relative '../sprues/sprue'
-
-module Squib
-  class Deck
-
-    # DSL method. See http://squib.readthedocs.io
-    def save(opts = {})
-      save_png(opts) if Array(opts[:format]).include? :png
-      save_pdf(opts) if Array(opts[:format]).include? :pdf
-      self
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def save_pdf(opts = {})
-      range = Args::CardRange.new(opts[:range], deck_size: size)
-      sheet = Args::Sheet.new(custom_colors, { file: 'output.pdf' }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      sprue_file = Args::SprueFile.new.load!(opts, expand_by: size)
-
-      if sprue_file.sprue.nil?
-        Graphics::SavePDF.new(self).render_pdf(range, sheet)
-      else
-        tmpl = Sprue.load sprue_file.sprue, dpi
-        Graphics::SaveSpruePDF.
-          new(self, tmpl, sheet).
-          render_sheet(range)
-      end
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def save_png(opts = {})
-      range = Args::CardRange.new(opts[:range], deck_size: size)
-      batch = Args::SaveBatch.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      @progress_bar.start("Saving PNGs to #{batch.summary}", size) do |bar|
-        range.each do |i|
-          @cards[i].save_png(batch[i])
-          bar.increment
-        end
-      end
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def save_sheet(opts = {})
-      range = Args::CardRange.new(opts[:range], deck_size: size)
-      batch = Args::SaveBatch.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      sheet = Args::Sheet.new(custom_colors, { margin: 0 }, size).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      sprue_file = Args::SprueFile.new.load!(opts, expand_by: size)
-
-      if sprue_file.sprue.nil?
-        render_sheet(range, batch, sheet)
-      else
-        tmpl = Sprue.load sprue_file.sprue, dpi
-        Graphics::SaveSpruePNG.
-          new(self, tmpl, sheet).
-          render_sheet(range)
-      end
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def showcase(opts = {})
-      range    = Args::CardRange.new(opts[:range], deck_size: size)
-      showcase = Args::ShowcaseSpecial.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      sheet    = Args::Sheet.new(custom_colors, { file: 'showcase.png' }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      render_showcase(range, sheet, showcase)
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def hand(opts = {})
-      range = Args::CardRange.new(opts[:range], deck_size: size)
-      hand  = Args::HandSpecial.new(height).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      sheet = Args::Sheet.new(custom_colors, { file: 'hand.png', trim_radius: 0 }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      render_hand(range, sheet, hand)
-    end
-
-  end
-end
+require_relative '../args/card_range'
+require_relative '../args/hand_special'
+require_relative '../args/save_batch'
+require_relative '../args/sheet'
+require_relative '../args/showcase_special'
+require_relative '../args/sprue_file'
+require_relative '../graphics/save_pdf'
+require_relative '../graphics/save_sprue'
+require_relative '../sprues/sprue'
+
+module Squib
+  class Deck
+
+    # DSL method. See http://squib.readthedocs.io
+    def save(opts = {})
+      save_png(opts) if Array(opts[:format]).include? :png
+      save_pdf(opts) if Array(opts[:format]).include? :pdf
+      self
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def save_pdf(opts = {})
+      range = Args::CardRange.new(opts[:range], deck_size: size)
+      sheet = Args::Sheet.new(custom_colors, { file: 'output.pdf' }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      sprue_file = Args::SprueFile.new.load!(opts, expand_by: size)
+
+      if sprue_file.sprue.nil?
+        Graphics::SavePDF.new(self).render_pdf(range, sheet)
+      else
+        tmpl = Sprue.load sprue_file.sprue, dpi
+        Graphics::SaveSpruePDF.
+          new(self, tmpl, sheet).
+          render_sheet(range)
+      end
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def save_png(opts = {})
+      range = Args::CardRange.new(opts[:range], deck_size: size)
+      batch = Args::SaveBatch.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      @progress_bar.start("Saving PNGs to #{batch.summary}", size) do |bar|
+        range.each do |i|
+          @cards[i].save_png(batch[i])
+          bar.increment
+        end
+      end
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def save_sheet(opts = {})
+      range = Args::CardRange.new(opts[:range], deck_size: size)
+      batch = Args::SaveBatch.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      sheet = Args::Sheet.new(custom_colors, { margin: 0 }, size).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      sprue_file = Args::SprueFile.new.load!(opts, expand_by: size)
+
+      if sprue_file.sprue.nil?
+        render_sheet(range, batch, sheet)
+      else
+        tmpl = Sprue.load sprue_file.sprue, dpi
+        Graphics::SaveSpruePNG.
+          new(self, tmpl, sheet).
+          render_sheet(range)
+      end
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def showcase(opts = {})
+      range    = Args::CardRange.new(opts[:range], deck_size: size)
+      showcase = Args::ShowcaseSpecial.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      sheet    = Args::Sheet.new(custom_colors, { file: 'showcase.png' }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      render_showcase(range, sheet, showcase)
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def hand(opts = {})
+      range = Args::CardRange.new(opts[:range], deck_size: size)
+      hand  = Args::HandSpecial.new(height).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      sheet = Args::Sheet.new(custom_colors, { file: 'hand.png', trim_radius: 0 }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      render_hand(range, sheet, hand)
+    end
+
+  end
+end

data/lib/squib/api/settings.rb

@@ -1,21 +1,21 @@
-module Squib
-  class Deck
-
-    # DSL method. See http://squib.readthedocs.io
-    def hint(text: :off)
-      conf.text_hint = text
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def set(opts = {})
-      raise 'DEPRECATED: As of v0.7 img_dir is no longer supported in "set". Use config.yml instead.' if opts.key? :img_dir
-      @font = (opts[:font] == :default) ? Squib::DEFAULT_FONT : opts[:font]
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def use_layout(file: 'layout.yml')
-      @layout = LayoutParser.new(@dpi).load_layout(file, @layout)
-    end
-
-  end
-end
+module Squib
+  class Deck
+
+    # DSL method. See http://squib.readthedocs.io
+    def hint(text: :off)
+      conf.text_hint = text
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def set(opts = {})
+      raise 'DEPRECATED: As of v0.7 img_dir is no longer supported in "set". Use config.yml instead.' if opts.key? :img_dir
+      @font = (opts[:font] == :default) ? Squib::DEFAULT_FONT : opts[:font]
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def use_layout(file: 'layout.yml')
+      @layout = LayoutParser.new(@dpi).load_layout(file, @layout)
+    end
+
+  end
+end

data/lib/squib/api/shapes.rb

@@ -1,124 +1,124 @@
-require_relative '../args/box'
-require_relative '../args/draw'
-require_relative '../args/card_range'
-require_relative '../args/transform'
-require_relative '../args/coords'
-
-module Squib
-  class Deck
-
-    # DSL method. See http://squib.readthedocs.io
-    def rect(opts = {})
-      range = Args::CardRange.new(opts[:range], deck_size: size)
-      box   = Args::Box.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      draw  = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].rect(box[i], draw[i], trans[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def circle(opts = {})
-      range  = Args::CardRange.new(opts[:range], deck_size: size)
-      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].circle(coords[i], draw[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def ellipse(opts = {})
-      range = Args::CardRange.new(opts[:range], deck_size: size)
-      draw  = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      box   = Args::Box.new(self, { width: '0.25in', height: '0.25in' }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].ellipse(box[i], draw[i], trans[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def grid(opts = {})
-      range = Args::CardRange.new(opts[:range], deck_size: size)
-      draw  = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      box   = Args::Box.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].grid(box[i], draw[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def triangle(opts = {})
-      range  = Args::CardRange.new(opts[:range], deck_size: size)
-      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].triangle(coords[i], draw[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def line(opts = {})
-      range   = Args::CardRange.new(opts[:range], deck_size: size)
-      draw    = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      coords  = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].line(coords[i], draw[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def curve(opts = {})
-      range  = Args::CardRange.new(opts[:range], deck_size: size)
-      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].curve(coords[i], draw[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def star(opts = {})
-      range  = Args::CardRange.new(opts[:range], deck_size: size)
-      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].star(coords[i], trans[i], draw[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def polygon(opts = {})
-      range  = Args::CardRange.new(opts[:range], deck_size: size)
-      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
-      range.each { |i| @cards[i].polygon(coords[i], trans[i], draw[i]) }
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def safe_zone(opts = {})
-      safe_defaults = {
-        margin: '0.25in',
-        radius: '0.125in',
-        stroke_color: :blue,
-        fill_color: '#0000',
-        stroke_width: 1.0,
-        dash: '3 3',
-      }
-      new_opts = safe_defaults.merge(opts)
-      margin = Args::UnitConversion.parse new_opts[:margin]
-      new_opts[:x] = margin
-      new_opts[:y] = margin
-      new_opts[:width] = width - (2 * margin)
-      new_opts[:height] = height - (2 * margin)
-      rect new_opts
-    end
-
-    # DSL method. See http://squib.readthedocs.io
-    def cut_zone(opts = {})
-      safe_defaults = {
-        margin: '0.125in',
-        radius: '0.125in',
-        stroke_color: :red,
-        fill_color: '#0000',
-        stroke_width: 2.0,
-      }
-      new_opts = safe_defaults.merge(opts)
-      margin = Args::UnitConversion.parse new_opts[:margin]
-      new_opts[:x] = margin
-      new_opts[:y] = margin
-      new_opts[:width] = width - (2 * margin)
-      new_opts[:height] = height - (2 * margin)
-      rect new_opts
-    end
-
-  end
-end
+require_relative '../args/box'
+require_relative '../args/draw'
+require_relative '../args/card_range'
+require_relative '../args/transform'
+require_relative '../args/coords'
+
+module Squib
+  class Deck
+
+    # DSL method. See http://squib.readthedocs.io
+    def rect(opts = {})
+      range = Args::CardRange.new(opts[:range], deck_size: size)
+      box   = Args::Box.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      draw  = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].rect(box[i], draw[i], trans[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def circle(opts = {})
+      range  = Args::CardRange.new(opts[:range], deck_size: size)
+      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].circle(coords[i], draw[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def ellipse(opts = {})
+      range = Args::CardRange.new(opts[:range], deck_size: size)
+      draw  = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      box   = Args::Box.new(self, { width: '0.25in', height: '0.25in' }).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].ellipse(box[i], draw[i], trans[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def grid(opts = {})
+      range = Args::CardRange.new(opts[:range], deck_size: size)
+      draw  = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      box   = Args::Box.new(self).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].grid(box[i], draw[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def triangle(opts = {})
+      range  = Args::CardRange.new(opts[:range], deck_size: size)
+      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].triangle(coords[i], draw[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def line(opts = {})
+      range   = Args::CardRange.new(opts[:range], deck_size: size)
+      draw    = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      coords  = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].line(coords[i], draw[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def curve(opts = {})
+      range  = Args::CardRange.new(opts[:range], deck_size: size)
+      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].curve(coords[i], draw[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def star(opts = {})
+      range  = Args::CardRange.new(opts[:range], deck_size: size)
+      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].star(coords[i], trans[i], draw[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def polygon(opts = {})
+      range  = Args::CardRange.new(opts[:range], deck_size: size)
+      draw   = Args::Draw.new(custom_colors).load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      coords = Args::Coords.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      trans  = Args::Transform.new.load!(opts, expand_by: size, layout: layout, dpi: dpi)
+      range.each { |i| @cards[i].polygon(coords[i], trans[i], draw[i]) }
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def safe_zone(opts = {})
+      safe_defaults = {
+        margin: '0.25in',
+        radius: '0.125in',
+        stroke_color: :blue,
+        fill_color: '#0000',
+        stroke_width: 1.0,
+        dash: '3 3',
+      }
+      new_opts = safe_defaults.merge(opts)
+      margin = Args::UnitConversion.parse new_opts[:margin]
+      new_opts[:x] = margin
+      new_opts[:y] = margin
+      new_opts[:width] = width - (2 * margin)
+      new_opts[:height] = height - (2 * margin)
+      rect new_opts
+    end
+
+    # DSL method. See http://squib.readthedocs.io
+    def cut_zone(opts = {})
+      safe_defaults = {
+        margin: '0.125in',
+        radius: '0.125in',
+        stroke_color: :red,
+        fill_color: '#0000',
+        stroke_width: 2.0,
+      }
+      new_opts = safe_defaults.merge(opts)
+      margin = Args::UnitConversion.parse new_opts[:margin]
+      new_opts[:x] = margin
+      new_opts[:y] = margin
+      new_opts[:width] = width - (2 * margin)
+      new_opts[:height] = height - (2 * margin)
+      rect new_opts
+    end
+
+  end
+end