Ausschießen

setImposition(settings)

Wendet Ausschieß-Einstellungen an. Das Objekt ist ein partielles Overlay — ausgelassene Schlüssel behalten ihren aktuellen Wert. Gibt true zurück; ein unbekannter Enum-Wert wirft eine Exception. Längen sind in der aktuellen Einheit (oder als String mit Suffix wie "6mm"); Legacy-Schlüssel …Mm/…Pt sind immer Millimeter/Punkte.

doc.setImposition({
  sheet:  { preset: "SRA3", portrait: true },
  layout: { type: "Booklet", cols: 2, rows: 2, order: "Z" },
  cropMarks: { enabled: true },
});

sheet

Schlüssel	Typ	Werte / Hinweise
preset	string	Papier-Preset (setzt Größe); Liste unten
portrait	bool	Ausrichtung
width / height	number|string	Explizite Größe (überschreibt Preset). Legacy: widthMm, heightMm

preset-Werte: Auto, Custom, A0–A4, B0–B3, SRA0–SRA4, Letter, Legal, Tabloid, SuperB, ArchB, 19x25, 23x35, 25x38, 28x40 (Groß-/Kleinschreibung egal; Aliase mit US-Präfix werden ebenfalls akzeptiert).

layout

Schlüssel	Typ	Werte / Hinweise
type	string	Ausschieß-Typ (unten)
autoMode	string	FitGridToSheet, FitSheetToGrid, Manual
cols, rows	int	Raster
order	string	Z, N, ZReverse, NReverse
scale	string	Fit, Fill, None (100%)
placedRotation	string	Auto, 0, 90, 180, 270
gutterH, gutterV	Länge	Stege zwischen Zellen (legacy gutterHMm/gutterVMm)
spine	Länge	Booklet-Bundsteg zwischen Facing-Paaren (legacy spineMm)
gutterAuto	bool	Stege automatisch berechnen
marginTop, marginBottom, marginLeft, marginRight	Länge	Bogenränder

type-Werte: NUp, Booklet, Section, Sequential, StepRepeat, CutAndStack, FlipCalendar, TriFold, WallCalendar, Accordion, HalfFold, GreetingCard.

source

Schlüssel	Typ	Werte
mode	string	all, selected, range
range	string	Seitenbereich bei mode:"range" (z. B. "1-8")

cropMarks

Schlüssel	Typ	Werte / Hinweise
enabled	bool
length	Länge	Markenlänge (legacy lengthMm)
offset	Länge	Abstand vom Endformat (legacy offsetMm)
weight	number (pt)	Linienstärke (legacy weightPt)
sides	string	both, front, back, first (firstpage), last (lastpage)
centerMarks	bool
registrationMarks	bool

booklet

Rückstich / Lagenbindung.

Schlüssel	Typ	Werte / Hinweise
foldScheme	string	4pp, 8pp, 16pp, 16ppWide (oder 4/8/16/wide)
bindingEdge	string	left, right
duplexFlip	string	short (left), long (top)
creep	bool	Creep-/Bundzuwachs-Kompensation
paperCaliper	Länge	Papierdicke für Creep (legacy paperCaliperMm)
sheetsPerSig	int	Bogen je Lage (Klebebindung)

stepRepeat

Gang-up mehrerer Motive.

Schlüssel	Typ	Werte
sides	string	simplex, duplex
perDesign	string	ownSheet, equal, count
count	int	Kopien je Motiv (bei count)
fill	string	cycle, blank
backFlip	string	left, top (Wendekante der Rückseite bei Duplex)

Bei sides: "duplex" paart der Planner die Quellseiten zu Vorder-/Rückseiten-Motiven und erzeugt Vorder- und Rückbogen, mit gespiegelten Positionen für die physische Wendung gemäß backFlip.

sequential / cutStack

Zweiseitige Nutzen für die Typen Sequential und Cut & Stack. Seiten paaren sich Vorder-/Rückseite (Seite 1 = Vorderseite, Seite 2 = ihre Rückseite, …); die Ausgabebögen wechseln Vorder- und Rückseite ab, und eine ungerade Seitenzahl lässt die letzte Rückseite leer.

Schlüssel	Typ	Werte
sides	string	simplex, duplex
backFlip	string	left, top (Wendekante der Rückseite)

Duplex-Ausgabe (Booklet, Section, Half-fold, Tri-fold, zweiseitiges Step & Repeat, Flip calendar, …) trägt außerdem einen Duplex-Druckhinweis im PDF (/ViewerPreferences /Duplex), sodass Druckdialoge beidseitigen Druck mit der richtigen Wendekante vorauswählen.

output

Schlüssel	Typ	Werte / Hinweise
profile	string	pdf (Standard), rasterized (flatten), gs (Ghostscript)
gsPreset	string	prepress, printer, ebook, screen, pdfx1a, custom
gsArgs	string	Zusätzliche Ghostscript-Argumente (custom-Preset)
dpi	int	Raster-DPI
cmyk	bool	In CMYK rastern (auch toCmyk)
intent	string|int	perceptual, relative, saturation, absolute (oder 0–3)
iccProfile	Pfad	CMYK-ICC-Profil (leer = mitgeliefertes GRACoL); Alias cmykProfile
rasterizer	string	inhouse (Standard) / gs
gsRasterize	bool	Transparenz vor Ghostscript abflachen

targetVersion

Zielversion des Ausgabe-PDFs: "1.3"–"1.7" oder "latest" (Standard 1.4).

generateImposition() → Dokument

Erzeugt das ausgeschossene PDF aus den aktuellen Einstellungen und gibt es als neues Dokument zurück (null + Exception bei Fehler).

var out = doc.generateImposition();
out.save("/path/booklet_imposed.pdf", { autoIndex: true });

Ein vollständiges, aufgezeichnetes Settings-Objekt finden Sie in den Beispielen.