AddInkAnnotation

Annotaties en hotspotkoppelingen

Beschrijving

Voegt een ink markup-annotatie (PDF /Subtype /Ink) toe die een of meer handgeschreven stroken, vrije markeringen of vrije-hand-schetsen voorstelt die op de pagina zijn getekend. De /InkList-woordenboekentry bevat een array met stroken; elke lijn is een array van afwisselende x/y-coördinaten die het spoor voorstelt dat een aanwijsapparaat tussen pen-omlaag- en pen-omhoog-events trekt. Kleurcomponenten en dekking worden op een 0–1-schaal uitgedrukt; Transparency loopt van 0–100 (0 = volledig dekkend, 100 = volledig transparant). Omdat dit entrypoint de PDF 1.4-annotatiedekkingssleutel /CA uitgeeft, verhoogt de library lager onvergrendelde documenten naar PDF 1.4 vóór het opslaan; vergrendelde lagere doelen worden door de compatibiliteitspoort geweigerd. Gedefinieerd in ISO 32000-1 §12.5.6.13

Syntaxis

Delphi

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

Syntaxis

InkPaths — Een of meer strokes die als één tekenreeks zijn gecodeerd. Strokes worden gescheiden door '|' of door een regeleinde (CR / LF / CRLF). Binnen elke stroke gebruiken de coördinaatparen dezelfde scheidingstekenconventie als AddPolygonAnnotation: afwisselende x/y-waarden worden gescheiden door spaties, komma's, puntkomma's of tabs. Voorbeeld: "100 100 110 105 120 110 | 200 200 210 205" beschrijft twee afzonderlijke strokes. Elke stroke moet ten minste twee coördinaatparen (vier getallen) en een even totaal aantal waarden bevatten; anders retourneert de aanroep 0

BorderWidth — Lijndikte van de ink, in de huidige eenheden

InkRed, InkGreen, InkBlue — RGB-componenten (0–1) van de inktkleur, weggeschreven naar /C

Title — Auteursnaam die in de /T-entry van de annotatie wordt geschreven. Geef een lege string door om deze over te slaan

Contents — Inhoud van de popup die bij de annotatie hoort. Geef een lege string door om deze over te slaan

Transparency — Dekking, uitgedrukt als percentage transparantie (0–100). De library zet dit om naar PDF /CA = 1 - Transparency/100 en begrenst de waarde tot het geldige bereik

Geretourneerde waarde

1 bij succes, 0 als er geen document is geselecteerd, de ink-string niet tot een geldige strokenlijst te parsen is of de annotatie niet kon worden aangemaakt

Opmerkingen

De annotatie-/Rect wordt automatisch berekend uit de gecombineerde omvang van alle stroken plus een kleine opvulling evenredig aan de randbreedte, zodat de getekende lijnen binnen de bounding box van de annotatie blijven

Dit entrypoint is geschikt voor zowel gedigitaliseerd handschrift dat van een touch-/pen-apparaat is vastgelegd als programmatische vrije-vormvormen zoals gekraste handtekeningen of annotaties die vanuit andere tools zijn geïmporteerd. Om na het aanmaken de inktkleur, rand, inhoud of rechthoek te overschrijven, gebruik SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents en SetAnnotRect