AddInkAnnotation

Adnotări și legături hotspot

Descriere

Adaugă o adnotăre markup de tip cerneală (PDF /Subtype /Ink) care reprezintă una sau mai multe trasări scrise de mână, semne libere sau schițe desenate pe pagină. Intrarea /InkList a dicționarului conține un vector de trasări; fiecare trasare este un vector de coordonate x/y alternante reprezentând traseul urmărit de un dispozitiv de indicare între evenimentele pen-down și pen-up. Componentele de culoare și opacitatea sunt exprimate pe o scală 0–1; Transparency este dat pe o scală 0–100 (0 = complet opac, 100 = complet transparent). Deoarece acest entry point emite cheia de opacitate a adnotării /CA din PDF 1.4, biblioteca ridică documentele mai mici neblocate la PDF 1.4 înainte de salvare; țintele mai mici blocate sunt respinse de poarta de compatibilitate. Definit în ISO 32000-1 §12.5.6.13

Sintaxă

Delphi

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

Parametri

InkPaths — Una sau mai multe trasări encodate ca un singur șir. Trasările sunt separate prin '|' sau printr-o linie nouă (CR / LF / CRLF). În interiorul fiecărei trasări, perechile de coordonate folosesc aceeași convenție de delimitator ca AddPolygonAnnotation: valori x/y alternante separate prin spații, virgule, punct și virgulă sau tab-uri. Exemplu: "100 100 110 105 120 110 | 200 200 210 205" descrie două trasări separate. Fiecare trasare trebuie să conțină cel puțin două perechi de coordonate (patru numere) și un număr total par de valori, altfel apelul returnează 0

BorderWidth — lățimea conturului cernelii, în unitățile curente

InkRed, InkGreen, InkBlue — componentele RGB (0–1) ale culorii cernelii, scrise în /C

Title — numele autorului scris în intrarea /T a adnotării. Treceți un șir gol pentru a omite

Contents — conținutul popup-ului asociat adnotării. Treceți un șir gol pentru a omite

Transparency — opacitate exprimată ca procent de transparență (0–100). Biblioteca îl convertește în PDF /CA = 1 - Transparency/100 și îl limitează la interval

Valoare returnată

1 în caz de succes, 0 dacă niciun document nu este selectat, dacă șirul de cerneală nu poate fi parsat într-o listă validă de trasări sau dacă adnotarea nu a putut fi creată

Observații

Adnotarea /Rect este calculată automat din întinderea combinată a tuturor trasărilor plus un padding mic proporțional cu lățimea chenarului, astfel încât trasările randate rămân în interiorul bounding box-ului adnotării

Acest entry point este potrivit atât pentru scrisul de mână digitalizat capturat de la un dispozitiv touch / pen, cât și pentru forme libere programatice precum semnături ciobite sau adnotări importate din alte unelte. Pentru a suprascrie culoarea cernelii, chenarul, conținutul sau dreptunghiul după creare, folosiți SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents și SetAnnotRect