squib 0.14.1 → 0.14.2

data/lib/squib/deck.rb

@@ -1,116 +1,116 @@
-require 'forwardable'
-require 'pp'
-require_relative '../squib'
-require_relative 'args/unit_conversion'
-require_relative 'card'
-require_relative 'conf'
-require_relative 'constants'
-require_relative 'graphics/hand'
-require_relative 'graphics/showcase'
-require_relative 'layout_parser'
-require_relative 'progress'
-
-
-# The project module
-#
-# @api public
-module Squib
-
-  # The main interface to Squib. Provides a front-end porcelain whereas the Card class interacts with the graphics plumbing.
-  #
-  # @api public
-  class Deck
-    include Enumerable
-    extend Forwardable
-
-    # Attributes for the width, height (in pixels) and number of cards
-    # These are expected to be immuatble for the life of Deck
-    # @api private
-    attr_reader :width, :height, :cards, :progress_bar
-
-    # Delegate these configuration options to the Squib::Conf object
-    def_delegators :conf, :antialias, :backend, :count_format, :custom_colors, :dir,
-                          :img_dir, :prefix, :text_hint, :typographer
-    # :nodoc:
-    # @api private
-    attr_reader :layout, :conf, :dpi, :font
-
-    #
-    # deck.size is really just @cards.size
-    def_delegators :cards, :size
-
-    # Squib's constructor that sets the immutable properties.
-    #
-    # This is the starting point for Squib. In providing a block to the constructor, you have access to all of Deck's instance methods.
-    # The documented methods in Deck are the ones intended for use by most users.
-    # If your game requires multiple different sizes or orientations, I recommend using multiple `Squib::Deck`s in your `deck.rb`. You can modify the internals of `Squib::Deck` (e.g. `@cards`), but that's not recommended.
-    # @example
-    #   require 'squib'
-    #   Squib::Deck.new do
-    #     text str: 'Hello, World!"
-    #   end
-    #
-    # @param width [Integer] the width of each card in pixels. Supports unit conversion (e.g. '2.5in').
-    # @param height [Integer] the height of each card in pixels. Supports unit conversion (e.g. '3.5in').
-    # @param cards [Integer] the number of cards in the deck
-    # @param dpi [Integer] the pixels per inch when rendering out to PDF or calculating using inches.
-    # @param config [String] the file used for global settings of this deck
-    # @param layout [String, Array] load a YML file of custom layouts. Multiple files are merged sequentially, redefining collisons. See README and sample for details.
-    # @param block [Block] the main body of the script.
-    # @api public
-    def initialize(width: 825, height: 1125, cards: 1, dpi: 300, config: 'config.yml', layout: nil, &block)
-      @dpi           = dpi
-      @font          = DEFAULT_FONT
-      @cards         = []
-      @conf          = Conf.load(config)
-      @progress_bar  = Progress.new(@conf.progress_bars) # FIXME this is evil. Using something different with @ and non-@
-      show_info(config, layout)
-      @width         = Args::UnitConversion.parse width, dpi
-      @height        = Args::UnitConversion.parse height, dpi
-      cards.times{ |i| @cards << Squib::Card.new(self, @width, @height, i) }
-      @layout = LayoutParser.new(dpi).load_layout(layout)
-      enable_groups_from_env!
-      if block_given?
-        instance_eval(&block) # here we go. wheeeee!
-      end
-      @cards.each { |c| c.finish! }
-    end
-
-    # Directly accesses the array of cards in the deck
-    #
-    # @api private
-    def [](key)
-      @cards[key]
-    end
-
-    # Iterates over each card in the deck
-    #
-    # @api private
-    def each(&block)
-      @cards.each { |card| block.call(card) }
-    end
-
-    # Use Logger to show more detail on the run
-    # :nodoc:
-    # @api private
-    def show_info(config, layout)
-      Squib::logger.info "Squib v#{Squib::VERSION}"
-      Squib::logger.info "  building #{@cards.size} #{@width}x#{@height} cards"
-      Squib::logger.info "  using #{@backend}"
-    end
-
-    ##################
-    ### PUBLIC API ###
-    ##################
-    require_relative 'api/background'
-    require_relative 'api/data'
-    require_relative 'api/groups'
-    require_relative 'api/image'
-    require_relative 'api/save'
-    require_relative 'api/settings'
-    require_relative 'api/shapes'
-    require_relative 'api/text'
-    require_relative 'api/units'
-
-  end
-end
+require 'forwardable'
+require 'pp'
+require_relative '../squib'
+require_relative 'args/unit_conversion'
+require_relative 'card'
+require_relative 'conf'
+require_relative 'constants'
+require_relative 'graphics/hand'
+require_relative 'graphics/showcase'
+require_relative 'layout_parser'
+require_relative 'progress'
+
+
+# The project module
+#
+# @api public
+module Squib
+
+  # The main interface to Squib. Provides a front-end porcelain whereas the Card class interacts with the graphics plumbing.
+  #
+  # @api public
+  class Deck
+    include Enumerable
+    extend Forwardable
+
+    # Attributes for the width, height (in pixels) and number of cards
+    # These are expected to be immuatble for the life of Deck
+    # @api private
+    attr_reader :width, :height, :cards, :progress_bar
+
+    # Delegate these configuration options to the Squib::Conf object
+    def_delegators :conf, :antialias, :backend, :count_format, :custom_colors, :dir,
+                          :img_dir, :prefix, :text_hint, :typographer
+    # :nodoc:
+    # @api private
+    attr_reader :layout, :conf, :dpi, :font
+
+    #
+    # deck.size is really just @cards.size
+    def_delegators :cards, :size
+
+    # Squib's constructor that sets the immutable properties.
+    #
+    # This is the starting point for Squib. In providing a block to the constructor, you have access to all of Deck's instance methods.
+    # The documented methods in Deck are the ones intended for use by most users.
+    # If your game requires multiple different sizes or orientations, I recommend using multiple `Squib::Deck`s in your `deck.rb`. You can modify the internals of `Squib::Deck` (e.g. `@cards`), but that's not recommended.
+    # @example
+    #   require 'squib'
+    #   Squib::Deck.new do
+    #     text str: 'Hello, World!"
+    #   end
+    #
+    # @param width [Integer] the width of each card in pixels. Supports unit conversion (e.g. '2.5in').
+    # @param height [Integer] the height of each card in pixels. Supports unit conversion (e.g. '3.5in').
+    # @param cards [Integer] the number of cards in the deck
+    # @param dpi [Integer] the pixels per inch when rendering out to PDF or calculating using inches.
+    # @param config [String] the file used for global settings of this deck
+    # @param layout [String, Array] load a YML file of custom layouts. Multiple files are merged sequentially, redefining collisons. See README and sample for details.
+    # @param block [Block] the main body of the script.
+    # @api public
+    def initialize(width: 825, height: 1125, cards: 1, dpi: 300, config: 'config.yml', layout: nil, &block)
+      @dpi           = dpi
+      @font          = DEFAULT_FONT
+      @cards         = []
+      @conf          = Conf.load(config)
+      @progress_bar  = Progress.new(@conf.progress_bars) # FIXME this is evil. Using something different with @ and non-@
+      show_info(config, layout)
+      @width         = Args::UnitConversion.parse width, dpi
+      @height        = Args::UnitConversion.parse height, dpi
+      cards.times{ |i| @cards << Squib::Card.new(self, @width, @height, i) }
+      @layout = LayoutParser.new(dpi).load_layout(layout)
+      enable_groups_from_env!
+      if block_given?
+        instance_eval(&block) # here we go. wheeeee!
+      end
+      @cards.each { |c| c.finish! }
+    end
+
+    # Directly accesses the array of cards in the deck
+    #
+    # @api private
+    def [](key)
+      @cards[key]
+    end
+
+    # Iterates over each card in the deck
+    #
+    # @api private
+    def each(&block)
+      @cards.each { |card| block.call(card) }
+    end
+
+    # Use Logger to show more detail on the run
+    # :nodoc:
+    # @api private
+    def show_info(config, layout)
+      Squib::logger.info "Squib v#{Squib::VERSION}"
+      Squib::logger.info "  building #{@cards.size} #{@width}x#{@height} cards"
+      Squib::logger.info "  using #{@backend}"
+    end
+
+    ##################
+    ### PUBLIC API ###
+    ##################
+    require_relative 'api/background'
+    require_relative 'api/data'
+    require_relative 'api/groups'
+    require_relative 'api/image'
+    require_relative 'api/save'
+    require_relative 'api/settings'
+    require_relative 'api/shapes'
+    require_relative 'api/text'
+    require_relative 'api/units'
+
+  end
+end

