AddInkAnnotation

Annotations et liens de zone réactive

Description

Ajoute une annotation d’encre (PDF /Subtype /Ink) représentant un ou plusieurs traits manuscrits ou tracés libres. L’entrée /InkList contient un tableau de traits, chacun étant une suite de coordonnées x/y alternées entre les événements stylet abaissé et relevé. Les composantes de couleur et l’opacité utilisent une échelle de 0–1 ; Transparency utilise une échelle de 0–100 (0 = totalement opaque, 100 = totalement transparent). Comme ce point d’entrée émet la clé d’opacité /CA de PDF 1.4, la bibliothèque élève les documents non verrouillés de version inférieure à PDF 1.4 avant enregistrement ; les cibles inférieures verrouillées sont refusées par le contrôle de compatibilité. Définition dans ISO 32000-1 §12.5.6.13

Syntaxe

Delphi

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

Paramètres

InkPaths — Un ou plusieurs tracés encodés dans une chaîne unique. Les tracés sont séparés par '|' ou par un saut de ligne (CR / LF / CRLF). Dans chaque tracé, les paires de coordonnées suivent la convention de séparation de AddPolygonAnnotation : valeurs x/y alternées séparées par des espaces, virgules, points-virgules ou tabulations. Exemple : "100 100 110 105 120 110 | 200 200 210 205" décrit deux tracés distincts. Chaque tracé doit comporter au moins deux paires de coordonnées (quatre nombres) et un nombre total pair de valeurs, sinon l’appel renvoie 0

BorderWidth — largeur de trait de l’encre, dans les unités actuelles

InkRed, InkGreen, InkBlue — Composantes RGB (0–1) de la couleur de l'encre, écrites dans /C

Title — Nom d'auteur écrit dans l'entrée /T de l'annotation Transmettez une chaîne vide pour l'omettre

Contents — Corps de la fenêtre contextuelle associée à l'annotation Transmettez une chaîne vide pour l'omettre

Transparency — opacité exprimée en pourcentage transparent (0–100). La bibliothèque convertit en PDF /CA = 1 - Transparency/100 et borne la plage

Valeur de retour

1 en cas de réussite, 0 si aucun document n'est sélectionné, si la chaîne d'encre ne peut pas être analysée en liste de tracés valide ou si l'annotation n'a pas pu être créée

Remarques

Le rectangle /Rect de l’annotation est calculé automatiquement à partir de l’étendue combinée de tous les traits, avec une petite marge proportionnelle à la largeur de bordure afin que les traits rendus restent dans le cadre de délimitation de l’annotation

Ce point d’entrée convient aussi bien à l’écriture manuscrite numérisée capturée avec un périphérique tactile ou un stylet qu’aux formes à main levée créées par programme, notamment les signatures griffonnées et les annotations importées d’autres outils. Pour remplacer après création la couleur de l’encre, la bordure, le contenu ou le rectangle, utilisez SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents et SetAnnotRect