Ajouter une image au pied de page d’un PDF dans Python SDK
API pour travailler avec l’image dans le pied de page des documents PDF en utilisant Cloud Python SDK.
Get StartedComment ajouter une image dans le pied de page d'un PDF via Cloud Python SDK
Pour ajouter une image dans le pied de page d’un PDF, nous utiliserons Aspose.PDF Cloud Python SDK. Ce SDK Cloud aide les programmeurs Python à développer des applications de création, annotation, édition et conversion de PDF basées sur le cloud en utilisant le langage de programmation Python via l’API REST d’Aspose.PDF. Créez simplement un compte sur Aspose for Cloud et obtenez les informations de votre application. Une fois que vous avez le SID et la clé de l’application, vous êtes prêt à utiliser le Aspose.PDF Cloud Python SDK. Si le paquet 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 paquets
pip install asposepdfcloud
Étapes pour ajouter une image dans le pied de page via Python
Les développeurs d’Aspose.PDF Cloud peuvent facilement charger et ajouter une image dans le pied de page d’un PDF en seulement quelques lignes de code.
- Installez le Python SDK
- Téléchargez un document PDF sur le serveur Aspose Cloud
- Téléchargez le document PDF traité depuis le serveur Aspose Cloud
- Ajoutez un nouveau pied de page avec image sur la page du document PDF
Ajoutez une image dans le pied de page d'un PDF en utilisant Python
import shutil
import json
import logging
from pathlib import Path
from asposepdfcloud import ApiClient, PdfApi, ImageFooter, HorizontalAlignment
# Configure logging
logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
class Config:
"""Configuration parameters."""
CREDENTIALS_FILE = Path(r"C:\\Projects\\ASPOSE\\Pdf.Cloud\\Credentials\\credentials.json")
LOCAL_FOLDER = Path(r"C:\Samples")
PDF_DOCUMENT_NAME = "sample.pdf"
LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
IMAGE_FOOTER_FILE = "sample.png"
PAGE_NUMBER = 2 # Your document page number...
class pdfHederFooter:
"""Class for managing PDF headers and footers using Aspose PDF Cloud API."""
def __init__(self, credentials_file: Path = Config.CREDENTIALS_FILE):
self.pdf_api = None
self._init_api(credentials_file)
def _init_api(self, credentials_file: Path):
"""Initialize the API client."""
try:
with credentials_file.open("r", encoding="utf-8") as file:
credentials = json.load(file)
api_key, app_id = credentials.get("key"), credentials.get("id")
if not api_key or not app_id:
raise ValueError("init_api(): Error: Missing API keys in the credentials file.")
self.pdf_api = PdfApi(ApiClient(api_key, app_id))
except (FileNotFoundError, json.JSONDecodeError, ValueError) as e:
logging.error(f"init_api(): Failed to load credentials: {e}")
def upload_file(self, fileName: str):
""" Upload a local fileName to the Aspose Cloud server. """
if self.pdf_api:
file_path = Config.LOCAL_FOLDER / fileName
try:
self.pdf_api.upload_file(fileName, str(file_path))
logging.info(f"upload_file(): File '{fileName}' uploaded successfully.")
except Exception as e:
logging.error(f"upload_document(): Failed to upload file: {e}")
def upload_document(self):
""" Upload a PDF document to the Aspose Cloud server. """
self.upload_file(Config.PDF_DOCUMENT_NAME)
def download_result(self):
""" Download the processed PDF document from the Aspose Cloud server. """
if self.pdf_api:
try:
temp_file = self.pdf_api.download_file(Config.PDF_DOCUMENT_NAME)
local_path = Config.LOCAL_FOLDER / Config.LOCAL_RESULT_DOCUMENT_NAME
shutil.move(temp_file, str(local_path))
logging.info(f"download_result(): File successfully downloaded: {local_path}")
except Exception as e:
logging.error(f"download_result(): Failed to download file: {e}")
def append_image_footer(self):
"""Append a new image footer to the PDF document."""
if self.pdf_api:
new_footer = ImageFooter(
background = True,
horizontal_alignment = HorizontalAlignment.CENTER,
file_name = Config.IMAGE_FOOTER_FILE,
width = 24,
height = 24
)
try:
response = self.pdf_api.post_document_image_footer(
Config.PDF_DOCUMENT_NAME, new_footer
)
if response.code == 200:
logging.info(f"append_image_footer(): Footer '{new_footer.file_name}' added to the document #{Config.PDF_DOCUMENT_NAME}.")
else:
logging.error(f"append_image_footer(): Failed to add footer '{new_footer.file_name}' to the document #{Config.PDF_DOCUMENT_NAME}. Response code: {response.code}")
except Exception as e:
logging.error(f"append_image_footer(): Error while adding footer: {e}")
def append_image_footer_page(self):
"""Append a new image footer on the page in PDF document."""
if self.pdf_api:
new_footer = ImageFooter(
background = True,
horizontal_alignment = HorizontalAlignment.RIGHT,
file_name = Config.IMAGE_FOOTER_FILE,
width = 24,
height = 24
)
try:
response = self.pdf_api.post_document_image_footer(
Config.PDF_DOCUMENT_NAME, new_footer, start_page_number=Config.PAGE_NUMBER, end_page_number=Config.PAGE_NUMBER
)
if response.code == 200:
logging.info(f"append_image_footer_page(): Footer '{new_footer.file_name}' added to the page #{Config.PAGE_NUMBER}.")
else:
logging.error(f"append_image_footer_page(): Failed to add footer '{new_footer.file_name}' to the document #{Config.PAGE_NUMBER}. Response code: {response.code}")
except Exception as e:
logging.error(f"append_image_footer_page(): Error while adding footer: {e}")
if __name__ == "__main__":
pdf_header_footer = pdfHederFooter()
pdf_header_footer.upload_document()
pdf_header_footer.upload_file(Config.IMAGE_FOOTER_FILE)
pdf_header_footer.append_image_footer()
pdf_header_footer.append_image_footer_page()
pdf_header_footer.download_result()
Travaillez avec le pied de page dans un PDF
Ajouter une image au pied de page d’un PDF améliore le branding du document, la sécurité, l’esthétique et la fonctionnalité. C’est particulièrement précieux pour les documents d’affaires, les rapports, les documents juridiques et les supports marketing, assurant une présentation professionnelle et bien structurée. Ajoutez le pied de page dans les documents PDF avec Aspose.PDF Cloud Python SDK.
Avec notre bibliothèque Python, vous pouvez :
- Combiner des documents PDF.
- Diviser des fichiers PDF.
- Convertir des PDF en d’autres formats, et vice versa.
- Manipuler les annotations.
- Travailler avec des images dans un PDF, etc.
- Vous pouvez essayer nos applications gratuites pour tester la fonctionnalité en ligne.