data/lib/squib/graphics/background.rb

@@ -1,14 +1,14 @@
-module Squib
-  class Card
-
-    # :nodoc:
-    # @api private
-    def background(color)
-      use_cairo do |cc|
-        cc.set_source_squibcolor(color)
-        cc.paint
-      end
-    end
-
-  end
-end
+module Squib
+  class Card
+
+    # :nodoc:
+    # @api private
+    def background(color)
+      use_cairo do |cc|
+        cc.set_source_squibcolor(color)
+        cc.paint
+      end
+    end
+
+  end
+end

data/lib/squib/graphics/cairo_context_wrapper.rb

@@ -1,113 +1,113 @@
-require 'forwardable'
-require_relative 'gradient_regex'
-
-module Squib
-  module Graphics
-    # Wrapper class for the Cairo context. Private.
-    # @api private
-    class CairoContextWrapper
-      extend Forwardable
-
-      # :nodoc:
-      # @api private
-      attr_accessor :cairo_cxt
-
-      # :nodoc:
-      # @api private
-      def initialize(cairo_cxt)
-        @cairo_cxt = cairo_cxt
-      end
-
-      def_delegators :cairo_cxt, :save, :set_source_color, :paint, :restore,
-        :translate, :rotate, :move_to, :update_pango_layout, :width, :height,
-        :show_pango_layout, :rounded_rectangle, :set_line_width, :stroke, :fill,
-        :set_source, :scale, :render_rsvg_handle, :circle, :triangle, :line_to,
-        :operator=, :show_page, :clip, :transform, :mask, :create_pango_layout,
-        :antialias=, :curve_to, :matrix, :matrix=, :identity_matrix, :pango_layout_path,
-        :stroke_preserve, :target, :new_path, :fill_preserve, :close_path,
-        :set_line_join, :set_line_cap, :set_dash, :arc, :arc_negative
-
-      # :nodoc:
-      # @api private
-      def set_source_squibcolor(arg)
-        raise 'nil is not a valid color' if arg.nil?
-        if match = arg.match(LINEAR_GRADIENT)
-          x1, y1, x2, y2 = match.captures
-          linear = Cairo::LinearPattern.new(x1.to_f, y1.to_f, x2.to_f, y2.to_f)
-          arg.scan(STOPS).each do |color, offset|
-            linear.add_color_stop(offset.to_f, color)
-          end
-          linear.matrix = matrix # match the coordinate systems - see bug 127
-          @cairo_cxt.set_source(linear)
-        elsif match = arg.match(RADIAL_GRADIENT)
-          x1, y1, r1, x2, y2, r2 = match.captures
-          radial = Cairo::RadialPattern.new(x1.to_f, y1.to_f, r1.to_f,
-                                            x2.to_f, y2.to_f, r2.to_f)
-          radial.matrix = matrix # match the coordinate systems - see bug 127
-          arg.scan(STOPS).each do |color, offset|
-            radial.add_color_stop(offset.to_f, color)
-          end
-          @cairo_cxt.set_source(radial)
-        else
-          @cairo_cxt.set_source_color(arg)
-        end
-      end
-
-      # Convenience method for a common task
-      # @api private
-      def fill_n_stroke(draw)
-        return stroke_n_fill(draw) if draw.stroke_strategy == :stroke_first
-        set_source_squibcolor draw.fill_color
-        fill_preserve
-        set_source_squibcolor draw.stroke_color
-        set_line_width draw.stroke_width
-        set_line_join draw.join
-        set_line_cap draw.cap
-        set_dash draw.dash
-        stroke
-      end
-
-      def stroke_n_fill(draw)
-        return fill_n_stroke(draw) if draw.stroke_strategy == :fill_first
-        set_source_squibcolor draw.stroke_color
-        set_line_width draw.stroke_width
-        set_line_join draw.join
-        set_line_cap draw.cap
-        set_dash draw.dash
-        stroke_preserve
-        set_source_squibcolor draw.fill_color
-        fill
-      end
-
-      # Convenience method for a common task
-      # @api private
-      def fancy_stroke(draw)
-        set_source_squibcolor draw.stroke_color
-        set_line_width draw.stroke_width
-        set_line_join draw.join
-        set_line_cap draw.cap
-        set_dash draw.dash
-        stroke
-      end
-
-      def rotate_about(x, y, angle)
-        translate(x, y)
-        rotate(angle)
-        translate(-x, -y)
-      end
-
-      # Flip either vertical or horizontal depending
-      # From the cairo website: http://cairographics.org/matrix_transform/
-      # cairo.Matrix(fx, 0,         0,
-      #              fy, cx*(1-fx), cy*(fy-1))
-      # fx/fy = 1 means 'no flip', fx/fy = -1 are used for horizontal/vertical flip
-      def flip(vertical, horizontal, x, y)
-        v = vertical   ? -1.0 : 1.0
-        h = horizontal ? -1.0 : 1.0
-        transform Cairo::Matrix.new(v, 0.0,     0.0,
-                                    h, x * (1 - v), y * (1 - h))
-      end
-
-    end
-  end
-end
+require 'forwardable'
+require_relative 'gradient_regex'
+
+module Squib
+  module Graphics
+    # Wrapper class for the Cairo context. Private.
+    # @api private
+    class CairoContextWrapper
+      extend Forwardable
+
+      # :nodoc:
+      # @api private
+      attr_accessor :cairo_cxt
+
+      # :nodoc:
+      # @api private
+      def initialize(cairo_cxt)
+        @cairo_cxt = cairo_cxt
+      end
+
+      def_delegators :cairo_cxt, :save, :set_source_color, :paint, :restore,
+        :translate, :rotate, :move_to, :update_pango_layout, :width, :height,
+        :show_pango_layout, :rounded_rectangle, :set_line_width, :stroke, :fill,
+        :set_source, :scale, :render_rsvg_handle, :circle, :triangle, :line_to,
+        :operator=, :show_page, :clip, :transform, :mask, :create_pango_layout,
+        :antialias=, :curve_to, :matrix, :matrix=, :identity_matrix, :pango_layout_path,
+        :stroke_preserve, :target, :new_path, :fill_preserve, :close_path,
+        :set_line_join, :set_line_cap, :set_dash, :arc, :arc_negative
+
+      # :nodoc:
+      # @api private
+      def set_source_squibcolor(arg)
+        raise 'nil is not a valid color' if arg.nil?
+        if match = arg.match(LINEAR_GRADIENT)
+          x1, y1, x2, y2 = match.captures
+          linear = Cairo::LinearPattern.new(x1.to_f, y1.to_f, x2.to_f, y2.to_f)
+          arg.scan(STOPS).each do |color, offset|
+            linear.add_color_stop(offset.to_f, color)
+          end
+          linear.matrix = matrix # match the coordinate systems - see bug 127
+          @cairo_cxt.set_source(linear)
+        elsif match = arg.match(RADIAL_GRADIENT)
+          x1, y1, r1, x2, y2, r2 = match.captures
+          radial = Cairo::RadialPattern.new(x1.to_f, y1.to_f, r1.to_f,
+                                            x2.to_f, y2.to_f, r2.to_f)
+          radial.matrix = matrix # match the coordinate systems - see bug 127
+          arg.scan(STOPS).each do |color, offset|
+            radial.add_color_stop(offset.to_f, color)
+          end
+          @cairo_cxt.set_source(radial)
+        else
+          @cairo_cxt.set_source_color(arg)
+        end
+      end
+
+      # Convenience method for a common task
+      # @api private
+      def fill_n_stroke(draw)
+        return stroke_n_fill(draw) if draw.stroke_strategy == :stroke_first
+        set_source_squibcolor draw.fill_color
+        fill_preserve
+        set_source_squibcolor draw.stroke_color
+        set_line_width draw.stroke_width
+        set_line_join draw.join
+        set_line_cap draw.cap
+        set_dash draw.dash
+        stroke
+      end
+
+      def stroke_n_fill(draw)
+        return fill_n_stroke(draw) if draw.stroke_strategy == :fill_first
+        set_source_squibcolor draw.stroke_color
+        set_line_width draw.stroke_width
+        set_line_join draw.join
+        set_line_cap draw.cap
+        set_dash draw.dash
+        stroke_preserve
+        set_source_squibcolor draw.fill_color
+        fill
+      end
+
+      # Convenience method for a common task
+      # @api private
+      def fancy_stroke(draw)
+        set_source_squibcolor draw.stroke_color
+        set_line_width draw.stroke_width
+        set_line_join draw.join
+        set_line_cap draw.cap
+        set_dash draw.dash
+        stroke
+      end
+
+      def rotate_about(x, y, angle)
+        translate(x, y)
+        rotate(angle)
+        translate(-x, -y)
+      end
+
+      # Flip either vertical or horizontal depending
+      # From the cairo website: http://cairographics.org/matrix_transform/
+      # cairo.Matrix(fx, 0,         0,
+      #              fy, cx*(1-fx), cy*(fy-1))
+      # fx/fy = 1 means 'no flip', fx/fy = -1 are used for horizontal/vertical flip
+      def flip(vertical, horizontal, x, y)
+        v = vertical   ? -1.0 : 1.0
+        h = horizontal ? -1.0 : 1.0
+        transform Cairo::Matrix.new(v, 0.0,     0.0,
+                                    h, x * (1 - v), y * (1 - h))
+      end
+
+    end
+  end
+end