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

Python-Net: Добавить нумерацию Бейтса в PDF с помощью Python

Wed, 15 Apr 2026 00:00:00 +0000

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

Используя BatesNArtifact класс, разработчики могут полностью настраивать поведение нумерации — включая начальный номер, количество цифр, префиксы и суффиксы, выравнивание и отступы. После настройки артефакт может быть применён к Document через add_bates_numbering метод на PageCollection или добавлено как часть списка PaginationArtifact objects. Aspose.PDF также поддерживает стиль конфигурации на основе делегатов, позволяя динамически управлять настройками артефактов во время выполнения.

Помимо создания номеров Бейтса, API предоставляет простой способ их удаления с помощью delete_bates_numbering, предлагая полную гибкость в рабочих процессах обработки документов.

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

Добавление артефакта нумерации Бейтса

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

Чтобы добавить артефакт нумерации Бейтса в a Document, вызовите AddBatesNumbering(BatesNArtifact) расширяющий метод для PageCollection, передавая BatesNArtifact экземпляр в качестве параметра:

import sys
from os import path
import aspose.pdf as ap

def _create_bates_artifact():
    """Create a Bates numbering artifact with default settings."""
    artifact = ap.BatesNArtifact()
    artifact.start_page = 1
    artifact.end_page = 0
    artifact.subset = ap.Subset.ALL
    artifact.number_of_digits = 6
    artifact.start_number = 1
    artifact.prefix = ""
    artifact.suffix = ""
    artifact.artifact_vertical_alignment = ap.VerticalAlignment.BOTTOM
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.RIGHT
    artifact.right_margin = 72
    artifact.left_margin = 72
    artifact.top_margin = 36
    artifact.bottom_margin = 36
    return artifact

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact(infile, outfile):
    """Add Bates numbering artifact to a PDF document."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_bates_numbering(document.pages, bates_artifact)
        document.save(outfile)

Добавить нумерацию Bates с использованием артефактов пагинации

Добавьте нумерацию Bates в PDF, используя коллекцию артефактов пагинации в Aspose.PDF for Python:

Загрузите документ PDF.
Вставьте дополнительные страницы при необходимости перед применением нумерации.
Создайте артефакт Bates.
Настройте свойства артефакта.
Добавьте артефакт в коллекцию нумерации.
Примените пагинацию к страницам.
Сохраните обновлённый документ.

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact_pagination(infile, outfile):
    """Add Bates numbering using pagination artifacts collection."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_pagination(document.pages, [bates_artifact])
        document.save(outfile)

Удалить нумерацию Bates

Чтобы удалить нумерацию Bates из Document, используйте delete_bates_numbering() метод на PageCollection:

import sys
from os import path
import aspose.pdf as ap

def delete_bates_numbering(infile, outfile):
    """Delete Bates numbering from a PDF document."""
    with ap.Document(infile) as document:
        ap.PageCollectionExtensions.delete_bates_numbering(document.pages)
        document.save(outfile)

Связанные темы артефактов

Python-Net: Добавить фоны PDF в Python

Wed, 15 Apr 2026 00:00:00 +0000

Добавить фоновое изображение в PDF

Фоновые изображения могут использоваться для добавления водяного знака или другого тонкого дизайна в документы. В Aspose.PDF for Python via .NET каждый PDF‑документ представляет собой набор страниц, а каждая страница содержит набор артефактов. The BackgroundArtifact класс может использоваться для добавления фонового изображения к объекту страницы.

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

Следующий фрагмент кода показывает, как добавить фоновое изображение к страницам PDF, используя объект BackgroundArtifact с Python.

Загрузите документ PDF.
Создайте фоновой артефакт.
Загрузите файл изображения.
Присоедините артефакт к странице.
Сохраните обновлённый документ.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_to_pdf(infile, imagefile, outfile):
    """Add a background image to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

Добавить фоновое изображение с непрозрачностью в PDF

Добавить полупрозрачное фоновое изображение на страницу PDF с использованием Aspose.PDF for Python.

Применяя непрозрачность, фоновое изображение становится частично прозрачным, позволяя оригинальному содержимому страницы (текст, изображения и т.д.) оставаться чётко видимым. Это особенно полезно для:

Водяные знаки
Брендовые наложения
Тонкие улучшения дизайна

Фон добавляется как артефакт, гарантируя, что он остаётся позади всего содержимого страницы.

Загрузите документ PDF.
Создайте фоновой артефакт.
Загрузите файл изображения.
Установите уровень непрозрачности.
Присоедините артефакт к странице.
Сохраните обновлённый документ.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_with_opacity_to_pdf(infile, imagefile, outfile):
    """Add a background image with opacity to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        artifact.opacity = 0.5
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

