Documentation – Trabalhar com Artefatos PDF em Python

Python-Net: Adicionar numeração Bates ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

A numeração Bates é amplamente utilizada em fluxos de trabalho jurídicos, médicos e empresariais para atribuir identificadores únicos e sequenciais às páginas de um conjunto de documentos. Aspose.PDF for Python via .NET oferece uma API simples e flexível para automatizar esse processo, permitindo que você aplique números Bates padronizados programaticamente em qualquer PDF.

Usando o BatesNArtifact classe, os desenvolvedores podem personalizar totalmente o comportamento da numeração — incluindo o número inicial, a contagem de dígitos, prefixos e sufixos, alinhamento e margens. Uma vez configurado, o artefato pode ser aplicado ao Document através do add_bates_numbering método no PageCollection ou adicionado como parte de uma lista de PaginationArtifact objects. Aspose.PDF também suporta um estilo de configuração baseado em delegate, permitindo o controle dinâmico das configurações de artefatos em tempo de execução.

Além de criar números Bates, a API fornece uma maneira fácil de removê-los usando delete_bates_numbering, oferecendo total flexibilidade nos fluxos de trabalho de processamento de documentos.

Este artigo mostra vários métodos para adicionar e remover numeração Bates em um PDF usando Aspose.PDF for Python via .NET, com exemplos claros de configuração, aplicação e remoção de artefatos.

Adicionando Artefato de Numeração Bates

Este exemplo mostra como adicionar programaticamente a numeração Bates a um documento PDF usando Aspose.PDF for Python via .NET. Configurando um BatesNArtifact com as configurações desejadas e aplicando‑as às páginas do documento, você pode automatizar o processo de adicionar identificadores padronizados a cada página.

Para adicionar um artefato de numeração Bates a um Document, chame o AddBatesNumbering(BatesNArtifact) método de extensão em PageCollection, passando um BatesNArtifact instância como parâmetro:

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)

Adicionar numeração Bates usando artefatos de paginação

Adicionar numeração Bates a um PDF usando a coleção de artefatos de paginação no Aspose.PDF for Python:

Carregue o documento PDF.
Insira páginas extras se necessário antes de aplicar a numeração.
Crie um artefato Bates.
Configure as propriedades do artefato.
Adicione o artefato à coleção de paginação.
Aplicar paginação nas páginas.
Salve o documento atualizado.

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)

Excluir numeração Bates

Para remover a numeração Bates de um Document, use o delete_bates_numbering() método no 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)

Tópicos de Artefatos Relacionados

Python-Net: Adicionar fundos de PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar uma Imagem de Fundo a um PDF

Imagens de plano de fundo podem ser usadas para adicionar uma marca d’água ou outro design sutil a documentos. No Aspose.PDF for Python via .NET, cada documento PDF é uma coleção de páginas e cada página contém uma coleção de artefatos. O BackgroundArtifact classe pode ser usada para adicionar uma imagem de fundo a um objeto de página.

Essa abordagem é útil quando você precisa colocar uma imagem decorativa atrás do conteúdo principal do PDF sem transformá-la em texto pesquisável no documento.

O seguinte trecho de código mostra como adicionar uma imagem de fundo às páginas PDF usando o objeto BackgroundArtifact com Python.

Carregue o documento PDF.
Crie um BackgroundArtifact.
Carregue o arquivo de imagem.
Anexe o artefato a uma página.
Salve o documento atualizado.


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)

Adicionar uma Imagem de Fundo com Opacidade a um PDF

Adicionar uma imagem de fundo semitransparente a uma página PDF usando Aspose.PDF for Python.

Ao aplicar opacidade, a imagem de fundo torna‑se parcialmente transparente, permitindo que o conteúdo original da página (texto, imagens, etc.) permaneça claramente visível. Isso é especialmente útil para:

Marcas d’água
Sobreposições de branding
Aprimoramentos sutis de design

O plano de fundo é adicionado como um artefato, garantindo que permaneça atrás de todo o conteúdo da página.

Carregue o documento PDF.
Crie um BackgroundArtifact.
Carregue o arquivo de imagem.
Defina o nível de opacidade.
Anexe o artefato a uma página.
Salve o documento atualizado.


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)

Adicionar uma Cor de Fundo a um PDF

Aplicar uma cor de fundo sólida a uma página PDF usando Aspose.PDF for Python.

Carregue o documento PDF.
Crie um BackgroundArtifact.
Definir a cor de fundo.
Anexe o artefato a uma página.
Salve o documento atualizado.


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)

Remover plano de fundo de um PDF

Remover artefatos de plano de fundo de uma página PDF usando Aspose.PDF for Python. Os planos de fundo em PDFs costumam ser armazenados como artefatos, e este método identifica seletivamente e remove apenas aqueles artefatos que são classificados como elementos de plano de fundo.

