AddPolygonAnnotation

Adnotacje i łącza obszarów aktywnych

Opis

Dodaje do wybranej strony adnotację oznaczenia zamkniętego wielokąta (PDF /Subtype /Polygon) z podaną listą wierzchołków. Wielokąt jest niejawnie zamknięty — podczas renderowania czytniki łączą ostatni wierzchołek z pierwszym. Kształt może być opcjonalnie wypełniony jednolitym kolorem wnętrza. Składowe kolorów i krycie są wyrażane w skali 0–1; Transparency podaje się w skali 0–100 (0 = pełne krycie, 100 = pełna przezroczystość). Biblioteka podnosi wersję dokumentu do PDF 1.5, gdy adnotacja Polygon jest emitowana przy blokadzie niższej wersji minimalnej. Zdefiniowano w ISO 32000-1 §12.5.6.9.

Składnia

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametry

VertexCoords — współrzędne wierzchołków jako pojedynczy ciąg naprzemiennych wartości x/y rozdzielonych spacjami, przecinkami, średnikami lub tabulatorami. Przykład: "100 100 200 100 200 200 100 200" definiuje kwadrat. Wymaga co najmniej dwóch par (czterech liczb) i parzystej łącznej liczby wartości; w przeciwnym razie wywołanie zwraca 0.

BorderWidth — szerokość obrysu konturu wielokąta, w bieżących jednostkach.

BorderRed, BorderGreen, BorderBlue — składowe RGB (0–1) koloru konturu, zapisywane w /C.

Filled — 1, aby emitować kolor wypełnienia wnętrza (/IC) wielokąta, 0, aby pozostawić go bez wypełnienia.

FillRed, FillGreen, FillBlue — składowe RGB (0–1) koloru wypełnienia wnętrza. Ignorowane, gdy Filled ma wartość 0

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 po powodzeniu, 0, jeśli nie wybrano dokumentu, nie udało się przeanalizować ciągu wierzchołków albo nie można było utworzyć adnotacji.

Uwagi

Prostokąt /Rect adnotacji jest obliczany automatycznie na podstawie zasięgu wierzchołków oraz niewielkiego marginesu proporcjonalnego do szerokości obramowania, dzięki czemu obrys pozostaje wewnątrz prostokąta ograniczającego adnotacji.

Opcjonalne pola zaawansowane opisane w specyfikacji PDF — /BE (efekt obramowania, w tym styl chmurzastego konturu), /IT (przeznaczenie, w tym PolygonCloud i PolygonDimension) oraz /Measure — nie są emitowane przez ten punkt wejścia. Można je dołączyć po utworzeniu, zapisując je bezpośrednio w słowniku adnotacji.

Aby po utworzeniu zastąpić kolor konturu, obramowanie, zawartość lub prostokąt, użyj SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents i SetAnnotRect.