Kustomisasi Bentuk Presentasi di Python melalui Java

Tentang apa halaman ini

Buat dan sesuaikan bentuk dalam presentasi PowerPoint dengan Aspose.Slides untuk Python melalui Java: jalur geometri, sudut melengkung, bentuk komposit.

Gambaran Umum

Artikel ini menjelaskan cara menyesuaikan bentuk presentasi dalam Aspose.Slides dengan mengedit geometri bentuk melalui edit points dan geometry paths. Artikel ini menunjukkan cara bekerja dengan GeometryPath untuk memodifikasi bentuk yang ada, melakukan operasi penyuntingan jalur dasar, menambah atau menghapus titik, dan menerapkan geometri yang diperbarui kembali ke sebuah bentuk.

Artikel ini juga memperlihatkan cara membuat bentuk kustom dan komposit, membangun bentuk dengan sudut melengkung, menentukan apakah geometri sebuah bentuk tertutup, dan mengonversi antara GeometryPath dan java.awt.Shape untuk skenario kustomisasi geometri tambahan.

Ubah Bentuk Menggunakan Edit Points

Pertimbangkan sebuah persegi. Di PowerPoint, dengan menggunakan edit points, Anda dapat

memindahkan sudut persegi ke dalam atau ke luar
menentukan kelengkungan untuk sebuah sudut atau titik
menambahkan titik baru ke persegi
memanipulasi titik pada persegi, dll.

Intinya, Anda dapat melakukan tugas-tugas yang dijelaskan pada bentuk apa pun. Dengan edit points, Anda dapat mengubah sebuah bentuk atau membuat bentuk baru dari bentuk yang ada.

Tips Penyuntingan Bentuk

overview_image

Sebelum Anda mulai menyunting bentuk PowerPoint melalui edit points, Anda mungkin ingin mempertimbangkan poin-poin berikut tentang bentuk:

Sebuah bentuk (atau jalurnya) dapat berupa tertutup atau terbuka.
Ketika sebuah bentuk tertutup, tidak memiliki titik mulai atau akhir. Ketika sebuah bentuk terbuka, memiliki titik mulai dan akhir.
Semua bentuk terdiri dari setidaknya 2 titik jangkar yang terhubung satu sama lain oleh garis.
Sebuah garis dapat lurus atau melengkung. Titik jangkar menentukan sifat garis.
Titik jangkar ada sebagai titik sudut, titik lurus, atau titik halus:
- Titik sudut adalah titik di mana 2 garis lurus bertemu dengan suatu sudut.
- Titik halus adalah titik di mana 2 pegangan berada dalam satu garis lurus dan segmen garis bergabung dalam lengkungan halus. Pada kasus ini, semua pegangan dipisahkan dari titik jangkar dengan jarak yang sama.
- Titik lurus adalah titik di mana 2 pegangan berada dalam satu garis lurus dan segmen garis tersebut bergabung dalam lengkungan halus. Pada kasus ini, pegangan tidak harus dipisahkan dari titik jangkar dengan jarak yang sama.
Dengan memindahkan atau menyunting titik jangkar (yang mengubah sudut garis), Anda dapat mengubah tampilan sebuah bentuk.

Untuk menyunting bentuk PowerPoint melalui edit points, Aspose.Slides menyediakan kelas GeometryPath.

Sebuah instance GeometryPath mewakili jalur geometri dari objek GeometryShape.
Untuk mengambil GeometryPath dari instance GeometryShape, Anda dapat menggunakan method GeometryShape.getGeometryPaths.
Untuk menetapkan GeometryPath pada sebuah bentuk, Anda dapat menggunakan method ini: GeometryShape.setGeometryPath untuk bentuk solid dan GeometryShape.setGeometryPaths untuk bentuk komposit.
Untuk menambahkan segmen, Anda dapat menggunakan method di bawah GeometryPath.
Dengan method GeometryPath.setStroke dan GeometryPath.setFillMode, Anda dapat mengatur tampilan untuk sebuah jalur geometri.
Dengan method GeometryPath.getPathData, Anda dapat mengambil jalur geometri dari sebuah GeometryShape sebagai array segmen jalur.
Untuk mengakses opsi kustomisasi geometri bentuk tambahan, Anda dapat mengonversi GeometryPath ke java.awt.Shape
Gunakan method geometryPathToGraphicsPath dan graphicsPathToGeometryPath (dari kelas ShapeUtil) untuk mengonversi GeometryPath ke java.awt.Shape bolak‑balik.

Operasi Penyuntingan Sederhana

Tanda tangan berikut menunjukkan operasi penyuntingan dasar:

Tambahkan sebuah garis ke akhir jalur:

geometry_path.lineTo(point)
geometry_path.lineTo(x, y)

Tambahkan sebuah garis ke posisi tertentu pada jalur:

geometry_path.lineTo(point, index)
geometry_path.lineTo(x, y, index)

Tambahkan sebuah kurva Bezier kubik di akhir jalur:

