Documentation – Bekerja dengan Artefak PDF di Python

Python-Net: Tambahkan Penomoran Bates ke PDF dengan Python

Fri, 12 Jun 2026 00:00:00 +0000

Penomoran Bates banyak digunakan dalam alur kerja hukum, medis, dan bisnis untuk menetapkan pengidentifikasi unik dan berurutan ke halaman dalam sekumpulan dokumen. Aspose.PDF for Python via .NET menawarkan API yang sederhana dan fleksibel untuk mengotomatisasi proses ini, memungkinkan Anda menerapkan nomor Bates standar secara programatik pada PDF apa pun.

Menggunakan BatesNArtifact kelas, pengembang dapat sepenuhnya menyesuaikan perilaku penomoran—termasuk nomor awal, jumlah digit, awalan dan akhiran, perataan, serta margin. Setelah dikonfigurasi, artefak dapat diterapkan ke Document melalui add_bates_numbering metode pada PageCollection atau ditambahkan sebagai bagian dari daftar PaginationArtifact objek. Aspose.PDF juga mendukung gaya konfigurasi berbasis delegasi, memungkinkan kontrol dinamis terhadap pengaturan artifact pada runtime.

Selain membuat nomor Bates, API menyediakan cara mudah untuk menghapusnya menggunakan delete_bates_numbering, menawarkan fleksibilitas lengkap dalam alur kerja pemrosesan dokumen.

Artikel ini menunjukkan beberapa metode untuk menambahkan dan menghapus penomoran Bates dalam PDF menggunakan Aspose.PDF for Python via .NET, dengan contoh yang jelas tentang konfigurasi, penerapan, dan penghapusan artifact.

Menambahkan Artefak Penomoran Bates

Contoh ini menunjukkan bagaimana cara menambahkan penomoran Bates secara programatis ke dokumen PDF menggunakan Aspose.PDF for Python via .NET. Dengan mengkonfigurasi sebuah BatesNArtifact dengan pengaturan yang diinginkan dan menerapkannya ke halaman dokumen, Anda dapat mengotomatiskan proses penambahan pengidentifikasi standar ke setiap halaman.

Untuk menambahkan artefak penomoran Bates ke sebuah Document, panggil AddBatesNumbering(BatesNArtifact) metode ekstensi pada PageCollection, melewatkan sebuah BatesNArtifact instance sebagai parameter:

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)

Menambahkan Penomoran Bates Menggunakan Artefak Paginasi

Menambahkan penomoran Bates ke PDF menggunakan koleksi artefak paginasi di Aspose.PDF for Python:

Muat dokumen PDF.
Sisipkan halaman tambahan jika diperlukan sebelum menerapkan penomoran.
Buat artefak Bates.
Konfigurasikan properti artefak.
Tambahkan artefak ke koleksi paginasi.
Terapkan pagination ke halaman.
Simpan dokumen yang diperbarui.

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)

Hapus Penomoran Bates

Untuk menghapus penomoran Bates dari sebuah Document, gunakan delete_bates_numbering() metode pada 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)

Topik Artefak Terkait

Python-Net: Tambahkan Latar Belakang PDF di Python

Fri, 12 Jun 2026 00:00:00 +0000

Menambahkan Gambar Latar Belakang ke PDF

Gambar latar dapat digunakan untuk menambahkan watermark, atau desain halus lainnya, ke dokumen. Dalam Aspose.PDF for Python via .NET, setiap dokumen PDF adalah kumpulan halaman dan setiap halaman berisi kumpulan artefak. The BackgroundArtifact kelas dapat digunakan untuk menambahkan gambar latar ke objek halaman.

Pendekatan ini berguna ketika Anda perlu menempatkan gambar dekoratif di belakang konten PDF utama tanpa mengubahnya menjadi teks dokumen yang dapat dicari.

Cuplikan kode berikut menunjukkan cara menambahkan gambar latar belakang ke halaman PDF menggunakan objek BackgroundArtifact dengan Python.

