Kelola Efek Transformasi Gambar dalam Presentasi dengan Python

Tentang apa halaman ini

Terapkan, rangkai, inspeksi, hapus, dan verifikasi efek transformasi gambar untuk bingkai gambar dengan Aspose.Slides untuk Python melalui .NET.

Gambaran Umum

Aspose.Slides merepresentasikan penyesuaian gambar sebagai koleksi terurut dari operasi transformasi gambar. Untuk sebuah bingkai gambar, mulailah dengan Picture bingkai tersebut dan akses propertinya image_transform. ImageTransformOperationCollection yang dikembalikan memungkinkan Anda menambahkan, menelusuri, memeriksa, menghapus, dan membersihkan efek tanpa menulis ulang byte gambar asli.

Artikel ini menunjukkan alur kerja lengkap untuk kecerahan dan kontras, transformasi warna, blur, transparansi, rantai efek berurutan, nilai efektif, penghapusan, dan verifikasi putaran balik PPTX.

Memahami Kepemilikan Efek dan Penggunaan Ulang Gambar

Sebuah sumber gambar dan gambar yang menampilkannya adalah objek yang berbeda:

PPImage menyimpan atau merujuk data gambar sumber yang dimiliki oleh presentasi.
Picture merupakan bagian dari isian gambar dan merujuk ke sumber gambar sambil menyimpan koleksi transformasi gambar.
PictureFrame adalah bentuk slide yang memiliki isian gambar terkait, geometri, pengaturan pemotongan, dan pemformatan level bingkai lainnya.

Oleh karena itu, operasi transformasi gambar tidak mengubah byte dalam PPImage. Ketika PPImage yang sama diberikan ke ShapeCollection.add_picture_frame lebih dari satu kali, setiap bingkai gambar baru menerima Picture‑nya sendiri dan koleksi transformasinya sendiri. Menerapkan skala abu‑abu pada satu bingkai tidak membuat bingkai lainnya menjadi skala abu‑abu, meskipun semuanya menggunakan sumber gambar tersemat yang sama.

Model Picture.image_transform yang sama juga dipakai oleh isian gambar lain, seperti bentuk atau latar belakang slide. Contoh di bawah berfokus pada bingkai gambar.

Gunakan Rentang Parameter dan Unit yang Valid

Metode yang ditunjukkan menggunakan rentang semantik dan unit berikut. Simpan nilai dalam rentang ini meskipun versi pustaka tertentu tidak menolak setiap nilai di luar rentang secara langsung; format presentasi target dapat menormalkan, menghilangkan, atau menolak data tidak valid saat disimpan atau ketika PowerPoint membuka berkas.

Operasi	Parameter	Rentang dan satuan yang valid
add_brightness_contrast_effect	`brightness`, `contrast`	`-100` sampai `100`, persen; `0` membiarkan komponen tidak berubah.
add_gray_scale_effect	None	Tanpa parameter numerik. Alpha tidak berubah.
add_duotone_effect	`color1`, `color2`	Dua warna untuk piksel gelap dan terang. Saluran RGB dan alfa menggunakan `0` sampai `255`.
add_tint_effect	`hue`, `amount`	Hue antara `0` inklusif sampai `360` eksklusif, dalam derajat; amount antara `-100` sampai `100`, persen.
add_hsl_effect	`hue`, `saturation`, `luminance`	Hue antara `0` inklusif sampai `360` eksklusif, dalam derajat; saturasi dan luminansi antara `-100` sampai `100`, persen.
add_color_replace_effect	`color`	Warna pengganti menggunakan nilai saluran dari `0` sampai `255`. Nilai alfa yang ada tidak berubah.
add_blur_effect	`radius`, `grow`	Radius non‑negatif dan diukur dalam poin; `grow` adalah Boolean yang mengontrol apakah konten yang blur dapat melampaui batas asli.
add_alpha_modulate_fixed_effect	`amount`	Persen non‑negatif. Gunakan `0` sampai `100` untuk skala opasitas biasa: `0` sepenuhnya transparan dan `100` mempertahankan alfa yang ada.
add_alpha_replace_effect	`alpha`	`0` sampai `100`, persen opasitas.
add_alpha_bi_level_effect	`threshold`	`0` sampai `100`, persen ambang alfa. Nilai di bawah ambang menjadi transparan; nilai pada atau di atas ambang menjadi tidak transparan.