geometry_path.cubicBezierTo(point1, point2, point3)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3)

Tambahkan sebuah kurva Bezier kubik ke posisi tertentu pada jalur:

geometry_path.cubicBezierTo(point1, point2, point3, index)
geometry_path.cubicBezierTo(x1, y1, x2, y2, x3, y3, index)

Tambahkan sebuah kurva Bezier kuadratik di akhir jalur:

geometry_path.quadraticBezierTo(point1, point2)
geometry_path.quadraticBezierTo(x1, y1, x2, y2)

Tambahkan sebuah kurva Bezier kuadratik ke posisi tertentu pada jalur:

geometry_path.quadraticBezierTo(point1, point2, index)
geometry_path.quadraticBezierTo(x1, y1, x2, y2, index)

Tambahkan sebuah busur ke jalur:

geometry_path.arcTo(width, height, start_angle, sweep_angle)

Tutup gambar saat ini pada jalur:

geometry_path.closeFigure()

Tetapkan posisi untuk titik berikutnya:

geometry_path.moveTo(point)
geometry_path.moveTo(x, y)

Hapus segmen jalur pada indeks tertentu:

geometry_path.removeAt(index)

Tambahkan Titik Kustom ke Bentuk

Buat instance kelas GeometryShape dan tetapkan tipe ShapeType.Rectangle.
Dapatkan instance kelas GeometryPath dari bentuk tersebut.
Tambahkan titik baru di antara dua titik atas pada jalur.
Tambahkan titik baru di antara dua titik bawah pada jalur.
Terapkan jalur ke bentuk.

Kode Python berikut menunjukkan cara menambahkan titik kustom ke sebuah bentuk:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.lineTo(100, 50, 1)
    geometry_path.lineTo(100, 50, 4)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example1_image

Hapus Titik dari Bentuk

Buat instance kelas GeometryShape dan tetapkan tipe ShapeType.Heart.
Dapatkan instance kelas GeometryPath dari bentuk tersebut.
Hapus segmen untuk jalur tersebut.
Terapkan jalur ke bentuk.

Kode Python berikut menunjukkan cara menghapus titik dari sebuah bentuk:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Heart, 100, 100, 300, 300)
    geometry_path = shape.getGeometryPaths()[0]
    geometry_path.removeAt(2)
    shape.setGeometryPath(geometry_path)
finally:
    presentation.dispose()

example2_image

Buat Bentuk Kustom

Hitung titik‑titik untuk bentuk.
Buat instance kelas GeometryPath.
Isi jalur dengan titik‑titik tersebut.
Buat instance kelas GeometryShape.
Terapkan jalur ke bentuk.

Kode Python berikut menunjukkan cara membuat bentuk kustom:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

import math

points = []
outer_radius = 100
inner_radius = 50
step = 72

for angle in range(-90, 270, step):
    radians = math.radians(angle)
    x = outer_radius * math.cos(radians)
    y = outer_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

    radians = math.radians(angle + step / 2)
    x = inner_radius * math.cos(radians)
    y = inner_radius * math.sin(radians)
    points.append((x + outer_radius, y + outer_radius))

star_path = GeometryPath()
star_path.moveTo(*points[0])
for point in points[1:]:
    star_path.lineTo(*point)
star_path.closeFigure()

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, outer_radius * 2, outer_radius * 2)
    shape.setGeometryPath(star_path)
finally:
    presentation.dispose()

example3_image

Buat Bentuk Kustom Komposit

Buat instance kelas GeometryShape.
Buat instance pertama kelas GeometryPath.
Buat instance kedua kelas GeometryPath.
Terapkan jalur‑jalur ke bentuk.

Kode Python berikut menunjukkan cara membuat bentuk kustom komposit:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 200, 100)

    top_path = GeometryPath()
    top_path.moveTo(0, 0)
    top_path.lineTo(shape.getWidth(), 0)
    top_path.lineTo(shape.getWidth(), shape.getHeight() / 3)
    top_path.lineTo(0, shape.getHeight() / 3)
    top_path.closeFigure()

    bottom_path = GeometryPath()
    bottom_path.moveTo(0, shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight() / 3 * 2)
    bottom_path.lineTo(shape.getWidth(), shape.getHeight())
    bottom_path.lineTo(0, shape.getHeight())
    bottom_path.closeFigure()

    shape.setGeometryPaths([top_path, bottom_path])
finally:
    presentation.dispose()

example4_image

Buat Bentuk Kustom dengan Sudut Melengkung

Kode Python berikut menunjukkan cara membuat bentuk kustom dengan sudut melengkung (ke dalam):

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, SaveFormat

shape_x = 20
shape_y = 20
shape_width = 300
shape_height = 200

left_top_size = 50
right_top_size = 20
right_bottom_size = 40
left_bottom_size = 10

