PNG
JPG
BMP
TIFF
PDF
クラウド Python SDK を介して PDF のヘッダーに画像を追加する方法
PDF のヘッダーに画像を追加するには、 Aspose.PDF Cloud Python SDK を使用します。このクラウド SDK は、Python プログラマーが Aspose.PDF REST API を介して Python プログラミング言語を使用してクラウドベースの 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 ドキュメントのページに新しい画像ヘッダーを追加する
Python を使用して PDF のヘッダーに画像を追加
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 のヘッダーに画像を追加することで、ドキュメントのブランディング、セキュリティ、美観、および機能が向上します。特にビジネス文書、レポート、法的書類、マーケティング資料において、プロフェッショナルでよく構成されたプレゼンテーションを保証します。 Aspose.PDF Cloud Python SDK を使用して、PDF ドキュメントにヘッダーを追加します。
Python SDK を使用してできること
- PDF ドキュメントのヘッダーとフッターをテキストまたは画像形式で追加します。
- PDF ドキュメントにテーブルやテキストまたは画像スタンプを追加します。
- 複数の PDF ドキュメントを既存のファイルに追加します。
- PDF の添付ファイル、注釈、およびフォーム フィールドを操作します。
- PDF ドキュメントに暗号化または復号化を適用し、パスワードを設定します。
- ページまたは PDF ドキュメント全体からすべてのスタンプとテーブルを削除します。
- ID を指定して PDF ドキュメントから特定のスタンプまたはテーブルを削除します。
- PDF ページまたはドキュメント全体の単一または複数のテキスト インスタンスを置き換えます。
- PDF ドキュメントをさまざまな他のファイル形式に変換するための広範なサポート。
- PDF ファイルのさまざまな要素を抽出し、PDF ドキュメントを最適化します。
- 機能をテストするための 無料アプリ をお試しください。