Untuk modulasi alfa tetap, transparansi dan opasitas bersifat komplementer. Misalnya, transparansi 35 % bersesuaian dengan nilai modulasi alfa 65 %.

Terapkan Kecerahan dan Kontras

ImageTransformOperationCollection.add_brightness_contrast_effect mengembalikan operasi BrightnessContrast. Pengaturan skalar disediakan saat operasi dibuat. BrightnessContrast.get_effective mengembalikan nilai baca‑saja yang dihitung yang dapat diperiksa atau dicatat.

Contoh berikut meningkatkan kecerahan sebesar 15 % dan kontras sebesar 20 %, lalu menampilkan pratinjau tanpa mengubah gambar tersemat:

import aspose.slides as slides

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

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

    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 400, 260, image)
    image_transform = picture_frame.picture_format.picture.image_transform
    brightness_contrast = image_transform.add_brightness_contrast_effect(15, 20)

    effective_values = brightness_contrast.get_effective()
    print("Brightness: " + str(effective_values.brightness) + "%")
    print("Contrast: " + str(effective_values.contrast) + "%")

    with slide.get_image() as preview:
        preview.save("brightness-contrast-preview.png")

BrightnessContrast adalah ekstensi efek gambar Office 2010 dan kurang portabel daripada efek luminansi DrawingML standar. Ketika kecerahan dan kontras harus tetap dapat disunting setelah putaran balik PPTX, gunakan ImageTransformOperationCollection.add_luminance_effect dan verifikasi hasilnya setelah membuka kembali berkas. Bagian batasan format menjelaskan perbedaan ini secara lebih detail.

Terapkan Transformasi Warna

Efek warna dapat diterapkan secara independen pada bingkai gambar yang menggunakan satu sumber gambar. Contoh berikut membuat lima bingkai dan menerapkan skala abu‑abu, duotone, tint, penyesuaian HSL, serta penggantian warna.

Duotone memiliki dua parameter warna yang dapat disunting secara terpisah: color1 memetakan piksel gelap, sedangkan color2 memetakan piksel terang. Ini membuatnya menjadi contoh berguna dari efek yang pengaturannya lebih kompleks daripada nilai skalar tunggal.

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

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

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

    gray_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 20, 20, 180, 120, image)
    gray_frame.picture_format.picture.image_transform.add_gray_scale_effect()

    duotone_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 220, 20, 180, 120, image)
    duotone = duotone_frame.picture_format.picture.image_transform.add_duotone_effect()
    duotone.color1.color = draw.Color.navy
    duotone.color2.color = draw.Color.gold

    tint_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 420, 20, 180, 120, image)
    tint_frame.picture_format.picture.image_transform.add_tint_effect(210, 35)

    hsl_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 120, 170, 180, 120, image)
    hsl_frame.picture_format.picture.image_transform.add_hsl_effect(30, 20, -10)

    replacement_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 320, 170, 180, 120, image)
    color_replacement = replacement_frame.picture_format.picture.image_transform.add_color_replace_effect()
    color_replacement.color.color = draw.Color.cornflower_blue

    presentation.save("color-transformations.pptx", slides.export.SaveFormat.PPTX)

add_color_replace_effect mengganti setiap warna piksel dengan satu warna tetap sambil mempertahankan alfa. Ini berbeda dari add_color_change_effect, yang memetakan satu warna sumber ke warna target dan mengekspos format warna sumber serta target.

Tambahkan Blur, Transparansi, dan Efek Alfa

add_blur_effect memengaruhi semua saluran warna, termasuk alfa. Atur grow ke True bila tepi yang blur dapat melampaui batas gambar asli.

Untuk transparansi seragam, gunakan add_alpha_modulate_fixed_effect. Ia mengalikan setiap nilai alfa yang ada, sehingga piksel yang sebagian transparan tetap berbeda secara proporsional. add_alpha_replace_effect justru menetapkan satu nilai alfa untuk semua piksel. add_alpha_bi_level_effect mengubah alfa menjadi dua level berdasarkan ambang.

