Documentation – Python で PDF アーティファクトを操作する

Python-Net: Python で PDF にベイツナンバリングを追加する方法

Tue, 09 Jun 2026 00:00:00 +0000

ベイツ番号付けは、法律、医療、ビジネスのワークフローで文書セット内のページに一意の識別子を連続して割り当てるために広く使用されています。Aspose.PDF for Python via .NET には、このプロセスを自動化するためのシンプルで柔軟な API が用意されているため、標準化された Bates 番号を任意の PDF にプログラムで適用できます。

を使用する BatesNArtifact クラスでは、開発者は開始番号、桁数、接頭辞と接尾辞、配置、余白など、番号付けの動作を完全にカスタマイズできます。設定が完了すると、アーティファクトをに適用できます。 Document を通じて add_bates_numbering のメソッド PageCollection またはリストの一部として追加 PaginationArtifact オブジェクト。Aspose.PDF はデリゲートベースの構成スタイルもサポートしているため、実行時にアーティファクト設定を動的に制御できます。

ベイツ番号の作成に加えて、API ではベイツ番号を簡単に削除する方法も用意されています。 delete_bates_numbering、文書処理ワークフローに完全な柔軟性を提供します。

この記事では、.NET 経由の Aspose.PDF for Python を使用して PDF にベイツ番号を追加および削除する複数の方法を、アーティファクトの構成、適用、および削除の明確な例とともに説明します。

ベイツナンバリングアーティファクトの追加

この例は、.NET 経由で Aspose.PDF for Python を使用して、プログラムで PDF ドキュメントにベイツ番号を追加する方法を示しています。を設定することにより BatesNArtifact 必要な設定を行い、それをドキュメントのページに適用すると、標準化された識別子を各ページに追加するプロセスを自動化できます。

ベイツナンバリングアーティファクトをに追加するには Document、に電話してください AddBatesNumbering(BatesNArtifact) の拡張メソッド PageCollection、渡す BatesNArtifact パラメータとしてのインスタンス:

import sys
from os import path
import aspose.pdf as ap

def _create_bates_artifact():
    """Create a Bates numbering artifact with default settings."""
    artifact = ap.BatesNArtifact()
    artifact.start_page = 1
    artifact.end_page = 0
    artifact.subset = ap.Subset.ALL
    artifact.number_of_digits = 6
    artifact.start_number = 1
    artifact.prefix = ""
    artifact.suffix = ""
    artifact.artifact_vertical_alignment = ap.VerticalAlignment.BOTTOM
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.RIGHT
    artifact.right_margin = 72
    artifact.left_margin = 72
    artifact.top_margin = 36
    artifact.bottom_margin = 36
    return artifact

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact(infile, outfile):
    """Add Bates numbering artifact to a PDF document."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_bates_numbering(document.pages, bates_artifact)
        document.save(outfile)

ページネーションアーティファクトを使用したベイツ番号の追加

Aspose.PDF for Python のページネーションアーティファクトコレクションを使用して PDF にベイツ番号を追加します。

PDF ドキュメントをロードします。
ナンバリングを適用する前に、必要に応じて余分なページを挿入してください。
ベイツアーティファクトを作る。
アーティファクトのプロパティを設定します。
アーティファクトをページネーションコレクションに追加します。
ページ分割をページに適用します。
更新した文書を保存します。

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact_pagination(infile, outfile):
    """Add Bates numbering using pagination artifacts collection."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_pagination(document.pages, [bates_artifact])
        document.save(outfile)

ベイツ番号を削除

からベイツ番号を削除するには Document、を使用してください delete_bates_numbering() のメソッド PageCollection:

import sys
from os import path
import aspose.pdf as ap

def delete_bates_numbering(infile, outfile):
    """Delete Bates numbering from a PDF document."""
    with ap.Document(infile) as document:
        ap.PageCollectionExtensions.delete_bates_numbering(document.pages)
        document.save(outfile)

アーティファクトの関連トピック

Python-Net: Python で PDF 背景を追加する方法

Tue, 09 Jun 2026 00:00:00 +0000

PDF への背景画像の追加

背景画像を使用して、透かしやその他の微妙なデザインを文書に追加できます。.NET 経由の Aspose.PDF for Python では、各 PDF ドキュメントはページの集まりであり、各ページにはアーティファクトのコレクションが含まれています。は背景アーティファクトクラスを使用して、ページオブジェクトに背景画像を追加できます。

この方法は、装飾画像を検索可能な文書テキストに変換せずにメインのPDFコンテンツの背後に配置する必要がある場合に便利です。

次のコードスニペットは、Python で BackgroundArtifact オブジェクトを使用して PDF ページに背景画像を追加する方法を示しています。

