compile-pdf-white-underbase 0.1.0

CompilePDF white-underbase producer — white-ink / underbase plate generation for PDFs.

compile-pdf-white-underbase

CompilePDF white / underbase producer — generates a named white-ink (or underbase / varnish / foil) separation plate for an input PDF.

Given an input PDF plus a policy describing how to derive the plate, the producer registers a named DeviceN white separation in the output PDF. White printing on transparent / dark substrates (labels, garment prints, foil-stamped artwork) needs a white plate that lays down under every printable element; screen-printing on dark fabric needs an underbase plate so the coloured inks read true. Auto-generating the plate from the existing artwork keeps it in register at every revision.

Like the other producers it is content-addressed (deterministic cache key) and its router mounts into the central compile-pdf app, gated by COMPILE_PRODUCER.

Engine status: today's engine is a passthrough — it returns the input bytes verbatim with a fully-populated summary. The wire contract (request / response shape, cache-key derivation) is final so hosts can wire UI today; the underbase tracer lands in a follow-up.

Part of the CompilePDF producer family; each producer lives in its own repo and PyPI package. See compile-pdf for the orchestrator that mounts them.

Install

uv pip install compile-pdf-white-underbase

HTTP surface

Mounted under /v1/white-underbase by the host app:

• POST /v1/white-underbase/apply — { input_pdf_b64, policy? } → the output PDF (base64), content hashes, cache key, and a generation summary.

CLI

compile-pdf-white-underbase [--policy policy.json] [--no-verify] in.pdf out.pdf

License

AGPL-3.0-or-later. Copyright © 2024–2026 Print with Synergy.