squib 0.14.1 → 0.14.2

data/samples/sprues/_hex_tiles.rb

@@ -1,15 +1,15 @@
-require 'squib'
-
-Squib::Deck.new(width: '65.8mm', height: '76mm', cards: 9) do
-  polygon(
-    x: '32.9mm', y: '38mm', n: 6, radius: '38mm', angle: 1.571,
-    stroke_color: :black, stroke_width: '0.014in', fill_color: :pink
-  )
-  text(
-    str: %w[One Two Three Four Five Six Seven Eight Nine],
-    x: '27mm', y: '35mm', width: '11.8mm', height: '6mm',
-    align: :center, valign: :middle
-  )
-  save_pdf file: 'hex_tiles.pdf',
-           sprue: 'my_sprues/hex_tiles.yml'
-end
+require 'squib'
+
+Squib::Deck.new(width: '65.8mm', height: '76mm', cards: 9) do
+  polygon(
+    x: '32.9mm', y: '38mm', n: 6, radius: '38mm', angle: 1.571,
+    stroke_color: :black, stroke_width: '0.014in', fill_color: :pink
+  )
+  text(
+    str: %w[One Two Three Four Five Six Seven Eight Nine],
+    x: '22mm', y: '35mm', width: '21.8mm', height: '6mm',
+    align: :center, valign: :middle
+  )
+  save_pdf file: 'hex_tiles.pdf',
+           sprue: 'my_sprues/hex_tiles.yml'
+end

data/samples/sprues/_mints.rb

@@ -1,11 +1,11 @@
-require 'squib'
-
-# An example deck that uses "mint" sized cards (e.g. Altoids).
-# These cards are pretty small but comfortably fit in a mint tin
-
-Squib::Deck.new(cards: 21, width: '54.0mm', height: '68.0mm') do
-  background color: :gray
-  rect
-  text str: (1..21).to_a
-  save_pdf sprue: 'my_sprues/us_letter_mints.yml'
-end
+require 'squib'
+
+# An example deck that uses "mint" sized cards (e.g. Altoids).
+# These cards are pretty small but comfortably fit in a mint tin
+
+Squib::Deck.new(cards: 21, width: '54.0mm', height: '68.0mm') do
+  background color: :gray
+  rect
+  text str: (1..21).to_a
+  save_pdf sprue: 'my_sprues/us_letter_mints.yml'
+end

data/samples/sprues/_sprue_example.rb

@@ -1,11 +1,11 @@
-require 'squib'
-
-Squib::Deck.new(cards: 9) do
-  background color: :white
-  rect stroke_width: 5, stroke_color: :red
-  text str: (0..9).map{ |i| "Card #{i}\n2.5x3.5in" },
-       font: 'Sans 32', align: :center, valign: :middle,
-       height: :deck, width: :deck
-  save_sheet sprue: 'letter_poker_card_9up.yml',
-             prefix: "sprue_example_"
-end
+require 'squib'
+
+Squib::Deck.new(cards: 9) do
+  background color: :white
+  rect stroke_width: 5, stroke_color: :red
+  text str: (0..9).map{ |i| "Card #{i}\n2.5x3.5in" },
+       font: 'Sans 32', align: :center, valign: :middle,
+       height: :deck, width: :deck
+  save_sheet sprue: 'letter_poker_card_9up.yml',
+             prefix: "sprue_example_"
+end

data/samples/text/_embed_text.rb

