Documentation – Travailler avec les artefacts PDF en Python

Python-Net: Ajouter une numérotation Bates au PDF en Python

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

La numérotation Bates est largement utilisée dans les flux de travail juridiques, médicaux et commerciaux pour attribuer des identifiants uniques et séquentiels aux pages d’un ensemble de documents. Aspose.PDF for Python via .NET propose une API simple et flexible pour automatiser ce processus, vous permettant d’appliquer des numéros Bates standardisés de manière programmatique à n’importe quel PDF.

En utilisant le BatesNArtifact classe, les développeurs peuvent entièrement personnaliser le comportement de la numérotation—y compris le numéro de départ, le nombre de chiffres, les préfixes et suffixes, l’alignement et les marges. Une fois configuré, l’artefact peut être appliqué au Document à travers le add_bates_numbering méthode sur le PageCollection ou ajouté en tant que partie d’une liste de PaginationArtifact objets. Aspose.PDF prend également en charge un style de configuration basé sur les délégués, permettant un contrôle dynamique des paramètres des artefacts à l’exécution.

En plus de créer des numéros Bates, l’API offre un moyen simple de les supprimer en utilisant delete_bates_numbering, offrant une flexibilité totale dans les flux de traitement de documents.

Cet article présente plusieurs méthodes pour ajouter et supprimer la numérotation Bates dans un PDF à l’aide d’Aspose.PDF for Python via .NET, avec des exemples clairs de configuration, d’application et de suppression des artefacts.

Ajout d’un artefact de numérotation Bates

Cet exemple montre comment ajouter programmatique la numérotation Bates à un document PDF en utilisant Aspose.PDF for Python via .NET. En configurant un BatesNArtifact avec les paramètres souhaités et en l’appliquant aux pages du document, vous pouvez automatiser le processus d’ajout d’identifiants standardisés à chaque page.

Pour ajouter un artefact de numérotation Bates à un Document, appelez le AddBatesNumbering(BatesNArtifact) méthode d’extension sur le PageCollection, en passant un BatesNArtifact instance comme paramètre :

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)

Ajouter la numérotation Bates à l’aide des artefacts de pagination

Ajouter la numérotation Bates à un PDF en utilisant la collection d’artefacts de pagination dans Aspose.PDF for Python:

Chargez le document PDF.
Insérez des pages supplémentaires si nécessaire avant d’appliquer la numérotation.
Créez un artefact Bates.
Configurez les propriétés de l’artefact.
Ajoutez l’artefact à la collection de pagination.
Appliquer la pagination aux pages.
Enregistrez le document mis à jour.

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)

Supprimer la numérotation Bates

Pour supprimer la numérotation Bates d’un Document, utilisez le delete_bates_numbering() méthode sur le 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)

Sujets d’artefacts associés

Python-Net: Ajouter des arrière-plans PDF en Python

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

Ajouter une image d’arrière-plan à un PDF

Les images d’arrière-plan peuvent être utilisées pour ajouter un filigrane, ou un autre design subtil, aux documents. Dans Aspose.PDF for Python via .NET, chaque document PDF est une collection de pages et chaque page contient une collection d’artefacts. Le BackgroundArtifact La classe peut être utilisée pour ajouter une image d’arrière-plan à un objet page.

Cette approche est utile lorsque vous devez placer une image décorative derrière le contenu principal du PDF sans le transformer en texte de document interrogeable.

L’extrait de code suivant montre comment ajouter une image d’arrière-plan aux pages PDF en utilisant l’objet BackgroundArtifact avec Python.

Chargez le document PDF.
Créez un artefact d’arrière-plan.
Chargez le fichier image.
Attachez l’artefact à une page.
Enregistrez le document mis à jour.


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)

Ajouter une image d’arrière-plan avec opacité à un PDF

Ajouter une image d’arrière-plan semi-transparente à une page PDF en utilisant Aspose.PDF for Python.

En appliquant l’opacité, l’image d’arrière-plan devient partiellement transparente, permettant au contenu original de la page (texte, images, etc.) de rester clairement visible. Ceci est particulièrement utile pour :

Filigranes
Superpositions de marque
Améliorations subtiles du design

L’arrière-plan est ajouté en tant qu’artefact, garantissant qu’il reste derrière tout le contenu de la page.

Chargez le document PDF.
Créez un artefact d’arrière-plan.
Chargez le fichier image.
Définir le niveau d’opacité.
Attachez l’artefact à une page.
Enregistrez le document mis à jour.


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)

Ajouter une couleur d’arrière-plan à un PDF

Appliquer une couleur d’arrière-plan unie à une page PDF à l’aide d’Aspose.PDF for Python.

Chargez le document PDF.
Créez un artefact d’arrière-plan.
Définir la couleur d’arrière-plan.
Attachez l’artefact à une page.
Enregistrez le document mis à jour.


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)

Supprimer l’arrière-plan d’un PDF

