Skript-API — Überblick

Imposio bettet eine JavaScript-Engine ein (der Script-Tab). Skripte steuern dieselben Operationen, die Sie von Hand ausführen — Dokumente öffnen, ausschießen, bearbeiten, exportieren — und automatisieren so wiederkehrende Arbeit.

Ein Skript ausführen

Öffnen Sie den Script-Tab, schreiben oder öffnen Sie eine .js-Datei und klicken Sie Run. Sie können Ihre Aktionen in der Oberfläche auch aufzeichnen — Imposio schreibt das äquivalente Skript (die Snippets auf diesen Seiten sind genau die Aufrufe, die der Recorder erzeugt).

Das Objektmodell

Alles beginnt bei einem einzigen globalen Objekt, imposio:

imposio.setUnits("mm");
var doc = imposio.open("/path/to/file.pdf");   // → ein Dokument
doc.setImposition({ /* … */ });
var out = doc.generateImposition();            // → ein neues Dokument
out.save("/path/to/out.pdf");

• imposio — der Einstiegspunkt: Dokumente öffnen/erstellen, Einheiten, Helfer.
• Dokument — Hülle um ein PDF: Seitenoperationen, Export, Metadaten, Sicherheit, Inspektion.
• Ausschießen — setImposition()-Einstellungen und generateImposition().
• Bearbeitungsebene — Vektorformen, Text und Bilder zeichnen und manipulieren.
• Beispiele — komplette Skripte.

Einheiten

Längen sind standardmäßig in Millimetern. Die Einheit für alle folgenden Aufrufe ändern Sie mit imposio.setUnits() ("mm", "cm", "in", "pt").

Längenwerte akzeptieren entweder eine Zahl (in der aktuellen Einheit) oder einen String mit Suffix, der die Einheit überschreibt:

imposio.setUnits("mm");
doc.addBlankPage(-1, 210, 297);     // mm
doc.addBlankPage(-1, "8.5in", "11in");  // explizite Einheiten je Wert

Koordinaten

Die Geometrie nutzt PDF-Koordinaten: Der Ursprung ist die linke untere Ecke, Y zeigt nach oben. Seitenindizes sind 0-basiert. Seitenbereiche sind Strings: "all", "1-5", "odd", "even", "2,4,7" (leerer String = alle).

Fehlerbehandlung

Fehlschlagende Methoden werfen eine JavaScript-Exception (z. B. ungültiger Enum-Wert oder fehlendes Dokument). Umhüllen Sie riskante Aufrufe mit try { … } catch (e) { … }, wenn Sie Fehler elegant behandeln möchten. Methoden, die ein Dokument liefern, geben bei Fehlern null zurück.