Documentation – Bekerja dengan PDF Facades

Python-Net: Kelas PdfFileEditor

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

Bekerja dengan dokumen PDF mencakup berbagai fungsi. Mengelola halaman file PDF adalah bagian penting dari pekerjaan ini. ‘aspose.pdf.facades’ menyediakan PdfFileEditor kelas untuk tujuan ini.

Kelas PdfFileEditor berisi metode-metode yang membantu memanipulasi halaman individu; kelas ini tidak mengedit atau memanipulasi isi sebuah halaman. Anda dapat menyisipkan halaman baru, menghapus halaman yang ada, membagi halaman, atau menentukan imposisi halaman menggunakan PdfFileEditor.

Apa yang dapat Anda lakukan dengan PdfFileEditor

Fitur yang disediakan oleh kelas ini dapat dikelompokkan menjadi alur kerja penyuntingan halaman, pengaturan PDF, dan pemisahan dokumen. Artikel-artikel ini menunjukkan cara menyusun ulang halaman, menggabungkan beberapa PDF, menyiapkan file untuk pencetakan, dan mengekstrak bagian dari dokumen yang ada tanpa mengedit file sumber secara manual.

Tutorial PdfFileEditor

Python-Net: Kelas PdfContentEditor

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

The PdfContentEditor kelas dalam Aspose.PDF Facades dirancang untuk tugas penyuntingan tingkat konten pada dokumen PDF yang ada. Ini menyediakan API yang disederhanakan untuk memperbarui elemen interaktif, mengganti teks, bekerja dengan lampiran dan tautan, serta menyesuaikan perilaku dokumen dalam aplikasi Python via .NET.

Apa yang dapat Anda lakukan dengan PdfContentEditor

Gunakan bagian ini untuk menjelajahi area utama penyuntingan konten PDF yang didukung oleh PdfContentEditor fasad:

Python-Net: Kelas PdfAnnotationEditor

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

The PdfAnnotationEditor Kelas dalam Aspose.PDF Facades ditujukan untuk bekerja dengan anotasi PDF dan markup berbasis komentar tanpa mengedit secara manual struktur tingkat rendah dari sebuah dokumen. Ini menyediakan cara yang disederhanakan untuk menangani alur kerja anotasi dalam Python via .NET ketika Anda perlu memeriksa atau memperbarui file PDF yang ada.

Untuk apa PdfAnnotationEditor digunakan

Gunakan antarmuka ini ketika alur kerja PDF Anda melibatkan anotasi, komentar tinjauan, atau elemen markup lain yang perlu dikelola secara programatik. Seiring bagian ini berkembang, itu harus berfungsi sebagai halaman arahan untuk tutorial terkait anotasi yang dibangun di sekitar PdfAnnotationEditor kelas.

Python-Net: Kelas PdfFileSignature

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

Menyiapkan Pembantu Tanda Tangan Digital PDF

Sebelum menerapkan tanda tangan digital ke PDF, merupakan praktik terbaik untuk menyiapkan sekumpulan fungsi pembantu yang dapat digunakan kembali. Fungsi-fungsi ini mengenkapsulasi tugas-tugas umum—seperti menginisialisasi handler tanda tangan, menentukan penempatan visual tanda tangan, dan mengonfigurasi penandatanganan berbasis sertifikat—sehingga logika penandatanganan utama Anda tetap bersih, konsisten, dan mudah dipelihara.

Apa yang Dicapai oleh Pengaturan Ini

Lapisan pembantu ini mempersiapkan semua yang dibutuhkan untuk alur kerja penandatanganan yang lancar:

Menginisialisasi objek PdfFileSignature dan mengaitkannya dengan dokumen
Mendefinisikan di mana tanda tangan akan muncul pada halaman
Memuat dan menerapkan sertifikat penandatanganan
Membuat objek tanda tangan PKCS#7 yang dapat digunakan kembali dengan metadata
Menyesuaikan tampilan visual tanda tangan

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd


DEFAULT_CERTIFICATE_PASSWORD = "Aspose2021"
DEFAULT_SIGNATURE_NAME = "Signature1"


def create_pdf_file_signature(infile):
    pdf_signature = pdf_facades.PdfFileSignature()
    pdf_signature.bind_pdf(infile)
    return pdf_signature


def create_signature_rectangle():
    return apd.Rectangle(10, 10, 200, 60)


