Documentation – Bekerja dengan Grafik PDF di Python

Python-Net: Tambahkan Bentuk Arc ke PDF dengan Python

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

Tambahkan objek Arc

Aspose.PDF for Python via .NET memungkinkan Anda menambahkan Arc bentuk ke halaman PDF menggunakan Graph class. Anda dapat menggambar busur berpinggir dan segmen busur berisi untuk diagram dan ilustrasi teknis.

Ikuti langkah-langkah di bawah ini:

Buat Document instansi.
Buat objek Graph dengan dimensi tertentu.
Atur border untuk objek Graph.
Buat objek Arc yang sesuai.
Tambahkan objek ini ke koleksi Shapes dalam objek graph.
Tambah Graph objek ke koleksi paragraphs halaman.
Simpan file PDF kami.

Potongan kode berikut menunjukkan cara menambahkan sebuah Arc objek.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc1 = drawing.Arc(100, 100, 95, 0, 90)
    arc1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(arc1)

    arc2 = drawing.Arc(100, 100, 90, 70, 180)
    arc2.graph_info.color = ap.Color.dark_blue
    graph.shapes.add(arc2)

    arc3 = drawing.Arc(100, 100, 85, 120, 210)
    arc3.graph_info.color = ap.Color.red
    graph.shapes.add(arc3)

    page.paragraphs.add(graph)
    document.save(outfile)

Buat Objek Busur Terisi

Contoh ini menunjukkan cara menambahkan segmen busur yang terisi dengan warna.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_arc_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    arc = drawing.Arc(100, 100, 95, 0, 90)

    arc.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(arc)

    line = drawing.Line([195, 100, 100, 100, 100, 195])
    line.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(line)

    page.paragraphs.add(graph)
    document.save(outfile)

Hasil menambahkan busur berisi:

Topik Grafik Terkait

Python-Net: Tambahkan Bentuk Lingkaran ke PDF dengan Python

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

Tambahkan objek Lingkaran

Aspose.PDF for Python via .NET memungkinkan Anda menambahkan Lingkaran bentuk ke halaman PDF melalui Graph kelas. Gunakan lingkaran untuk diagram, anotasi, dan elemen visual sederhana.

Ikuti langkah-langkah di bawah ini:

Buat Document instansi.
Buat objek Graph dengan dimensi tertentu.
Atur border untuk objek Graph.
Tambah Graph objek ke koleksi paragraphs halaman.
Simpan file PDF kami.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

Lingkaran yang kami gambar akan terlihat seperti ini:

Buat Objek Lingkaran Terisi

Contoh ini menunjukkan cara menambahkan lingkaran dan mengisinya dengan warna.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_circle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    circle = drawing.Circle(100, 100, 40)
    circle.graph_info.color = ap.Color.green_yellow
    circle.graph_info.fill_color = ap.Color.green
    circle.text = ap.text.TextFragment("Circle")
    graph.shapes.add(circle)

    page.paragraphs.add(graph)
    document.save(outfile)

Hasil penambahan lingkaran berisi:

Topik Grafik Terkait

Python-Net: Tambahkan Bentuk Kurva ke PDF dengan Python

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

Tambahkan objek Kurva

Aspose.PDF for Python via .NET memungkinkan Anda menambahkan Kurva bentuk ke halaman PDF melalui Graph kelas.

Artikel ini menunjukkan cara membuat kurva berbingkai dan terisi.

Ikuti langkah-langkah di bawah ini:

Buat Document instansi.
Buat objek Graph dengan dimensi tertentu.
Atur border untuk objek Graph.
Tambah Graph objek ke koleksi paragraphs halaman.
Simpan file PDF kami.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_curve(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

Gambar berikut menunjukkan hasil yang dieksekusi dengan cuplikan kode kami:

Membuat Objek Curve Terisi

Contoh ini menunjukkan cara menambahkan objek Curve yang terisi dengan warna.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_curve_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 200)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    curve1 = drawing.Curve([10, 10, 50, 60, 70, 10, 100, 120])
    curve1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(curve1)

    page.paragraphs.add(graph)
    document.save(outfile)

Hasil menambahkan kurva terisi:

Topik Grafik Terkait

Python-Net: Tambahkan Bentuk Garis ke PDF dengan Python

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

Tambahkan objek Line

Aspose.PDF for Python via .NET memungkinkan Anda menambahkan Line bentuk ke halaman PDF menggunakan Graph kelas. Anda dapat mengontrol warna garis, pola dash, dan penempatan.

Ikuti langkah-langkah di bawah ini:

Buat Document instansi.
Buat Objek Grafik
Tambah Graph objek ke koleksi paragraphs halaman.
Buat dan Konfigurasikan Garis
Tambahkan Line ke Grafik
Simpan file PDF kami.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def add_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

