AddPolygonAnnotation

Аннотации и активные ссылки

Описание

Добавляет разметочную аннотацию замкнутого многоугольника (PDF /Subtype /Polygon) на выбранную страницу с переданным списком вершин. Многоугольник замыкается неявно — при рендеринге читатели соединяют последнюю вершину с первой. Фигуру можно дополнительно залить сплошным внутренним цветом. Компоненты цвета и непрозрачность выражаются по шкале 0–1; Transparency задается по шкале 0–100 (0 = полностью непрозрачно, 100 = полностью прозрачно). Библиотека повышает версию документа до PDF 1.5, если аннотация Polygon выдается при более низком закрепленном минимуме версии. Определено в ISO 32000-1 §12.5.6.9.

Синтаксис

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;

Параметры

VertexCoords — координаты вершин одной строкой из чередующихся значений x/y, разделенных пробелами, запятыми, точками с запятой или табуляциями. Пример: "100 100 200 100 200 200 100 200" задает квадрат. Требуется минимум две пары (четыре числа) и четное общее число чисел, иначе вызов возвращает 0

BorderWidth — толщина обводки многоугольника в текущих единицах

BorderRed, BorderGreen, BorderBlue — RGB-составляющие (0–1) цвета контура, записываемые в /C

Filled — 1 добавляет цвет заливки внутренней области (/IC) телу многоугольника, 0 оставляет незалиты

FillRed, FillGreen, FillBlue — RGB-составляющие (0–1) цвета заливки внутренней области; игнорируются при Filled = 0

Title — имя автора, записываемое в запись /T аннотации; пустая строка пропускает параметр

Contents — текст всплывающей подсказки, связанной с аннотацией; пустая строка пропускает параметр

Transparency — прозрачность в процентах (0–100). Библиотека пересчитывает её в /CA = 1 - Transparency/100 и ограничивает диапазон

Возвращаемое значение

1 в случае успеха, 0 — если документ не выбран, строка вершин не разбирается или аннотацию не удалось создать

Примечания

Аннотационный /Rect вычисляется автоматически по охвату вершин плюс небольшая отбивка, пропорциональная толщине рамки, чтобы обводка осталась внутри ограничивающего блока

Продвинутые необязательные поля из спецификации PDF — /BE (эффект рамки, включая облачный стиль), /IT (намерение, включая PolygonCloud и PolygonDimension) и /Measure — эта точка входа не пишет; после создания их можно дописать прямо в словарь аннотации

Чтобы перезаписать цвет оглавления, границу, содержимое или прямоугольник после создания, используйте SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents и SetAnnotRect