Ajouter des annotations de texte en surbrillance à un PDF via Python SDK
API pour ajouter des annotations aux documents PDF en utilisant Cloud Python SDK.
Get StartedComment ajouter des annotations à un PDF via Cloud Python SDK
Pour ajouter des annotations de texte en surbrillance dans un PDF, nous utiliserons Aspose.PDF Cloud Python SDK. Ce SDK Cloud aide les programmeurs Python à développer des applications de création, d’annotation, d’édition et de conversion de PDF basées sur le cloud en utilisant le langage de programmation Python via Aspose.PDF REST API. Il suffit de créer un compte sur Aspose for Cloud et d’obtenir vos informations d’application. Une fois que vous avez l’App SID et la clé, vous êtes prêt à essayer Aspose.PDF Cloud Python SDK. Si le package python est hébergé sur Github, vous pouvez l’installer directement depuis Github :
Installation depuis Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Commande de la console du gestionnaire de packages
pip install asposepdfcloud
Étapes pour ajouter des annotations à un PDF via Python
Les développeurs Aspose.PDF Cloud peuvent facilement charger et ajouter des annotations à un PDF en quelques lignes de code.
- Installer Python SDK.
- Télécharger le PDF sur le stockage cloud.
- Créer une nouvelle annotation en surbrillance avec position, couleur, texte et style définis.
- Envoyer l’annotation à la page spécifiée en utilisant l’API Aspose Cloud.
- Vérifier la réponse et enregistrer le résultat.
- Télécharger le fichier mis à jour pour une utilisation locale.
Ajouter des annotations à un PDF en utilisant Python
from annotations_helper import Config, PdfAnnotationsHelper, logging
from asposepdfcloud import PdfApi, HighlightAnnotation, Rectangle, Color, Point, AnnotationFlags, HorizontalAlignment, VerticalAlignment
class PdfAddHighlightAnnotations:
"""Class for managing PDF annotations using Aspose PDF Cloud API."""
def __init__(self, pdf_api: PdfApi, helper: PdfAnnotationsHelper):
self.pdfApi = pdf_api
self.helper = helper
def append_highlight_annotation(self):
"""Append a new highlight text annotation to the PDF document."""
if self.pdfApi:
self.helper.uploadFile(Config.PDF_DOCUMENT_NAME, Config.LOCAL_FOLDER, Config.REMOTE_FOLDER)
args = {
"folder": Config.REMOTE_FOLDER
}
new_annotation = HighlightAnnotation(
rect = Rectangle(llx=100, lly=350, urx=450, ury=400),
name = 'Highlight_Text_Annotation',
flags = [AnnotationFlags.DEFAULT],
horizontal_alignment = HorizontalAlignment.LEFT,
vertical_alignment = VerticalAlignment.TOP,
rich_text = Config.NEW_HL_ANNOTATION_TEXT,
subject = Config.NEW_HL_ANNOTATION_SUBJECT,
contents= Config.NEW_HL_ANNOTATION_CONTENTS,
title = Config.NEW_HL_ANNOTATION_DESCRIPTION,
z_index = 1,
color=Color(a=0xFF, r=0, g=0xFF, b=0),
quad_points = [
Point(10, 10),
Point(20, 10),
Point(10, 20),
Point(10, 10)
],
modified = '03/27/2025 00:00:00.000 AM',
)
try:
response = self.pdfApi.post_page_highlight_annotations(Config.PDF_DOCUMENT_NAME, Config.PAGE_NUMBER, [new_annotation], **args)
if response.code == 200:
logging.info(f"append_highlight_annotation(): annotation '{Config.NEW_HL_ANNOTATION_TEXT}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
self.helper.downloadFile(Config.PDF_DOCUMENT_NAME, Config.LOCAL_RESULT_DOCUMENT_NAME, Config.LOCAL_FOLDER, Config.REMOTE_FOLDER, "add_highlight_")
else:
logging.error(f"append_highlight_annotation(): Failed to add annotation to the document. Response code: {response.code}")
except Exception as e:
logging.error(f"append_highlight_annotation(): Error while adding annotation: {e}")