import aspose.slides as slides

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

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

    blurred_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 20, 20, 200, 140, image)
    blur = blurred_frame.picture_format.picture.image_transform.add_blur_effect(4.5, True)
    blur.radius = 5

    transparent_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 240, 20, 200, 140, image)
    alpha_modulate = transparent_frame.picture_format.picture.image_transform.add_alpha_modulate_fixed_effect(65)
    alpha_modulate.amount = 60

    uniform_alpha_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 20, 180, 200, 140, image)
    uniform_alpha_frame.picture_format.picture.image_transform.add_alpha_replace_effect(55)

    binary_alpha_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 240, 180, 200, 140, image)
    alpha_bi_level = binary_alpha_frame.picture_format.picture.image_transform.add_alpha_bi_level_effect(50)
    alpha_bi_level.threshold = 45
    binary_alpha_frame.picture_format.picture.image_transform.add_alpha_inverse_effect()

    presentation.save("blur-and-alpha-effects.pptx", slides.export.SaveFormat.PPTX)

Operasi alfa tanpa parameter lainnya meliputi add_alpha_ceiling_effect, yang membuat setiap alfa selain nol menjadi sepenuhnya tidak transparan; add_alpha_floor_effect, yang membuat setiap alfa di bawah 100 % sepenuhnya transparan; dan add_alpha_inverse_effect, yang mengubah alfa menjadi 100% - alpha.

Bangun Rantai Efek Berurutan

Setiap metode add_..._effect menambahkan operasi baru ke akhir koleksi. Renderer menggunakan koleksi sebagai jalur pipa berurutan: keluaran operasi 0 menjadi masukan operasi 1, dan seterusnya. Akibatnya, operasi yang sama dalam urutan berbeda dapat menghasilkan gambar yang berbeda.

Misalnya, skala abu‑abu diikuti tint pertama‑tama menghapus informasi kromatik lalu mewarnai kembali hasil luminansi. Tint diikuti skala abu‑abu menghapus tint kembali. Demikian pula, penggantian alfa dapat menimpa nilai alfa yang dihitung oleh operasi sebelumnya, sementara modulasi alfa mempertahankan perbedaan relatifnya.

Contoh berikut membangun rantai empat operasi, menyimpannya sebagai PPTX, membuka kembali presentasi, memeriksa tipe operasi serta urutannya, dan merender hasil yang dibuka kembali:

import aspose.slides as slides

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

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

    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 400, 260, image)
    image_transform = picture_frame.picture_format.picture.image_transform
    image_transform.add_gray_scale_effect()
    image_transform.add_tint_effect(220, 25)
    image_transform.add_blur_effect(2.5, False)
    image_transform.add_alpha_modulate_fixed_effect(80)

    presentation.save("image-transform-chain.pptx", slides.export.SaveFormat.PPTX)

with slides.Presentation("image-transform-chain.pptx") as reopened_presentation:
    reopened_shape = reopened_presentation.slides[0].shapes[0]

    if isinstance(reopened_shape, slides.PictureFrame):
        reopened_transform = reopened_shape.picture_format.picture.image_transform
        order_is_preserved = (
            len(reopened_transform) == 4 and
            isinstance(reopened_transform[0], slides.effects.GrayScale) and
            isinstance(reopened_transform[1], slides.effects.Tint) and
            isinstance(reopened_transform[2], slides.effects.Blur) and
            isinstance(reopened_transform[3], slides.effects.AlphaModulateFixed)
        )
        print("The effect chain was preserved." if order_is_preserved else "The effect chain changed during the round trip.")

        with reopened_presentation.slides[0].get_image() as rendered_slide:
            rendered_slide.save("reopened-effect-chain.png")
    else:
        print("The reopened shape is not a picture frame.")

Koleksi tidak memberlakukan matriks kompatibilitas yang membatasi operasi warna, alfa, dan blur ke rantai terpisah. Mereka dapat digabungkan, tetapi kombinasi tidak selalu berguna. Penggantian warna tetap menghilangkan variasi RGB yang dihasilkan oleh efek warna sebelumnya; skala abu‑abu setelah duotone menghapus dua warna terpilih; dan operasi alfa ceiling, floor, replacement, atau bi‑level dapat membuang detail alfa yang dibuat sebelumnya. Bangun rantai sesuai urutan pemrosesan piksel yang diinginkan, bukan memperlakukan elemennya sebagai flag pemformatan tak berurutan.

Periksa Nilai yang Dapat Diedit dan Nilai Efektif

Operasi yang dapat diedit adalah objek yang disimpan dalam Picture.image_transform. Tergantung pada efeknya, objek ini mungkin mengekspos anggota yang dapat ditulisi secara langsung. Misalnya, Blur mengekspos properti radius dan grow yang dapat ditulisi, AlphaModulateFixed mengekspos properti amount yang dapat ditulisi, dan AlphaBiLevel mengekspos properti threshold yang dapat ditulisi. Efek warna seperti Duotone mengekspos objek ColorFormat yang dapat diubah.