Carregue o documento PDF.
Acessar artefatos de página.
Filtrar artefatos de plano de fundo.
Coletar elementos de plano de fundo.
Excluir artefatos de plano de fundo.
Salve o documento atualizado.


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)

Tópicos de Artefatos Relacionados

Python-Net: Adicionar marcas d'água ao PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Adicionar um artefato de marca d’água a um PDF Document usando Aspose.PDF for Python via .NET. Uma marca d’água é uma sobreposição visual aplicada às páginas para branding, segurança ou fins informacionais. O exemplo mostra como configurar TextState aparência, posicionamento com HorizontalAlignment e VerticalAlignment, rotação e transparência antes de aplicar a marca d’água a Page.

Extrair marcas d’água de PDF

Carregue o documento PDF.
Acessar artefatos de página.
Filtrar artefatos de marca d’água.
Coletar elementos de marca d’água.
Extrair propriedades da marca d’água.
Exibir informações da marca d’água.

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}")

Adicionar uma marca d’água ao PDF

Adicionar uma marca d’água de texto a um documento PDF usando Aspose.PDF for Python:

Carregue o documento PDF.
Criar um estado de texto.
Criar um artefato de marca d’água.
Definir o texto e o estilo da marca d’água.
Configurar posicionamento e rotação.
Defina a opacidade e o comportamento de fundo.
Anexe a marca d’água a uma página.
Salve o documento atualizado.

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)

Remover artefatos de marca d’água da página PDF

Remover artefatos de marca d’água de uma página específica em um documento PDF usando a API Aspose.PDF for Python. A abordagem tem como alvo os elementos de marca d’água armazenados como artefatos de página (especificamente aqueles classificados como subtipos de marca d’água de paginação), itera sobre eles e os exclui antes de salvar o documento atualizado.

Carregue o documento PDF.
Acessar artefatos de página.
Filtrar artefatos de marca d’água.
Excluir artefatos de marca d’água.
Salve o documento atualizado.

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)

Tópicos de Artefatos Relacionados

Python-Net: Contar Artefatos PDF em Python

Mon, 18 May 2026 00:00:00 +0000

Contando Artefatos de um Tipo Particular

Inspecione e conte artefatos de paginação em um PDF Document usando Aspose.PDF for Python via .NET. Artefatos de paginação incluem elementos como marcas d’água, fundos, cabeçalhos e rodapés que são aplicados às páginas para fins de layout e identificação. Ao filtrar Artifact objetos em um Page e agrupando-os por subtipo (Artifact.ArtifactSubtype), os desenvolvedores podem analisar rapidamente a estrutura do documento e verificar a presença de elementos específicos.

Para calcular a contagem total de artefatos de um tipo específico (por exemplo, o número total de marcas d’água), use o código a seguir. O exemplo filtra a página Artifacts coleção (an ArtifactCollection) by Artifact.ArtifactType e então conta subtipos (Artifact.ArtifactSubtype).

Abra o documento PDF (veja Document).
Filtre artefatos de paginação usando o ‘da página Artifacts coleção.
Contar artefatos por subtipo (Artifact.ArtifactSubtype).
Imprima os resultados.


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)}")

Tópicos de Artefatos Relacionados

Python-Net: Gerenciar cabeçalhos e rodapés de PDF usando Python

Mon, 18 May 2026 00:00:00 +0000

Criar Artefatos de Texto Estilizado

Esta função utilitária explica como criar um artefato de texto reutilizável para páginas PDF usando Aspose.PDF for Python. Ela foi projetada para gerar cabeçalhos ou rodapés estilizados com formatação consistente, incluindo configurações de Font, cor, tamanho e alinhamento. A função abstrai a criação do artefato para que possa ser reutilizada em diferentes decorações de texto a nível de página.

Instanciar o objeto artefato.
Definir o conteúdo de texto do artefato.
Aplicar estilo de texto.
Definir alinhamento.
Retornar artefato configurado.

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

Adicionar cabeçalho ao PDF

Abra o PDF de entrada.
Crie um HeaderArtifact com o texto “Sample Header”.
Anexe‑o à primeira página.
Salve o PDF atualizado.

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)

Adicionar Rodapé ao PDF

Abra o PDF de entrada.
Crie um FooterArtifact com texto “Sample Footer”.
Anexe‑o à primeira página.
Salve o arquivo de saída.

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)

Excluir Artefatos de Cabeçalho ou Rodapé

Abrir o PDF.
Encontre artefatos marcados como cabeçalhos ou rodapés de paginação.
Remova-os da primeira página.
Salve o documento limpo.

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)