Добавить цвет фона в PDF

Применить сплошной цвет фона к странице PDF с использованием Aspose.PDF for Python.

Загрузите документ PDF.
Создайте фоновой артефакт.
Установите цвет фона.
Присоедините артефакт к странице.
Сохраните обновлённый документ.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_color_to_pdf(infile, outfile):
    """Add a solid color background to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_color = ap.Color.dark_khaki
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

Удалить фон из PDF

Удалить артефакты фона со страницы PDF с помощью Aspose.PDF for Python. Фоновые элементы в PDF часто хранятся как артефакты, и этот метод выборочно идентифицирует и удаляет только те артефакты, которые классифицированы как фоновые элементы.

Загрузите документ PDF.
Получите доступ к артефактам страницы.
Отфильтруйте фоновые артефакты.
Соберите фоновые элементы.
Удалите фоновые артефакты.
Сохраните обновлённый документ.


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def remove_background(infile, outfile):
    with ap.Document(infile) as document:
        backgrounds = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.BACKGROUND
        ]

        for background in backgrounds:
            document.pages[1].artifacts.delete(background)

        document.save(outfile)

Связанные темы артефактов

Python-Net: Добавить водяные знаки в PDF в Python

Wed, 15 Apr 2026 00:00:00 +0000

Добавить артефакт водяного знака в PDF Document используя Aspose.PDF for Python via .NET. Водяной знак — это визуальное наложение, применяемое к страницам для брендинга, безопасности или информационных целей. Пример показывает, как настроить TextState внешний вид, позиционирование с HorizontalAlignment и VerticalAlignment, вращение и прозрачность перед применением водяного знака к Page.

Извлечь водяные знаки из PDF

Загрузите документ PDF.
Получите доступ к артефактам страницы.
Отфильтруйте артефакты водяных знаков.
Соберите элементы водяных знаков.
Извлеките свойства водяного знака.
Выведите информацию о водяном знаке.

from os import path
import sys
import aspose.pdf as ap

def extract_watermark_from_pdf(infile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            print(f"{watermark.text} {watermark.rectangle}")

Добавить водяной знак в PDF

Добавьте текстовый водяной знак в PDF‑документ с помощью Aspose.PDF for Python:

Загрузите документ PDF.
Создайте состояние текста.
Создайте артефакт водяного знака.
Установите текст водяного знака и стиль.
Настройте позиционирование и вращение.
Установите непрозрачность и поведение фона.
Прикрепите водяной знак к странице.
Сохраните обновлённый документ.

from os import path
import sys
import aspose.pdf as ap

def add_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        text_state = ap.text.TextState()
        text_state.font_size = 72
        text_state.foreground_color = ap.Color.blue_violet
        text_state.font_style = ap.text.FontStyles.BOLD
        text_state.font = ap.text.FontRepository.find_font("Arial")

        watermark = ap.WatermarkArtifact()
        watermark.set_text_and_state("WATERMARK", text_state)
        watermark.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
        watermark.artifact_vertical_alignment = ap.VerticalAlignment.CENTER
        watermark.rotation = 60
        watermark.opacity = 0.2
        watermark.is_background = True

        document.pages[1].artifacts.append(watermark)
        document.save(outfile)

Удалить артефакты водяных знаков со страницы PDF

Удалить артефакты водяного знака с конкретной страницы PDF‑документа, используя API Aspose.PDF for Python. Этот подход ориентируется на элементы водяного знака, хранящиеся как артефакты страницы (в частности, классифицированные как подтипы пагинации водяного знака), проходит их в цикле и удаляет перед сохранением обновленного документа.

Загрузите документ PDF.
Получите доступ к артефактам страницы.
Отфильтруйте артефакты водяных знаков.
Удалите артефакты водяного знака.
Сохраните обновлённый документ.

from os import path
import sys
import aspose.pdf as ap

def delete_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            document.pages[1].artifacts.delete(watermark)

        document.save(outfile)

Связанные темы артефактов

Python-Net: Подсчёт артефактов PDF на Python

Wed, 15 Apr 2026 00:00:00 +0000

Подсчёт артефактов определённого типа

Проверьте и подсчитайте артефакты пагинации в PDF Document используя Aspose.PDF for Python via .NET. Артефакты пагинации включают такие элементы, как водяные знаки, фон, заголовки и нижние колонтитулы, которые применяются к страницам для целей оформления и идентификации. Фильтруя Artifact объекты на Page и группируя их по подтипу (Artifact.ArtifactSubtype), разработчики могут быстро проанализировать структуру документа и проверить наличие конкретных элементов.

Чтобы вычислить общее количество артефактов определённого типа (например, общее число водяных знаков), используйте следующий код. Пример фильтрует страницу Artifacts коллекция (an ArtifactCollection) по Artifact.ArtifactType а затем подсчитывает подтипы (Artifact.ArtifactSubtype).

Откройте PDF-документ (см Document).
Отфильтруйте артефакты пагинации, используя страницу Artifacts коллекцию.
Подсчитайте артефакты по подтипу (Artifact.ArtifactSubtype).
Выведите результаты.


from os import path
from collections import Counter
import sys
import aspose.pdf as ap

def count_pdf_artifacts(infile):
    """Count and display artifacts of different types on the first page."""
    with ap.Document(infile) as document:
        pagination_artifacts = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
        ]

        subtypes = [artifact.subtype for artifact in pagination_artifacts]
        counts = Counter(subtypes)

        print(f"Watermarks: {counts.get(ap.Artifact.ArtifactSubtype.WATERMARK, 0)}")
        print(f"Backgrounds: {counts.get(ap.Artifact.ArtifactSubtype.BACKGROUND, 0)}")
        print(f"Headers: {counts.get(ap.Artifact.ArtifactSubtype.HEADER, 0)}")
        print(f"Footers: {counts.get(ap.Artifact.ArtifactSubtype.FOOTER, 0)}")

Связанные темы артефактов

Python-Net: Управление колонтитулами в PDF с помощью Python

Tue, 21 Apr 2026 00:00:00 +0000

Создать стилизованные текстовые артефакты

Эта утилитная функция объясняет, как создать переиспользуемый текстовый артефакт для страниц PDF с использованием Aspose.PDF for Python. Она предназначена для генерации стилизованных заголовков или нижних колонтитулов с единообразным форматированием, включая настройки шрифтов, цвет, размер и выравнивание. Функция абстрагирует создание артефакта, чтобы его можно было переиспользовать для различных текстовых украшений уровня страницы.

Создайте объект артефакта.
Установите текстовое содержимое артефакта.
Примените стилизацию текста.
Установите выравнивание.
Вернуть сконфигурированный артефакт.

from os import path
import aspose.pdf as ap
import sys

def _create_text_artifact(artifact_class, text):
    """Create a text artifact (header/footer) with common styling."""
    artifact = artifact_class()
    artifact.text = text
    artifact.text_state.font_size = 14
    artifact.text_state.font = ap.text.FontRepository.find_font("Arial")
    artifact.text_state.foreground_color = ap.Color.navy
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
    return artifact

Добавить заголовок в PDF

Откройте входной PDF.
Создайте HeaderArtifact с текстом “Sample Header”.
Добавьте его к первой странице.
Сохраните обновлённый PDF.

from os import path
import aspose.pdf as ap
import sys

def add_header_artifact(infile, outfile):
    """Add a header artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        header = _create_text_artifact(ap.HeaderArtifact, "Sample Header")
        document.pages[1].artifacts.append(header)
        document.save(outfile)

Добавить нижний колонтитул в PDF

Откройте входной PDF.
Создайте FooterArtifact с текстом “Sample Footer”.
Добавьте его к первой странице.
Сохраните выходной файл.

from os import path
import aspose.pdf as ap
import sys

def add_footer_artifact(infile, outfile):
    """Add a footer artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        footer = _create_text_artifact(ap.FooterArtifact, "Sample Footer")
        document.pages[1].artifacts.append(footer)
        document.save(outfile)

Удалить артефакты заголовка или нижнего колонтитула

Откройте PDF.
Найдите артефакты, помеченные как заголовки или нижние колонтитулы страниц.
Удалите их с первой страницы.
Сохраните очищенный документ.

from os import path
import aspose.pdf as ap
import sys

def delete_header_footer_artifact(infile, outfile):
    with ap.Document(infile) as document:
        header_footers = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and (
                artifact.subtype == ap.Artifact.ArtifactSubtype.HEADER
                or artifact.subtype == ap.Artifact.ArtifactSubtype.FOOTER
            )
        ]

        for art in header_footers:
            document.pages[1].artifacts.delete(art)

        document.save(outfile)