save_sheet¶
Lays out the cards in range and renders a stitched PNG sheet
Options¶
- range
default:
:all
the range of cards over which this will be rendered. See {file:README.md#Specifying_Ranges Specifying Ranges}
- sprue
default:
nil
the sprue file to use. If
nil
, then no sprue is used and the cards are laid out automatically using the parameters below. If non-nil, Squib checks for a built-in sprue file of that name. Otherwise, it attempts to open a file relative to the current directory. For more information on Squib Sprues, see Sprue Thy Sheets.- columns
default:
5
the number of columns in the grid. Must be an integer
- rows
default:
:infinite
the number of rows in the grid. When set to :infinite, the sheet scales to the rows needed. If there are more cards than rows*columns, new sheets are started.
- prefix
default:
card_
the prefix of the file name(s)
- count_format
default:
'%02d'
the format string used for formatting the card count (e.g. padding zeros). Uses a Ruby format string (see the Ruby doc for
Kernel::sprintf
for specifics)- suffix
default:
''
the suffix of all the filenames saved, just before the .png extension.
- dir
default:
'_output'
the directory to save to. Created if it doesn’t exist.
- margin
default:
0
the margin around the outside of the sheet. Supports Unit Conversion.
- gap
default
0
the space in pixels between the cards. Supports Unit Conversion.
- trim
default
0
the space around the edge of each card to trim (e.g. to cut off the bleed margin for print-and-play). Supports Unit Conversion. Must be the same for all cards.
- trim_radius
default:
0
the rounded rectangle radius around the card to trim before saving. Supports Unit Conversion. Must be the same for all cards.
- rtl
default
false
whether to render columns right to left, used for duplex printing of card backs