presentation = Presentation()
try:
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Custom, shape_x, shape_y, shape_width, shape_height)
    geometry_path = GeometryPath()
    geometry_path.moveTo(left_top_size, 0)
    geometry_path.lineTo(shape_width - right_top_size, 0)
    geometry_path.arcTo(right_top_size, right_top_size, 180, -90)
    geometry_path.lineTo(shape_width, shape_height - right_bottom_size)
    geometry_path.arcTo(right_bottom_size, right_bottom_size, -90, -90)
    geometry_path.lineTo(left_bottom_size, shape_height)
    geometry_path.arcTo(left_bottom_size, left_bottom_size, 0, -90)
    geometry_path.lineTo(0, left_top_size)
    geometry_path.arcTo(left_top_size, left_top_size, 90, -90)
    geometry_path.closeFigure()
    shape.setGeometryPath(geometry_path)
    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Temukan Apakah Geometri Bentuk Tertutup

Sebuah bentuk tertutup didefinisikan sebagai bentuk di mana semua sisinya terhubung, membentuk satu batas tanpa celah. Bentuk semacam itu dapat berupa bentuk geometris sederhana atau kontur kustom yang kompleks. Contoh kode berikut menunjukkan cara memeriksa apakah geometri sebuah bentuk tertutup:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import PathCommandType

def is_geometry_closed(geometry_shape):
    is_closed = False
    for geometry_path in geometry_shape.getGeometryPaths():
        path_data = geometry_path.getPathData()
        if len(path_data) == 0:
            continue
        last_segment = path_data[-1]
        is_closed = last_segment.getPathCommand() == PathCommandType.Close
        if not is_closed:
            return False
    return is_closed

Konversi GeometryPath ke java.awt.Shape

Buat instance kelas GeometryShape.
Buat instance kelas java.awt.Shape.
Konversi instance java.awt.Shape ke instance GeometryPath dengan berjalan melalui PathIterator‑nya dan memutar ulang setiap segmen pada jalur.
Terapkan jalur‑jalur ke bentuk.

Kode Python berikut mengimplementasikan langkah‑langkah di atas untuk mengonversi jalur grafis ke jalur geometri:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, ShapeType, GeometryPath, PathFillModeType

from java.awt import Font
from java.awt.geom import PathIterator
from java.awt.image import BufferedImage

presentation = Presentation()
try:
    # Buat bentuk baru.
    shape = presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 100)

    # Dapatkan jalur geometri bentuk.
    original_path = shape.getGeometryPaths()[0]
    original_path.setFillMode(PathFillModeType.None_)

    # Buat jalur grafis baru dengan teks.
    font = Font("Arial", Font.PLAIN, 40)
    text = "Text in shape"
    image = BufferedImage(100, 100, BufferedImage.TYPE_INT_ARGB)
    graphics = image.createGraphics()
    try:
        glyph_vector = font.createGlyphVector(graphics.getFontRenderContext(), text)
        graphics_path = glyph_vector.getOutline(20.0, -glyph_vector.getVisualBounds().getY() + 10)
    finally:
        graphics.dispose()

    # Konversi jalur grafis ke jalur geometri.
    text_path = GeometryPath()
    path_iterator = graphics_path.getPathIterator(None)
    points = jpype.JArray(jpype.JFloat)(6)
    while not path_iterator.isDone():
        segment_type = path_iterator.currentSegment(points)
        if segment_type == PathIterator.SEG_MOVETO:
            text_path.moveTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_LINETO:
            text_path.lineTo(points[0], points[1])
        elif segment_type == PathIterator.SEG_QUADTO:
            text_path.quadraticBezierTo(points[0], points[1], points[2], points[3])
        elif segment_type == PathIterator.SEG_CUBICTO:
            text_path.cubicBezierTo(points[0], points[1], points[2], points[3], points[4], points[5])
        elif segment_type == PathIterator.SEG_CLOSE:
            text_path.closeFigure()
        path_iterator.next()
    text_path.setFillMode(PathFillModeType.Normal)

    # Terapkan jalur teks bersama dengan jalur geometri asli.
    shape.setGeometryPaths([original_path, text_path])
finally:
    presentation.dispose()

example5_image

FAQ

Apa yang terjadi pada isian dan garis tepi setelah mengganti geometri?

Gaya tetap melekat pada bentuk; hanya kontur yang berubah. Isian dan garis tepi secara otomatis diterapkan pada geometri baru.

Bagaimana cara memutar bentuk kustom beserta geometri secara tepat?

Gunakan method setRotation pada bentuk; geometri berputar bersama bentuk karena terikat pada sistem koordinat bentuk itu sendiri.

Apakah saya dapat mengonversi bentuk kustom menjadi gambar untuk “mengunci” hasilnya?

Ya. Ekspor area slide yang diperlukan atau shape itu sendiri ke format raster; ini menyederhanakan pekerjaan lanjutan dengan geometri yang kompleks.

Mengelola Connector dalam Presentasi dengan Python via Java Menambahkan Elips ke Presentasi dalam Python via Java