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

Examples