Command Line

Command line

Everything the interactive interface does is also a command, so a build can be scripted, run from a Makefile, or driven by an agent. Every command explains itself:

tayda-uv help
tayda-uv help convert

Flags go before the image file name, as in every example below. Options placed after it are taken as extra file names and rejected.

enclosures

tayda-uv enclosures

Lists the enclosures the tool knows: 125B 1590A 1590B 1590BB 1590BB2 1590D 1590DD 1590XX.

sides

tayda-uv sides 1590B

SIDE  ARTBOARD       MIN PIXELS @300DPI  TOLERANCE
A     56 × 108.5 mm  662 × 1282          ±0.50 mm
B     52 × 24 mm     615 × 284           ±1.00 mm
C     24 × 103 mm    284 × 1217          ±1.00 mm
D     52 × 24 mm     615 × 284           ±1.00 mm
E     24 × 103 mm    284 × 1217          ±1.00 mm
Lid   56 × 108.5 mm  662 × 1282          ±1.00 mm

The artboard each side needs, the smallest image that reaches 300 DPI at that size, and Tayda's printing tolerance for it. All eight tables are on Enclosure sizes.

validate

tayda-uv validate -e <enclosure> -s <side> <image>

Checks artwork against a side and writes nothing. Exit code 0 means ready to print, 1 means not.

artwork face.png: PNG, 700 × 1356 px
  side A: 56 × 108.5 mm, artwork lands at 318 × 317 DPI
  warning: aspect ratio is off by 0.02%, within tolerance; artwork will be scaled to fill the artboard

problem: lines block printing: resolution under 300 DPI at the artboard's size, or an aspect ratio more than 0.5% off. warning: lines do not block but are worth reading: small aspect drift, or an image that is landscape where the side is portrait, which usually means it is rotated 90°.

Flag	Meaning
-e	enclosure name, e.g. 1590B
-s	side: A, B, C, D, E or Lid
-dpi	resolution to render SVG artwork at (default 600); ignored for other formats

convert

tayda-uv convert -e <enclosure> -s <side> [options] <image>

Writes the print-ready PDF for one side. It runs the same checks as validate first and refuses to write if there are problems, so a separate validate is only needed when you want to check without producing a file.

artwork face.png: PNG, 700 × 1356 px
  side A: 56 × 108.5 mm, artwork lands at 318 × 317 DPI

wrote face.pdf — 56 × 108.5 mm, layers: RDG_WHITE → CMYK
check it with Tayda's PDF Analyzer before ordering.

Flag	Meaning
-e	enclosure name
-s	side
-o	output file; default is <image>-<enclosure>-<side>.pdf, lowercased (face-1590b-a.pdf)
-white	RDG_WHITE undercoat: none, auto (default) or full
-gloss	RDG_GLOSS varnish: none (default), full, artwork or mask
-gloss-mask	image marking where the varnish goes; implies -gloss mask
-dpi	resolution to render SVG artwork at (default 600)
-force	write the PDF even if validation finds problems

Run it once per side; each PDF holds a single artboard, which is what the Tayda Box Tool expects. White and gloss explains the layer options.

The PDF is written atomically: it is rendered to a temporary file next to the destination and renamed into place, so a failed conversion leaves nothing behind rather than an empty file named like a finished artboard.

-force exists for the case where you have looked at the problems and decided to print anyway — an aspect ratio a hair over the limit on artwork you have already adjusted, say. Tayda will print whatever you send. Do not put it in a script.

inspect

tayda-uv inspect [-e <enclosure> -s <side>] <pdf>...

Reads a finished PDF back and reports what is actually in it. Detail on Checking the output.

face.pdf: 1 page, 158.74 × 307.56 pt
  artboard: 56 × 108.5 mm            1590B side A OK
  colour:   DeviceCMYK               no RGB OK
  spots:    RDG_WHITE                OK
  order:    RDG_WHITE → CMYK         OK

Flag	Meaning
-e	assert the artboard is this enclosure's
-s	assert the artboard is this side's

Without -e and -s it names every side matching the artboard size, which is usually two (A and Lid are the same size, as are B and D, and C and E). With them, it fails if the file is for any other side. Takes any number of files and exits 0 only if every one passes.

Exit codes

Code	Meaning
0	Worked. For validate and inspect: the file passed.
1	The work failed: artwork not printable, PDF did not pass, unreadable image, write error.
2	The command was typed wrong: unknown enclosure or side, missing flag, wrong number of files.

So a script can tell "no such enclosure" from "this artwork is too low-res". Usage errors print a pointer to the relevant tayda-uv help <command>.

Help

tayda-uv help, tayda-uv help <command>, tayda-uv --help and tayda-uv <command> -h all work. Help you asked for goes to stdout and exits 0, so tayda-uv help convert | less behaves. Help shown because of a mistake goes to stderr with exit 2.

Converting all six sides

There is no batch mode, so doing a whole enclosure is a loop. convert validates each side itself and skips what it cannot print; inspect confirms what was written:

for s in A B C D E Lid; do
  tayda-uv convert -e 1590B -s "$s" -white full -o "fuzz-$s.pdf" "art-$s.png" &&
  tayda-uv inspect -e 1590B -s "$s" "fuzz-$s.pdf"
done

Or, in a Makefile, one rule per side so only the artwork that changed is reconverted:

ENC = 1590B
SIDES = A B C D E Lid

all: $(SIDES:%=fuzz-%.pdf)

fuzz-%.pdf: art-%.png
	tayda-uv convert -e $(ENC) -s $* -white full -o $@ $<
	tayda-uv inspect -e $(ENC) -s $* $@