AddInkAnnotation

Anotace a hotspotové odkazy

Popis

Přidá ink markup anotaci (PDF /Subtype /Ink) představující jednu nebo více ručně psaných částí, volných značek nebo náčrtů nakreslených na stránku. Položka slovníku /InkList obsahuje pole tahů; každý tah je pole střídajících se souřadnic x/y popisujících dráhu sledovanou ukazovacím zařízením mezi událostmi stisknutí a zvednutí pera. Barevné složky a neprůhlednost se vyjadřují v měřítku 0–1; Transparency se udává v měřítku 0–100 (0 = zcela neprůhledné, 100 = zcela průhledné). Protože tento vstupní bod vypisuje klíč neprůhlednosti /CA anotací PDF 1.4, knihovna před uložením zvýší odemčené dokumenty s nižší verzí na PDF 1.4; nižší uzamčené cíle odmítne brána kompatibility. Definováno v 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;

Parametry

InkPaths — Jeden nebo více tahů zakódovaných jako jediný řetězec. Tahy jsou odděleny znakem '|' nebo novým řádkem (CR / LF / CRLF). Uvnitř každého tahu používají dvojice souřadnic stejnou konvenci oddělovačů jako AddPolygonAnnotation: střídající se hodnoty x/y oddělené mezerami, čárkami, středníky nebo tabulátory. Příklad: "100 100 110 105 120 110 | 200 200 210 205" popisuje dva samostatné tahy. Každý tah musí obsahovat alespoň dvě dvojice souřadnic (čtyři čísla) a sudý celkový počet hodnot, jinak volání vrátí 0

BorderWidth — Šířka tahu ink, v aktuálních jednotkách

InkRed, InkGreen, InkBlue — RGB složky (0–1) barvy ink, zapisované do /C

Title — Jméno autora zapsané do položky /T anotace. Chcete-li ho přeskočit, předejte prázdný řetězec

Contents — Tělo vyskakovacího okna přiřazeného k anotaci. Chcete-li ho přeskočit, předejte prázdný řetězec

Transparency — Průhlednost vyjádřená jako procento průhlednosti (0–100). Knihovna ji převede na PDF /CA = 1 - Transparency/100 a omezí na povolený rozsah

Návratová hodnota

1 při úspěchu, 0 není-li vybrán žádný dokument, nepodaří-li se parsovat ink řetězec na platný seznam tahů, nebo nebude-li možné anotaci vytvořit

Poznámky

Obdélník anotace /Rect se spočítá automaticky ze společného rozsahu všech tahů plus malého odsazení úměrného šířce okraje, takže vykreslené tahy zůstanou uvnitř ohraničujícího boxu anotace

Tento vstupní bod se hodí jak pro digitalizované ruční písmo zachycené z dotykového nebo perového zařízení, tak pro programově vytvořené volné tvary jako nakreslené podpisy nebo anotace importované z jiných nástrojů. Chcete-li po vytvoření přepsat barvu ink, okraj, obsah nebo obdélník, použijte SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect