You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
3.8 KiB
65 lines
3.8 KiB
Hello, World! Dissected |
|
======================= |
|
|
|
After seeing Squib's `landing page <http://squib.rocks>`_, your might find it helpful to dissect what's really going on in each line of code of a basic Squib snippet. |
|
|
|
.. code-block:: ruby |
|
:linenos: |
|
|
|
require 'squib' |
|
|
|
Squib::Deck.new width: 825, height: 1125, cards: 2 do |
|
background color: 'pink' |
|
rect |
|
text str: ['Hello', 'World!'] |
|
save_png prefix: 'hello_' |
|
end |
|
|
|
Let’s dissect this: |
|
|
|
* Line 1: this code will bring in the Squib library for us to use. Keep this at the top. |
|
* Line 2: By convention, we put a blank line between our require statements and the rest of our code |
|
* Line 3: Define a new deck of cards. Just 2 cards. 825 pixels wide etc. Squib also supports :doc:`/units` if you prefer to specify something like ``'2.75in'``. |
|
* Line 4: Set the background to pink. Colors can be in various notations, and supports linear and radial graidents - see :doc:`/colors`. |
|
* Line 5: Draw a rectangle around the edge of each card. Note that this has no arguments, because :doc:`/parameters`. The defaults can be found in the DSL reference for the :doc:`/dsl/rect` method. |
|
* Line 6: Put some text in upper-left the corner of the card, using the default font, etc. See the :doc:`/dsl/text` DSL method for more options. The first card will have ``'Hello'`` and the second card will have ``'World'`` because :doc:`/arrays`. |
|
* Line 7: Save our card out to a png files called ``hello_00.png`` and ``hello_01.png`` saved in the ``_output`` folder. |
|
|
|
Dissection of "Even Bigger..." |
|
------------------------------ |
|
|
|
On Squib's `landing page <http://squib.rocks>`_ we end with a pretty complex example. It's compact and designed to show how much you can get done with a little bit of code. Here's a dissection of that. |
|
|
|
.. code-block:: ruby |
|
:linenos: |
|
|
|
require 'squib' |
|
|
|
Squib::Deck.new(cards: 4, layout: %w(hand.yml even-bigger.yml)) do |
|
background color: '#230602' |
|
deck = xlsx file: 'even-bigger.xlsx' |
|
svg file: deck['Art'], layout: 'Art' |
|
|
|
%w(Title Description Snark).each do |key| |
|
text str: deck[key], layout: key |
|
end |
|
|
|
%w(Attack Defend Health).each do |key| |
|
svg file: "#{key.downcase}.svg", layout: "#{key}Icon" |
|
text str: deck[key], layout: key |
|
end |
|
|
|
save_png prefix: 'even_bigger_' |
|
showcase file: 'showcase.png', fill_color: '#0000' |
|
hand file: 'hand.png', trim: 37.5, trim_radius: 25, fill_color: '#0000' |
|
end |
|
|
|
* Line 3: Make 4 cards. Use two layouts: the built-in hand.yml (see :doc:`/layouts`) and then our own layout. The layouts get merged, with our own `even-bigger.yml` overriding ``hand.yml`` whenever they collide. |
|
* Line 5: Read some data from an Excel file, which amounts to a column-based hash of arrays, so that each element of an array corresponds to a specific data point to a given card. For example, ``3`` in the ``'Attack'`` column will be put on the second card. |
|
* Line 6: Using the Excel data cell for the filename, we can customize a different icon for every card. But, every SVG in this command will be styled according to the ``Art`` entry in our layout (i.e. in ``even-bigger.yml``) |
|
* Line 8: Iterate over an array of strings, namely, ``'Title'``, ``'Description'``, and ``'Snark'``. |
|
* Line 9: Draw text for the (Title, Description, or Snark), using *their* styling rules in our layout. |
|
* Line 13: Using `Ruby String interpolation <https://en.wikibooks.org/wiki/Ruby_Programming/Syntax/Literals#Interpolation>`_, lookup the appropriate icon (e.g. ``'attack.svg'``), converted to lowercase letters, and then using the Icon layout of that for styling (e.g. ``'AttackIcon'`` or ``'DefendIcon'``) |
|
* Line 17: Render every card to individual PNG files |
|
* Line 18: Render a "showcase" of cards, using a perspective-reflect effect. See :doc:`/dsl/showcase` method. |
|
* Line 19: Render a "hand" of cards (spread over a circle). See :doc:`/dsl/hand` method.
|
|
|