AddInkAnnotation

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

Описание

Добавляет рукописную разметочную аннотацию (PDF /Subtype /Ink), представляющую один или несколько штрихов, написанных от руки, свободных пометок или набросков, нарисованных на странице. Запись словаря /InkList содержит массив штрихов; каждый штрих — массив чередующихся координат x/y, описывающих путь, пройденный указывающим устройством между событиями нажатия и отпускания пера. Компоненты цвета и непрозрачность выражаются по шкале 0–1; Transparency задается по шкале 0–100 (0 = полностью непрозрачно, 100 = полностью прозрачно). Поскольку эта точка входа выдает ключ непрозрачности /CA аннотаций PDF 1.4, библиотека поднимает разблокированные документы более низких версий до PDF 1.4 перед сохранением; закрепленные более низкие цели отвергаются вентилем совместимости. Определено в ISO 32000-1 §12.5.6.13.

Синтаксис

Delphi

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

Параметры

InkPaths — One or more strokes encoded as a single string. Strokes are separated by '|' or by a newline (CR / LF / CRLF). Within each stroke the coordinate pairs use the same delimiter convention as AddPolygonAnnotation: alternating x/y values separated by spaces, commas, semicolons, or tabs. Example: "100 100 110 105 120 110 | 200 200 210 205" describes two separate strokes. Each stroke must contain at least two coordinate pairs (four numbers) and an even total number of values, otherwise the call returns 0.

BorderWidth — толщина росчерка в текущих единицах

InkRed, InkGreen, InkBlue — RGB-составляющие (0–1) цвета росчерка, записываемые в /C

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

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

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

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

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

Примечания

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

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