Muat dokumen PDF.
Buat artefak latar belakang.
Muat file gambar.
Lampirkan artefak ke halaman.
Simpan dokumen yang diperbarui.


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)

Tambahkan Gambar Latar Belakang dengan Opasitas ke PDF

Tambahkan gambar latar belakang semi-transparan ke halaman PDF menggunakan Aspose.PDF for Python.

Dengan menerapkan opasitas, gambar latar belakang menjadi sebagian transparan, memungkinkan konten halaman asli (teks, gambar, dll.) tetap terlihat jelas. Ini sangat berguna untuk:

Watermark
Overlay merek
Peningkatan desain yang halus

Latar belakang ditambahkan sebagai artefak, memastikan tetap berada di belakang semua konten halaman.

Muat dokumen PDF.
Buat artefak latar belakang.
Muat file gambar.
Atur tingkat opasitas.
Lampirkan artefak ke halaman.
Simpan dokumen yang diperbarui.


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)

Tambahkan Warna Latar Belakang ke PDF

Terapkan warna latar belakang solid ke halaman PDF menggunakan Aspose.PDF for Python.

Muat dokumen PDF.
Buat artefak latar belakang.
Atur warna latar belakang.
Lampirkan artefak ke halaman.
Simpan dokumen yang diperbarui.


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)

Hapus Latar Belakang dari PDF

Hapus artefak latar belakang dari halaman PDF menggunakan Aspose.PDF for Python. Latar belakang dalam PDF sering disimpan sebagai artefak, dan metode ini secara selektif mengidentifikasi serta menghapus hanya artefak yang diklasifikasikan sebagai elemen latar belakang.

Muat dokumen PDF.
Akses artefak halaman.
Saring artefak latar belakang.
Kumpulkan elemen latar belakang.
Hapus artefak latar belakang.
Simpan dokumen yang diperbarui.


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)

Topik Artefak Terkait

Python-Net: Menambahkan Tanda Air ke PDF dengan Python

Fri, 12 Jun 2026 00:00:00 +0000

Tambahkan artefak watermark ke PDF Document menggunakan Aspose.PDF for Python via .NET. Watermark adalah lapisan visual yang diterapkan pada halaman untuk tujuan branding, keamanan, atau informasi. Contoh ini menunjukkan cara mengkonfigurasi TextState penampilan, penempatan dengan HorizontalAlignment dan VerticalAlignment, rotasi, dan transparansi sebelum menerapkan watermark ke Page.

Ekstrak Watermark dari PDF

Muat dokumen PDF.
Akses artefak halaman.
Filter artefak watermark.
Kumpulkan elemen watermark.
Ekstrak properti watermark.
Keluarkan informasi watermark.

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}")

Tambahkan Watermark ke PDF

Tambahkan watermark teks ke dokumen PDF menggunakan Aspose.PDF for Python:

Muat dokumen PDF.
Buat keadaan teks.
Buat artefak watermark.
Atur teks watermark dan gaya.
Konfigurasikan penempatan dan rotasi.
Atur opacity dan perilaku latar belakang.
Lampirkan watermark ke halaman.
Simpan dokumen yang diperbarui.

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)

Hapus Artefak Watermark dari Halaman PDF

Hapus artefak watermark dari halaman tertentu dalam dokumen PDF menggunakan API Aspose.PDF for Python. Pendekatan ini menargetkan elemen watermark yang disimpan sebagai artefak halaman (khususnya yang diklasifikasikan sebagai subtipe watermark pagination), mengiterasi mereka, dan menghapusnya sebelum menyimpan dokumen yang diperbarui.

Muat dokumen PDF.
Akses artefak halaman.
Filter artefak watermark.
Hapus artefak watermark.
Simpan dokumen yang diperbarui.

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)

Topik Artefak Terkait

Python-Net: Hitung Artefak PDF dalam Python

Fri, 12 Jun 2026 00:00:00 +0000

