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 на анотацията се изчислява автоматично от комбинирания обхват на всички щрихи плюс малка отстъпка, пропорционална на ширината на рамката, така че изобразените щрихи да останат в ограждащата кутия на анотацията

Тази входна точка е подходяща както за дигитализирано ръкописно писане, заснето с тъч / pen устройство, така и за програмно свободноръчни форми като надраскани подписи или анотации, импортирани от други инструменти. За да презапишете цвета на мастилото, рамката, съдържанието или правоъгълника след създаване, използвайте SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents и SetAnnotRect