squib 0.18.0 → 0.19.0a

data/samples/sprues/_fold_sheet.rb

@@ -1,30 +1,30 @@
-require 'squib'
-
-# Note that this sample has no bleed - you might want to have bleed
-# but tighter than usual: 0.1 instead of 0.125in since this sprue is
-# crowded horizontally on US letter
-Squib::Deck.new(width: '2.5in', height: '3.5in', cards: 8) do
-  background color: :white
-  rect stroke_width: 5, stroke_color: :red
-  # Note that we are interleaving strings
-  # This could be used as a secondary Squib script that loads
-  # Squib-generated individual images
-  strings = [
-    "Front 1",
-    "Back 1",
-    "Front 2",
-    "Back 2",
-    "Front 3",
-    "Back 3",
-    "Front 4",
-    "Back 4",
-  ]
-
-  text str: strings,font: 'Sans 32', align: :center, valign: :middle,
-       height: :deck, width: :deck
-       
-  save_sheet prefix: 'foldable_',
-             sprue: 'letter_poker_foldable_8up.yml' # built-in sprue
-  save_pdf file: 'foldable.pdf',
-           sprue: 'letter_poker_foldable_8up.yml' # built-in sprue
-end
+require 'squib'
+
+# Note that this sample has no bleed - you might want to have bleed
+# but tighter than usual: 0.1 instead of 0.125in since this sprue is
+# crowded horizontally on US letter
+Squib::Deck.new(width: '2.5in', height: '3.5in', cards: 8) do
+  background color: :white
+  rect stroke_width: 5, stroke_color: :red
+  # Note that we are interleaving strings
+  # This could be used as a secondary Squib script that loads
+  # Squib-generated individual images
+  strings = [
+    "Front 1",
+    "Back 1",
+    "Front 2",
+    "Back 2",
+    "Front 3",
+    "Back 3",
+    "Front 4",
+    "Back 4",
+  ]
+
+  text str: strings,font: 'Sans 32', align: :center, valign: :middle,
+       height: :deck, width: :deck
+       
+  save_sheet prefix: 'foldable_',
+             sprue: 'letter_poker_foldable_8up.yml' # built-in sprue
+  save_pdf file: 'foldable.pdf',
+           sprue: 'letter_poker_foldable_8up.yml' # built-in sprue
+end

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: '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
+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/_negative_coords.rb

@@ -1,7 +1,7 @@
-require_relative '../../lib/squib'
-
-Squib::Deck.new(width: 100, height: 100, cards: 3) do 
-  background color: :grey
-  text str: 'Hello', font: 'Sans Bold 10'
-  save_sheet sprue: 'my_sprues/negatives.yml', prefix: 'sprue_negatives_'
+require_relative '../../lib/squib'
+
+Squib::Deck.new(width: 100, height: 100, cards: 3) do 
+  background color: :grey
+  text str: 'Hello', font: 'Sans Bold 10'
+  save_sheet sprue: 'my_sprues/negatives.yml', prefix: 'sprue_negatives_'
 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/system_font_debug/_list_fonts.rb

@@ -1,14 +1,14 @@
-# require 'squib'
-require_relative '../../lib/squib'
-
-# Per issue #334, sometimes Pango doesn't find the font file you want
-# Pango requires fonts to be installed on the system, but sometimes the
-# font name is not obvious. e.g. "Foo Regular" might be actually named "Foo"
-# Use these methods to debug this problem
-
-# Usually you would just run this method to see what fonts are installed
-# This is commented out to make our test cases
-# Squib.print_system_fonts
-
-Squib.system_fonts.include? 'Open Sans' # checks if we have Open Sans installed
-# Note: does nothing since it's just a check
+# require 'squib'
+require_relative '../../lib/squib'
+
+# Per issue #334, sometimes Pango doesn't find the font file you want
+# Pango requires fonts to be installed on the system, but sometimes the
+# font name is not obvious. e.g. "Foo Regular" might be actually named "Foo"
+# Use these methods to debug this problem
+
+# Usually you would just run this method to see what fonts are installed
+# This is commented out to make our test cases
+# Squib.print_system_fonts
+
+Squib.system_fonts.include? 'Open Sans' # checks if we have Open Sans installed
+# Note: does nothing since it's just a check

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,52 +1,52 @@
-require 'squib'
-require 'squib/sample_helpers'
-
-Squib::Deck.new(width: 1000, height: 1450) 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 ellipsize: :autosize, the font size will autoscale.' do |x, y|
-    text str: 'This text doeas not fit with font size 7. It is autoscaled to the largest size that fits instead.', x: x - 50, y: y,
-         hint: :red, width: 350, height: 100, ellipsize: :autoscale, 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: 1450) 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 ellipsize: :autosize, the font size will autoscale.' do |x, y|
+    text str: 'This text doeas not fit with font size 7. It is autoscaled to the largest size that fits instead.', x: x - 50, y: y,
+         hint: :red, width: 350, height: 100, ellipsize: :autoscale, 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