PDF ドキュメントをロードします。
背景アーティファクトを作成します。
画像ファイルをロードします。
アーティファクトをページに添付します。
更新した文書を保存します。


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_to_pdf(infile, imagefile, outfile):
    """Add a background image to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

不透明度のある背景画像を PDF に追加

Aspose.PDF for Python を使用して、半透明の背景イメージを PDF ページに追加します。

不透明度を適用すると、背景画像が部分的に透明になり、元のページコンテンツ（テキスト、画像など）がはっきりと見えるようになります。これは特に以下の場合に役立ちます。

ウォーターマーク
ブランディングオーバーレイ
微妙なデザインの強化

背景はアーティファクトとして追加され、すべてのページコンテンツの背後に残ります。

PDF ドキュメントをロードします。
背景アーティファクトを作成します。
画像ファイルをロードします。
不透明度を設定します。
アーティファクトをページに添付します。
更新した文書を保存します。


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_image_with_opacity_to_pdf(infile, imagefile, outfile):
    """Add a background image with opacity to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        artifact.opacity = 0.5
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

PDF への背景色の追加

Aspose.PDF for Python を使用して PDF ページに単色の背景色を適用します。

PDF ドキュメントをロードします。
背景アーティファクトを作成します。
背景色を設定します。
アーティファクトをページに添付します。
更新した文書を保存します。


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def add_background_color_to_pdf(infile, outfile):
    """Add a solid color background to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_color = ap.Color.dark_khaki
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

PDF から背景を削除

Aspose.PDF for Python を使用して PDF ページからバックグラウンドアーティファクトを削除します。 PDF の背景はアーティファクトとして保存されることが多く、この方法では背景要素として分類されたアーティファクトのみを選択的に識別して削除します。

PDF ドキュメントをロードします。
ページアーティファクトにアクセスします。
バックグラウンドアーティファクトをフィルタリングします。
背景要素を集める。
背景のアーティファクトを削除します。
更新した文書を保存します。


from os import path
from io import FileIO
import aspose.pdf as ap
import sys

def remove_background(infile, outfile):
    with ap.Document(infile) as document:
        backgrounds = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.BACKGROUND
        ]

        for background in backgrounds:
            document.pages[1].artifacts.delete(background)

        document.save(outfile)

アーティファクトの関連トピック

Python-Net: Python で PDF にウォーターマークを追加する方法

Tue, 09 Jun 2026 00:00:00 +0000

PDF へのウォーターマークアーティファクトの追加 Document .NET 経由で Python 用 Aspose.PDF を使用する。ウォーターマークは、ブランディング、セキュリティ、または情報提供を目的としてページに適用される視覚的なオーバーレイです。この例は設定方法を示しています。 TextState 外観、位置決め HorizontalAlignment そして VerticalAlignment、ウォーターマークを適用する前の回転、透明度 Page.

PDF からウォーターマークを抽出

PDF ドキュメントをロードします。
ページアーティファクトにアクセスします。
ウォーターマークアーティファクトをフィルタリングします。
ウォーターマークの要素を集めましょう。
ウォーターマークプロパティを抽出します。
ウォーターマーク情報を出力します。

from os import path
import sys
import aspose.pdf as ap

def extract_watermark_from_pdf(infile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            print(f"{watermark.text} {watermark.rectangle}")

PDF にウォーターマークを追加

Python 用 Aspose.PDF を使用して PDF ドキュメントにテキストウォーターマークを追加します。

PDF ドキュメントをロードします。
テキストステートを作成します。
ウォーターマークアーティファクトを作成します。
ウォーターマークのテキストとスタイルを設定します。
ポジショニングとローテーションを設定します。
不透明度と背景の動作を設定します。
ウォーターマークをページに添付します。
更新した文書を保存します。

from os import path
import sys
import aspose.pdf as ap

def add_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        text_state = ap.text.TextState()
        text_state.font_size = 72
        text_state.foreground_color = ap.Color.blue_violet
        text_state.font_style = ap.text.FontStyles.BOLD
        text_state.font = ap.text.FontRepository.find_font("Arial")

        watermark = ap.WatermarkArtifact()
        watermark.set_text_and_state("WATERMARK", text_state)
        watermark.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
        watermark.artifact_vertical_alignment = ap.VerticalAlignment.CENTER
        watermark.rotation = 60
        watermark.opacity = 0.2
        watermark.is_background = True

        document.pages[1].artifacts.append(watermark)
        document.save(outfile)

PDF ページからウォーターマークアーティファクトを削除

Aspose.PDF for Python API を使用して、PDF ドキュメントの特定のページからウォーターマークアーティファクトを削除します。このアプローチは、ページアーティファクトとして保存されているウォーターマーク要素（特にページネーションウォーターマークサブタイプとして分類されたもの）を対象とし、それらを繰り返し処理して、更新された文書を保存する前に削除します。

PDF ドキュメントをロードします。
ページアーティファクトにアクセスします。
ウォーターマークアーティファクトをフィルタリングします。
ウォーターマークアーティファクトを削除します。
更新した文書を保存します。

from os import path
import sys
import aspose.pdf as ap

def delete_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            document.pages[1].artifacts.delete(watermark)

        document.save(outfile)

アーティファクトの関連トピック

Python-Net: Python で PDF アーティファクトをカウントする方法

Tue, 09 Jun 2026 00:00:00 +0000

特定のタイプのアーティファクトのカウント

PDF のページネーションアーティファクトの検査とカウント Document .NET 経由で Python 用 Aspose.PDF を使用する。ページネーションアーティファクトには、レイアウトや識別の目的でページに適用されるウォーターマーク、背景、ヘッダー、フッターなどの要素が含まれます。フィルタリングによって Artifact 上のオブジェクト Page そしてそれらをサブタイプごとにグループ化します（Artifact.ArtifactSubtype) を使うと、開発者はドキュメントの構造をすばやく分析し、特定の要素の存在を確認できます。

特定のタイプのアーティファクトの総数 (ウォーターマークの総数など) を計算するには、次のコードを使用します。この例ではページがフィルタリングされます。 Artifacts コレクション (と) ArtifactCollection) によって Artifact.ArtifactType そしてサブタイプを数えます (Artifact.ArtifactSubtype).

PDF ドキュメントを開きます (「」を参照)。 Document).
ページを使用してページネーションアーティファクトをフィルタリングする Artifacts コレクション。
サブタイプ別にアーティファクトをカウントする (Artifact.ArtifactSubtype).
結果を印刷します。


from os import path
from collections import Counter
import sys
import aspose.pdf as ap

def count_pdf_artifacts(infile):
    """Count and display artifacts of different types on the first page."""
    with ap.Document(infile) as document:
        pagination_artifacts = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
        ]

        subtypes = [artifact.subtype for artifact in pagination_artifacts]
        counts = Counter(subtypes)

        print(f"Watermarks: {counts.get(ap.Artifact.ArtifactSubtype.WATERMARK, 0)}")
        print(f"Backgrounds: {counts.get(ap.Artifact.ArtifactSubtype.BACKGROUND, 0)}")
        print(f"Headers: {counts.get(ap.Artifact.ArtifactSubtype.HEADER, 0)}")
        print(f"Footers: {counts.get(ap.Artifact.ArtifactSubtype.FOOTER, 0)}")

アーティファクトの関連トピック

Python-Net: Python を使用して PDF ヘッダーとフッターを管理する

Tue, 09 Jun 2026 00:00:00 +0000

スタイル付きテキストアーティファクトの作成

このユーティリティ関数は、Aspose.PDF for Python を使用して PDF ページ用の再利用可能なテキストアーティファクトを作成する方法を説明します。フォント設定、色、サイズ、配置など、一貫したフォーマットでスタイル付きのヘッダーまたはフッターを生成するように設計されています。この関数はアーティファクトの作成を抽象化して、さまざまなページレベルのテキスト装飾に再利用できます。

アーティファクトオブジェクトをインスタンス化します。
アーティファクトのテキストコンテンツを設定します。
テキストスタイルを適用します。
配置を設定します。
設定済みのアーティファクトを返します。

from os import path
import aspose.pdf as ap
import sys

def _create_text_artifact(artifact_class, text):
    """Create a text artifact (header/footer) with common styling."""
    artifact = artifact_class()
    artifact.text = text
    artifact.text_state.font_size = 14
    artifact.text_state.font = ap.text.FontRepository.find_font("Arial")
    artifact.text_state.foreground_color = ap.Color.navy
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
    return artifact

PDF にヘッダーを追加

入力 PDF を開きます。
「サンプルヘッダー」というテキストを含むヘッダーアーティファクトを作成します。
最初のページに追加してください。
更新した PDF を保存します。

from os import path
import aspose.pdf as ap
import sys

def add_header_artifact(infile, outfile):
    """Add a header artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        header = _create_text_artifact(ap.HeaderArtifact, "Sample Header")
        document.pages[1].artifacts.append(header)
        document.save(outfile)

PDF にフッターを追加

入力 PDF を開きます。
「サンプルフッター」というテキストを含むフッターアーティファクトを作成します。
最初のページに追加してください。
出力ファイルを保存します。

from os import path
import aspose.pdf as ap
import sys

def add_footer_artifact(infile, outfile):
    """Add a footer artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        footer = _create_text_artifact(ap.FooterArtifact, "Sample Footer")
        document.pages[1].artifacts.append(footer)
        document.save(outfile)

ヘッダーまたはフッターのアーティファクトを削除

PDF を開きます。
ページネーションヘッダーまたはフッターとしてマークされたアーティファクトを検索します。
最初のページから削除してください。
クリーニングした文書を保存します。

from os import path
import aspose.pdf as ap
import sys

def delete_header_footer_artifact(infile, outfile):
    with ap.Document(infile) as document:
        header_footers = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and (
                artifact.subtype == ap.Artifact.ArtifactSubtype.HEADER
                or artifact.subtype == ap.Artifact.ArtifactSubtype.FOOTER
            )
        ]

        for art in header_footers:
            document.pages[1].artifacts.delete(art)

        document.save(outfile)