Menambahkan Bingkai Gambar ke Presentasi dengan Python

Pendahuluan

Bingkai gambar di Aspose.Slides for Python memungkinkan Anda menempatkan dan mengelola gambar raster dan vektor sebagai bentuk slide asli. Anda dapat menyisipkan gambar dari file atau aliran, memposisikan dan mengubah ukurannya dengan koordinat yang tepat, menerapkan rotasi, mengatur transparansi, dan mengontrol urutan z bersama bentuk lainnya. API juga mendukung pemotongan, mempertahankan rasio aspek, mengatur batas dan efek, serta mengganti gambar yang mendasari tanpa membangun ulang tata letak. Karena bingkai gambar berperilaku seperti bentuk biasa, Anda dapat menambahkan animasi, hyperlink, dan teks alternatif, sehingga mudah membangun presentasi yang kaya visual dan dapat diakses.

Membuat Bingkai Gambar

Bagian ini menunjukkan cara menyisipkan gambar ke dalam slide dengan membuat sebuah PictureFrame dengan Aspose.Slides for Python. Anda akan belajar cara memuat gambar, menempatkannya secara tepat pada slide, dan mengontrol ukuran serta formatnya.

Buat sebuah instance dari kelas Presentation.
Dapatkan slide berdasarkan indeksnya.
Buat sebuah PPImage dengan menambahkan gambar ke ImageCollection presentasi. Gambar ini akan digunakan untuk mengisi bentuk.
Tentukan lebar dan tinggi bingkai.
Buat sebuah PictureFrame dengan ukuran tersebut menggunakan metode add_picture_frame.
Simpan presentasi sebagai file PPTX.

Kode Python berikut menunjukkan cara membuat bingkai gambar:

import aspose.slides as slides

# Membuat instance kelas Presentation untuk mewakili file PPTX.
with slides.Presentation() as presentation:
    # Dapatkan slide pertama.
    slide = presentation.slides[0]

    # Tambahkan gambar ke presentasi.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Tambahkan bingkai gambar dengan ukuran sesuai gambar.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

        # Simpan presentasi sebagai PPTX.
        presentation.save("picture_frame.pptx", slides.export.SaveFormat.PPTX)

Bingkai gambar memungkinkan Anda dengan cepat membuat slide presentasi dari gambar. Saat Anda menggabungkan bingkai gambar dengan opsi penyimpanan Aspose.Slides, Anda dapat mengontrol operasi I/O untuk mengonversi gambar dari satu format ke format lain. Anda mungkin ingin melihat halaman ini: konversi gambar ke JPG; konversi JPG ke gambar; konversi JPG ke PNG; konversi PNG ke JPG; konversi PNG ke SVG; konversi SVG ke PNG.

Membuat Bingkai Gambar dengan Skala Relatif

Bagian ini mendemonstrasikan penempatan gambar dengan ukuran tetap, kemudian menerapkan skala berbasis persentase secara independen pada lebar dan tingginya. Karena persentase dapat berbeda, rasio aspek dapat berubah. Skala dilakukan relatif terhadap dimensi asli gambar.

Buat sebuah instance dari kelas Presentation.
Dapatkan slide berdasarkan indeksnya.
Buat sebuah PPImage dengan menambahkan gambar ke ImageCollection.
Tambahkan sebuah PictureFrame ke slide.
Atur lebar dan tinggi relatif bingkai gambar.
Simpan presentasi sebagai file PPTX.

Kode Python berikut menunjukkan cara membuat bingkai gambar dengan skala relatif:

import aspose.slides as slides

# Membuat instance kelas Presentation untuk mewakili file PPTX.
with slides.Presentation() as presentation:
    # Dapatkan slide pertama.
    slide = presentation.slides[0]

    # Tambahkan gambar ke koleksi gambar presentasi.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Tambahkan bingkai gambar ke slide.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 100, 100, image)

        # Atur lebar dan tinggi skala relatif.
        picture_frame.relative_scale_height = 0.8
        picture_frame.relative_scale_width = 1.35

        # Simpan presentasi.
        presentation.save("relative_scaling.pptx", slides.export.SaveFormat.PPTX)

