AddInkAnnotation

Anotacijos ir interaktyvios nuorodos

Aprašas

Prideda rašalo žymėjimo anotaciją (PDF /Subtype /Ink), vaizduojančią vieną ar daugiau ranka rašytų potėpių, laisvos formos žymių arba laisvų eskizų, nupieštų puslapyje. /InkList žodyno įrašas saugo potėpių masyvą; kiekvienas potėpis yra pakaitomis einančių x/y koordinačių masyvas, apibūdinantis kelią, kurį žymeklio įrenginys nubraižė tarp pieštuko nuleidimo ir pakėlimo įvykių. Spalvos komponentai ir neskaidrumas išreiškiami 0–1 skalėje; Transparency pateikiamas 0–100 skalėje (0 = visiškai nepermatoma, 100 = visiškai skaidri). Kadangi šis įėjimo taškas išveda PDF 1.4 anotacijos /CA neskaidrumo raktą, biblioteka prieš išsaugodama pakelia žemesnės versijos neužrakintus dokumentus iki PDF 1.4; užrakinti žemesni tikslai atmetami suderinamumo tikrintuve. Apibrėžta ISO 32000-1 §12.5.6.13.

Sintaksė

Delphi

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

Parametrai

InkPaths — Viena ar daugiau potėpių, koduotų viena eilute. Potėpiai atskiriami '|' arba nauja eilute (CR / LF / CRLF). Kiekviename potėpyje koordinačių poros naudoja tą pačią skyriklio konvenciją kaip AddPolygonAnnotation: pakaitomis einančios x/y reikšmės, atskirtos tarpais, kableliais, kabliataškiais arba tabuliacija. Pavyzdys: "100 100 110 105 120 110 | 200 200 210 205" aprašo du atskirus potėpius. Kiekviename potėpyje turi būti bent dvi koordinačių poros (keturi skaičiai) ir lyginis bendras reikšmių skaičius, kitaip kvietimas grąžina 0.

BorderWidth — Rašalo potėpio storis dabartiniais vienetais.

InkRed, InkGreen, InkBlue — RGB komponentai (0–1) rašalo spalvai, įrašomi į /C.

Title — Autoriaus vardas, įrašomas į anotacijos /T lauką. Palikite tuščią eilutę, jei norite praleisti.

Contents — Su anotacija susieto iššokančio lango turinys. Palikite tuščią eilutę, jei norite praleisti.

Transparency — Skaidrumo procentas (0–100). Biblioteka tai paverčia į PDF /CA = 1 - Transparency/100 ir apriboja iki intervalo.

Grąžinamos reikšmės

1 sėkmės atveju, 0 jei nepasirinktas dokumentas, potėpių eilutė nesuardoma į galiojantį potėpių sąrašą arba anotacijos nepavyko sukurti.

Pastabos

Anotacijos /Rect apskaičiuojamas automatiškai iš visų potėpių bendros aprėpties kartu su maža paminkštinimo atsarga, proporcinga rėmelio pločiui, kad atvaizduoti potėpiai liktų anotacijos ribojančiame stačiakampyje.

Šis įėjimo taškas tinka ir iš skaitmenizuoto rašysenos įrašo, gauto iš lietimo / pieštuko įrenginio, ir programinėms laisvos rankos formoms, tokioms kaip braižyti parašai ar iš kitų įrankių importuotos anotacijos. Norėdami po sukūrimo perrašyti rašalo spalvą, rėmelį, turinį ar stačiakampį, naudokite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents ir SetAnnotRect.