squib 0.0.5 → 0.0.6

data/samples/custom-layout2.yml

@@ -0,0 +1,15 @@
+# Used in the layouts.rb sample in conjunction with custom-layout.yml
+#
+# When used with custom-layout.yml loaded first, this layout overrides subtitle
+subtitle:
+  x: 150
+  y: 150
+  width: 575
+  height: 60
+  align: left 
+  valign: middle
+  font_size: 25
+# This one is completely new
+description: 
+  extends: subtitle
+  y: += 350

data/samples/custom_config.rb

@@ -1,4 +1,3 @@
-#!/usr/bin/env ruby
 require 'squib'
 
 Squib::Deck.new(config: 'custom-config.yml') do

data/samples/excel.rb

@@ -1,7 +1,6 @@
-#!/usr/bin/env ruby
 require 'squib'
 
-Squib::Deck.new(width: 825, height: 1125, cards: 3) do
+Squib::Deck.new(cards: 3) do
   background color: :white
 
   # Takes the first sheet by default

data/samples/layouts.rb

@@ -0,0 +1,61 @@
+# encoding: utf-8
+require 'squib'
+
+Squib::Deck.new(layout: 'custom-layout.yml') do
+  background color: :white
+  hint text: :cyan
+
+  # Layouts are YAML files that specify any option as a default
+  rect layout: :frame
+
+  # You can also override a given layout entry in the command
+  circle layout: :frame, x: 50, y: 50, radius: 25
+
+  # Lots of commands have the :layout option
+  text str: 'The Title', layout: :title
+
+  # Layouts also support YAML merge keys toreuse settings
+  svg file: 'spanner.svg',     layout: :icon_left
+  png file: 'shiny-purse.png', layout: :icon_middle
+  svg file: 'spanner.svg',     layout: :icon_right
+
+  # Squib has its own, richer merge key: "extends"
+  rect fill_color: :black, layout: :bonus
+  rect fill_color: :white, layout: :bonus_inner
+  text str: 'Extends!',    layout: :bonus_text
+
+  # Strings can also be used to specify a layout (e.g. from a data file)
+  text str: 'subtitle', layout: 'subtitle'
+
+  # For debugging purposes, you can always print out the loaded layout
+  #require 'pp'
+  #pp @layout
+
+  save_png prefix: 'layout_'
+end
+
+Squib::Deck.new(layout: ['custom-layout.yml', 'custom-layout2.yml']) do
+  text str: 'The Title',       layout: :title       # from custom-layout.yml
+  text str: 'The Subtitle',    layout: :subtitle    # redefined in custom-layout2.yml
+  text str: 'The Description', layout: :description # from custom-layout2.yml
+  save_png prefix: 'layout2_'
+end
+
+# Built-in layouts are easy to use and extend
+Squib::Deck.new(layout: 'playing-card.yml') do
+  text str: "A\u2660",      layout: :bonus_ul, font: 'Sans bold 100', hint: :red
+  text str: "A\u2660",      layout: :bonus_lr, font: 'Sans bold 100', hint: :red
+  text str: "artwork here", layout: :art, hint: :red
+  save_png prefix: 'layout_builtin_playing_card_'
+end
+
+# Built-in layouts are easy to use and extend
+Squib::Deck.new(layout: 'hand.yml') do
+  %w(title bonus1 bonus2 bonus3 bonus4 bonus5
+    description snark art).each do |icon|
+    text str: icon.capitalize, layout: icon,
+         hint: :red, valign: 'middle', align: 'center'
+  end
+  png file: 'pokercard.png', alpha: 0.5
+  save_png prefix: 'layout_builtin_hand_'
+end

data/samples/ranges.rb

