AddPolyLineAnnotation

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

Описание

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

Синтаксис

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Параметры

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

BorderWidth — толщина ломаной и её конечных украшений в текущих единицах

LineRed, LineGreen, LineBlue — RGB-составляющие (0–1) цвета линии, записываемые в /C

StartStyle, EndStyle — стили концов линии для первой и последней вершин соответственно; выберите одно из:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

Out-of-range values clamp to 0 (None).

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 — /IT (намерение, включая PolyLineDimension) и /Measure — эта точка входа не пишет; после создания их можно дописать прямо в словарь аннотации

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