Отображаемая подпись PDF-документов
СЭП КриптоПро DSS позволяет добавлять в PDF-документы видимую (отображаемую) подпись. Видимая подпись может служить как подтверждение факта подписания электронного документа при его печати.
Шаблоны подписи
Для того чтобы поставить видимую подпись в электронный PDF-документ необходимо передать описание представления подписи в запрос на формирование подписи. Представление подписи (в терминологии PDF «signature appearance») можно описать шаблоном подписи, содержащим параметры данного представления.
СЭП КриптоПро DSS позволяет добавлять три вида вида шаблонов видимой подписи:
Общие параметры шаблонов
Размеры всех элементов в представлении подписи и в шаблоне указываются в единицах измерения – типографских пунктах Adobe (points). 1 пункт = 1/72 дюйма = 0,3528 мм.
Цвет элементов указывается в системе RGB (red, green, blue; красный, зелёный, синий).
Положение представления подписи на странице задаётся в системе координат PDF документа. Точка с координатами (0, 0) соответствует левому нижнему углу страницы.
ColorDescription
Описание цвета элемента. Описание полей приведено в таблице ниже.
| Поле | Тип | Описание |
|---|---|---|
| Red | int | Значение красной компоненты цвета |
| Green | int | Значение зелёной компоненты цвета |
| Blue | int | Значение синей компоненты цвета |
SignatureRect
Описание прямоугольника подписи. Описание полей приведено в таблице ниже.
| Поле | Тип | Описание |
|---|---|---|
| LowerLeftX | int | X координата левого нижнего угла прямоугольника |
| LowerLeftY | int | Y координата левого нижнего угла прямоугольника |
| UpperRightX | int | X координата правого верхнего угла прямоугольника |
| UpperRightY | int | Y координата правого верхнего угла прямоугольника |
| BorderRadius | int | Радиус скругления углов прямоугольника |
| BorderWeight | int | Толщина линии границы прямоугольника. 0 – отсутствие границы (значение по умолчанию) |
| BorderColor | ColorDescription | Цвет границы прямоугольника. По умолчанию (0, 0, 0) |
| BackgroundColor | ColorDescription | Цвет фона прямоугольника. По умолчанию (255, 255, 255) |
| ContentMargin | int | Отступ от границы прямоугольника до содержимого представления подписи |
FontDescription
Описание шрифта. Описание полей класса приведено ниже.
| Поле | Тип | Описание |
|---|---|---|
| FontSize | int | Размер шрифта |
| FontFamily | int | Название шрифта. Допустимые значения: times, arial По умолчанию times |
| FontColor | ColorDescription | Цвет шрифта |
Textblock
Описание блока текста. Блок текста – это набор символов, заканчивающийся переводом строки (абзац). Описание полей класса приведено ниже.
| Поле | Тип | Описание |
|---|---|---|
| Text | string | Содержимое блока |
| Font | FontDescription | Описание шрифта |
| Margin | int | Отступ от границы прямоугольника до текста. |
ImageBlock
Описание изображения – логотипа или фона прямоугольника подписи. Для задания изображения в качестве фона необходимо указать только поле Image.
| Поле | Тип | Описание |
|---|---|---|
| Image | string | Байты изображения, закодированное в Base64. Поддерживаемые форматы изображений: JPEG, JPEG2000, GIF, PNG, BMP, WMF, TIFF, CCITT, JBIG2. |
| LowerLeftX | int | X координата левого нижнего угла прямоугольника. Только для описания логотипа. |
| LowerLeftY | int | Y координата левого нижнего угла прямоугольника. Только для описания логотипа. |
| Scale | Int | Масштаб изображения. Только для описания логотипа. |
Простой текстовый шаблон
Данный шаблон является наиболее простым в конфигурации и используется в случае, когда отображаемая подпись включает в себя только текстовые данные.
Конфигурация шаблона включает в себя следующие поля:
| Поле | Тип | Описание |
|---|---|---|
| Content | TextBlock[] | Содержимое представления в виде массива текстовых блоков |
| Page | int | Номер страницы (первая страница имеет номер 1), на которой следует расположить представление. Отрицательные значения соответствуют отсчету от последней страницы. -1 указывает на последнюю страницу |
| Rect | SignatureRect | Описание прямоугольника подписи. |
| TemplateId | int | Идентификатор шаблона. Должен иметь значение 1. |
Шаблон с логотипом и текстом
Данный шаблон может включать в себя графическое изображение (например, логотип компании) вдобавок к текстовой информации, описывающей подписываемые данные.
Шаблон включает в себя следующие поля:
| Поле | Тип | Описание |
|---|---|---|
| Content | TextBlock[] | Содержимое представления в виде массива текстовых блоков |
| Page | int | Номер страницы (первая страница имеет номер 1), на которой следует расположить представление. Отрицательные значения соответствуют отсчету от последней страницы. -1 указывает на последнюю страницу |
| Icon | ImageBlock | Описание параметров логотипа. |
| Rect | SignatureRect | Описание прямоугольника подписи. |
| TemplateId | int | Идентификатор шаблона. Должен иметь значение 2. |
Шаблон в виде изображения
Данный шаблон позволяет использовать цельное изображение в качестве отображаемой подписи
| Поле | Тип | Описание |
|---|---|---|
| Content | TextBlock[] | Содержимое представления в виде массива текстовых блоков |
| Page | int | Номер страницы (первая страница имеет номер 1), на которой следует расположить представление. Отрицательные значения соответствуют отсчету от последней страницы. -1 указывает на последнюю страницу |
| Background | ImageBlock | Описание параметров изображения. |
| Rect | SignatureRect | Описание прямоугольника подписи. |
| TemplateId | int | Идентификатор шаблона. Должен иметь значение 3. |