squib 0.0.4 → 0.0.5

data/samples/basic.rb

@@ -1,7 +1,6 @@
-#!/usr/bin/env ruby
 require 'squib'
 
-data = {'name' => ['Thief', 'Grifter', 'Mastermind'], 
+data = {'name' => ['Thief', 'Grifter', 'Mastermind'],
         'level' => [1,2,3]}
 
 Squib::Deck.new(width: 825, height: 1125, cards: 3) do
@@ -10,11 +9,11 @@ Squib::Deck.new(width: 825, height: 1125, cards: 3) do
   rect x: 75, y: 75, width: 128, height: 128, radius: 25
 
   text str: data['name'], x: 220, y: 78, font: 'Arial 54'
-  text str: data['level'], x: 75, y: 85, width: 128, 
+  text str: data['level'], x: 75, y: 85, width: 128,
        font: 'Arial 72', align: :center
 
-   png range: [0,2], file: 'shiny-purse.png', x: 620, y: 75
-   svg range: 1..2, file: 'spanner.svg', x: 620, y: 218
+  png range: [0,2], file: 'shiny-purse.png', x: 620, y: 75
+  svg range: 1..2, file: 'spanner.svg', x: 620, y: 218
 
-  save prefix: 'basic_', format: :png#, progress_bar: true
-end
+  save prefix: 'basic_', format: :png
+end

data/samples/cairo_access.rb

@@ -0,0 +1,27 @@
+require 'squib'
+
+Squib::Deck.new(cards: 2) do
+
+  # If you really need something custom-made, the underlying cairo context
+  # can be accessed directly via each Squib::Card
+  #
+  # WARNING! Input validation is not done on Squib::Cards. Proceed at your own risk.
+
+  # The recommended approach is to use Deck's Enumerable, which iterates over Squib::Cards
+  # I also recommend wrapping it in a Cairo save/restore, which Squib calls "use_cairo"
+  each do |card|
+    card.use_cairo do |cairo_context|
+      cairo_context.set_source_color(:white)
+      cairo_context.paint
+    end
+  end
+
+  # Or the square bracket accessors []
+  self[1].use_cairo do |cairo_context|
+    cairo_context.circle(50, 50, 50)
+    cairo_context.set_source_color(:red)
+    cairo_context.fill
+  end
+
+  save_png prefix: 'cairo_access_'
+end

data/samples/colors.rb

@@ -12,5 +12,5 @@ Squib::Deck.new(width: 825, height: 1125, cards: 1) do
   text color: '#ffff000000009999', str: '12-hex (alpha)', x: 50, y: y+=50
   text color: :burnt_orange, str: 'Symbols of constants too', x: 50, y: y+=50
 
-  save_png prefix: "colors_"
-end
+  save_png prefix: 'colors_'
+end

data/samples/custom-layout.yml

@@ -1,4 +1,4 @@
-frame: 
+frame:
   x: 38
   y: 38
   width: 750
@@ -10,7 +10,7 @@ title:
   width: 625
   height: 100
   align: !ruby/symbol center #see http://www.yaml.org/YAML_for_ruby.html#symbols
-  valign: !ruby/symbol middle  
+  valign: !ruby/symbol middle
 subtitle:
   x: 150
   y: 150
@@ -37,15 +37,15 @@ icon_right:
 # Called "extends"
 # Any layout can extend another layout, so long as it's not a circle
 # Order doesn't matter since it's done after YAML procesing
-# And, if the entry overrides 
+# And, if the entry overrides
 bonus: #becomes our bonus rectangle
   x: 250
   y: 600
   width:  300
   height: 200
   radius: 32
-bonus_inner: 
-  extends: bonus 
+bonus_inner:
+  extends: bonus
   x: += 10 # i.e. 260
   y: += 10 # i.e. 610
   width: -= 20  # i.e. 180

data/samples/custom_config.rb

@@ -3,10 +3,10 @@ require 'squib'
 
 Squib::Deck.new(config: 'custom-config.yml') do
   # Custom color defined in our config
-  background color: :foo 
+  background color: :foo
 
   # Hints are turned on in the config file
-  text str: "The Title", x: 0, y: 78, width: 825,
+  text str: 'The Title', x: 0, y: 78, width: 825,
        font: 'Arial 72', align: :center
 
   # Progress bars are shown for these commands
@@ -14,6 +14,6 @@ Squib::Deck.new(config: 'custom-config.yml') do
   png file: 'shiny-purse2.png', x: 620, y: 75
   svg file: 'spanner2.svg', x: 620, y: 218
   save_png prefix: 'custom-config_'
-  save_pdf file: "custom-config-out.pdf"
+  save_pdf file: 'custom-config-out.pdf'
 
-end
+end

data/samples/draw_shapes.rb

@@ -1,19 +1,19 @@
 require 'squib'
 
-Squib::Deck.new do 
-  rect x: 300, y: 300, width: 400, height: 400, 
+Squib::Deck.new do
+  rect x: 300, y: 300, width: 400, height: 400,
        fill_color: :blue, stroke_color: :red, stroke_width: 50.0
 
   circle x: 600, y: 600, radius: 75,
-         fill_color: :gray, stroke_color: :green, stroke_width: 8.0  
+         fill_color: :gray, stroke_color: :green, stroke_width: 8.0
 
-  triangle x1: 50, y1: 50, 
-           x2: 150, y2: 150, 
+  triangle x1: 50, y1: 50,
+           x2: 150, y2: 150,
            x3: 75, y3: 250
 
-  line x1: 50, y1: 550, 
+  line x1: 50, y1: 550,
        x2: 150, y2: 650,
-       stroke_width: 25.0        
+       stroke_width: 25.0
 
   save_png prefix: 'shape_'
-end
+end

data/samples/hello_world.rb

@@ -1,7 +1,6 @@
-#!/usr/bin/env ruby
 require 'squib'
 
-Squib::Deck.new do
-  text str: 'Hello, World!'  
+Squib::Deck.new(cards: 2) do
+  text str: %w(Hello World!)
   save_png
 end

data/samples/load_images.rb

@@ -19,11 +19,16 @@ Squib::Deck.new(width: 825, height: 1125, cards: 1) do
   # relative to the SVG page. See this example in an SVG editor
   svg file: 'offset.svg', id: 'thing',  x: 0, y: 0, width: 600, height: 600
 
-  # Over 15 different blending operators are supported. 
+  # Over 15 different blending operators are supported.
   # See http://cairographics.org/operators
   # Alpha transparency too
   png file: 'ball.png', x: 50, y: 700
   png file: 'grit.png', x: 70, y: 750, blend: :color_burn, alpha: 0.75
 
+  # Images can be rotated around their upper-left corner
+  png file: 'shiny-purse.png', x: 300, y: 700, angle: 0.0 # default (no rotate)
+  png file: 'shiny-purse.png', x: 300, y: 800, angle: Math::PI / 4
+  svg file: 'spanner.svg',     x: 300, y: 900, angle: Math::PI / 2 - 0.1
+
   save prefix: 'load_images_', format: :png
 end

data/samples/portrait-landscape.rb

@@ -1,23 +1,23 @@
 require 'squib'
 
 # For decks with both landscape and portrait orientations,
-# we recommend using two separate decks. 
+# we recommend using two separate decks.
 # For print-on-demand, we can rotate all of the images in the final step.
 
 # Normal cards
-Squib::Deck.new(width: 825, height: 1125) do 
+Squib::Deck.new(width: 825, height: 1125) do
   background color: '#aaa'
 
-  text str: "This is portrait"
+  text str: 'This is portrait'
 
-  save_png prefix: "portrait_"
+  save_png prefix: 'portrait_'
 end
 
 # Money cards are landscape
 Squib::Deck.new(width: 1125, height: 825) do
   background color: '#aaa'
 
-  text str: "This is landscape"
+  text str: 'This is landscape'
 
-  save_png prefix: "landscape_", rotate: true
-end
+  save_png prefix: 'landscape_', rotate: true
+end

data/samples/ranges.rb

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 require 'squib'
 
-data = {'name' => ['Thief', 'Grifter', 'Mastermind'], 
+data = {'name' => ['Thief', 'Grifter', 'Mastermind'],
         'type' => ['Thug', 'Thinker', 'Thinker'],
         'level' => [1,2,3]}
 
@@ -12,22 +12,22 @@ Squib::Deck.new(width: 825, height: 1125, cards: 3) do
   text str: data['level'], x: 65, y: 40, font: 'Arial 72'
 
   # Could be explicit about using :all, too
-  text range: :all, 
-       str: data['type'], x: 40, y: 128, font: 'Arial 18', 
+  text range: :all,
+       str: data['type'], x: 40, y: 128, font: 'Arial 18',
        width: 100, align: :center
 
   # Ranges are inclusive, zero-based
-  text range: 0..1, str: "Thief and Grifter only!!", x: 25, y:200
+  text range: 0..1, str: 'Thief and Grifter only!!', x: 25, y:200
 
   # Integers are also allowed
-  text range: 0, str: "Thief only!", x: 25, y: 250
+  text range: 0, str: 'Thief only!', x: 25, y: 250
 
   # Negatives go from the back of the deck
-  text range: -1, str: "Mastermind only!", x: 25, y: 250
-  text range: -2..-1, str: "Grifter and Mastermind only!", x: 25, y: 650
+  text range: -1, str: 'Mastermind only!', x: 25, y: 250
+  text range: -2..-1, str: 'Grifter and Mastermind only!', x: 25, y: 650
 
   # We can use Arrays too!
-  text range: [0,2], str: "Thief and Mastermind only!!", x: 25, y:300
+  text range: [0,2], str: 'Thief and Mastermind only!!', x: 25, y:300
 
   # Just about everything in Squib can be given an array that
   # corresponds to the deck's cards. This allows for each card to be styled differently
@@ -40,16 +40,15 @@ Squib::Deck.new(width: 825, height: 1125, cards: 3) do
   # Useful idiom: construct a hash from card names back to its index (ID),
   # then use a range. No need to memorize IDs, and you can add cards easily
   id = {} ; data['name'].each_with_index{ |name,i| id[name] = i}
-  text range: id['Thief']..id['Grifter'], 
-       str: "Thief through Grifter with id lookup!!",  
+  text range: id['Thief']..id['Grifter'],
+       str: 'Thief through Grifter with id lookup!!',
        x:25, y: 400
 
   # Useful idiom: generate arrays from a column called 'type'
   type = {}; data['type'].each_with_index{ |t,i| (type[t] ||= []) << i}
-  text range: type['Thinker'], 
-       str: "Only for Thinkers!",  
+  text range: type['Thinker'],
+       str: 'Only for Thinkers!',
        x:25, y: 500
-       
+
   save prefix: 'ranges_', format: :png
 end
-

data/samples/save_pdf.rb

@@ -7,8 +7,8 @@ Squib::Deck.new(width: 825, height: 1125, cards: 16) do
 
   text str: (1..16).to_a, x: 220, y: 78, font: 'Arial 54'
 
-  save_pdf file: "sample-save-pdf.pdf", margin: 75, gap: 5, trim: 37
+  save_pdf file: 'sample-save-pdf.pdf', margin: 75, gap: 5, trim: 37
 
   #Note that our PNGs still are not trimmed even though the pdf ones are
-  save_png range: 1, prefix: "save_pdf_"
+  save_png range: 1, prefix: 'save_pdf_'
 end

data/samples/text_options.rb

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 require 'squib'
 
-data = {'name' => ['Thief', 'Grifter', 'Mastermind'], 
+data = {'name' => ['Thief', 'Grifter', 'Mastermind'],
         'level' => [1,2,3]}
 longtext = "This is left-justified text.\nWhat do you know about tweetle beetles? well... \nWhen 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. AND... When beetles fight these battles in a bottle with their paddles and the bottle's on a poodle and the poodle's eating noodles... ...they call this a muddle puddle tweetle poodle beetle noodle bottle paddle battle."
 
@@ -16,52 +16,52 @@ Squib::Deck.new(width: 825, height: 1125, cards: 3) do
 
   text str: "UTF-8 \u2663", x: 565, y: 150, font: 'Arial weight=900 36'
 
-  text str: "Font strings are expressive!", x:65, y: 200,
+  text str: 'Font strings are expressive!', x:65, y: 200,
        font: 'Impact bold italic 36'
 
-  text str: "Font strings are expressive!", x:65, y: 300,
+  text str: 'Font strings are expressive!', x:65, y: 300,
        font: 'Arial,Verdana weight=900 style=oblique 36'
 
-  text str: "Font string sizes can be overridden per card.", x: 65, y: 350,
+  text str: 'Font string sizes can be overridden per card.', x: 65, y: 350,
        font: 'Impact 36', font_size: [16, 20, 24]
 
-  text str: "This text has fixed width, fixed height, center-aligned, middle-valigned, and has a red hint", 
+  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,
-       align: :center, valign: :middle,
+       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",
+  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,
        ellipsize: true
 
   hint text: :cyan
-  text str: "Text hints are also globally togglable!",
+  text str: 'Text hints are also globally togglable!',
         x: 65, y: 625,
         font: 'Arial 22'
   hint text: :off
-  text str: "See? No hint here.",
+  text str: 'See? No hint here.',
         x: 565, y: 625,
         font: 'Arial 22'
 
-  text str: "Rotated",
-        x: 565, y: 675, angle: 0.1,
-        font: 'Arial 18'
+  text str: 'Rotated',
+        x: 565, y: 675, angle: 0.2,
+        font: 'Arial 18', hint: :red
 
   text str: longtext, font: 'Arial 16',
-       x: 65, y: 700, 
-       width: inches(2.25), height: inches(1), 
+       x: 65, y: 700,
+       width: inches(2.25), height: inches(1),
        justify: true
 
-  text str: "<b>Markup</b> is also <i>quite</i> <s>easy</s> awesome", 
+  text str: '<b>Markup</b> is also <i>quite</i> <s>easy</s> awesome',
        markup: true,
        x: 50, y: 1000,
-       width: 750, height: 100, 
+       width: 750, height: 100,
        valign: :bottom,
        font: 'Arial 32', hint: :cyan
-  
+
   save prefix: 'text_', format: :png
 end

data/samples/tgc_proofs.rb

@@ -2,7 +2,7 @@
 require 'squib'
 
 # This sample uses a proof overlay from TheGameCrafter.com to check bleed
-Squib::Deck.new(width: 825, height: 1125, cards: 1) do 
+Squib::Deck.new(width: 825, height: 1125, cards: 1) do
   background color: :white
   rect x: 38, y: 38, width: 750, height: 1050, x_radius: 38, y_radius: 38
   rect x: 75, y: 75, width: 128, height: 128, x_radius: 25, y_radius: 25
@@ -15,6 +15,6 @@ Squib::Deck.new(width: 825, height: 1125, cards: 1) do
 
   # TGC proof overlay
   png file: 'pokercard.png', x:0, y:0, alpha: 0.5
-  
+
   save_png prefix: 'tgc_sample_'
-end
+end

data/samples/use_layout.rb

@@ -1,6 +1,6 @@
 require 'squib'
 
-Squib::Deck.new(layout: 'custom-layout.yml') do 
+Squib::Deck.new(layout: 'custom-layout.yml') do
   background color: :white
   hint text: :cyan
 
@@ -29,6 +29,6 @@ Squib::Deck.new(layout: 'custom-layout.yml') do
   # For debugging purposes, you can always print out the loaded layout
   #require 'pp'
   #pp @layout
-  
+
   save_png prefix: 'layout_'
-end
+end

data/spec/api/api_text_spec.rb

@@ -3,37 +3,31 @@ require 'squib'
 
 describe Squib::Deck, '#text' do
 
-  context "fonts" do
+  context 'fonts' do
      it "should use the default font when #text and #set_font don't specify" do
       card = instance_double(Squib::Card)
-      expect(card).to receive(:text).with('a', 'Arial 36', 
-                                    anything, anything, anything,anything,anything,anything, anything, anything, anything,anything, anything, anything, anything, anything, anything
-                                    ).once
-      Squib::Deck.new do  
-        @cards = [card] 
+      expect(card).to receive(:text).with('a', 'Arial 36', *([anything] * 15)).once
+      Squib::Deck.new do
+        @cards = [card]
         text str: 'a'
       end
     end
 
     it "should use the #set_font when #text doesn't specify" do
       card = instance_double(Squib::Card)
-      expect(card).to receive(:text).with('a', 'Times New Roman 16', 
-                                    anything, anything, anything, anything,anything,anything, anything, anything, anything,anything, anything, anything, anything, anything, anything
-                                    ).once
-      Squib::Deck.new do  
-        @cards = [card] 
+      expect(card).to receive(:text).with('a', 'Times New Roman 16', *([anything] * 15)).once
+      Squib::Deck.new do
+        @cards = [card]
         set font: 'Times New Roman 16'
         text str: 'a'
       end
     end
 
-    it "should use the specified font no matter what" do
+    it 'should use the specified font no matter what' do
       card = instance_double(Squib::Card)
-      expect(card).to receive(:text).with('a', 'Arial 18', 
-                                    anything, anything, anything, anything,anything,anything,anything, anything, anything,anything, anything, anything, anything, anything, anything
-                                    ).once
-      Squib::Deck.new do  
-        @cards = [card] 
+      expect(card).to receive(:text).with('a', 'Arial 18', *([anything] * 15)).once
+      Squib::Deck.new do
+        @cards = [card]
         set font: 'Times New Roman 16'
         text str: 'a', font: 'Arial 18'
       end