Ekstrak Gambar Raster dari Bingkai Gambar

Anda dapat mengekstrak gambar raster dari objek PictureFrame dan menyimpannya dalam format PNG, JPG, dan format lainnya. Contoh kode di bawah ini mendemonstrasikan cara mengekstrak gambar dari dokumen “sample.pptx” dan menyimpannya dalam format PNG.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    first_slide = presentation.slides[0]
    first_shape = first_slide.shapes[0]

    if isinstance(first_shape, slides.PictureFrame):
        image = first_shape.picture_format.picture.image.image
        image.save("slide_1_shape_1.png", slides.ImageFormat.PNG)

Ekstrak Gambar SVG dari Bingkai Gambar

Ketika sebuah presentasi berisi grafik SVG yang ditempatkan di dalam bentuk PictureFrame, Aspose.Slides for Python via .NET memungkinkan Anda mengambil gambar vektor asli dengan fidelitas penuh. Dengan menelusuri koleksi bentuk slide, Anda dapat mengidentifikasi setiap PictureFrame, memeriksa apakah PPImage yang mendasarinya berisi konten SVG, dan kemudian menyimpan gambar tersebut ke disk atau aliran dalam format SVG aslinya.

Contoh kode berikut mendemonstrasikan cara mengekstrak gambar SVG dari bingkai gambar:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.PictureFrame):
        svg_image = shape.picture_format.picture.image.svg_image

        if svg_image is not None:
            with open("output.svg", "w", encoding="utf-8") as svg_stream:
                svg_stream.write(svg_image.svg_content)

Dapatkan Transparansi Gambar

Aspose.Slides memungkinkan Anda mengambil efek transparansi yang diterapkan pada sebuah gambar. Kode Python ini mendemonstrasikan operasinya:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    picture_frame = presentation.slides[0].shapes[0]
    image_transform = picture_frame.picture_format.picture.image_transform
    for effect in image_transform:
        if isinstance(effect, slides.effects.AlphaModulateFixed):
            transparency_value = 100 - effect.amount
            print("Picture transparency: " + str(transparency_value))

Semua efek yang diterapkan pada gambar dapat ditemukan di aspose.slides.effects.

Dapatkan Kecerahan dan Kontras Gambar

Aspose.Slides memungkinkan Anda mengambil efek kecerahan dan kontras yang diterapkan pada sebuah gambar. Kelas Luminance mewakili efek transformasi gambar ini.

Kode Python berikut mendemonstrasikan cara mendapatkan pengaturan kecerahan dan kontras dari bingkai gambar:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]
    picture_frame = shape

    image_transform = picture_frame.picture_format.picture.image_transform
    for effect in image_transform:
        if isinstance(effect, slides.effects.Luminance):
            luminance = effect.get_effective()
            brightness = luminance.brightness
            contrast = luminance.contrast

            print("Brightness: " + str(brightness))
            print("Contrast: " + str(contrast))

Pemformatan Bingkai Gambar

Aspose.Slides menyediakan banyak opsi pemformatan yang dapat Anda terapkan pada sebuah bingkai gambar. Dengan opsi-opsi ini, Anda dapat menyesuaikan bingkai gambar untuk memenuhi kebutuhan spesifik.

Buat sebuah instance dari kelas Presentation.
Dapatkan slide berdasarkan indeksnya.
Buat sebuah PPImage dengan menambahkan gambar ke ImageCollection presentasi. Gambar ini akan digunakan untuk mengisi bentuk.
Tentukan lebar dan tinggi bingkai.
Buat sebuah PictureFrame dengan ukuran tersebut menggunakan metode add_picture_frame slide.
Atur warna garis bingkai gambar.
Atur lebar garis bingkai gambar.
Putar bingkai gambar dengan memberikan nilai positif (searah jarum jam) atau negatif (berlawanan arah jarum jam).
Simpan presentasi yang telah dimodifikasi sebagai file PPTX.