Cara menambahkan Garis Dotted Dashed ke dokumen PDF Anda

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_dotted_dashed_line(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    line = drawing.Line([100, 100, 200, 100])
    line.graph_info.color = ap.Color.red
    line.graph_info.dash_array = [0, 1, 0]
    line.graph_info.dash_phase = 1
    graph.shapes.add(line)

    document.save(outfile)

Hasil penambahan garis dotted dashed:

Gambar Garis Melintasi Halaman

Anda juga dapat menggambar garis melintasi halaman untuk membentuk sebuah salib.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def draw_line_across_page(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.page_info.margin.left = 0
    page.page_info.margin.right = 0
    page.page_info.margin.bottom = 0
    page.page_info.margin.top = 0

    graph = drawing.Graph(page.page_info.width, page.page_info.height)
    line = drawing.Line([page.rect.llx, 0, page.page_info.width, page.rect.ury])
    graph.shapes.add(line)
    line2 = drawing.Line([0, page.rect.ury, page.page_info.width, page.rect.llx])
    graph.shapes.add(line2)
    page.paragraphs.add(graph)

    document.save(outfile)

Topik Grafik Terkait

Python-Net: Tambahkan Bentuk Persegi Panjang ke PDF dalam Python

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

Tambahkan objek Rectangle

Aspose.PDF for Python via .NET memungkinkan Anda menambahkan Rectangle bentuk ke halaman PDF melalui Graph kelas. Anda dapat menggambar persegi panjang berbingkai dan menerapkan isian padat, gradasi, atau transparan.

Ikuti langkah-langkah di bawah ini:

Buat PDF baru Document.
Tambah Page ke koleksi halaman file PDF.
Tambah Fragmen teks ke koleksi paragraphs dari instance halaman.
Buat Graph instansi.
Setel batas untuk objek Graph.
Tambah Rectangle objek ke koleksi bentuk dari objek Graph.
Tambahkan objek grafik ke koleksi paragraphs dari instance halaman.
Tambah Fragmen teks ke koleksi paragraphs dari instance halaman.
Dan simpan file PDF Anda

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    text_fragment = ap.text.TextFragment("Rectangle")
    page.paragraphs.add(text_fragment)

    graph = drawing.Graph(400, 300)
    page.paragraphs.add(graph)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.red)

    rect = drawing.Rectangle(20, 20, 350, 250)
    graph.shapes.add(rect)
    page.paragraphs.add(text_fragment)

    document.save(outfile)

Buat Objek Persegi Panjang Terisi

Aspose.PDF for Python via .NET juga menawarkan fitur untuk mengisi objek persegi panjang dengan warna tertentu.

Potongan kode berikut menunjukkan cara menambahkan sebuah Rectangle objek yang diisi dengan warna.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.red
    graph.shapes.add(rect)

    document.save(outfile)

Hasil dari persegi panjang yang diisi dengan warna solid:

Tambahkan Gambar dengan Isian Gradien

Aspose.PDF for Python via .NET mendukung fitur untuk menambahkan objek grafik ke dokumen PDF dan terkadang diperlukan untuk mengisi objek grafik dengan Warna Gradien.

Potongan kode berikut menunjukkan cara menambahkan sebuah Rectangle objek yang diisi dengan Warna Gradien.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_drawing_with_gradient_fill(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(0, 0, 300, 300)
    gradient_color = ap.Color()
    gradient_settings = drawing.GradientAxialShading(ap.Color.red, ap.Color.blue)
    gradient_settings.start = ap.Point(0, 0)
    gradient_settings.end = ap.Point(350, 350)
    gradient_color.pattern_color_space = gradient_settings
    rect.graph_info.fill_color = gradient_color
    graph.shapes.add(rect)

    document.save(outfile)

Buat Persegi Panjang dengan Saluran Warna Alfa

Aspose.PDF untuk Python via .NET juga mendukung transparansi melalui saluran warna alfa.

Potongan kode berikut menunjukkan cara menambahkan sebuah Rectangle objek dengan nilai alfa.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_rectangle_with_alpha_color_channel(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(100, 400)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(100, 100, 200, 120)
    rect.graph_info.fill_color = ap.Color.from_argb(128, 244, 180, 0)
    graph.shapes.add(rect)

    rect1 = drawing.Rectangle(200, 150, 200, 100)
    rect1.graph_info.fill_color = ap.Color.from_argb(160, 120, 0, 120)
    graph.shapes.add(rect1)

    document.save(outfile)

Kontrol Z-Order bentuk

Aspose.PDF for .NET mendukung fitur untuk menambahkan objek grafik (misalnya grafik, garis, persegi panjang, dll.) ke dokumen PDF. Saat menambahkan lebih dari satu instance dari objek yang sama dalam file PDF, kami dapat mengontrol render mereka dengan menentukan Z-Order. Z-Order juga digunakan ketika kita perlu merender objek di atas satu sama lain.

Potongan kode berikut menunjukkan langkah-langkah untuk merender Rectangle objek di atas satu sama lain.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def _add_rectangle_to_page(
    page: ap.Page,
    x: float,
    y: float,
    width: float,
    height: float,
    color: ap.Color,
    zindex: int,
):
    graph = drawing.Graph(width, height)
    graph.is_change_position = False
    graph.left = x
    graph.top = y
    rect = drawing.Rectangle(0, 0, width, height)
    rect.graph_info.fill_color = color
    rect.graph_info.color = color
    graph.shapes.add(rect)
    graph.z_index = zindex
    page.paragraphs.add(graph)


def control_z_order_of_rectangle(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    page.set_page_size(375, 300)
    page.page_info.margin.left = 0
    page.page_info.margin.top = 0

    _add_rectangle_to_page(page, 50, 40, 60, 40, ap.Color.red, 2)
    _add_rectangle_to_page(page, 20, 20, 30, 30, ap.Color.blue, 1)
    _add_rectangle_to_page(page, 40, 40, 60, 30, ap.Color.green, 0)

    document.save(outfile)

Topik Grafik Terkait

Python-Net: Tambahkan Bentuk Elips ke PDF dalam Python

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

Tambahkan objek Ellipse

Aspose.PDF for Python via .NET memungkinkan Anda menambahkan Elips bentuk ke halaman PDF dengan Graph class. Anda dapat menggambar outline elips, menerapkan warna isi, dan menempatkan teks di dalam objek elips.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(150, 100, 120, 60)
    ellipse1.graph_info.color = ap.Color.green_yellow
    ellipse1.text = ap.text.TextFragment("Ellipse")
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(50, 50, 18, 300)
    ellipse2.graph_info.color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Buat Objek Elips Terisi

Potongan kode berikut menunjukkan cara menambahkan sebuah Elips objek yang diisi dengan warna.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def create_ellipse_filled(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    ellipse1 = drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    graph.shapes.add(ellipse1)

    ellipse2 = drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Tambahkan Teks di dalam Elips

Aspose.PDF for Python via .NET juga memungkinkan Anda menempatkan teks di dalam objek bentuk. Contoh berikut menambahkan teks ke bentuk elips.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing

def add_text_inside_ellipse(outfile: str):
    document = ap.Document()
    page = document.pages.add()
    graph = drawing.Graph(400, 400)
    graph.border = ap.BorderInfo(ap.BorderSide.ALL, ap.Color.green)

    text_fragment = ap.text.TextFragment("Ellipse")
    text_fragment.text_state.font = ap.text.FontRepository.find_font("Helvetica")
    text_fragment.text_state.font_size = 24

    ellipse1 = ap.drawing.Ellipse(100, 100, 120, 180)
    ellipse1.graph_info.fill_color = ap.Color.green_yellow
    ellipse1.text = text_fragment
    graph.shapes.add(ellipse1)

    ellipse2 = ap.drawing.Ellipse(200, 150, 180, 120)
    ellipse2.graph_info.fill_color = ap.Color.dark_red
    ellipse2.text = text_fragment
    graph.shapes.add(ellipse2)

    page.paragraphs.add(graph)
    document.save(outfile)

Topik Grafik Terkait

Python-Net: Periksa Batas Bentuk dalam Grafik PDF dengan Python

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

Periksa batas bentuk dalam Graph

Saat Anda menambahkan bentuk ke sebuah Graph, Anda dapat mengaktifkan validasi batas untuk memastikan setiap bentuk cocok dalam area grafik.

Gunakan BoundsCheckMode untuk mendefinisikan perilaku ketika sebuah bentuk berada di luar jangkauan. Dalam contoh ini, THROW_EXCEPTION_IF_DOES_NOT_FIT digunakan untuk menimbulkan sebuah pengecualian.

Ikuti langkah-langkah di bawah ini:

Buat PDF baru Document.
Tambahkan sebuah Page.
Buat sebuah Graph dan tambahkan ke halaman.
Buat sebuah Rectangle yang melampaui batas grafik.
Atur mode pemeriksaan batas ke THROW_EXCEPTION_IF_DOES_NOT_FIT.
Tambahkan persegi panjang dan tangani eksepsi.
Simpan dokumen.

import aspose.pdf as ap
import aspose.pdf.drawing as drawing


def check_shape_bounds(outfile: str):
    document = ap.Document()
    page = document.pages.add()

    graph = drawing.Graph(100, 100)
    graph.top = 10
    graph.left = 15
    graph.border = ap.BorderInfo(ap.BorderSide.BOX, 1, ap.Color.black)
    page.paragraphs.add(graph)

    rect = drawing.Rectangle(-1, 0, 50, 50)
    rect.graph_info.fill_color = ap.Color.tomato

    try:
        graph.shapes.update_bounds_check_mode(
            ap.BoundsCheckMode.THROW_EXCEPTION_IF_DOES_NOT_FIT
        )
        graph.shapes.add(rect)
    except Exception as e:
        print(e)

    document.save(outfile)

Catatan

Gunakan THROW_EXCEPTION_IF_DOES_NOT_FIT ketika validasi tata letak yang ketat diperlukan.
Untuk perilaku permisif, pilih yang lain BoundsCheckMode opsi berdasarkan kebutuhan tata letak Anda.