Menghitung Artefak dari Tipe Tertentu

Periksa dan hitung artefak paginasi dalam PDF Document menggunakan Aspose.PDF for Python via .NET. Artefak paginasi mencakup elemen seperti watermark, latar belakang, header, dan footer yang diterapkan pada halaman untuk tujuan tata letak dan identifikasi. Dengan memfilter Artifact objek pada sebuah Page dan mengelompokkannya berdasarkan subtipe (Artifact.ArtifactSubtype), pengembang dapat dengan cepat menganalisis struktur dokumen dan memverifikasi keberadaan elemen tertentu.

Untuk menghitung jumlah total artefak dari tipe tertentu (misalnya, total watermark), gunakan kode berikut. Contoh ini memfilter halaman Artifacts koleksi (sebuah ArtifactCollection) oleh Artifact.ArtifactType dan kemudian menghitung subtipe (Artifact.ArtifactSubtype).

Buka dokumen PDF (lihat Document).
Filter artefak paginasi menggunakan halaman Artifacts koleksi.
Hitung artefak berdasarkan subtipe (Artifact.ArtifactSubtype).
Cetak hasil.


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)}")

Topik Artefak Terkait

Python-Net: Kelola Header dan Footer PDF menggunakan Python

Fri, 12 Jun 2026 00:00:00 +0000

Buat Artefak Teks Bergaya

Fungsi utilitas ini menjelaskan cara membuat artefak teks yang dapat digunakan kembali untuk halaman PDF menggunakan Aspose.PDF for Python. Fungsi ini dirancang untuk menghasilkan header atau footer yang bergaya dengan pemformatan konsisten, termasuk pengaturan font, warna, ukuran, dan perataan. Fungsi ini mengabstraksi pembuatan artefak sehingga dapat digunakan kembali untuk dekorasi teks tingkat halaman yang berbeda.

Instansiasi objek artefak.
Atur konten teks artefak.
Terapkan gaya teks.
Atur perataan.
Kembalikan artefak yang dikonfigurasi.

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

Tambahkan Header ke PDF

Buka PDF input.
Buat HeaderArtifact dengan teks “Sample Header”.
Tambahkan ke halaman pertama.
Simpan PDF yang diperbarui.

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)

Buka PDF input.
Buat FooterArtifact dengan teks “Sample Footer”.
Tambahkan ke halaman pertama.
Simpan file output.

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)

Hapus Artefak Header atau Footer

Buka PDF.
Temukan artefak yang ditandai sebagai header atau footer pagination.
Hapus mereka dari halaman pertama.
Simpan dokumen yang sudah dibersihkan.

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)

Documentation – Bekerja dengan Artefak PDF di Python

Python-Net: Tambahkan Penomoran Bates ke PDF dengan Python

Menambahkan Artefak Penomoran Bates

Menambahkan Penomoran Bates Menggunakan Artefak Paginasi

Hapus Penomoran Bates

Topik Artefak Terkait

Python-Net: Tambahkan Latar Belakang PDF di Python

Menambahkan Gambar Latar Belakang ke PDF

Tambahkan Gambar Latar Belakang dengan Opasitas ke PDF

Tambahkan Warna Latar Belakang ke PDF

Hapus Latar Belakang dari PDF

Topik Artefak Terkait

Python-Net: Menambahkan Tanda Air ke PDF dengan Python

Ekstrak Watermark dari PDF

Tambahkan Watermark ke PDF

Hapus Artefak Watermark dari Halaman PDF

Topik Artefak Terkait

Python-Net: Hitung Artefak PDF dalam Python

Menghitung Artefak dari Tipe Tertentu

Topik Artefak Terkait

Python-Net: Kelola Header dan Footer PDF menggunakan Python

Buat Artefak Teks Bergaya

Tambahkan Header ke PDF

Tambahkan Footer ke PDF

Hapus Artefak Header atau Footer

Topik Artefak Terkait