@@ -1,128 +1,128 @@
-require 'squib'
-
-Squib::Deck.new do
-  background color: :white
-  rect x: 0, y: 0, width: 825, height: 1125, stroke_width: 2.0
-
-  embed_text = 'Take 11 :tool: and gain 2 :health:. Take <b>2</b> :tool: <i>and gain 3 :purse: if level 2.</i>'
-  text(str: embed_text, font: 'Sans 7',
-       x: 0, y: 0, width: 180, hint: :red,
-       align: :left, ellipsize: false, justify: false) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
-    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
-    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
-  end
-
-  embed_text = 'Middle align: Take 1 :tool: and gain 2 :health:. Take 2 :tool: and gain 3 :purse:'
-  text(str: embed_text, font: 'Sans 7',
-       x: 200, y: 0, width: 180, height: 300, valign: :middle,
-       align: :left, ellipsize: false, justify: false, hint: :cyan) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
-    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
-    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
-  end
-
-  embed_text = 'This :tool: aligns on the bottom properly. :purse:'
-  text(str: embed_text, font: 'Sans 7',
-       x: 400, y: 0, width: 180, height: 300, valign: :bottom,
-       align: :left, ellipsize: false, justify: false, hint: :green) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
-    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
-    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
-  end
-
-  embed_text = 'Yes, this wraps strangely. We are trying to determine the cause. These are 1 :tool::tool::tool: and these are multiple :tool::tool: :tool::tool:'
-  text(str: embed_text, font: 'Sans 6',
-       x: 600, y: 0, width: 180, height: 300, wrap: :word_char,
-       align: :left, ellipsize: false, justify: false, hint: :cyan) do |embed|
-    embed.svg key: ':tool:', width: 28, height: 28, file: 'spanner.svg'
-  end
-
-  embed_text = ':tool:Justify will :tool: work too, and :purse: with more words just for fun'
-  text(str: embed_text, font: 'Sans 7',
-       x: 0, y: 320, width: 180, height: 300, valign: :bottom,
-       align: :left, ellipsize: false, justify: true, hint: :magenta) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
-    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
-    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
-  end
-
-  embed_text = 'Right-aligned works :tool: with :health: and :purse:'
-  text(str: embed_text, font: 'Sans 7',
-       x: 200, y: 320, width: 180, height: 300, valign: :bottom,
-       align: :right, ellipsize: false, justify: false, hint: :magenta) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
-    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
-    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
-  end
-
-  embed_text = ':tool:Center-aligned works :tool: with :health: and :purse:'
-  text(str: embed_text, font: 'Sans 7',
-       x: 400, y: 320, width: 180, height: 300,
-       align: :center, ellipsize: false, justify: false, hint: :magenta) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, data: File.read('spanner.svg')
-    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
-    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
-  end
-
-  embed_text = 'Markup --- and typography replacements --- with ":tool:" icons <i>won\'t</i> fail'
-  text(str: embed_text, font: 'Serif 6', markup: true,
-       x: 600, y: 320, width: 180, height: 300,
-       align: :center, hint: :magenta) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
-  end
-
-  embed_text = ':tool:' # JUST the icon
-  text(str: embed_text, x: 0, y: 640, width: 180, height: 50, markup: true,
-     font: 'Arial 7', align: :center, valign: :middle, hint: :red) do |embed|
-    embed.svg key: ':tool:', width: 28, height: 28, file: 'spanner.svg'
-  end
-
-  embed_text = ':purse:' # JUST the icon
-  text(str: embed_text, x: 200, y: 640, width: 180, height: 50, markup: true,
-     font: 'Arial 7', align: :center, valign: :middle, hint: :red) do |embed|
-    embed.png key: ':purse:', width: 28, height: 28, file: 'shiny-purse.png'
-  end
-
-  embed_text = ":tool: Death to Nemesis bug 103!! :purse:"
-  text(str: embed_text, font: 'Sans Bold 8', stroke_width: 2,
-       color: :red, stroke_color: :blue, dash: '3 3', align: :left,
-       valign: :middle, x: 0, y: 700, width: 380, height: 150,
-       hint: :magenta) do |embed|
-    embed.svg key: ':tool:', file: 'spanner.svg', width: 32, height: 32
-    embed.png key: ':purse:', file: 'shiny-purse.png', width: 32, height: 32
-  end
-
-  embed_text = 'You can adjust the icon with dx and dy. Normal: :tool: Adjusted: :heart:'
-  text(str: embed_text, font: 'Sans 6', x: 400, y: 640, width: 180,
-       height: 300, hint: :magenta) do |embed|
-    embed.svg key: ':tool:', width: 28, height: 28, file: 'spanner.svg'
-    embed.svg key: ':heart:', width: 28, height: 28, dx: 10, dy: 10,
-              file: 'glass-heart.svg'
-  end
-
-  embed_text = "Native sizes work too\n:tool:\n\n\n\n\n\n:shiny-purse:\n\n\n\n\n\n:tool2:"
-  text(str: embed_text, font: 'Sans 6', x: 600, y: 640, width: 180,
-       height: 475, hint: :magenta) do |embed|
-    embed.svg key: ':tool:', width: :native, height: :native,
-              file: 'spanner.svg'
-    embed.svg key: ':tool2:', width: :native, height: :native,
-              data: File.open('spanner.svg','r').read
-    embed.png key: ':shiny-purse:', width: :native, height: :native,
-              file: 'shiny-purse.png'
-  end
-
-  save_png prefix: 'embed_'
-end
-
-Squib::Deck.new(cards: 3) do
-  background color: :white
-  str = 'Take 1 :tool: and gain 2 :health:.'
-  text(str: str, font: 'Sans', font_size: [6, 8.5, 11.5],
-       x: 0, y: 0, width: 180, height: 300, valign: :bottom,
-       align: :left, ellipsize: false, justify: false, hint: :cyan) do |embed|
-    embed.svg key: ':tool:',   width: [28, 42, 56], height: [28, 42, 56], file: 'spanner.svg'
-    embed.svg key: ':health:', width: [28, 42, 56], height: [28, 42, 56], file: 'glass-heart.svg'
-  end
-  save_sheet prefix: 'embed_multisheet_', columns: 3
-end
+require 'squib'
+
+Squib::Deck.new do
+  background color: :white
+  rect x: 0, y: 0, width: 825, height: 1125, stroke_width: 2.0
+
+  embed_text = 'Take 11 :tool: and gain 2 :health:. Take <b>2</b> :tool: <i>and gain 3 :purse: if level 2.</i>'
+  text(str: embed_text, font: 'Sans 7',
+       x: 0, y: 0, width: 180, hint: :red,
+       align: :left, ellipsize: false, justify: false) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
+    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
+    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
+  end
+
+  embed_text = 'Middle align: Take 1 :tool: and gain 2 :health:. Take 2 :tool: and gain 3 :purse:'
+  text(str: embed_text, font: 'Sans 7',
+       x: 200, y: 0, width: 180, height: 300, valign: :middle,
+       align: :left, ellipsize: false, justify: false, hint: :cyan) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
+    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
+    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
+  end
+
+  embed_text = 'This :tool: aligns on the bottom properly. :purse:'
+  text(str: embed_text, font: 'Sans 7',
+       x: 400, y: 0, width: 180, height: 300, valign: :bottom,
+       align: :left, ellipsize: false, justify: false, hint: :green) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
+    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
+    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
+  end
+
+  embed_text = 'Yes, this wraps strangely. We are trying to determine the cause. These are 1 :tool::tool::tool: and these are multiple :tool::tool: :tool::tool:'
+  text(str: embed_text, font: 'Sans 6',
+       x: 600, y: 0, width: 180, height: 300, wrap: :word_char,
+       align: :left, ellipsize: false, justify: false, hint: :cyan) do |embed|
+    embed.svg key: ':tool:', width: 28, height: 28, file: 'spanner.svg'
+  end
+
+  embed_text = ':tool:Justify will :tool: work too, and :purse: with more words just for fun'
+  text(str: embed_text, font: 'Sans 7',
+       x: 0, y: 320, width: 180, height: 300, valign: :bottom,
+       align: :left, ellipsize: false, justify: true, hint: :magenta) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
+    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
+    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
+  end
+
+  embed_text = 'Right-aligned works :tool: with :health: and :purse:'
+  text(str: embed_text, font: 'Sans 7',
+       x: 200, y: 320, width: 180, height: 300, valign: :bottom,
+       align: :right, ellipsize: false, justify: false, hint: :magenta) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
+    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
+    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
+  end
+
+  embed_text = ':tool:Center-aligned works :tool: with :health: and :purse:'
+  text(str: embed_text, font: 'Sans 7',
+       x: 400, y: 320, width: 180, height: 300,
+       align: :center, ellipsize: false, justify: false, hint: :magenta) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, data: File.read('spanner.svg')
+    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
+    embed.png key: ':purse:',  width: 28, height: 28, file: 'shiny-purse.png'
+  end
+
+  embed_text = 'Markup --- and typography replacements --- with ":tool:" icons <i>won\'t</i> fail'
+  text(str: embed_text, font: 'Serif 6', markup: true,
+       x: 600, y: 320, width: 180, height: 300,
+       align: :center, hint: :magenta) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
+  end
+
+  embed_text = ':tool:' # JUST the icon
+  text(str: embed_text, x: 0, y: 640, width: 180, height: 50, markup: true,
+     font: 'Arial 7', align: :center, valign: :middle, hint: :red) do |embed|
+    embed.svg key: ':tool:', width: 28, height: 28, file: 'spanner.svg'
+  end
+
+  embed_text = ':purse:' # JUST the icon
+  text(str: embed_text, x: 200, y: 640, width: 180, height: 50, markup: true,
+     font: 'Arial 7', align: :center, valign: :middle, hint: :red) do |embed|
+    embed.png key: ':purse:', width: 28, height: 28, file: 'shiny-purse.png'
+  end
+
+  embed_text = ":tool: Death to Nemesis bug 103!! :purse:"
+  text(str: embed_text, font: 'Sans Bold 8', stroke_width: 2,
+       color: :red, stroke_color: :blue, dash: '3 3', align: :left,
+       valign: :middle, x: 0, y: 700, width: 380, height: 150,
+       hint: :magenta) do |embed|
+    embed.svg key: ':tool:', file: 'spanner.svg', width: 32, height: 32
+    embed.png key: ':purse:', file: 'shiny-purse.png', width: 32, height: 32
+  end
+
+  embed_text = 'You can adjust the icon with dx and dy. Normal: :tool: Adjusted: :heart:'
+  text(str: embed_text, font: 'Sans 6', x: 400, y: 640, width: 180,
+       height: 300, hint: :magenta) do |embed|
+    embed.svg key: ':tool:', width: 28, height: 28, file: 'spanner.svg'
+    embed.svg key: ':heart:', width: 28, height: 28, dx: 10, dy: 10,
+              file: 'glass-heart.svg'
+  end
+
+  embed_text = "Native sizes work too\n:tool:\n\n\n\n\n\n:shiny-purse:\n\n\n\n\n\n:tool2:"
+  text(str: embed_text, font: 'Sans 6', x: 600, y: 640, width: 180,
+       height: 475, hint: :magenta) do |embed|
+    embed.svg key: ':tool:', width: :native, height: :native,
+              file: 'spanner.svg'
+    embed.svg key: ':tool2:', width: :native, height: :native,
+              data: File.open('spanner.svg','r').read
+    embed.png key: ':shiny-purse:', width: :native, height: :native,
+              file: 'shiny-purse.png'
+  end
+
+  save_png prefix: 'embed_'
+end
+
+Squib::Deck.new(cards: 3) do
+  background color: :white
+  str = 'Take 1 :tool: and gain 2 :health:.'
+  text(str: str, font: 'Sans', font_size: [6, 8.5, 11.5],
+       x: 0, y: 0, width: 180, height: 300, valign: :bottom,
+       align: :left, ellipsize: false, justify: false, hint: :cyan) do |embed|
+    embed.svg key: ':tool:',   width: [28, 42, 56], height: [28, 42, 56], file: 'spanner.svg'
+    embed.svg key: ':health:', width: [28, 42, 56], height: [28, 42, 56], file: 'glass-heart.svg'
+  end
+  save_sheet prefix: 'embed_multisheet_', columns: 3
+end

