AddInkAnnotation

Анотації та активні зони-посилання

Опис

Додає анотацію розмітки чорнила (PDF /Subtype /Ink), що представляє одну чи більше рукописних штрихів, вільних позначок чи начерків, намальованих на сторінці. Запис словника /InkList містить масив штрихів; кожен штрих — це масив чергованих координат x/y, що представляє шлях, який прокладає вказівний пристрій між подіями pen-down і pen-up. Колірні компоненти та непрозорість виражаються за шкалою 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 — Один чи більше штрихів, закодованих одним рядком. Штрихи розділяються '|' чи новим рядком (CR / LF / CRLF). Усередині кожного штриха пари координат використовують ту саму конвенцію роздільників, що й AddPolygonAnnotation: черговані значення x/y, розділені пробілами, комами, крапками з комою чи табуляціями. Приклад: "100 100 110 105 120 110 | 200 200 210 205" описує два окремі штрихи. Кожен штрих має містити щонайменше дві пари координат (чотири числа) і парну загальну кількість значень, інакше виклик повертає 0

BorderWidth — товщина обведення чорнила в поточних одиницях

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

Title — ім'я автора, яке записується в запис /T анотації. Щоб пропустити, передайте порожній рядок

Contents — вміст спливного вікна, пов'язаного з анотацією. Щоб пропустити, передайте порожній рядок

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

Значення, що повертається

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

Примітки

Прямокутник /Rect анотації обчислюється автоматично з сукупного охоплення всіх штрихів плюс невеликий відступ, пропорційний ширині рамки, тож відрендерені штрихи лишаються всередині обмежувального прямокутника анотації

Ця точка входу придатна і для оцифрованого рукописного вводу, знятого з сенсорного чи перового пристрою, і для програмних вільних фігур, як-от нашкрябані підписи чи анотації, імпортовані з інших інструментів. Щоб перезаписати колір чорнила, рамку, вміст чи прямокутник після створення, використовуйте SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents і SetAnnotRect