AddInkAnnotation

Anotácie a aktívne odkazy

Opis

Pridáva inkovú anotáciu (PDF /Subtype /Ink) predstavujúcu jeden alebo viac ručne písaných ťahov, voľných značiek alebo kresieb od ruky nakreslených na stránke. Položka slovníka /InkList obsahuje pole ťahov; každý ťah je pole striedajúcich sa súradníc x/y, ktoré predstavujú dráhu sledovanú ukazovacím zariadením medzi udalosťami stlačenia a uvoľnenia pera. Zložky farby a nepriehľadnosť sa vyjadrujú na škále 0–1; Transparency sa zadáva na škále 0–100 (0 = úplne nepriehľadné, 100 = úplne priehľadné). Keďže tento vstupný bod zapisuje kľúč nepriehľadnosti /CA anotácie PDF 1.4, knižnica pred uložením zvýši nižšie neuzamknuté dokumenty na PDF 1.4; uzamknuté ciele s nižšou verziou odmietne kontrola kompatibility. Definované v ISO 32000-1 §12.5.6.13.

Syntax

Delphi

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

Parametre

InkPaths — Jedno alebo viac ťahov zakódovaných ako jeden reťazec. Ťahy sa oddeľujú znakom '|' alebo novým riadkom (CR / LF / CRLF). V rámci každého ťahu používajú dvojice súradníc rovnakú konvenciu oddeľovania ako AddPolygonAnnotation: striedajúce sa hodnoty x/y oddelené medzerami, čiarkami, bodkočiarkami alebo tabulátormi. Príklad: "100 100 110 105 120 110 | 200 200 210 205" opisuje dva samostatné ťahy. Každý ťah musí obsahovať aspoň dva páry súradníc (štyri čísla) a párny celkový počet hodnôt, inak volanie vráti 0.

BorderWidth — Šírka ťahu atramentu v aktuálnych jednotkách.

InkRed, InkGreen, InkBlue — RGB zložky (0–1) farby atramentu, zapisované do /C.

Title — Meno autora zapísané do položky /T anotácie. Na preskočenie zadajte prázdny reťazec.

Contents — Text obsahu vyskakovacieho okna priradeného k anotácii. Na preskočenie zadajte prázdny reťazec.

Transparency — Nepriehľadnosť vyjadrená ako percento priehľadnosti (0–100). Knižnica ju prevedie na PDF /CA = 1 - Transparency/100 a ohraničí na rozsah.

Return Value

1 pri úspechu, 0 ak nie je vybraný dokument, reťazec atramentu sa nepodarí rozparsovať na platný zoznam ťahov alebo sa anotáciu nepodarilo vytvoriť.

Poznámky

Anotácia /Rect sa vypočíta automaticky z celkového rozsahu všetkých ťahov plus malého odsadenia úmerného šírke okraja, aby vykreslené ťahy zostali vo vnútri ohraničovacieho rámca anotácie.

Tento vstupný bod je vhodný pre digitalizované rukopisné zápisy zachytené dotykovým alebo perovým zariadením aj pre programovo vytvorené tvary od ruky, ako sú čmárané podpisy alebo anotácie importované z iných nástrojov. Na prepísanie farby atramentu, okraja, obsahu alebo obdĺžnika po vytvorení použite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect.