AddInkAnnotation

Anotacije i hotspot poveznice

Opis

Dodaje anotaciju za tintu (PDF /Subtype /Ink) koja predstavlja jedan ili više ručno ispisanih poteza, slobodnih oznaka ili slobodnih skica nacrtanih na stranici. Unos rječnika /InkList sadrži polje poteza; svaki potez je polje izmjeničnih x/y koordinata koje predstavljaju putanju koju pokazivački uređaj prati između događaja spuštanja i podizanja olovke. Komponente boje i neprozirnost izražene su na skali 0–1; Transparency se daje na skali 0–100 (0 = potpuno neprozirno, 100 = potpuno prozirno). Budući da ova ulazna točka emitira ključ neprozirnosti /CA za anotaciju PDF 1.4, biblioteka podiže niže otključane dokumente na PDF 1.4 prije spremanja; zaključane niže ciljne verzije odbacuju se putem provjere kompatibilnosti. Definirano u ISO 32000-1 §12.5.6.13.

Sintaksa

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametri

InkPaths — Jedan ili više poteza kodiranih kao jedan niz. Potezi su odvojeni znakom '|' ili novim redom (CR / LF / CRLF). Unutar svakog poteza parovi koordinata koriste istu konvenciju razdvajanja kao AddPolygonAnnotation: izmjenične x/y vrijednosti odvojene razmacima, zarezima, točkama sa zarezom ili tabulatorima. Primjer: "100 100 110 105 120 110 | 200 200 210 205" opisuje dva odvojena poteza. Svaki potez mora sadržavati najmanje dva para koordinata (četiri broja) i paran ukupan broj vrijednosti, inače poziv vraća 0.

BorderWidth — Širina poteza tinte, u trenutačnim jedinicama.

InkRed, InkGreen, InkBlue — RGB komponente (0–1) boje tinte, zapisane u /C.

Title — Ime autora zapisano u unos /T anotacije. Proslijedite prazan niz ako ga želite preskočiti.

Contents — Tijelo skočnog prozora povezanog s anotacijom. Proslijedite prazan niz ako ga želite preskočiti.

Transparency — Neprozirnost izražena kao postotak prozirnosti (0–100). Biblioteka to pretvara u PDF /CA = 1 - Transparency/100 i ograničava na raspon.

Povratne vrijednosti

1 pri uspjehu, 0 ako nije odabran dokument, ako se niz tinte ne može raščlaniti u valjani popis poteza ili ako anotacija nije mogla biti stvorena

Napomene

Anotacijski /Rect automatski se izračunava iz zajedničkog obuhvata svih poteza uz mali dodatak proporcionalan širini obruba kako bi nacrtani potezi ostali unutar omeđujućeg okvira anotacije.

Ova je ulazna točka prikladna i za digitalizirani rukopis prikupljen s uređaja na dodir / olovku i za programske slobodne oblike kao što su škrabani potpisi ili anotacije uvezene iz drugih alata. Za prepisivanje boje tinte, obruba, sadržaja ili pravokutnika nakon stvaranja upotrijebite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents i SetAnnotRect.