Beberapa operasi, termasuk BrightnessContrast, HSL, Tint, dan AlphaReplace, tidak mengekspos skalar penciptaannya sebagai properti yang dapat ditulisi. Untuk mengubah pengaturan tersebut, hapus operasi dan tambahkan pengganti pada posisi yang diperlukan.

Data efektif yang dikembalikan oleh get_effective() dihitung dan bersifat baca‑saja. Data ini berguna untuk menyelesaikan warna yang bergantung pada tema dan membaca nilai normalisasi yang dipakai renderer, namun bukan permukaan penyuntingan lain. Contoh berikut menelusuri rantai dan memeriksa nilai efektif di mana API yang bersangkutan menyediakannya:

import aspose.slides as slides

with slides.Presentation("image-transform-chain.pptx") as presentation:
    picture_frame = None

    for shape in presentation.slides[0].shapes:
        if isinstance(shape, slides.PictureFrame):
            picture_frame = shape
            break

    if picture_frame is not None:
        image_transform = picture_frame.picture_format.picture.image_transform

        for index, operation in enumerate(image_transform):
            print(str(index) + ": " + type(operation).__name__)

            if isinstance(operation, slides.effects.BrightnessContrast):
                effect_data = operation.get_effective()
                print("  Brightness: " + str(effect_data.brightness))
                print("  Contrast: " + str(effect_data.contrast))
            elif isinstance(operation, slides.effects.Luminance):
                effect_data = operation.get_effective()
                print("  Brightness: " + str(effect_data.brightness))
                print("  Contrast: " + str(effect_data.contrast))
            elif isinstance(operation, slides.effects.Duotone):
                effect_data = operation.get_effective()
                print("  Dark color: " + str(effect_data.color1))
                print("  Light color: " + str(effect_data.color2))
            elif isinstance(operation, slides.effects.ColorReplace):
                effect_data = operation.get_effective()
                print("  Replacement color: " + str(effect_data.color))
            elif isinstance(operation, slides.effects.HSL):
                effect_data = operation.get_effective()
                print("  HSL: " + str(effect_data.hue) + ", " + str(effect_data.saturation) + ", " + str(effect_data.luminance))
            elif isinstance(operation, slides.effects.Tint):
                effect_data = operation.get_effective()
                print("  Tint: " + str(effect_data.hue) + ", " + str(effect_data.amount))
            elif isinstance(operation, slides.effects.Blur):
                effect_data = operation.get_effective()
                print("  Blur radius: " + str(effect_data.radius) + " pt")
            elif isinstance(operation, slides.effects.AlphaModulateFixed):
                effect_data = operation.get_effective()
                print("  Alpha amount: " + str(effect_data.amount) + "%")
            elif isinstance(operation, slides.effects.AlphaReplace):
                effect_data = operation.get_effective()
                print("  Replacement alpha: " + str(effect_data.alpha) + "%")
            elif isinstance(operation, slides.effects.AlphaBiLevel):
                effect_data = operation.get_effective()
                print("  Alpha threshold: " + str(effect_data.threshold) + "%")

Efek tanpa parameter seperti skala abu‑abu, alpha ceiling, dan alpha inverse tetap memiliki objek data‑efektif, tetapi tidak ada pengaturan skalar yang dapat dicetak. Keberadaan dan posisinya dalam koleksi merupakan informasi penting.

Hapus atau Bersihkan Transformasi Gambar

Gunakan ImageTransformOperationCollection.remove_at untuk menghapus satu operasi berdasarkan indeks. Karena indeks bergeser setelah penghapusan, cari target terlebih dahulu lalu hapus setelah penelusuran. Gunakan clear() untuk menghapus seluruh rantai.

import aspose.slides as slides

with slides.Presentation("image-transform-chain.pptx") as presentation:
    picture_frame = None

    for shape in presentation.slides[0].shapes:
        if isinstance(shape, slides.PictureFrame):
            picture_frame = shape
            break

    if picture_frame is not None:
        image_transform = picture_frame.picture_format.picture.image_transform
        blur_index = None

        for index, operation in enumerate(image_transform):
            if isinstance(operation, slides.effects.Blur):
                blur_index = index
                break

        if blur_index is not None:
            image_transform.remove_at(blur_index)
            print("The blur operation was removed.")

        image_transform.clear()
        print("Remaining operations: " + str(len(image_transform)))
        presentation.save("image-transforms-cleared.pptx", slides.export.SaveFormat.PPTX)

