AddInkAnnotation

Adnotacje i łącza obszarów aktywnych

Opis

Dodaje adnotację odręcznego atramentu (PDF /Subtype /Ink) reprezentującą co najmniej jeden odręczny pociągnięcie, znak swobodny lub szkic narysowany na stronie. Wpis słownika /InkList zawiera tablicę pociągnięć; każde pociągnięcie jest tablicą naprzemiennych współrzędnych x/y przedstawiających ścieżkę urządzenia wskazującego między zdarzeniami przyłożenia i uniesienia pióra. Składowe koloru i krycie są wyrażane w skali 0–1; Transparency podaje się w skali 0–100 (0 = całkowicie nieprzezroczyste, 100 = całkowicie przezroczyste). Ponieważ ten punkt wejścia emituje klucz krycia adnotacji PDF 1.4 /CA, biblioteka podnosi niższe, niezablokowane dokumenty do PDF 1.4 przed zapisem; zablokowane niższe cele są odrzucane przez kontrolę zgodności. Definicję zawiera ISO 32000-1 §12.5.6.13

Składnia

Delphi

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

Parametry

InkPaths — co najmniej jedno pociągnięcie zakodowane jako pojedynczy ciąg. Pociągnięcia są rozdzielane znakiem '|' lub nowym wierszem (CR / LF / CRLF). W każdym pociągnięciu pary współrzędnych używają tej samej konwencji separatorów co AddPolygonAnnotation: naprzemienne wartości x/y rozdzielone spacjami, przecinkami, średnikami lub tabulatorami. Przykład: "100 100 110 105 120 110 | 200 200 210 205" opisuje dwa oddzielne pociągnięcia. Każde pociągnięcie musi zawierać co najmniej dwie pary współrzędnych (cztery liczby) i parzystą łączną liczbę wartości, w przeciwnym razie wywołanie zwraca 0

BorderWidth — szerokość obrysu atramentu w bieżących jednostkach

InkRed, InkGreen, InkBlue — składowe RGB (0–1) koloru atramentu, zapisywane w /C

Title — Nazwa autora zapisywana we wpisie adnotacji oznaczonym jako '/T. Aby pominąć tę wartość, przekaż pusty ciąg

Contents — Treść wyskakującego okna powiązanego z adnotacją. Aby pominąć tę wartość, przekaż pusty ciąg

Transparency — Krycie wyrażone jako procent przezroczystości (0–100). Biblioteka przelicza tę wartość na PDF /CA = 1 - Transparency/100 i ogranicza ją do prawidłowego zakresu

Wartość zwracana

1 w przypadku powodzenia, 0, jeśli nie wybrano dokumentu, ciągu atramentu nie można przetworzyć na prawidłową listę pociągnięć albo nie można utworzyć adnotacji

Uwagi

Prostokąt /Rect adnotacji jest obliczany automatycznie na podstawie łącznego zasięgu wszystkich pociągnięć oraz niewielkiego marginesu proporcjonalnego do szerokości obramowania, dzięki czemu renderowane pociągnięcia pozostają wewnątrz prostokąta ograniczającego adnotacji.

Ten punkt wejścia nadaje się zarówno do cyfrowego pisma odręcznego przechwyconego z urządzenia dotykowego lub pióra, jak i do programowo tworzonych odręcznych kształtów, takich jak szkicowane podpisy albo adnotacje zaimportowane z innych narzędzi. Aby po utworzeniu zastąpić kolor odręcznej kreski, obramowanie, zawartość lub prostokąt, użyj SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents i SetAnnotRect.