Preskočiť na obsah

Skriptovacie API — prehľad

Imposio má zabudovaný JavaScript engine (tab Script). Skripty riadia tie isté operácie, ktoré robíte ručne — otváranie dokumentov, impozíciu, úpravy, export — takže viete zautomatizovať opakovanú prácu a štandardizovať výstup.

Spustenie skriptu

Otvorte tab Script, napíšte alebo otvorte .js súbor a dajte Run. Svoje kroky v GUI si môžete aj nahrať — Imposio vygeneruje ekvivalentný skript (ukážky na týchto stránkach sú presne tie volania, ktoré produkuje recorder).

Objektový model

Všetko začína jediným globálnym objektom 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: otváranie/vytváranie dokumentov, jednotky, helpery.
  • Dokument — obal nad jedným PDF: operácie so stranami, export, metadáta, zabezpečenie, inšpekcia.
  • Impozícia — nastavenia setImposition() a generateImposition().
  • Editovacia vrstva — kreslenie a manipulácia vektorových tvarov, textu a obrázkov.
  • Príklady — kompletné skripty.

Jednotky

Dĺžky sú predvolene v milimetroch. Jednotku pre všetky nasledujúce volania zmeníte cez imposio.setUnits() ("mm", "cm", "in", "pt").

Dĺžkové hodnoty akceptujú buď číslo (v aktuálnej jednotke), alebo string so sufixom, ktorý jednotku prebije:

imposio.setUnits("mm");
doc.addBlankPage(-1, 210, 297);     // mm
doc.addBlankPage(-1, "8.5in", "11in");  // explicitné jednotky pri hodnote

Súradnice

Geometria používa PDF súradnice: počiatok je ľavý dolný roh a Y rastie nahor. Indexy strán sú 0-based. Rozsahy strán sú stringy: "all", "1-5", "odd", "even", "2,4,7" (prázdny string = všetky).

Spracovanie chýb

Metódy pri zlyhaní vyhodia JavaScript výnimku (napr. neplatná enum hodnota alebo chýbajúci dokument). Rizikové volania obaľte do try { … } catch (e) { … }, ak potrebujete chyby spracovať elegantne. Metódy vracajúce Dokument vrátia pri zlyhaní null.