def configure_signature_certificate(
    pdf_signature, certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    pdf_signature.set_certificate(certificate_path, certificate_password)


def create_pkcs7_signature(
    certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    signature = ap.forms.PKCS7(certificate_path, certificate_password)
    signature.reason = "Document approval"
    signature.contact_info = "qa@example.com"
    signature.location = "New York, USA"
    signature.authority = "Aspose.PDF Example"
    return signature


def create_custom_signature_appearance():
    appearance = ap.forms.SignatureCustomAppearance()
    appearance.font_family_name = "Arial"
    appearance.font_size = 10
    appearance.show_contact_info = True
    appearance.show_location = True
    appearance.show_reason = True
    return appearance

Python-Net: Kelas FormEditor

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

The FormEditor Kelas dalam Aspose.PDF Facades dirancang untuk membuat dan memperbarui bidang formulir PDF interaktif. Ini membantu Anda membangun struktur formulir, menyesuaikan properti bidang, mengubah pengaturan tampilan, dan melampirkan perilaku interaktif seperti skrip dan tindakan submit dalam aplikasi Python.

Tugas umum FormEditor

Gunakan tutorial berikut untuk bekerja dengan kemampuan utama dari FormEditor fasad:

Python-Net: Kelas PdfFileInfo

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

The PdfFileInfo Kelas dalam Aspose.PDF Facades menyediakan akses ke informasi PDF tingkat dokumen dan tingkat halaman tanpa memerlukan parsing tingkat rendah. Ini berguna ketika Anda perlu memeriksa metadata, mengambil properti dokumen, memeriksa hak istimewa, atau memeriksa dimensi dan offset halaman dalam alur kerja otomatis.

Apa yang dapat Anda lakukan dengan PdfFileInfo

Gunakan artikel dalam bagian ini untuk menjelajahi kemampuan utama inspeksi file PdfFileInfo fasad:

Python-Net: Kelas PdfFileSecurity

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

The PdfFileSecurity Kelas dalam Aspose.PDF Facades digunakan untuk melindungi dokumen PDF dan mengontrol bagaimana pengguna dapat berinteraksi dengan mereka. Ini mendukung alur kerja keamanan umum seperti enkripsi berbasis kata sandi, dekripsi, rotasi kata sandi, dan manajemen izin untuk mencetak, menyalin, dan mengedit.

Apa yang dapat Anda lakukan dengan PdfFileSecurity

Gunakan artikel di bagian ini untuk menjelajahi tugas keamanan PDF utama yang didukung oleh PdfFileSecurity fasad:

Python-Net: Kelas PdfViewer

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

Aspose.PDF for Python via .NET menyediakan PdfViewer fasad untuk bekerja dengan skenario penampilan PDF dan decoding halaman. Salah satu kasus penggunaan umum adalah mengonversi halaman PDF menjadi objek gambar yang kemudian dapat disimpan ke disk.

Buat pembantu PdfViewer yang dapat digunakan kembali

Sebelum mendekode halaman atau membaca properti terkait penampil, buatlah helper kecil yang menginisialisasi dan mengembalikan sebuah PdfViewer instance. Ini menjaga contoh-contoh di bawah tetap mandiri dan membuatnya jelas bagaimana objek viewer dibuat sebelum dihubungkan ke dokumen PDF.

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades


def _create_viewer() -> pdf_facades.PdfViewer:
    """Create a PdfViewer configured for decoding examples."""
    viewer = pdf_facades.PdfViewer()
    viewer.coordinate_type = ap.PageCoordinateType.MEDIA_BOX
    viewer.resolution = 150
    viewer.scale_factor = 1.0
    viewer.show_hidden_areas = False
    return viewer

Dekode semua halaman PDF

Gunakan decode_all_pages() ketika Anda ingin mengonversi setiap halaman dalam PDF menjadi gambar terpisah. Gambar halaman yang dikembalikan kemudian dapat disimpan satu per satu ke direktori output.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def decode_all_pages(infile: str, output_dir: str) -> None:
    """Decode all pages of a PDF document into image files."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        decoded_pages = viewer.decode_all_pages()

        for index, page_image in enumerate(decoded_pages, start=1):
            image_path = path.join(output_dir, f"decode_all_pages_{index}.png")
            page_image.save(image_path)
    finally:
        viewer.close_pdf_file()

Mendekode halaman PDF tertentu

Gunakan decode_page() ketika Anda hanya membutuhkan satu halaman dari dokumen. Ini berguna saat membuat pratinjau, thumbnail, atau ekspor khusus halaman.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def decode_specific_page(infile: str, outfile: str, page_number: int = 1) -> None:
    """Decode a specific PDF page into an image file."""
    viewer = _create_viewer()
    try:
        viewer.bind_pdf(infile)
        page_image = viewer.decode_page(page_number)
        page_image.save(outfile)

    finally:
        viewer.close()

Periksa Metadata PDF

The inspect_pdf_metadata fungsi menunjukkan cara membuka dokumen PDF dan mengambil metadata dasar yang terkait dengan penampil menggunakan Aspose.PDF. Ini fokus pada mengekstrak informasi yang menggambarkan bagaimana dokumen ditafsirkan dan ditampilkan daripada isinya.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def inspect_pdf_metadata(infile: str) -> None:
    """Open a PDF and print page-count related viewer metadata."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        print(f"Page count: {viewer.page_count}")
        print(f"Coordinate type: {viewer.coordinate_type}")
        print(f"Resolution: {viewer.resolution}")
    finally:
        viewer.close_pdf_file()

Python-Net: Kelas Form

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

Python-Net: Kelas Stamp

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

Aspose.PDF for Python via .NET menyediakan Stempel kelas untuk menempatkan konten visual yang dapat digunakan kembali pada halaman PDF. Sebuah stamp dapat didasarkan pada teks, gambar, atau bahkan halaman dari PDF lain, dan dapat diposisikan, diputar, diberi gaya, serta dibatasi pada halaman tertentu.

Artikel ini menunjukkan beberapa alur kerja cap umum:

Buat sumber daya teks yang dapat digunakan kembali untuk stempel berbasis teks.
Tambahkan stempel gambar dan halaman PDF.
Tambahkan stempel teks bergaya.
Batasi stempel pada halaman yang dipilih.
Konfigurasikan cap gambar latar belakang.

Contoh ini menggunakan dua fungsi pembantu: satu membuat teks terformat untuk cap berbasis teks, dan yang lainnya membuat sebuah TextState objek yang digunakan untuk menata stempel teks.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def _create_text_logo(text: str) -> pdf_facades.FormattedText:
    """Create formatted text for text stamp examples."""
    return pdf_facades.FormattedText(
        text,
        drawing.Color.blue,
        drawing.Color.light_gray,
        pdf_facades.FontStyle.HELVETICA_BOLD,
        pdf_facades.EncodingType.WINANSI,
        True,
        14,
    )


def _create_text_state() -> ap.text.TextState:
    """Create a text state used to style text stamps."""
    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.dark_blue
    text_state.font_size = 16
    text_state.font_style = ap.text.FontStyles.BOLD
    return text_state

Tambahkan cap gambar

Gunakan bind_image() ketika stempel harus menampilkan gambar seperti logo, lencana, atau ikon. Setelah mengikat gambar, Anda dapat mengatur ID stempel dan asalnya sebelum menambahkannya ke dokumen.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_image_stamp(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp to the PDF."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.stamp_id = 1
        stamp.set_origin(36, 520)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Tambahkan halaman PDF sebagai stempel

Gunakan bind_pdf() ketika Anda ingin menggunakan halaman dari file PDF lain sebagai konten stamp. Ini berguna untuk overlay seperti persetujuan, templat, atau elemen visual yang sudah dibuat sebelumnya yang disimpan dalam dokumen terpisah.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_pdf_page_as_stamp(infile: str, stamp_pdf: str, outfile: str) -> None:
    """Add the first page of another PDF as a stamp."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_pdf(stamp_pdf, 1)
        stamp.page_number = 1
        stamp.set_origin(36, 250)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Tambahkan text stamp dengan text state

Gunakan bind_logo() bersama dengan bind_text_state() ketika Anda ingin membuat stempel berbasis teks dengan gaya font khusus. Pendekatan ini berguna untuk tanda persetujuan, label, dan anotasi khusus alur kerja.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_text_stamp_with_text_state(infile: str, outfile: str) -> None:
    """Add a text stamp and style it with a TextState object."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_logo(_create_text_logo("Approved by signing workflow"))
        stamp.bind_text_state(_create_text_state())
        stamp.set_origin(36, 700)
        stamp.rotation = 15.0

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Tambahkan stempel ke halaman tertentu

Jika cap tidak seharusnya muncul di setiap halaman, tetapkan nomor halaman target ke pages properti. Contoh ini menambahkan stempel gambar hanya pada halaman pertama.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_stamp_to_specific_pages(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp only to the selected pages."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.pages = [1]
        stamp.set_origin(400, 40)
        stamp.set_image_size(120, 60)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Tambahkan cap gambar latar belakang

Gunakan stempel latar belakang ketika gambar harus muncul di belakang konten halaman. Anda juga dapat mengontrol opasitas stempel, rotasi, kualitas, ukuran, dan posisi untuk membuat efek gaya watermark.

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_background_image_stamp(infile: str, image_file: str, outfile: str) -> None:
    """Add a rotated background image stamp with opacity and quality settings."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.is_background = True
        stamp.opacity = 0.35
        stamp.quality = 90
        stamp.rotation = 45.0
        stamp.set_image_size(160, 80)
        stamp.set_origin(200, 300)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Topik Facade Terkait

Python-Net: Kelas PdfFileStamp

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

The PdfFileStamp Kelas dalam Aspose.PDF Facades dirancang untuk menambahkan konten visual berulang ke halaman PDF. Ini berguna ketika Anda perlu menerapkan header, footer, nomor halaman, atau cap di seluruh dokumen tanpa harus mengedit setiap halaman secara manual.

Apa yang dapat Anda lakukan dengan PdfFileStamp

Gunakan artikel dalam bagian ini untuk menjelajahi tugas stamping utama yang didukung oleh PdfFileStamp fasad: