davidhollis/cardboard-rs

A command-line utility for rendering playtest cards for custom board and card games, as individual print-ready images or print-and-play PDFs

cardboard

A command-line utility for rapidly prototyping board and card games [, eventually!]

Developing

There's not much here yet, but it's relatively vanilla Rust: any development environment that's capable of working with cargo should be just fine. To get started:

cargo build
cargo test

cardboard-rs's Issues

Load card sets

Read in excel sheets, csvs, yaml documents, and kdl documents and produce arrays of card contexts.

Expand Stroke model

Add support for stroke colors, widths, dash patterns, and joint types

Add models for other kinds of shapes

Add models for:

• corner_radius=n property on the existing rectangle
• triangle x1 y1 x2 y2 x3 y3
• polygon nsides cx cy radius [angle]
• star npoints cx cy in-radius out-radius [angle]
• ellipse cx cy x-radius y-radius [angle]
• circle cx cy radius
• path { [<path-operation>]* [<path-style>]* }

Add model for group

Add Group container model with transformation, clipping, and support for only-if

Add support for indirection in card sets

Allow cards to reference external dictionaries for shared values (factions, categories, etc)

Add color model with support for templating color names

Add knuffel decoder for `Insets` to support uniform case

Add support for a 1-argument version that expands to Insets::uniform.

Create a usable CLI for the V1 functionality

Add support for base text styles

Add a base element (name subject to change) that sets base styles that subsequent text elements inherit from

Add printing metrics modeling for laying out multiple cards in a pdf

With presets for popular printers

Add configuration options for other printing modes

Support modes such as:

• print wireframes
• suppress crop lines
• print cut and/or safe lines
• overprint into gutters

Add model for images

image { frame; [<image-style>]+ }

Create a set of stock layouts

Enable embedded icons in text objects

Support image transparency

Expand Font model

Add support for different forms of text formatting supported by whatever rendering engine we end up going with

Write V1 docs

Support scaling images as a 9-part grid

Add support for rotating and reflecting cards in sheet layouts

The properties are there, but when actually placing cards on sheets we don't do any orientation changes.

Expand text formatting

Add some rudimentary markup features and snippets to make text handling easier

Add support for fill types outside of solid, transparent

Add rendering

Add a rendering engine (almost certainly either skia or cairo) that's capable of producing a png from a layout and a context

Cut version 1.0.0

Add handlebars templating

Add a global handlebars instance (probably initialized with lazy_static!) and then hook it up to layout::templates::TemplateAwareString.

Add config model

Add a config model and CLI that includes options to control the rendering pipeline, e.g.:

• don't draw anything, just validate the model
• just draw bounding boxes for everything
• include the cut and safe lines
• for single cards, clip to the cut line