Kode Python berikut mendemonstrasikan proses pemformatan bingkai gambar:

import aspose.slides as slides
import aspose.pydrawing as draw

# Membuat instance kelas Presentation untuk mewakili file PPTX.
with slides.Presentation() as presentation:
    # Dapatkan slide pertama.
    slide = presentation.slides[0]

    # Tambahkan gambar ke koleksi gambar presentasi.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Tambahkan bingkai gambar dengan ukuran sesuai gambar.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

        # Terapkan format pada bingkai gambar.
        picture_frame.line_format.fill_format.fill_type = slides.FillType.SOLID
        picture_frame.line_format.fill_format.solid_fill_color.color = draw.Color.blue
        picture_frame.line_format.width = 20
        picture_frame.rotation = 45

    # Simpan presentasi sebagai PPTX.
    presentation.save("picture_formatting.pptx", slides.export.SaveFormat.PPTX)

Tip

Aspose telah mengembangkan Collage Maker gratis. Jika Anda perlu menggabungkan gambar JPG/JPEG atau PNG, atau membuat grid foto, Anda dapat menggunakan layanan ini.

Menambahkan Gambar sebagai Tautan

Untuk menjaga ukuran file presentasi tetap kecil, Anda dapat menambahkan gambar atau video melalui tautan alih-alih menyematkan file secara langsung dalam presentasi. Kode Python berikut menunjukkan cara menyisipkan gambar dan video ke dalam placeholder:

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    slide = presentation.slides[0]

    shapes_to_remove = []

    for shape in slide.shapes:
        if shape.placeholder is None:
            continue

        if shape.placeholder.type == slides.PlaceholderType.PICTURE:
            picture_frame = slide.shapes.add_picture_frame(
                slides.ShapeType.RECTANGLE, shape.x, shape.y, shape.width, shape.height, None)

            picture_frame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            shapes_to_remove.append(shape)

        elif shape.placeholder.type == slides.PlaceholderType.MEDIA:
            video_frame = slide.shapes.add_video_frame(shape.X, shape.Y, shape.width, shape.height, "")

            video_frame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            video_frame.link_path_long = "https://youtu.be/t_1LYZ102RA"
            shapes_to_remove.append(shape)

    for shape in shapes_to_remove:
        slide.shapes.remove(shape)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

Pangkas Gambar

Di bagian ini, Anda akan belajar cara memotong area terlihat gambar dalam bingkai gambar tanpa mengubah file sumber. Anda juga akan mempelajari metode dasar untuk menerapkan margin pemotongan guna menciptakan komposisi yang bersih dan terfokus langsung di slide.

Kode Python berikut menunjukkan cara memotong gambar pada slide:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # Tambahkan gambar ke koleksi gambar presentasi.
    with slides.Images.from_file("image.png") as source_image:
        image = presentation.images.add_image(source_image)

    # Tambahkan bingkai gambar ke slide.
    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 100, 100, 420, 250, image)

    # Potong gambar (nilai persentase).
    picture_frame.picture_format.crop_left = 23.6
    picture_frame.picture_format.crop_right = 21.5
    picture_frame.picture_format.crop_top = 3
    picture_frame.picture_format.crop_bottom = 31

    # Simpan hasil.
    presentation.save("cropped_image.pptx", slides.export.SaveFormat.PPTX)

Hapus Area Terpotong pada Gambar

Jika Anda ingin menghapus area terpotong gambar dalam sebuah bingkai, gunakan metode delete_picture_cropped_areas. Metode ini mengembalikan gambar yang telah dipotong, atau gambar asli jika tidak diperlukan pemotongan.

Kode Python berikut mendemonstrasikan operasi tersebut:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    # Dapatkan PictureFrame dari slide pertama.
    picture_frame = slides.shape[0]

    # Dapatkan PictureFrame dari slide pertama.
    cropped_image = picture_frame.picture_format.delete_picture_cropped_areas()

    # Simpan hasil.
    presentation.save("deleted_cropped_areas.pptx", slides.export.SaveFormat.PPTX)

