Documentation – Trabajar con artefactos PDF en Python

Python-Net: Agregar numeración Bates a PDF en Python

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

La numeración Bates se usa ampliamente en flujos de trabajo legales, médicos y empresariales para asignar identificadores únicos y secuenciales a las páginas dentro de un conjunto de documentos. Aspose.PDF for Python via .NET ofrece una API simple y flexible para automatizar este proceso, permitiéndote aplicar números Bates estandarizados de forma programática en cualquier PDF.

Usando el BatesNArtifact clase, los desarrolladores pueden personalizar completamente el comportamiento de la numeración—incluyendo el número inicial, la cantidad de dígitos, los prefijos y sufijos, la alineación y los márgenes. Una vez configurado, el artefacto puede aplicarse al Document a través del add_bates_numbering método en el PageCollection o añadido como parte de una lista de PaginationArtifact objetos. Aspose.PDF también admite un estilo de configuración basado en delegados, que permite el control dinámico de la configuración de artefactos en tiempo de ejecución.

Además de crear números Bates, la API proporciona una forma fácil de eliminarlos usando delete_bates_numbering, ofreciendo una flexibilidad completa en los flujos de trabajo de procesamiento de documentos.

Este artículo muestra varios métodos para agregar y eliminar la numeración Bates en un PDF usando Aspose.PDF for Python via .NET, con ejemplos claros de configuración, aplicación y eliminación de artefactos.

Agregar artefacto de numeración Bates

Este ejemplo muestra cómo agregar programáticamente la numeración Bates a un documento PDF usando Aspose.PDF for Python via .NET. Configurando un BatesNArtifact con los ajustes deseados y aplicándolo a las páginas del documento, puede automatizar el proceso de añadir identificadores estandarizados a cada página.

Para agregar un artefacto de numeración Bates a un Document, llama al AddBatesNumbering(BatesNArtifact) método de extensión en el PageCollection, pasando un BatesNArtifact instancia como el 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)

Agregar numeración Bates usando artefactos de paginación

Agregar numeración Bates a un PDF usando la colección de artefactos de paginación en Aspose.PDF for Python:

Cargue el documento PDF.
Inserte páginas extra si es necesario antes de aplicar la numeración.
Cree un artefacto Bates.
Configure las propiedades del artefacto.
Añada el artefacto a la colección de paginación.
Aplicar paginación a las páginas.
Guarde el documento actualizado.

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)

Eliminar numeración Bates

Para eliminar la numeración Bates de un Document, use el delete_bates_numbering() método en el 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)

Temas relacionados con artefactos

Python-Net: Agregar fondos de PDF en Python

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

Agregar una imagen de fondo a un PDF

Las imágenes de fondo pueden usarse para agregar una marca de agua, u otro diseño sutil, a los documentos. En Aspose.PDF for Python via .NET, cada documento PDF es una colección de páginas y cada página contiene una colección de artefactos. El BackgroundArtifact clase puede usarse para agregar una imagen de fondo a un objeto de página.

Este enfoque es útil cuando necesitas colocar una imagen decorativa detrás del contenido principal del PDF sin convertirlo en texto del documento searchable.

El siguiente fragmento de código muestra cómo agregar una imagen de fondo a las páginas PDF utilizando el objeto BackgroundArtifact con Python.

Cargue el documento PDF.
Cree un artefacto de fondo.
Cargue el archivo de imagen.
Adjunte el artefacto a una página.
Guarde el documento actualizado.


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)

Agregar una imagen de fondo con opacidad a un PDF

Agregar una imagen de fondo semitransparente a una página PDF usando Aspose.PDF for Python.

Al aplicar opacidad, la imagen de fondo se vuelve parcialmente transparente, permitiendo que el contenido original de la página (texto, imágenes, etc.) siga siendo claramente visible. Esto es especialmente útil para:

Marcas de agua
Superposiciones de marca
Sutiles mejoras de diseño

El fondo se agrega como un artefacto, asegurando que permanezca detrás de todo el contenido de la página.

Cargue el documento PDF.
Cree un artefacto de fondo.
Cargue el archivo de imagen.
Establezca el nivel de opacidad.
Adjunte el artefacto a una página.
Guarde el documento actualizado.


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)

Agregar un color de fondo a un PDF

Aplicar un color de fondo sólido a una página PDF usando Aspose.PDF for Python.

Cargue el documento PDF.
Cree un artefacto de fondo.
Establecer el color de fondo.
Adjunte el artefacto a una página.
Guarde el documento actualizado.


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)

Eliminar fondo de un PDF

