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). Бібліотека перераховує це в PDF /CA = 1 - Transparency/100 і обрізає значення до допустимого діапазону

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

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

Примітки

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

Необов'язкові досвідчені поля зі специфікації PDF — /BE (ефект рамки, зокрема хмарний стиль контуру), /IT (намір, зокрема PolygonCloud і PolygonDimension) та /Measure — ця точка входу не емітує. Їх можна дописати після створення, записавши їх прямо в словник анотації

Щоб перезаписати колір закладки, рамку, вміст чи прямокутник після створення, використовуйте SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents і SetAnnotRect