data/samples/text/_text.rb

@@ -1,47 +1,47 @@
-require 'squib'
-require 'squib/sample_helpers'
-
-Squib::Deck.new(width: 1000, height: 1250) do
-  draw_graph_paper width, height
-
-  sample 'Font strings are quite expressive. Specify family, modifiers, then size. Font names with spaces in them should end with a comma to help with parsing.' do |x, y|
-    text font: 'Arial bold italic 11', str: 'Bold and italic!', x: x, y: y - 50
-    text font: 'Arial weight=300 11', str: 'Light bold!', x: x, y: y
-    text font: 'Times New Roman, 11', str: 'Times New Roman', x: x, y: y + 50
-    text font: 'NoSuchFont,Arial 11', str: 'Arial Backup', x: x, y: y + 100
-  end
-
-  sample 'Specify width and height to see a text box. Also: set "hint" to see the extents of your text box' do |x, y|
-    text str: 'This has fixed width and height.', x: x, y: y,
-         hint: :red, width: 300, height: 100, font: 'Serif bold 8'
-  end
-
-  sample 'If you specify the width only, the text will ellipsize.' do |x, y|
-    text str: 'The meaning of life is 42', x: x - 50, y: y,
-         hint: :red, width: 350, font: 'Serif bold 7'
-  end
-
-  sample 'If you specify the width only, and turn off ellipsize, the height will auto-stretch.' do |x, y|
-    text str: 'This has fixed width, but not fixed height.', x: x, y: y,
-         hint: :red, width: 300, ellipsize: false, font: 'Serif bold 8'
-  end
-
-  sample 'The text method returns the ink extents of each card\'s rendered text. So you can custom-fit a shape around it.' do |x, y|
-    ['Auto fit!', 'Auto fit!!!!' ].each.with_index do |str, i|
-      text_y = y + i * 50
-      extents = text str: str, x: x, y: text_y, font: 'Sans Bold 8'
-
-      # Extents come back as an array of hashes, which can get split out like this
-      text_width  = extents[0][:width]
-      text_height = extents[0][:height]
-      rect x: x, y: text_y, width: text_width, height: text_height, radius: 10,
-           stroke_color: :purple, stroke_width: 3
-    end
-  end
-
-  sample 'Text can be rotated about the upper-left corner of the text box. Unit is in radians.' do |x, y|
-    text str: 'Rotated', hint: :red, x: x, y: y, angle: Math::PI / 6
-  end
-
-  save_png prefix: '_text_'
-end
+require 'squib'
+require 'squib/sample_helpers'
+
+Squib::Deck.new(width: 1000, height: 1250) do
+  draw_graph_paper width, height
+
+  sample 'Font strings are quite expressive. Specify family, modifiers, then size. Font names with spaces in them should end with a comma to help with parsing.' do |x, y|
+    text font: 'Arial bold italic 11', str: 'Bold and italic!', x: x, y: y - 50
+    text font: 'Arial weight=300 11', str: 'Light bold!', x: x, y: y
+    text font: 'Times New Roman, 11', str: 'Times New Roman', x: x, y: y + 50
+    text font: 'NoSuchFont,Arial 11', str: 'Arial Backup', x: x, y: y + 100
+  end
+
+  sample 'Specify width and height to see a text box. Also: set "hint" to see the extents of your text box' do |x, y|
+    text str: 'This has fixed width and height.', x: x, y: y,
+         hint: :red, width: 300, height: 100, font: 'Serif bold 8'
+  end
+
+  sample 'If you specify the width only, the text will ellipsize.' do |x, y|
+    text str: 'The meaning of life is 42', x: x - 50, y: y,
+         hint: :red, width: 350, font: 'Serif bold 7'
+  end
+
+  sample 'If you specify the width only, and turn off ellipsize, the height will auto-stretch.' do |x, y|
+    text str: 'This has fixed width, but not fixed height.', x: x, y: y,
+         hint: :red, width: 300, ellipsize: false, font: 'Serif bold 8'
+  end
+
+  sample 'The text method returns the ink extents of each card\'s rendered text. So you can custom-fit a shape around it.' do |x, y|
+    ['Auto fit!', 'Auto fit!!!!' ].each.with_index do |str, i|
+      text_y = y + i * 50
+      extents = text str: str, x: x, y: text_y, font: 'Sans Bold 8'
+
+      # Extents come back as an array of hashes, which can get split out like this
+      text_width  = extents[0][:width]
+      text_height = extents[0][:height]
+      rect x: x, y: text_y, width: text_width, height: text_height, radius: 10,
+           stroke_color: :purple, stroke_width: 3
+    end
+  end
+
+  sample 'Text can be rotated about the upper-left corner of the text box. Unit is in radians.' do |x, y|
+    text str: 'Rotated', hint: :red, x: x, y: y, angle: Math::PI / 6
+  end
+
+  save_png prefix: '_text_'
+end

