Skriptovací API — přehled

Imposio má vestavěný JavaScript engine (záložka Script). Skripty řídí tytéž operace, které děláte ručně — otevírání dokumentů, impozici, úpravy, export — takže můžete zautomatizovat opakovanou práci a standardizovat výstup.

Spuštění skriptu

Otevřete záložku Script, napište nebo otevřete .js soubor a dejte Run. Své kroky v GUI si můžete i nahrát — Imposio vygeneruje ekvivalentní skript (ukázky na těchto stránkách jsou přesně ta volání, která produkuje recorder).

Objektový model

Vše začíná jediným globálním objektem imposio:

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

• imposio — vstupní bod: otevírání/vytváření dokumentů, jednotky, helpery.
• Dokument — obal nad jedním PDF: operace se stranami, export, metadata, zabezpečení, inspekce.
• Impozice — nastavení setImposition() a generateImposition().
• Editační vrstva — kreslení a manipulace vektorových tvarů, textu a obrázků.
• Příklady — kompletní skripty.

Jednotky

Délky jsou výchozí v milimetrech. Jednotku pro všechna následující volání změníte přes imposio.setUnits() ("mm", "cm", "in", "pt").

Délkové hodnoty akceptují buď číslo (v aktuální jednotce), nebo string se sufixem, který jednotku přebije:

imposio.setUnits("mm");
doc.addBlankPage(-1, 210, 297);     // mm
doc.addBlankPage(-1, "8.5in", "11in");  // explicitní jednotky u hodnoty

Souřadnice

Geometrie používá PDF souřadnice: počátek je levý dolní roh a Y roste nahoru. Indexy stran jsou 0-based. Rozsahy stran jsou stringy: "all", "1-5", "odd", "even", "2,4,7" (prázdný string = všechny).

Zpracování chyb

Metody při selhání vyhodí JavaScript výjimku (např. neplatná enum hodnota nebo chybějící dokument). Riziková volání obalte do try { … } catch (e) { … }, pokud potřebujete chyby zpracovat elegantně. Metody vracející Dokument vrátí při selhání null.