Intégrer des codes-barres directement dans les fichiers PDF est une exigence courante pour le suivi des stocks, la billetterie et les flux de travail de documents sécurisés. Aspose.PDF for Python via .NET fournit un SDK robuste qui simplifie l’ajout de codes-barres aux PDF en Python. Dans ce tutoriel, vous apprendrez comment générer des images de codes-barres, les placer sur des PDF existants et personnaliser leur apparence. À la fin, vous serez capable d’ajouter programmétiquement des codes-barres à un ou plusieurs documents PDF en toute confiance.

Comment ajouter un code-barres à un PDF en Python - Étape par étape

  1. Installer les packages requis : Utilisez pip pour installer Aspose.PDF et Aspose.BarCode.
pip install aspose-pdf
pip install aspose-barcode-for-python-via-net
  1. Générer l’image du code-barres : Créez un code-barres à l’aide d’Aspose.BarCode. L’image générée peut être enregistrée dans un flux mémoire.
from aspose.barcode import generation

# Generate the barcode image
generator = generation.BarcodeGenerator(generation.EncodeTypes.CODE39_STANDARD, "1234567")
generator.save(barcode_image, generation.BarCodeImageFormat.PNG)
  1. Créer le document PDF cible : Ouvrez le PDF existant avec Aspose.PDF.
import aspose.pdf as ap

# Create a new PDF document and add a page
document = ap.Document("input.pdf")
page = document.pages.add()
page.set_page_size(595, 842)
  1. Insérer l’image du code-barres sur la page souhaitée : Utilisez un ImageStamp pour placer le code-barres. Ajustez la position et la taille selon les besoins.
# Add the barcode image at the specified coordinates
page.add_image(barcode_image, ap.Rectangle(100, 650, 300, 750, True))
  1. Enregistrer le PDF mis à jour (ou boucler pour un traitement en masse) : Conservez les modifications ou parcourez plusieurs PDF pour ajouter en masse des codes-barres à un PDF en Python.
document.save(output_pdf)

Intégration d’un code-barres dans un PDF avec Python - Exemple de code complet

L’exemple suivant montre un flux de travail complet qui génère un code‑barres, l’intègre dans un PDF existant et enregistre le résultat.

import aspose.pdf as ap
from aspose.barcode import generation

def add_barcode_to_new_pdf(output_pdf, barcode_image):
    # Generate the barcode image
    generator = generation.BarcodeGenerator(generation.EncodeTypes.CODE39_STANDARD, "1234567")
    generator.save(barcode_image, generation.BarCodeImageFormat.PNG)

# Create a new PDF document and add a page
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(595, 842)

# Add the barcode image at the specified coordinates
    page.add_image(barcode_image, ap.Rectangle(100, 650, 300, 750, True))

# Save the resulting PDF document
    document.save(output_pdf)

if __name__ == "__main__":
    add_barcode_to_new_pdf("AddBarcodeToNewPDF.pdf", "barcode.png")

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour les chemins de fichiers pour qu’ils correspondent à vos emplacements réels, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Aspose.PDF for Python via .NET - Prérequis et configuration

Pour commencer à utiliser le SDK, assurez‑vous d’avoir Python 3.6+ et le runtime .NET installés. Ensuite, installez les packages via pip :

pip install aspose-pdf aspose-barcode

Vous pouvez également télécharger les dernières versions binaires depuis la page de téléchargement. Aucun code de licence supplémentaire n’est requis pour l’évaluation, mais une licence valide est nécessaire pour une utilisation en production (voir la page de licence temporaire et la page de tarification).

Lire le code-barres à partir d’un document PDF avec Python

Nous pouvons reconnaître n’importe quelle image de code‑barres intégrée sur l’une des pages du document PDF en utilisant la collection resources.images d’une page. Cela permet d’extraire les images du PDF, puis nous lirons les informations du code‑barres à partir de l’image extraite. Nous pouvons lire les codes‑barres des documents PDF en suivant les étapes ci‑dessous :

  1. Tout d’abord, chargez le document PDF d’entrée en utilisant la Document class.
  2. Ensuite, sélectionnez la page cible et récupérez sa collection resources.images.
  3. Puis, enregistrez chaque image incorporée dans un fichier dans une boucle.
  4. Ensuite, créez une instance de la BarCodeReader class avec le chemin de l’image et DecodeType comme arguments.
  5. Après cela, appelez la méthode read_bar_codes() pour obtenir les résultats de reconnaissance.
  6. Enfin, parcourez les résultats et affichez les informations du code-barres.

L’exemple de code suivant montre comment lire une image de code‑barres à partir d’un document PDF en utilisant Python.

import aspose.pdf as ap
from aspose.barcode import recognition
from io import FileIO

def read_barcode_from_pdf(input_pdf, extracted_image):
    # Load the input PDF document
    document = ap.Document(input_pdf)
    page = document.pages[1]

# Extract the first image from the page resources
    x_image = page.resources.images[1]
    with FileIO(extracted_image, "wb") as image_stream:
        x_image.save(image_stream)

# Read the barcode from the extracted image
    reader = recognition.BarCodeReader(extracted_image, recognition.DecodeType.CODE39_STANDARD)
    for result in reader.read_bar_codes():
        print(f"Codetext found: {result.code_text}")
        print(f"Symbology: {result.code_type_name}")

if __name__ == "__main__":
    read_barcode_from_pdf("AddBarcodeToExistingPDF.pdf", "extracted_barcode.png")

Codetext found: 1234567
Symbology: Code39Standard

Conclusion

Ajouter un code-barres à un PDF en Python devient simple avec Aspose.PDF for Python via .NET. Les puissantes fonctionnalités de manipulation PDF du SDK combinées à la génération de codes-barres d’Aspose.BarCode vous permettent de mettre en œuvre un flux complet d’ajout de code-barres à un PDF en seulement quelques lignes de code. Que vous mettiez à jour un seul document ou que vous effectuiez un ajout en masse de code-barres à un PDF en Python pour de gros lots, la bibliothèque offre les performances et la flexibilité dont vous avez besoin. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; vous pouvez explorer les options de tarification abordables sur la page de tarification ou obtenir une licence d’évaluation temporaire depuis la page de licence temporaire.

FAQs

  • Comment ajouter un code‑barres à un PDF existant en Python ?
    Utilisez Aspose.PDF pour charger le PDF, générez le code‑barres avec Aspose.BarCode, et intégrez‑le en utilisant add_image(). Le processus complet est illustré dans l’exemple de code ci‑dessus.

  • Quelle est l’approche recommandée pour ajouter en masse des codes-barres à un PDF en Python ?
    Parcourez votre collection de PDF, réutilisez un seul BarcodeGenerator et travaillez avec des flux. Appliquez les conseils de performance de la section “Performance Considerations” pour maintenir une faible utilisation de la mémoire.

  • Existe-t-il un moyen de personnaliser la taille et la position du code-barres de manière programmatique ?
    Absolument. Ajustez les propriétés width, height, x, y et rotation du barcode.

En savoir plus