Добавление изображения в заголовок PDF в Python SDK
API для работы с изображениями в заголовках PDF-документов с использованием Cloud Python SDK.
Get StartedКак добавить изображение в заголовок PDF через Cloud Python SDK
Чтобы добавить изображение в заголовок PDF, мы будем использовать Aspose.PDF Cloud Python SDK. Этот Cloud SDK помогает программистам на Python разрабатывать облачные приложения для создания, аннотирования, редактирования и конвертации PDF с использованием языка программирования Python через REST API Aspose.PDF. Просто создайте учетную запись на Aspose for Cloud и получите информацию о вашем приложении. Как только у вас будет App SID и ключ, вы готовы использовать Aspose.PDF Cloud Python SDK. Если пакет Python размещен на Github, вы можете установить его напрямую с Github:
Установка с Github
pip install git+https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-python.git
Команда в консоли диспетчера пакетов
pip install asposepdfcloud
Шаги для добавления изображения в заголовок через Python
Разработчики Aspose.PDF Cloud могут легко загрузить и добавить изображение в заголовок PDF всего в несколько строк кода.
- Установите Python SDK
- Загрузите PDF-документ на сервер Aspose Cloud
- Скачайте обработанный PDF-документ с сервера Aspose Cloud
- Добавьте новый заголовок с изображением на страницу PDF-документа
Добавление изображения в заголовок PDF с использованием Python
import shutil
import json
import logging
from pathlib import Path
from asposepdfcloud import ApiClient, PdfApi, ImageHeader, HorizontalAlignment, TextHorizontalAlignment
# Configure logging
logging.basicConfig(level=logging.INFO, format="%(asctime)s - %(levelname)s - %(message)s")
class Config:
"""Configuration parameters."""
CREDENTIALS_FILE = Path(r"..\\credentials.json")
LOCAL_FOLDER = Path(r"C:\Samples")
PDF_DOCUMENT_NAME = "sample.pdf"
LOCAL_RESULT_DOCUMENT_NAME = "output_sample.pdf"
IMAGE_HEADER_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_header(self):
"""Append a new image header to the PDF document."""
if self.pdf_api:
new_header = ImageHeader(
background = True,
horizontal_alignment = HorizontalAlignment.CENTER,
file_name = Config.IMAGE_HEADER_FILE,
width = 24,
height = 24
)
try:
response = self.pdf_api.post_document_image_header(
Config.PDF_DOCUMENT_NAME, new_header
)
if response.code == 200:
logging.info(f"append_image_header(): Header '{new_header.file_name}' added to the document '{Config.PDF_DOCUMENT_NAME}'.")
else:
logging.error(f"append_image_header(): Failed to add header '{new_header.file_name}' to the document '{Config.PDF_DOCUMENT_NAME}'. Response code: {response.code}")
except Exception as e:
logging.error(f"append_image_header(): Error while adding header: {e}")
def append_image_heade_page(self):
"""Append a new image header to the page on PDF document."""
if self.pdf_api:
new_header = ImageHeader(
background = True,
horizontal_alignment = HorizontalAlignment.LEFT,
file_name = Config.IMAGE_HEADER_FILE,
width = 24,
height = 24
)
try:
response = self.pdf_api.post_document_image_header(
Config.PDF_DOCUMENT_NAME, new_header, start_page_number=Config.PAGE_NUMBER, end_page_number=Config.PAGE_NUMBER
)
if response.code == 200:
logging.info(f"append_image_heade_page(): Header '{new_header.file_name}' added to the page #{Config.PAGE_NUMBER}.")
else:
logging.error(f"append_image_heade_page(): Failed to add header '{new_header.file_name}' to the page #{Config.PAGE_NUMBER}. Response code: {response.code}")
except Exception as e:
logging.error(f"append_image_heade_page(): Error while adding header: {e}")
if __name__ == "__main__":
pdf_header_footer = pdfHederFooter()
pdf_header_footer.upload_document()
pdf_header_footer.upload_file(Config.IMAGE_HEADER_FILE)
pdf_header_footer.append_image_header()
pdf_header_footer.append_image_heade_page()
pdf_header_footer.download_result()
Работа с заголовками через Python SDK
Добавление изображения в заголовок PDF улучшает брендинг, безопасность, эстетику и функциональность документа. Это особенно важно для бизнес-документов, отчетов, юридических бумаг и маркетинговых материалов, обеспечивая профессиональную и хорошо структурированную презентацию. Добавьте заголовок в PDF-документы с Aspose.PDF Cloud Python SDK.
С нашим Python SDK вы можете
- Добавлять заголовок и нижний колонтитул PDF-документа в текстовом или графическом формате.
- Добавлять таблицы и текстовые или графические штампы в PDF-документы.
- Присоединять несколько PDF-документов к существующему файлу.
- Работать с вложениями, аннотациями и полями форм в PDF.
- Применять шифрование или дешифрование к PDF-документам и устанавливать пароль.
- Удалять все штампы и таблицы с страницы или всего документа PDF.
- Удалять конкретный штамп или таблицу из документа PDF по его ID.
- Заменять один или несколько экземпляров текста на странице PDF или в целом документе.
- Поддержка конвертации PDF-документов в различные другие форматы файлов.
- Извлечение различных элементов PDF-файлов и оптимизация PDF-документов.
- Вы можете попробовать наше бесплатное приложение для тестирования функциональности.
- Ресурсы для обучения
- Документация
- Исходный код
- Ссылки на API
- Поддержка продукта
- Бесплатная поддержка
- Платная поддержка
- Блог
- Почему Aspose.PDF Cloud для Python?
- Список клиентов
- Безопасность