require 'yaml' require 'pp' require 'squib' require 'squib/card' require 'squib/progress' require 'squib/input_helpers' require 'squib/constants' require 'squib/layout_parser' require 'squib/args/unit_conversion' # 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 include Squib::InputHelpers # :nodoc: # @api private attr_reader :width, :height # :nodoc: # @api private attr_reader :cards # :nodoc: # @api private attr_reader :text_hint # :nodoc: # @api private attr_reader :layout, :config # 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 @width = Args::UnitConversion.parse width, dpi @height = Args::UnitConversion.parse height, dpi @font = Squib::SYSTEM_DEFAULTS[:default_font] @cards = [] @custom_colors = {} @img_dir = '.' @progress_bar = Squib::Progress.new(false) @text_hint = :off cards.times{ @cards << Squib::Card.new(self, @width, @height) } show_info(config, layout) load_config(config) @layout = LayoutParser.load_layout(layout) if block_given? instance_eval(&block) # here we go. wheeeee! end 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 # Load the configuration file, if exists, overriding hardcoded defaults # @api private def load_config(file) if File.exists?(file) && config = YAML.load_file(file) Squib::logger.info { " using config: #{file}" } config = Squib::CONFIG_DEFAULTS.merge(config) @dpi = config['dpi'].to_i @text_hint = config['text_hint'] @progress_bar.enabled = config['progress_bars'] @custom_colors = config['custom_colors'] @img_dir = config['img_dir'] end 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" end ################## ### PUBLIC API ### ################## require 'squib/api/background' require 'squib/api/data' require 'squib/api/image' require 'squib/api/save' require 'squib/api/settings' require 'squib/api/shapes' require 'squib/api/text' require 'squib/api/units' end end