Supprimer les artefacts d’arrière-plan d’une page PDF à l’aide d’Aspose.PDF for Python. Les arrière-plans dans les PDF sont souvent enregistrés comme des artefacts, et cette méthode identifie et supprime sélectivement uniquement les artefacts classés comme éléments d’arrière-plan.

Chargez le document PDF.
Accéder aux artefacts de page.
Filtrer les artefacts d’arrière-plan.
Collecter les éléments d’arrière-plan.
Supprimer les artefacts d’arrière-plan.
Enregistrez le document mis à jour.


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)

Sujets d’artefacts associés

Python-Net: Ajouter des filigranes au PDF en Python

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

Ajouter un artefact de filigrane à un PDF Document en utilisant Aspose.PDF for Python via .NET. Un filigrane est une superposition visuelle appliquée aux pages à des fins de marque, de sécurité ou d’information. L’exemple montre comment configurer TextState apparence, positionnement avec HorizontalAlignment et VerticalAlignment, rotation, et transparence avant d’appliquer le filigrane à un Page.

Extraire les filigranes du PDF

Chargez le document PDF.
Accéder aux artefacts de page.
Filtrer les artefacts de filigrane.
Collecter les éléments de filigrane.
Extraire les propriétés du filigrane.
Informations de filigrane en sortie.

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

Ajouter un filigrane au PDF

Ajouter un filigrane de texte à un document PDF à l’aide d’Aspose.PDF for Python :

Chargez le document PDF.
Créer un état de texte.
Créer un artefact de filigrane.
Définir le texte et le style du filigrane.
Configurer le positionnement et la rotation.
Définir l’opacité et le comportement d’arrière-plan.
Attacher le filigrane à une page.
Enregistrez le document mis à jour.

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)

Supprimer les artefacts de filigrane d’une page PDF

Supprimer les artefacts de filigrane d’une page spécifique d’un document PDF à l’aide de l’API Aspose.PDF for Python. L’approche cible les éléments de filigrane stockés comme artefacts de page (plus précisément ceux classés comme sous-types de filigrane de pagination), les parcourt et les supprime avant d’enregistrer le document mis à jour.

Chargez le document PDF.
Accéder aux artefacts de page.
Filtrer les artefacts de filigrane.
Supprimer les artefacts de filigrane.
Enregistrez le document mis à jour.

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)

Sujets d’artefacts associés

Python-Net: Compter les artefacts PDF en Python

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

Comptage des artefacts d’un type particulier

Inspectez et comptez les artefacts de pagination dans un PDF Document en utilisant Aspose.PDF for Python via .NET. Les artefacts de pagination comprennent des éléments tels que les filigranes, les arrière-plans, les en-têtes et les pieds de page qui sont appliqués aux pages à des fins de mise en page et d’identification. En filtrant Artifact objets sur un Page et les regrouper par sous-type (Artifact.ArtifactSubtype), les développeurs peuvent rapidement analyser la structure du document et vérifier la présence d’éléments spécifiques.

Pour calculer le nombre total d’artefacts d’un type particulier (par exemple, le nombre total de filigranes), utilisez le code suivant. L’exemple filtre les page’s Artifacts collection (un ArtifactCollection) par Artifact.ArtifactType et puis compte les sous-types (Artifact.ArtifactSubtype).

Ouvrez le document PDF (voir Document).
Filtrer les artefacts de pagination en utilisant la page Artifacts collection.
Compter les artefacts par sous-type (Artifact.ArtifactSubtype).
Imprimer les résultats.


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

Sujets d’artefacts associés

Python-Net: Gérer les en-têtes et pieds de page PDF avec Python

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

Créer des artefacts de texte stylisés

Cette fonction utilitaire explique comment créer un artefact de texte réutilisable pour les pages PDF en utilisant Aspose.PDF for Python. Elle est conçue pour générer des en-têtes ou pieds de page stylisés avec un formatage cohérent, incluant les paramètres de police, la couleur, la taille et l’alignement. La fonction abstrait la création d’artefact afin qu’elle puisse être réutilisée pour différentes décorations de texte au niveau de la page.

Instanciez l’objet artefact.
Définissez le contenu texte de l’artefact.
Appliquez le style du texte.
Définir l’alignement.
Retourner l’artefact configuré.

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

Ajouter un en-tête au PDF

Ouvrir le PDF d’entrée.
Créer un HeaderArtifact avec le texte “Sample Header”.
Ajoutez-le à la première page.
Enregistrez le PDF mis à jour.

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)

Ajouter un pied de page au PDF

Ouvrir le PDF d’entrée.
Créer un FooterArtifact avec le texte “Sample Footer”.
Ajoutez-le à la première page.
Enregistrer le fichier de sortie.

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)

Supprimer les artefacts d’en-tête ou de pied de page

Ouvrir le PDF.
Trouver les artefacts marqués comme en-têtes ou pieds de page de pagination.
Les supprimer de la première page.
Enregistrer le document nettoyé.

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)