Az imposio objektum¶
A globális belépési pont. Megnyitja és létrehozza a dokumentumokat, és vezérli az egységeket.
Dokumentumok megnyitása és létrehozása¶
imposio.open(path, opts?)¶
Fájl megnyitása a lemezről. Kiterjesztés szerint: PDF (közvetlenül), képek
(PNG/JPEG/BMP/GIF/TIFF/WebP → egy oldal), SVG, PostScript (PS/EPS, Ghostscript révén), EPUB
vagy szöveg/Markdown. Dokumentumot ad vissza, hiba esetén null-t (+
kivétel).
| Paraméter | Típus | Leírás |
|---|---|---|
path |
string | A fájl abszolút útvonala. |
opts |
objektum | Importbeállítások (lent); hosszak az aktuális egységben. |
Kép-opts: { size: [w, h] | dpi: N, bleed: { size, rgb: [r,g,b] (0–255) | cmyk:
[c,m,y,k] (0–100), backPage: true } } — a size/dpi az oldalméretet / nyomtatási
felbontást adja meg; a bleed egyszínű kifutókeretet ad hozzá (az oldal minden szélén
size-zal nő, vágódoboz = a kép, a CMYK konvertálás nélkül DeviceCMYK-ként kerül a PDF-be),
a backPage: true pedig egy második, ugyanazzal a színnel kitöltött oldalt fűz hozzá.
Szöveg/EPUB-opts: { pageSize: [w, h], margin, font, fontSize, wrap, encoding, markdown }.
var doc = imposio.open("/Users/me/jobs/booklet.pdf");
var card = imposio.open("card.png",
{ size: [90, 50], bleed: { size: 3, cmyk: [0, 100, 100, 0], backPage: true } });
imposio.newDocument(width, height)¶
Új, üres, egyoldalas dokumentumot hoz létre. A méretek az aktuális egységben vannak. Visszaad egy Document-et.
| Paraméter | Típus | Leírás |
|---|---|---|
width |
number|string | Oldalszélesség (aktuális egység, vagy pl. "210mm" karakterlánc). |
height |
number|string | Oldalmagasság. |
imposio.activeDocument()¶
Az aktuálisan aktív PDF-fület adja vissza a felületről kölcsönzött (borrowed)
Document-ként (a módosítások hatással vannak az élő dokumentumra; a szkript nem törli).
Headless/CLI módban vagy nyitott dokumentum nélkül null-t ad vissza.
imposio.activePage()¶
Az aktív fülön megjelenített oldal 0-alapú indexét adja vissza, vagy -1-et, ha nincs.
Egységek¶
imposio.setUnits(units)¶
Beállítja az egységet az összes következő hosszértékhez és getter-hez. true-t ad
vissza; ismeretlen egység kivételt dob.
| Érték | Egység |
|---|---|
"mm" |
milliméter (alapértelmezett) |
"cm" |
centiméter |
"in" / "inch" |
hüvelyk |
"pt" / "point" |
PostScript-pont |
imposio.units()¶
Az aktuális egységet adja vissza karakterláncként.
Egységsegédprogramok¶
| Metódus | Visszaad |
|---|---|
imposio.toPt(v) |
v (aktuális egység) → pont |
imposio.fromPt(pt) |
pont → aktuális egység |
imposio.mmToPt(mm) |
milliméter → pont (mindig mm) |
imposio.ptToMm(pt) |
pont → milliméter (mindig mm) |
imposio.setUnits("in");
var pts = imposio.toPt(8.5); // 612
Adatfájlok¶
imposio.loadData(path, opts?)¶
Táblázatos fájl betöltése a változó adatok összefűzéséhez.
Támogatott: CSV / TSV / TXT / XLSX / ODS / JSON. Visszatérés:
{ columns: […], rows: [[…]], format }; hiba esetén kivételt dob.
opts kulcs |
Leírás | Alapérték |
|---|---|---|
encoding |
pl. "windows-1250" |
"Auto" |
firstRowHeaders |
Az első sor tartalmazza az oszlopneveket | true |
delimiter |
pl. ";" (CSV) |
auto |
imposio.combineData(tables, opts?)¶
Több táblát (a loadData-ból vagy szkriptben építve) egyetlen { columns, rows }
objektummá fűz össze. A tables tömb.
opts kulcs |
Értékek | Jelentés |
|---|---|---|
modes |
["append"\|"parallel", …] |
Hogyan csatlakozik a tables[i] az eredményhez (a modes[0] figyelmen kívül marad): append = sorok alá, parallel = oszlopok mellé. |
mismatch |
"pad" (alapérték), "cycle", "truncate" |
Eltérő sorszámú parallel táblák. |
Watermarkok¶
imposio.readWatermarkImage(path, opts?)¶
Beolvas egy Imposio watermarkot egy renderelt vagy szkennelt képből, és { ok, text }
értéket ad vissza. Az opts { seedX, seedY } a mintára kattintás pixelkoordinátái
(frame watermark esetén bárhol a szegélyen) — ettől megbízható a beolvasás mozgalmas
háttéren is. A beágyazáshoz lásd addWatermark.
var r = imposio.readWatermarkImage("scan.png", { seedX: 620, seedY: 18 });
if (r.ok) console.log("watermark:", r.text);