Menghapus atau membersihkan transformasi hanya mengubah pemformatan gambar. Hal ini tidak menghapus, mengompresi ulang, atau mengubah sumber daya PPImage yang digunakan kembali.

Pertimbangkan Format Presentasi dan Target Ekspor

Transformasi gambar berasal dari DrawingML, sehingga PPTX adalah format yang dapat disunting secara disarankan untuk rantai efek. Bahkan dengan PPTX, tidak semua operasi memiliki portabilitas yang identik:

Operasi DrawingML standar seperti luminansi, skala abu‑abu, duotone, tint, HSL, blur, dan operasi alfa umum memiliki peluang terbaik untuk bertahan setelah putaran balik PPTX. Selalu buka kembali berkas yang dihasilkan dan periksa koleksinya bila preservasi menjadi keharusan.
BrightnessContrast adalah ekstensi Office 2010, bukan operasi luminansi DrawingML standar. Ia dapat dipakai untuk perenderan dalam memori, tetapi tidak dijamin tetap sebagai operasi BrightnessContrast yang dapat disunting setelah menyimpan dan membuka kembali PPTX. Lebih baik gunakan add_luminance_effect untuk penyesuaian kecerahan dan kontras yang persisten.
Format PPT biner lebih tua daripada model efek DrawingML penuh. Menyimpan ke PPT dapat menghilangkan operasi yang tidak didukung, menyederhanakan rantai menjadi subset yang didukung, atau memperkirakan tampilannya. Jangan gunakan PPT sebagai format verifikasi untuk rantai yang dapat disunting secara kompleks.
Merender ke PNG, JPEG, TIFF, PDF, SVG, HTML, atau output visual lainnya menerapkan rantai yang didukung pada tampilan yang dirender. Output tersebut tidak berisi ImageTransformOperationCollection yang dapat disunting; format raster meratakan hasil menjadi piksel, sementara ekspor dokumen atau vektor menyimpan representasi perenderan mereka sendiri.
Efek tidak membuat gambar yang ditautkan menjadi mandiri. Merender gambar yang ditautkan tetap bergantung pada sumber daya yang ditautkan tersedia saat presentasi dimuat.

Berbagai konsumen presentasi dapat merender kasus tepi secara berbeda, terutama ketika beberapa operasi alfa atau kuantisasi warna digabungkan. Untuk output yang kritis, uji baik putaran balik yang dapat disunting maupun format ekspor akhir dengan versi Aspose.Slides yang sama dengan yang dipakai di produksi.

FAQ

Apakah efek transformasi gambar memodifikasi data gambar yang tersemat?

Tidak. Operasi tersebut milik Picture yang digunakan oleh isian gambar. Byte PPImage yang mendasarinya tetap tidak berubah.

Apakah dua bingkai gambar yang menggunakan gambar yang sama berbagi efeknya?

Tidak. Menggunakan kembali PPImage menghindari duplikasi data gambar, tetapi setiap bingkai gambar biasanya memiliki Picture dan koleksi transformasi gambar yang terpisah.

Bisakah efek warna, blur, dan alfa digabungkan?

Ya. Koleksi menerima mereka dalam satu rantai berurutan. Pertimbangkan apa yang dilakukan setiap operasi pada keluaran operasi sebelumnya karena operasi penggantian dan ambang dapat menghilangkan detail warna atau alfa yang lebih awal.

Mengapa nilai efektif bersifat baca‑saja?

Data efektif mewakili nilai yang dihitung untuk perenderan, termasuk warna yang telah diselesaikan. Sunting operasi yang tersimpan dalam koleksi transformasi bila ada anggota yang dapat ditulisi; jika tidak, hapus operasi tersebut dan tambahkan pengganti dengan parameter penciptaan baru.

Format apa yang harus saya gunakan untuk mempertahankan rantai transformasi?

Gunakan PPTX dan verifikasi berkas dengan membukanya kembali. PPT lama tidak dapat merepresentasikan model efek DrawingML lengkap, dan format ekspor yang dirender hanya mempertahankan tampilan, bukan operasi transformasi yang dapat disunting.

Kelola Audio dalam Presentasi Menggunakan Python