data/samples/text/_text_options.rb

@@ -1,102 +1,102 @@
-# encoding: UTF-8
-require 'squib'
-
-data = { 'name' => ['Thief', 'Grifter', 'Mastermind'],
-        'level' => [1, 2, 3] }
-longtext = "This is left-justified text, with newlines.\nWhat do you know about tweetle beetles? well... When tweetle beetles fight, it's called a tweetle beetle battle. And when they battle in a puddle, it's a tweetle beetle puddle battle. AND when tweetle beetles battle with paddles in a puddle, they call it a tweetle beetle puddle paddle battle. AND... When beetles battle beetles in a puddle paddle battle and the beetle battle puddle is a puddle in a bottle... ..they call this a tweetle beetle bottle puddle paddle battle muddle."
-
-Squib::Deck.new(width: 825, height: 1125, cards: 3) do
-  background color: :white
-  rect x: 15, y: 15, width: 795, height: 1095, x_radius: 50, y_radius: 50
-  rect x: 30, y: 30, width: 128, height: 128, x_radius: 25, y_radius: 25
-
-  # Arrays are rendered over each card
-  text str: data['name'], x: 250, y: 55, font: 'Arial weight=900 18'
-  text str: data['level'], x: 65, y: 40, font: 'Arial 24', color: :burnt_orange
-
-  text str: 'Font strings are expressive!', x:65, y: 200,
-       font: 'Impact bold italic 12'
-
-  text str: 'Font strings are expressive!', x:65, y: 300,
-       font: 'Arial,Verdana weight=900 style=oblique 12'
-
-  text str: 'Font string sizes can be overridden per card.', x: 65, y: 350,
-       font: 'Impact 12', font_size: [5, 7, 8]
-
-  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: 125,
-       align: :center, valign: 'MIDDLE', # these can be specified with case-insenstive strings too
-       font: 'Serif 5'
-
-  extents = text str: 'Ink extent return value',
-       x: 65, y: 550,
-       font: 'Sans Bold', font_size: [5, 7, 8]
-  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
-
-  # If width & height are defined and the text will overflow the box, we can ellipsize.
-  text str: "Ellipsization!\nThe ultimate question of life, the universe, and everything to life and everything is 42",
-       hint: :green, font: 'Arial 7',
-       x: 450, y: 400,
-       width: 280, height: 180,
-       ellipsize: true
-
-  # Text hints are guides for showing you how your text boxes are laid out exactly
-  hint text: :cyan
-  set font: 'Serif 7' # Impacts all future text calls (unless they specify differently)
-  text str: 'Text hints & fonts are globally togglable!', x: 65, y: 625
-  set font: :default # back to Squib-wide default
-  hint text: :off
-  text str: 'See? No hint here.',
-        x: 565, y: 625,
-        font: 'Arial 7'
-
-  # Text can be rotated, in radians, about the upper-left corner of the text box.
-  text str: 'Rotated',
-        x: 565, y: 675, angle: 0.2,
-        font: 'Arial 6', hint: :red
-
-  # Text can be justified, and have newlines
-  text str: longtext, font: 'Arial 5',
-       x: 65, y: 700,
-       width: '1.5in', height: inches(1),
-       justify: true, spacing: -6
-
-  # Here's how you embed images into text.
-  # Pass a block to the method call and use the given context
-  embed_text = 'Embedded icons! Take 1 :tool: and gain 2:health:. If Level 2, take 2 :tool:'
-  text(str: embed_text, font: 'Sans 6',
-       x: '1.8in', y: '2.5in', width: '0.85in',
-       align: :left, ellipsize: false) do |embed|
-    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
-    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
-  end
-
-  text str: 'Fill n <span fgcolor="#ff0000">stroke</span>',
-       color: :green, stroke_width: 2.0, stroke_color: :blue,
-       x: '1.8in', y: '2.9in', width: '0.85in', font: 'Sans Bold 9', markup: true
-
-  text str: 'Stroke n <span fgcolor="#ff0000">fill</span>',
-       color: :green, stroke_width: 2.0, stroke_color: :blue, stroke_strategy: :stroke_first,
-       x: '1.8in', y: '3.0in', width: '0.85in', font: 'Sans Bold 9', markup: true
-
-  text str: 'Dotted',
-       color: :white, stroke_width: 2.0, dash: '4 2', stroke_color: :black,
-       x: '1.8in', y: '3.1in', width: '0.85in', font: 'Sans Bold 9', markup: true
-  #
-  text str: "<b>Markup</b> is <i>quite</i> <s>'easy'</s> <span fgcolor=\"\#ff0000\">awesome</span>. Can't beat those \"smart\" 'quotes', now with 10--20% more en-dashes --- and em-dashes --- with explicit ellipses too...",
-       markup: true,
-       x: 50, y: 1000,
-       width: 750, height: 100,
-       valign: :bottom,
-       font: 'Serif 6', hint: :cyan
-
-  save prefix: 'text_options_', format: :png
-end
+# encoding: UTF-8
+require 'squib'
+
+data = { 'name' => ['Thief', 'Grifter', 'Mastermind'],
+        'level' => [1, 2, 3] }
+longtext = "This is left-justified text, with newlines.\nWhat do you know about tweetle beetles? well... When tweetle beetles fight, it's called a tweetle beetle battle. And when they battle in a puddle, it's a tweetle beetle puddle battle. AND when tweetle beetles battle with paddles in a puddle, they call it a tweetle beetle puddle paddle battle. AND... When beetles battle beetles in a puddle paddle battle and the beetle battle puddle is a puddle in a bottle... ..they call this a tweetle beetle bottle puddle paddle battle muddle."
+
+Squib::Deck.new(width: 825, height: 1125, cards: 3) do
+  background color: :white
+  rect x: 15, y: 15, width: 795, height: 1095, x_radius: 50, y_radius: 50
+  rect x: 30, y: 30, width: 128, height: 128, x_radius: 25, y_radius: 25
+
+  # Arrays are rendered over each card
+  text str: data['name'], x: 250, y: 55, font: 'Arial weight=900 18'
+  text str: data['level'], x: 65, y: 40, font: 'Arial 24', color: :burnt_orange
+
+  text str: 'Font strings are expressive!', x:65, y: 200,
+       font: 'Impact bold italic 12'
+
+  text str: 'Font strings are expressive!', x:65, y: 300,
+       font: 'Arial,Verdana weight=900 style=oblique 12'
+
+  text str: 'Font string sizes can be overridden per card.', x: 65, y: 350,
+       font: 'Impact 12', font_size: [5, 7, 8]
+
+  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: 125,
+       align: :center, valign: 'MIDDLE', # these can be specified with case-insenstive strings too
+       font: 'Serif 5'
+
+  extents = text str: 'Ink extent return value',
+       x: 65, y: 550,
+       font: 'Sans Bold', font_size: [5, 7, 8]
+  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
+
+  # If width & height are defined and the text will overflow the box, we can ellipsize.
+  text str: "Ellipsization!\nThe ultimate question of life, the universe, and everything to life and everything is 42",
+       hint: :green, font: 'Arial 7',
+       x: 450, y: 400,
+       width: 280, height: 180,
+       ellipsize: true
+
+  # Text hints are guides for showing you how your text boxes are laid out exactly
+  hint text: :cyan
+  set font: 'Serif 7' # Impacts all future text calls (unless they specify differently)
+  text str: 'Text hints & fonts are globally togglable!', x: 65, y: 625
+  set font: :default # back to Squib-wide default
+  hint text: :off
+  text str: 'See? No hint here.',
+        x: 565, y: 625,
+        font: 'Arial 7'
+
+  # Text can be rotated, in radians, about the upper-left corner of the text box.
+  text str: 'Rotated',
+        x: 565, y: 675, angle: 0.2,
+        font: 'Arial 6', hint: :red
+
+  # Text can be justified, and have newlines
+  text str: longtext, font: 'Arial 5',
+       x: 65, y: 700,
+       width: '1.5in', height: inches(1),
+       justify: true, spacing: -6
+
+  # Here's how you embed images into text.
+  # Pass a block to the method call and use the given context
+  embed_text = 'Embedded icons! Take 1 :tool: and gain 2:health:. If Level 2, take 2 :tool:'
+  text(str: embed_text, font: 'Sans 6',
+       x: '1.8in', y: '2.5in', width: '0.85in',
+       align: :left, ellipsize: false) do |embed|
+    embed.svg key: ':tool:',   width: 28, height: 28, file: 'spanner.svg'
+    embed.svg key: ':health:', width: 28, height: 28, file: 'glass-heart.svg'
+  end
+
+  text str: 'Fill n <span fgcolor="#ff0000">stroke</span>',
+       color: :green, stroke_width: 2.0, stroke_color: :blue,
+       x: '1.8in', y: '2.9in', width: '0.85in', font: 'Sans Bold 9', markup: true
+
+  text str: 'Stroke n <span fgcolor="#ff0000">fill</span>',
+       color: :green, stroke_width: 2.0, stroke_color: :blue, stroke_strategy: :stroke_first,
+       x: '1.8in', y: '3.0in', width: '0.85in', font: 'Sans Bold 9', markup: true
+
+  text str: 'Dotted',
+       color: :white, stroke_width: 2.0, dash: '4 2', stroke_color: :black,
+       x: '1.8in', y: '3.1in', width: '0.85in', font: 'Sans Bold 9', markup: true
+  #
+  text str: "<b>Markup</b> is <i>quite</i> <s>'easy'</s> <span fgcolor=\"\#ff0000\">awesome</span>. Can't beat those \"smart\" 'quotes', now with 10--20% more en-dashes --- and em-dashes --- with explicit ellipses too...",
+       markup: true,
+       x: 50, y: 1000,
+       width: 750, height: 100,
+       valign: :bottom,
+       font: 'Serif 6', hint: :cyan
+
+  save prefix: 'text_options_', format: :png
+end