Работа с артефактами PDF в Python

Артефакты в PDF — это графические объекты или другие элементы, которые не являются частью фактического содержимого документа. Обычно они используются для украшения, верстки или в качестве фона. Примеры артефактов включают заголовки страниц, колонтитулы, разделительные линии или изображения, не несущие смысловой нагрузки.

Цель артефактов в PDF состоит в том, чтобы обеспечить различие между элементами контента и неконтентными элементами. Это важно для доступности, поскольку программы чтения с экрана и другие вспомогательные технологии могут игнорировать артефакты и сосредотачиваться на соответствующем контенте. Артефакты также могут улучшить производительность и качество PDF‑документов, так как их можно исключать из печати, поиска или копирования.

Используйте этот раздел, когда нужно создавать или проверять неконтентные элементы PDF в Python, такие как фон документа, водяные знаки страниц и метки нумерации Бейтса. Ниже приведены руководства, показывающие основные рабочие процессы с артефактами, поддерживаемые Aspose.PDF for Python via .NET.

Чтобы создать элемент в качестве артефакта в PDF, вам нужно использовать the Artifact класс. Он содержит следующие полезные свойства:

custom_type - Получает название типа артефакта. Может использоваться, если тип артефакта не является стандартным.
custom_subtype - Получает название подтипа артефакта. Может использоваться, если подтип артефакта не является стандартным.
type - Получает тип артефакта.
subtype - Получает подтип артефакта. Если у артефакта есть нестандартный подтип, название подтипа можно прочитать через CustomSubtype.
contents - Получает коллекцию внутренних операторов артефакта.
form - Получает XForm артефакта (если используется XForm).
rectangle — Получает прямоугольник артефакта.
position — Получает или задает позицию артефакта. Если это свойство указано, то отступы и выравнивания игнорируются.
right_margin — Правый отступ артефакта. Если позиция указана явно (в свойстве Position), это значение игнорируется.
left_margin — Левый отступ артефакта. Если позиция указана явно (в свойстве Position), это значение игнорируется.
top_margin — Верхний отступ артефакта. Если позиция указана явно (в свойстве Position), это значение игнорируется.
bottom_margin — Нижний отступ артефакта. Если позиция указана явно (в свойстве Position), это значение игнорируется.
artifact_horizontal_alignment - Горизонтальное выравнивание артефакта. Если позиция указана явно (в свойстве Position), это значение игнорируется.
artifact_vertical_alignment - Вертикальное выравнивание артефакта. Если позиция указана явно (в свойстве Position), это значение игнорируется.
rotation - Получает или задаёт угол поворота артефакта.
text - Получает текст артефакта.
image - Получает изображение артефакта (если присутствует).
opacity - Получает или задаёт непрозрачность артефакта. Возможные значения находятся в диапазоне 0..1.
lines - Строки многострочного текстового артефакта.
text_state - Состояние текста для текста артефакта.
is_background - Если true, артефакт размещается позади содержимого страницы.

Следующие классы также могут быть полезны при работе с артефактами:

Рабочие процессы артефактов, охваченные в этом разделе

Пожалуйста, ознакомьтесь со следующими разделами статьи:

Добавление фонов - добавьте фоновое изображение в ваш PDF‑файл с помощью Python.
Добавление нумерации Бейтса - добавить Bates Numbering в PDF.
Добавление водяного знака - как добавить watermark в PDF с помощью Python.
Подсчёт артефактов - подсчет Artifacts в PDF с использованием Python.
Управляйте заголовками и нижними колонтитулами PDF - управление headers и footers в PDF documents.

Эти руководства полезны, когда вам нужно управлять декоративными или структурными элементами PDF без изменения основного потока содержимого документа.

Сравнение PDF-документов в Python Доступность и Tagged PDF в Python