Kihagyás

Szkript API — áttekintés

Az Imposio beépített JavaScript motort tartalmaz (a Script fülön). A szkriptek ugyanazokat a műveleteket hajtják végre, amelyeket kézzel is elvégezhetsz — dokumentumok megnyitása, impozálás, szerkesztés, exportálás — az ismétlődő munka automatizálásához és a kimenet szabványosításához.

Szkript futtatása

Nyisd meg a Script fület, írj vagy nyiss meg egy .js fájlt, majd futtasd (Run). A felületen végzett műveleteket is rögzítheted: az Imposio megírja az egyenértékű szkriptet (az ezeken az oldalakon lévő kódrészletek pontosan azok a hívások, amelyeket a rögzítő produkál).

Az objektummodell

Minden egyetlen globális objektumból indul ki: imposio:

imposio.setUnits("mm");
var doc = imposio.open("/path/to/file.pdf");   // → egy Document
doc.setImposition({ /* … */ });
var out = doc.generateImposition();            // → egy új Document
out.save("/path/to/out.pdf");
  • imposio — a belépési pont: dokumentumok megnyitása/létrehozása, egységek, segédprogramok.
  • Document — egy PDF burkolója: oldalműveletek, exportálás, metaadatok, biztonság, ellenőrzés.
  • Imposition — setImposition() és generateImposition() beállítások.
  • Szerkesztési réteg — vektoros alakzatok, szöveg és képek rajzolása és kezelése.
  • Példák — teljes szkriptek.

Egységek

A hosszak alapértelmezés szerint milliméterben vannak megadva. Az összes következő hívás egységét imposio.setUnits() segítségével változtathatod meg ("mm", "cm", "in", "pt").

A hosszértékek elfogadnak számot (az aktuális egységben) vagy utótaggal ellátott karakterláncot, amely kikényszeríti az egységet:

imposio.setUnits("mm");
doc.addBlankPage(-1, 210, 297);           // mm
doc.addBlankPage(-1, "8.5in", "11in");   // explicit egység értékenként

Koordináták

A geometria PDF-koordinátákat használ: az origó a bal alsó sarokban van, és Y felfelé nő. Az oldalindexek 0-alapúak. Az oldaltartományok karakterláncok: "all", "1-5", "odd", "even", "2,4,7" (üres = összes).

Hibakezelés

A sikertelen metódusok JavaScript-kivételt dobnak (pl. érvénytelen enum érték, vagy hiányzó dokumentum). Kerítsd be a kockázatos hívásokat try { … } catch (e) { … } blokkba, ha a hibákat tisztán akarod kezelni. A Documentot visszaadó metódusok hiba esetén null-t adnak vissza.