AddInkAnnotation

Annotasjoner og hotspot-lenker

Beskrivelse

Legger til en blekk markering-annotasjon (PDF /Subtype /Ink) som representerer én eller flere håndskrevne streker, frihåndsmerker eller frihåndsskisser tegnet på siden. /InkList-ordbokoppføringen inneholder en matrise av streker; hver strek er en matrise av vekslende x/y-koordinater som representerer banen sporet av en pekeenhet mellom penn-ned- og penn-opp-hendelser. Fargekomponenter og dekkevne uttrykkes på en 0–1-skala; Transparency oppgis på en 0–100-skala (0 = helt ugjennomsiktig, 100 = helt gjennomsiktig). Ettersom dette inngangspunktet emiterer PDF 1.4-annotasjonens /CA-dekkevnenøkkel, hever biblioteket lavere ulåste dokumenter til PDF 1.4 før lagring; låste lavere mål avslås av kompatibilitetsporten. Definert i ISO 32000-1 §12.5.6.13

Syntaks

Delphi

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

Parametere

InkPaths — Én eller flere streker kodet som én enkelt streng. Streker atskilles med '|' eller med linjeskift (CR / LF / CRLF). Innenfor hver strek bruker koordinatparene samme skilletegn-konvensjon som AddPolygonAnnotation: vekslende x/y-verdier atskilt med mellomrom, komma, semikolon eller tabulator. Eksempel: "100 100 110 105 120 110 | 200 200 210 205" beskriver to separate streker. Hver strek må inneholde minst to koordinatpar (fire tall) og et partall antall verdier totalt, ellers returnerer kallet 0

BorderWidth — Strekbredde på blekket, i gjeldende enheter

InkRed, InkGreen, InkBlue — RGB-komponenter (0–1) i blekkfargen, skrevet inn i /C

Title — Forfatterens navn, som skrives inn i annotasjonens /T-oppføring. Send en tom streng for å hoppe over

Contents — Innholdet i popup-vinduet knyttet til annotasjonen. Send en tom streng for å hoppe over

Transparency — Dekkevne oppgitt som prosent gjennomsiktighet (0–100). Biblioteket regner om til PDF /CA = 1 - Transparency/100 og begrenser til gyldig område

Return Value

1 ved suksess, 0 hvis ingen dokument er valgt, blekkstrengen ikke kan tolkes til en gyldig strekeliste, eller annotasjonen ikke kunne opprettes

Merknader

Annotasjonens /Rect beregnes automatisk fra den kombinerte utstrekningen av alle streker pluss en liten utfylling proporsjonal med kantbredden slik at de renderete strekene forblir innenfor annotasjonens avgrensende boks

Dette inngangspunktet passer både til digitalisert håndskrift fanget opp fra en berørings-/pennenhet og til programmerte frihåndsformer som kriblede signaturer eller annotasjoner importert fra andre verktøy. For å overskrive blekkfargen, kanten, innholdet eller rektangelet etter oppretting, bruk SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents og SetAnnotRect