NOTE

Metode delete_picture_cropped_areas menambahkan gambar yang dipotong ke koleksi gambar presentasi. Jika gambar hanya digunakan dalam PictureFrame yang diproses, hal ini dapat mengurangi ukuran presentasi; jika tidak, jumlah gambar dalam presentasi hasil dapat meningkat.

Selama pemotongan, metode ini mengonversi file metafile WMF/EMF menjadi gambar raster PNG.

Kompres Gambar

Anda dapat mengompres gambar dalam presentasi menggunakan metode PictureFillFormat.compress_image. Metode ini mengompres gambar dengan mengurangi ukuran berdasarkan ukuran bentuk dan resolusi yang ditentukan, dengan opsi menghapus area terpotong.

Ini menyesuaikan ukuran dan resolusi gambar mirip dengan fitur PowerPoint Picture Format -> Compress Pictures -> Resolution.

Contoh Python berikut mendemonstrasikan cara mengompres gambar dalam presentasi dengan menentukan resolusi target dan secara opsional menghapus area terpotong:

import aspose.slides as slides

with slides.Presentation("demo.pptx") as presentation:
    slide = presentation.slides[0]
    picture_frame = slide.shapes[0]

    # Kompres gambar dengan resolusi target 150 DPI (resolusi Web) dan hapus area yang dipotong.
    result = picture_frame.picture_format.compress_image(True, slides.export.PicturesCompression.DPI150)

    # Periksa hasil kompresi.
    if result:
        print("Image successfully compressed.")
    else:
        print("Image compression failed or no changes were necessary.")

    presentation.save("compressed_image.pptx", slides.export.SaveFormat.PPTX)

Atau menggunakan nilai DPI khusus secara langsung:

import aspose.slides as slides

with slides.Presentation("demo.pptx") as presentation:
    slide = presentation.slides[0]
    picture_frame = slide.shapes[0]

    # Kompres gambar ke 150 DPI (resolusi web), menghapus area yang dipotong.
    picture_frame.picture_format.compress_image(True, 150)

    presentation.save("compressed_image.pptx", slides.export.SaveFormat.PPTX)

NOTE

Metode ini mengonversi gambar ke resolusi lebih rendah berdasarkan ukuran bentuk dan DPI yang diberikan. Area terpotong juga dapat dihapus untuk mengoptimalkan ukuran file. Jika gambar adalah metafile (WMF/EMF) atau SVG, kompresi tidak akan diterapkan. Selain itu, kualitas JPEG dipertahankan atau sedikit dikurangi berdasarkan resolusi, serupa dengan cara PowerPoint menangani JPEG beresolusi tinggi.

Kunci Rasio Aspek

Jika Anda menginginkan bentuk yang berisi gambar mempertahankan rasio aspeknya setelah mengubah dimensi gambar, atur properti aspect_ratio_locked menjadi True.

Kode Python berikut menunjukkan cara mengunci rasio aspek bentuk:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    layout = presentation.layout_slides.get_by_type(slides.SlideLayoutType.CUSTOM)
    empty_slide = presentation.slides.add_empty_slide(layout)

    with slides.Images.from_file("image.png") as source_image:
        image = presentation.images.add_image(source_image)

    picture_frame = empty_slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

    # Kunci rasio aspek saat mengubah ukuran.
    picture_frame.picture_frame_lock.aspect_ratio_locked = True

    presentation.save("aspect_ratio_locked.pptx", slides.export.SaveFormat.PPTX)

NOTE

Pengaturan Lock Aspect Ratio ini hanya mempertahankan rasio aspek bentuk, bukan rasio aspek gambar di dalamnya.

Gunakan Properti Stretch Offset

Dengan properti stretch_offset_left, stretch_offset_top, stretch_offset_right, dan stretch_offset_bottom pada kelas PictureFillFormat, Anda dapat mendefinisikan sebuah persegi panjang isi.

