AddInkAnnotation

Annotationer og hotspot-links

Beskrivelse

Tilføjer en Ink-markeringsannotering (PDF /Subtype /Ink), der repræsenterer en eller flere håndskrevne streger, frihåndsmærker eller frihåndsskitser tegnet på siden. Ordbogsposten /InkList indeholder et array af streger; hver streg er et array af skiftende x/y-koordinater, der repræsenterer den sti, som en pegeenhed har fulgt mellem pen-ned- og pen-op-hændelser. Farvekomponenter og opacitet udtrykkes på en skala fra 0–1; Transparency angives på en skala fra 0–100 (0 = helt uigennemsigtig, 100 = helt gennemsigtig). Da dette indgangspunkt udsender PDF 1.4-annotationsnøglen /CA for opacitet, hæver biblioteket ulåste dokumenter med lavere version til PDF 1.4 før lagring; låste mål med lavere version afvises af kompatibilitetskontrollen. Defineret 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;

Parametre

InkPaths — En eller flere streger kodet som én streng. Streger adskilles med '|' eller et linjeskift (CR / LF / CRLF). I hver streg bruger koordinatparrene samme skilletegnskonvention som AddPolygonAnnotation: skiftende x/y-værdier adskilt med mellemrum, kommaer, semikoloner eller tabulatorer. Eksempel: "100 100 110 105 120 110 | 200 200 210 205" beskriver to separate streger. Hver streg skal indeholde mindst to koordinatpar (fire tal) og et lige samlet antal værdier, ellers returnerer kaldet 0

BorderWidth — Stregbredde på blækket i aktuelle enheder.

InkRed, InkGreen, InkBlue — RGB-komponenter (0–1) for blækfarven, skrevet til /C.

Title — Forfatternavn, der skrives til PDF'ens /T-post for annotationen. Angiv en tom streng for at udelade det.

Contents — Brødteksten i den popup, der er knyttet til anmærkningen. Angiv en tom streng for at springe over.

Transparency — Opacitet udtrykt som procent gennemsigtighed (0–100). Biblioteket konverterer dette til PDF /CA = 1 - Transparency/100 og begrænser værdien til intervallet.

Returværdi

1 ved succes, 0 hvis intet dokument er valgt, Ink-strengen ikke kan fortolkes som en gyldig stregliste, eller annoteringen ikke kunne oprettes

Bemærkninger

Annotationens /Rect beregnes automatisk ud fra den samlede udstrækning af alle streger plus en lille udfyldning proportional med kantbredden, så de renderede streger forbliver inden for annotationens afgrænsningsboks.

Dette indgangspunkt er egnet både til digitaliseret håndskrift indfanget fra en touch-/pen-enhed og til programmatiske frihåndsformer såsom kradsede signaturer eller annotationer importeret fra andre værktøjer. Brug SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents og SetAnnotRect til at overskrive blækfarve, kant, indhold eller rektangel efter oprettelsen.