PNG JPG BMP TIFF PDF
Aspose.PDF  for Python

Python SDK で PDF のヘッダーに画像を追加

クラウド Python SDK を使用して PDF ドキュメントのヘッダーで画像を操作するための API。

Get Started

クラウド 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 のヘッダーに画像を簡単に読み込み追加できます。

  1. Python SDK をインストールする
  2. PDF ドキュメントを Aspose Cloud サーバーにアップロードする
  3. 処理された PDF ドキュメントを Aspose Cloud サーバーからダウンロードする
  4. 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 ドキュメントを最適化します。
  • 機能をテストするための 無料アプリ をお試しください。

  •