Ketika peregangan ditentukan untuk sebuah gambar, persegi panjang sumber diskalakan agar sesuai dengan persegi panjang isi. Setiap sisi persegi panjang isi didefinisikan oleh offset persentase dari sisi yang bersesuaian pada kotak pembatas bentuk. Persentase positif menunjukkan inset, sementara persentase negatif menunjukkan outset.

Buat sebuah instance dari kelas Presentation.
Dapatkan referensi ke slide berdasarkan indeksnya.
Tambahkan sebuah AutoShape persegi.
Atur tipe isi bentuk.
Atur mode isi gambar bentuk.
Muat sebuah gambar.
Tetapkan gambar untuk mengisi bentuk.
Tentukan offset gambar dari sisi yang bersesuaian pada kotak pembatas bentuk.
Simpan presentasi sebagai file PPTX.

Kode Python berikut mendemonstrasikan cara menggunakan properti Stretch Offset:

import aspose.slides as slides

# Membuat instance kelas Presentation yang mewakili file PPTX.
with slides.Presentation() as presentation:
    # Dapatkan slide pertama.
    slide = presentation.slides[0]

    # Tambahkan AutoShape persegi panjang.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 300, 300)

    # Atur tipe isi bentuk.
    shape.fill_format.fill_type = slides.FillType.PICTURE

    # Atur mode isi gambar bentuk.
    shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH

    # Muat gambar dan tambahkan ke presentasi.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

    # Tetapkan gambar untuk mengisi bentuk.
    shape.fill_format.picture_fill_format.picture.image = image

    # Tentukan offset gambar dari sisi yang bersesuaian pada kotak pembatas bentuk.
    shape.fill_format.picture_fill_format.stretch_offset_left = 25
    shape.fill_format.picture_fill_format.stretch_offset_right = 25
    shape.fill_format.picture_fill_format.stretch_offset_top = -20
    shape.fill_format.picture_fill_format.stretch_offset_bottom = -10

    # Simpan file PPTX ke disk.
    presentation.save("stretch_offset.pptx", slides.export.SaveFormat.PPTX)

Tip

Aspose menyediakan konverter gratis—JPEG ke PowerPoint dan PNG ke PowerPoint—yang memungkinkan Anda dengan cepat membuat presentasi dari gambar.

FAQ

Bagaimana saya dapat mengetahui format gambar apa yang didukung untuk PictureFrame?

Aspose.Slides mendukung baik gambar raster (PNG, JPEG, BMP, GIF, dll.) maupun gambar vektor (misalnya, SVG) melalui objek gambar yang ditetapkan ke sebuah PictureFrame. Daftar format yang didukung umumnya tumpang tindih dengan kemampuan mesin konversi slide dan gambar.

Bagaimana penambahan puluhan gambar besar memengaruhi ukuran dan kinerja PPTX?

Menyematkan gambar besar meningkatkan ukuran file dan penggunaan memori; menautkan gambar membantu menjaga ukuran presentasi tetap kecil namun memerlukan file eksternal tetap dapat diakses. Aspose.Slides menyediakan kemampuan menambahkan gambar melalui tautan untuk mengurangi ukuran file.

Bagaimana cara mengunci objek gambar agar tidak tergerak/terubah ukuran secara tidak sengaja?

Gunakan shape locks untuk sebuah PictureFrame (misalnya, nonaktifkan pemindahan atau perubahan ukuran). Mekanisme penguncian dijelaskan untuk bentuk dalam artikel perlindungan terpisah [/slides/id/python-net/applying-protection-to-presentation/] dan didukung untuk berbagai tipe bentuk, termasuk PictureFrame.

Apakah fidelitas vektor SVG tetap terjaga saat mengekspor presentasi ke PDF/gambar?

Aspose.Slides memungkinkan mengekstrak SVG dari sebuah PictureFrame sebagai vektor asli. Saat mengekspor ke PDF atau format raster, hasilnya mungkin rasterisasi tergantung pada pengaturan ekspor; fakta bahwa SVG asli disimpan sebagai vektor dikonfirmasi oleh perilaku ekstraksi.