Sursa: https://www.pdflabs.com/docs/stamptk-manual/
Acest manual STAMPtk descrie pe scurt toate opțiunile și operațiunile programului. STAMPtk este un program în linie de comandă, deci pentru a încerca aceste exemple ar trebui să folosiți terminalul de computer sau promptul de comandă.
Rezumat
stamptk [ < optiuni pagina > ][ include=< page option file > | - ]...[ output=< output filename > | - ][ alpha=< transparency factor > ][ verbose ]Unde < optiuni pagina > poate fi o opțiune sau mai multe de tipul:
< page range handle >< option key >=< option value >descrise mai jos, iar
< page option file > este numele fișierului de tip text care conține < page options >, câte o < page option > pe linie și
< output filename > este numele fișierului PDF care va fi creat. Dacă acesta nu este menționat, stamptk cere un nume în stdout.
Opțiuni
Stamptk creează pagini PDF folosind:
Utilizând opțiunile pot fi alese intervalele de pagini, iar aceste intervale de pagini separate pot avea numere de pagină suprapuse sau chiar identice.
< page range handle > este o succesiune de majuscule (A-Z[A-Z]...) care identifică intervalele paginilor pentru care se aplică < option key > și < option value >.
Opțiunile care folosesc același handle sunt combinate pentru a realiza un interval de pagină. Intervalele multiple de pagini pot fi alese folosind un at tip de handle pentru fiecare interval în parte. Intervalele paginilor pot suprapune numerele paginilor (a se vedea opțiunea option).
< option key > poate fi:
text | textUTF8 | pos | origin | size | color | font| angle | margin | range | stream | embed | media< option value > poate fi o valoare care se potrivește cu opțiunea option key dată, după cum urmează:
text=< text string >
Acesta este textul pe care doriți să-l afișați pe pagină. Este restricționat la setul de caractere CP-1252. Puteți să setați doar unul dintre acestea pe intervalul de pagini, dar puteți adăuga mai multe șiruri de text într-o pagină utilizând mai multe intervale de pagini. Este codificat în CP-1252, opțional utilizând octale “escaped” (\ 000) sau hexazecimale (\ xHH) pentru caractere non-ASCII. Caracterul Backslash este salvat (“escape”) folosind un backslash (\).
textUTF8=< text string >
Acesta este textul pe care doriți să-l afișați pe pagină. Este restricționat la setul de caractere CP-1252. Puteți să setați doar unul dintre acestea pe intervalul de pagini, dar puteți adăuga mai multe șiruri de text într-o pagină utilizând mai multe intervale de pagini. Este codificat în UTF-8.
pos=< X >,< Y >
Această opțiune stabilește poziția textului pe pagină. X sau Y pot fi fie coordonate absolute pe pagină, fie argumente relative.
Coordonatele absolute sunt măsurate în puncte (72 de puncte pe inch, 1 inch=2,54 cm), iar originea paginii este în colțul paginii din stânga jos.
Argumentele relative sunt relative la pagină. Pentru axa X: center, left sau right și pentru axa Y: center, top sau bottom. Valori implicite: center, center
origin=< X >,< Y >
Această opțiune stabilește originea textului care trebuie utilizată atunci când poziționați textul pe pagină cu pos. X poate fi center, left sau right, iar Y poate fi center, top sau bottom. Acestea descriu locația originii textului utilizând limitele textului. Implicit: center, center
size=< font size >
Această opțiune stabilește dimensiunea textului în puncte (72 de puncte / inch). Implicit: 14
color=< red >,< green >,< blue > | #< RRGGBB >
Această opțiune stabilește culoarea textului. Aveți două opțiuni de formatare: zecimal sau hexazecimal. Când se utilizează formatarea zecimală, culorile roșu, verde și albastru iau valori întregi între 0 și 255. Când se utilizează formatarea hexazecimală, culorile RR, GG și BB iau valori hexazecimale între 00 și FF. Culoare implicită: # 000000 (negru)
font=< standard font name >
Această opțiune definește fontul utilizat pentru afișarea textului. Acesta poate fi:
Dacă adăugați un flux de pagină (descris mai jos) care utilizează unul dintre fonturile standard PDF, setați această opțiune pentru a corespunde paginii respective. Acest lucru va asigura că resursele de fonturi necesare sunt împachetate în pagina PDF. Dacă nu se specifică niciun text sau flux pentru niciun interval de pagini, în PDF nu se adaugă resurse de fonturi. Implicit: sans
angle=N | NE | E | SE | S | SW | W | NW
Această opțiune stabilește unghiul textului. Utilizează punctele cardinale pentru a diviza cercul în bucăți de câte 45 de grade. De exemplu, unghiul N va poziționa textul pe orizontală, iar unghiul E rotește textul la 90 de grade în sensul acelor de ceasornic, astfel că textul se citește de sus în jos. Centrul de rotire al textului este originea sa. Valoare implicită: N
stream=stamptkStream...stamptkEndStream
Această opțiune vă permite să adăugați propriul cod de descriere a paginii PDF la paginile din interval. Cuvintele cheie delimitează codul PDF care va fi adăugat în pagina PDF. Există o linie nouă după primul cuvânt cheie și o alta înainte de ultimul cuvânt cheie. Acest lucru poate fi utilizat în combinație cu text, textUTF8 și opțiunile conexe.
Când se utilizează numai opțiunea stream, singurele alte opțiuni pe care trebuie să le luați în considerare sunt opțiunile range, embed, media și font - celelalte opțiuni se referă doar la adăugarea de texte în pagini. Puteți aplica mai multe fluxuri unei singure pagini utilizând mai multe intervale de pagini.
embed=< PDF string >
Această opțiune ia un șir arbitrar și îl integrează invizibil în dicționarul PDF al fiecărei pagini utilizând cheia cu dicționarul stamptkData. Acest lucru este util dacă aveți date pe care doriți să le transmiteți unui parser în format PDF. Parantezele și caracterele backslash trebuie să fie “escaped” cu un backslash. Poate fi setată doar o opțiune pe pagină. Dacă mai mult de un interval stabilește această opțiune, aceasta va fi utilizată doar la setarea finală - valorile nu sunt atașate modului în care sunt textul paginii și fluxurile de pagini. Lungimea maximă: 64k octeți.
media=< standard page name >[Landscape] | < page width >,< page height >
Această opțiune stabilește dimensiunile paginii.
Pentru formate de pagină cu nume standard, utilizați numele formatului: letter, tabloid, ledger, legal, statement, executive, folio, A0, A1, A2, A3, A4, A5, B4 sau B5.
Sau puteți să dați indicați lățimea și înălțimea paginii în puncte (există 72 de puncte pe inch). Implicit: letter
margin=< page margin >
se utilizează împreună cu valorile relative pos (top, bottom, left, right) pentru a indica stamptk cât spațiu trebuie păstrat între originea textului și marginea paginii. Este o valoare întreagă și unitatea de măsură este punctul (există 72 de puncte pe inch, deci un punct este egal cu 72/2,54 cm). Implicit: 24
range=< first page number >[-< final page number >[Even | Odd]]
unde numerele paginilor dau una sau mai multe pagini care vor fi utilizate pentru acest interval de pagini. Numărătoarea paginilor începe cu 1, astfel încât prima pagină este numerotată cu 1, nu cu zero. Pe intervalele de pagini, puteți adăuga Even sau Odd pentru a prelucra doar acele pagini. Implicit: 1