Eliminar artefactos de fondo de una página PDF usando Aspose.PDF for Python. Los fondos en los PDF a menudo se almacenan como artefactos, y este método identifica y elimina selectivamente solo aquellos artefactos que están clasificados como elementos de fondo.

Cargue el documento PDF.
Acceder a los artefactos de página.
Filtrar artefactos de fondo.
Recopilar elementos de fondo.
Eliminar artefactos de fondo.
Guarde el documento actualizado.


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)

Temas relacionados con artefactos

Python-Net: Agregar marcas de agua a PDF en Python

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

Agregar un artefacto de marca de agua a un PDF Document usando Aspose.PDF for Python via .NET. Una marca de agua es una superposición visual aplicada a las páginas para la marca, seguridad o propósitos informativos. El ejemplo muestra cómo configurar TextState apariencia, posicionamiento con HorizontalAlignment y VerticalAlignment, rotación y transparencia antes de aplicar la marca de agua a un Page.

Extraer marcas de agua del PDF

Cargue el documento PDF.
Acceder a los artefactos de página.
Filtrar artefactos de marcas de agua.
Recopilar elementos de marcas de agua.
Extraer propiedades de la marca de agua.
Mostrar información de la marca de agua.

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

Agregar una marca de agua a PDF

Agregar una marca de agua de texto a un documento PDF usando Aspose.PDF for Python:

Cargue el documento PDF.
Crear un estado de texto.
Crear un artefacto de marca de agua.
Establecer el texto y el estilo de la marca de agua.
Configura la posición y la rotación.
Establece la opacidad y el comportamiento del fondo.
Adjunta la marca de agua a una página.
Guarde el documento actualizado.

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)

Eliminar artefactos de marca de agua de la página PDF

Eliminar artefactos de marca de agua de una página específica en un documento PDF utilizando la Aspose.PDF for Python API. El enfoque busca los elementos de marca de agua almacenados como artefactos de página (específicamente los clasificados como subtipos de marca de agua de paginación), itera sobre ellos y los elimina antes de guardar el documento actualizado.

Cargue el documento PDF.
Acceder a los artefactos de página.
Filtrar artefactos de marcas de agua.
Eliminar artefactos de marca de agua.
Guarde el documento actualizado.

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)

Temas relacionados con artefactos

Python-Net: Contar artefactos PDF en Python

Fri, 08 May 2026 00:00:00 +0000

Contar artefactos de un tipo concreto

Este ejemplo muestra cómo inspeccionar y contar artefactos de paginación en un PDF Document usando Aspose.PDF for Python via .NET. Los artefactos de paginación incluyen elementos como marcas de agua, fondos, encabezados y pies de página que se aplican a las páginas con fines de diseño e identificación. Al filtrar objetos Artifact en una Page y agruparlos por subtipo (Artifact.ArtifactSubtype), los desarrolladores pueden analizar rápidamente la estructura del documento y verificar la presencia de elementos específicos.

Para calcular el recuento total de artefactos de un tipo concreto, por ejemplo el número total de marcas de agua, use el siguiente código. El ejemplo filtra la colección Artifacts de la página, que es una ArtifactCollection, por Artifact.ArtifactType y luego cuenta los subtipos (Artifact.ArtifactSubtype).

Abra el documento PDF (ver Document).
Filtrar los artefactos de paginación usando la colección Artifacts de la página.
Contar artefactos por subtipo (Artifact.ArtifactSubtype).
Imprima los 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)}")

Temas relacionados con artefactos

Python-Net: Administrar encabezados y pies de página de PDF usando Python

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

Crear artefactos de texto con estilo

Esta función utilitaria explica cómo crear un artefacto de texto reutilizable para páginas PDF usando Aspose.PDF for Python. Está diseñada para generar encabezados o pies de página con estilo y un formato coherente, incluidos los ajustes de fuente, color, tamaño y alineación. La función abstrae la creación del artefacto para que pueda reutilizarse en diferentes decoraciones de texto a nivel de página.

Instanciar el objeto artefacto.
Establecer el contenido de texto del artefacto.
Aplicar estilo de texto.
Establecer alineación.
Devolver artefacto 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

Agregar encabezado al PDF

Abrir el PDF de entrada.
Cree un HeaderArtifact con el texto “Sample Header”.
Agréguelo a la primera página.
Guarde el PDF actualizado.

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)

Agregar pie de página al PDF

Abrir el PDF de entrada.
Crear un FooterArtifact con el texto “Sample Footer”.
Agréguelo a la primera página.
Guardar el archivo de salida.

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)

Eliminar artefactos de encabezado o pie de página

Abrir el PDF.
Buscar artefactos marcados como encabezados o pies de página de paginación.
Elimínelos de la primera página.
Guarde el documento limpio.

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)