@@ -1,4 +1,3 @@
-#!/usr/bin/env ruby
 require 'squib'
 
 data = {'name' => ['Thief', 'Grifter', 'Mastermind'],

data/samples/sample.csv

@@ -0,0 +1,3 @@
+Type,"Quantity"
+Thief,2
+Mastermind,1

data/samples/text_options.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+# encoding: UTF-8
 require 'squib'
 
 data = {'name' => ['Thief', 'Grifter', 'Mastermind'],
@@ -28,11 +28,22 @@ Squib::Deck.new(width: 825, height: 1125, cards: 3) do
   text str: 'This text has fixed width, fixed height, center-aligned, middle-valigned, and has a red hint',
        hint: :red,
        x: 65, y: 400,
-       width: 300, height: 200,
+       width: 300, height: 125,
        align: :center, valign: 'MIDDLE', #case-insenstive strings allowed too.
        font: 'Arial 18'
 
-  text str: 'Ellipsization!\nThe ultimate question of life, the universe, and everything to life and everything is 42',
+  extents = text str: 'Ink extent return value',
+       x: 65, y: 550,
+       font: 'Sans Bold', font_size: [16, 20, 24]
+  margin = 10
+  # Extents come back as an array of hashes, which can get split out like this
+  ws = extents.inject([]) { |arr, ext| arr << ext[:width] + 10; arr }
+  hs = extents.inject([]) { |arr, ext| arr << ext[:height] + 10; arr }
+  rect x: 65 - margin/2, y: 550 - margin/2,
+       width: ws, height: hs,
+       radius: 10, stroke_color: :black
+
+  text str: "Ellipsization!\nThe ultimate question of life, the universe, and everything to life and everything is 42",
        hint: :green, font: 'Arial 22',
        x: 450, y: 400,
        width: 280, height: 180,

data/samples/tgc_proofs.rb

@@ -1,4 +1,3 @@
-#!/usr/bin/env ruby
 require 'squib'
 
 # This sample uses a proof overlay from TheGameCrafter.com to check bleed

data/samples/units.rb

@@ -1,6 +1,6 @@
 require 'squib'
 
-Squib::Deck.new(width: 825, height: 1125, cards: 3) do
+Squib::Deck.new(width: 825, height: 1125) do
   background color: :white
 
   bleed = inches(0.125)

data/spec/api/api_data_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe Squib::Deck do
+  context '#csv' do
+    it 'loads basic csv data' do
+      expect(Squib.csv(file: csv_file('basic.csv'))).to eq({
+        'h1' => [1, 3],
+        'h2' => [2, 4]
+        })
+    end
+
+    it 'collapses duplicate columns and warns' do
+      expect(Squib.logger).to receive(:warn)
+        .with('CSV duplicated the following column keys: h1,h1')
+      expect(Squib.csv(file: csv_file('dup_cols.csv'))).to eq({
+        'h1' => [1, 3],
+        'h2' => [5, 7],
+        'H2' => [6, 8],
+        'h3' => [9, 10],
+        })
+    end
+
+    it 'handles spaces properly' do
+      expect(Squib.csv(file: csv_file('with_spaces.csv'))).to eq({
+        'With Spaces' => ['a b c      ', 3],
+        'h2' => [2, 4],
+        'h3' => [3, nil]
+        })
+    end
+  end
+end

data/spec/api/api_image_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require 'squib'
+
+describe Squib::Deck, 'images' do
+
+  context '#png' do
+     it 'calls Card#png, Dir, and progress bar' do
+      card = instance_double(Squib::Card)
+      progress = double(Squib::Progress)
+      expect(card).to receive(:png).with('foo', 0, 1, 0.5, :overlay, 0.75).once
+      expect(Dir).to receive(:chdir).with('.').and_yield.once
+      expect(progress).to receive(:start).and_yield(progress).once
+      expect(progress).to receive(:increment).once
+      Squib::Deck.new do
+        @progress_bar = progress
+        @cards = [card]
+        png file: 'foo', x: 0, y: 1, alpha: 0.5, blend: :overlay, angle: 0.75
+      end
+    end
+  end
+
+  context '#svg' do
+     it 'calls Card#svg, Dir, and progress bar' do
+      card = instance_double(Squib::Card)
+      progress = double(Squib::Progress)
+      expect(card).to receive(:svg).with('foo', '#bar', 0, 1, 20, 30, 0.5, :overlay, 0.75).once
+      expect(Dir).to receive(:chdir).with('.').and_yield.once
+      expect(progress).to receive(:start).and_yield(progress).once
+      expect(progress).to receive(:increment).once
+      Squib::Deck.new do
+        @progress_bar = progress
+        @cards = [card]
+        svg file: 'foo', id: 'bar', x: 0, y: 1, width: 20, height: 30, alpha: 0.5, blend: :overlay, angle: 0.75
+      end
+    end
+  end
+
+end

data/spec/data/csv/basic.csv

@@ -0,0 +1,3 @@
+h1,h2
+1,2
+3,4

data/spec/data/csv/dup_cols.csv

@@ -0,0 +1,3 @@
+h1,h1,h2,H2,h3
+1,2,5,6,9
+3,4,7,8,10

data/spec/data/csv/with_spaces.csv

@@ -0,0 +1,3 @@
+With Spaces,h2,h3
+a b c      , 2,3
+3          ,4

data/spec/data/layouts/multifile-a.yml

@@ -0,0 +1,4 @@
+title:
+  x: 100
+subtitle:
+  x: 200

data/spec/data/layouts/multifile-b.yml

@@ -0,0 +1,4 @@
+title: # redefined
+  x: 300
+desc:
+  x: 400

data/spec/data/layouts/multifile-extends-a.yml

@@ -0,0 +1,8 @@
+grandparent:
+  x: 100
+parent_a:
+  extends: grandparent
+  x: += 10   # evaluates to 110
+parent_b: 
+  extends: grandparent
+  x: += 20   # evaluates to 120, for now...

data/spec/data/layouts/multifile-extends-b.yml

@@ -0,0 +1,9 @@
+child_a:
+  extends: parent_a
+  x: += 3    # evaluates to 113
+parent_b:    # redefined
+  extends: grandparent
+  x: += 30   # evaluates to 130
+child_b:
+  extends: parent_b
+  x: += 3    # evaluates to 133

data/spec/data/samples/autoscale_font.rb.txt

@@ -0,0 +1,81 @@
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=1.0, @green=1.0, @blue=1.0>])
+cairo: paint([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=1.0, @green=1.0, @blue=1.0>])
+cairo: paint([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=1.0, @green=1.0, @blue=1.0>])
+cairo: paint([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([65, 400])
+cairo: rotate([0])
+cairo: translate([-65, -400])
+cairo: move_to([65, 400])
+pango: font_description=([])
+pango: text=(["ShortBig"])
+pango: width=([716800])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment center>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: rounded_rectangle([65, 400, 0, 0, 0, 0])
+cairo: set_source_color([:red])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([65, 400])
+cairo: rotate([0])
+cairo: translate([-65, -400])
+cairo: move_to([65, 400])
+pango: font_description=([])
+pango: text=(["Medium_Length_Name"])
+pango: width=([716800])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment center>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: rounded_rectangle([65, 400, 0, 0, 0, 0])
+cairo: set_source_color([:red])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([65, 400])
+cairo: rotate([0])
+cairo: translate([-65, -400])
+cairo: move_to([65, 400])
+pango: font_description=([])
+pango: text=(["Super_Duper_Long_Name"])
+pango: width=([716800])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment center>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: rounded_rectangle([65, 400, 0, 0, 0, 0])
+cairo: set_source_color([:red])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: restore([])
+surface: write_to_png(["_output/autoscale_0.png"])
+surface: write_to_png(["_output/autoscale_1.png"])
+surface: write_to_png(["_output/autoscale_2.png"])

data/spec/data/samples/basic.rb.txt

@@ -0,0 +1,206 @@
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=1.0, @green=1.0, @blue=1.0>])
+cairo: paint([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=1.0, @green=1.0, @blue=1.0>])
+cairo: paint([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=1.0, @green=1.0, @blue=1.0>])
+cairo: paint([])
+cairo: restore([])
+cairo: save([])
+cairo: rounded_rectangle([38, 38, 750, 1050, 38, 38])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: rounded_rectangle([38, 38, 750, 1050, 38, 38])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=0.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: fill([])
+cairo: restore([])
+cairo: save([])
+cairo: rounded_rectangle([38, 38, 750, 1050, 38, 38])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: rounded_rectangle([38, 38, 750, 1050, 38, 38])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=0.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: fill([])
+cairo: restore([])
+cairo: save([])
+cairo: rounded_rectangle([38, 38, 750, 1050, 38, 38])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: rounded_rectangle([38, 38, 750, 1050, 38, 38])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=0.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: fill([])
+cairo: restore([])
+cairo: save([])
+cairo: rounded_rectangle([75, 75, 128, 128, 25, 25])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: rounded_rectangle([75, 75, 128, 128, 25, 25])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=0.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: fill([])
+cairo: restore([])
+cairo: save([])
+cairo: rounded_rectangle([75, 75, 128, 128, 25, 25])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: rounded_rectangle([75, 75, 128, 128, 25, 25])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=0.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: fill([])
+cairo: restore([])
+cairo: save([])
+cairo: rounded_rectangle([75, 75, 128, 128, 25, 25])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: set_line_width([2.0])
+cairo: stroke([])
+cairo: rounded_rectangle([75, 75, 128, 128, 25, 25])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=0.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: fill([])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([220, 78])
+cairo: rotate([0])
+cairo: translate([-220, -78])
+cairo: move_to([220, 78])
+pango: font_description=([])
+pango: text=(["Thief"])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment left>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([220, 78])
+cairo: rotate([0])
+cairo: translate([-220, -78])
+cairo: move_to([220, 78])
+pango: font_description=([])
+pango: text=(["Grifter"])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment left>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([220, 78])
+cairo: rotate([0])
+cairo: translate([-220, -78])
+cairo: move_to([220, 78])
+pango: font_description=([])
+pango: text=(["Mastermind"])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment left>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([75, 85])
+cairo: rotate([0])
+cairo: translate([-75, -85])
+cairo: move_to([75, 85])
+pango: font_description=([])
+pango: text=(["1"])
+pango: width=([131072])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment center>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([75, 85])
+cairo: rotate([0])
+cairo: translate([-75, -85])
+cairo: move_to([75, 85])
+pango: font_description=([])
+pango: text=(["2"])
+pango: width=([131072])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment center>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: restore([])
+cairo: save([])
+cairo: set_source_color([#<Cairo::Color::RGB: @alpha=1.0, @red=0.0, @green=0.0, @blue=0.0>])
+cairo: translate([75, 85])
+cairo: rotate([0])
+cairo: translate([-75, -85])
+cairo: move_to([75, 85])
+pango: font_description=([])
+pango: text=(["3"])
+pango: width=([131072])
+pango: wrap=([#<Pango::Layout::WrapMode word-char>])
+pango: ellipsize=([#<Pango::Layout::EllipsizeMode end>])
+pango: alignment=([#<Pango::Layout::Alignment center>])
+pango: justify=([false])
+pango: spacing=([0])
+cairo: update_pango_layout([MockDouble])
+cairo: update_pango_layout([MockDouble])
+cairo: show_pango_layout([MockDouble])
+cairo: restore([])
+cairo: save([])
+cairo: translate([620, 75])
+cairo: rotate([0])
+cairo: translate([-620, -75])
+cairo: set_source([ImageSurface, 620, 75])
+cairo: paint([1.0])
+cairo: restore([])
+cairo: save([])
+cairo: translate([620, 75])
+cairo: rotate([0])
+cairo: translate([-620, -75])
+cairo: set_source([ImageSurface, 620, 75])
+cairo: paint([1.0])
+cairo: restore([])
+cairo: scale([1.0, 1.0])
+cairo: render_rsvg_handle([RSVG::Handle, nil])
+cairo: save([])
+cairo: translate([620, 218])
+cairo: rotate([0])
+cairo: translate([-620, -218])
+cairo: set_source([MockDouble, 620, 218])
+cairo: paint([1.0])
+cairo: restore([])
+cairo: scale([1.0, 1.0])
+cairo: render_rsvg_handle([RSVG::Handle, nil])
+cairo: save([])
+cairo: translate([620, 218])
+cairo: rotate([0])
+cairo: translate([-620, -218])
+cairo: set_source([MockDouble, 620, 218])
+cairo: paint([1.0])
+cairo: restore([])
+surface: write_to_png(["_output/basic_0.png"])
+surface: write_to_png(["_output/basic_1.png"])
+surface: write_to_png(["_output/basic_2.png"])