AddPolygonAnnotation

Anotace a hotspotové odkazy

Popis

Přidá na vybranou stránku uzavřenou polygonovou markup anotaci (PDF /Subtype /Polygon) se zadaným seznamem vrcholů. Polygon se uzavírá implicitně — při vykreslení spojí čtenář poslední vrchol zpět s prvním. Tvar lze volitelně vyplnit plnou barvou výplně. 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é). Knihovna zvýší verzi dokumentu na PDF 1.5, pokud se anotace Polygon vypíše při nižším uzamčeném minimu verze. Definováno v ISO 32000-1 §12.5.6.9

Syntaxe

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 — Souřadnice vrcholů jako jediný řetězec střídajících se hodnot x/y oddělených mezerami, čárkami, středníky, nebo tabulátory. Příklad: "100 100 200 100 200 200 100 200" definuje čtverec. Vyžaduje aspoň dva páry (čtyři čísla) a sudý celkový počet čísel, jinak volání vrátí 0

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

BorderRed, BorderGreen, BorderBlue — RGB složky (0–1) barvy obrysu, zapisované do /C

Filled — 1 zapíše vnitřní barvu výplně (/IC) pro tělo polygonu, 0 ponechá nevyplněné

FillRed, FillGreen, FillBlue — RGB složky (0–1) barvy vnitřní výplně. Při Filled = 0 se ignorují

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 řetězec vrcholů, nebo nebude-li možné anotaci vytvořit

Poznámky

Obdélník anotace /Rect se spočítá automaticky z rozsahu vrcholů plus malého odsazení úměrného šířce okraje, takže tah obrysu zůstane uvnitř ohraničujícího boxu anotace

Pokročilé volitelné pole popsané specifikací PDF — /BE (border effect, včetně stylu obrysu cloudy), /IT (intent, včetně PolygonCloud a PolygonDimension) a /Measure — tento vstupní bod nevypisuje. Po vytvoření je lze doplnit přímým zápisem do slovníku anotace

Chcete-li po vytvoření přepsat barvu obrysu, okraj, obsah nebo obdélník, použijte SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect