Beheer afbeeldingstransformatie‑effecten in presentaties met Python

Waar deze pagina over gaat

Pas afbeeldingstransformatie‑effecten toe, koppel ze, inspecteer, verwijder en verifieer ze voor foto‑frames met Aspose.Slides voor Python via .NET.

Overzicht

Aspose.Slides stelt afbeelding-aanpassingen voor als een geordende collectie van beeldtransformatie‑operaties. Voor een foto‑frame start u met de Picture van het frame en krijg je toegang tot de eigenschap image_transform. De geretourneerde ImageTransformOperationCollection stelt u in staat om effecten toe te voegen, te enumereren, te inspecteren, te verwijderen en te wissen zonder de oorspronkelijke afbeeldingsbytes te herschrijven.

Dit artikel toont een volledige workflow voor helderheid en contrast, kleuraanpassingen, onscherpte, transparantie, geordende effectketens, effectieve waarden, verwijdering en PPTX‑round‑trip‑verificatie.

Begrijp eigendom van effect en hergebruik van afbeelding

Een afbeeldingsbron en de foto die deze weergeeft zijn verschillende objecten:

PPImage slaat de bronafbeeldingsdata op of verwijst ernaar en behoort toe aan de presentatie.
Picture maakt deel uit van een foto‑vulling en verwijst naar een afbeeldingsbron terwijl het de afbeelding‑transformatie‑collectie opslaat.
PictureFrame is de dia‑vorm die de bijbehorende foto‑vulling, geometrie, uitsnijdingsinstellingen en andere frame‑niveau‑opmaak bezit.

Daarom wijzigen beeldtransformatie‑operaties de bytes in PPImage niet. Wanneer dezelfde PPImage meer dan eens aan ShapeCollection.add_picture_frame wordt doorgegeven, krijgt elk nieuw foto‑frame zijn eigen Picture en zijn eigen transformatie‑collectie. Het toepassen van grijswaarden op één frame maakt de andere frames niet grijs, zelfs als ze dezelfde ingebedde afbeeldingsbron hergebruiken.

Hetzelfde Picture.image_transform‑model wordt ook gebruikt door andere foto‑vullingen, zoals een vorm‑ of dia‑achtergrond. De onderstaande voorbeelden richten zich op foto‑frames.

Gebruik geldige parameterbereiken en eenheden

De getoonde methoden gebruiken de volgende semantische bereiken en eenheden. Houd waarden binnen deze bereiken, ook al wijst een bepaalde bibliotheekversie een out‑of‑range‑waarde niet onmiddellijk af; het doelpresentatie‑formaat kan ongeldige data normaliseren, weglaten of afwijzen tijdens het opslaan of wanneer PowerPoint het bestand opent.

Operatie	Parameters	Geldig bereik en eenheid
add_brightness_contrast_effect	`brightness`, `contrast`	`-100` tot `100`, procent; `0` laat het onderdeel ongewijzigd.
add_gray_scale_effect	None	Geen numerieke parameters. Alfa blijft ongewijzigd.
add_duotone_effect	`color1`, `color2`	Twee kleuren voor donkere en lichte pixels. RGB‑ en alfabereiken gebruiken `0` tot `255`.
add_tint_effect	`hue`, `amount`	Tint: `0` inclusief tot `360` exclusief, in graden; hoeveelheid: `-100` tot `100`, procent.
add_hsl_effect	`hue`, `saturation`, `luminance`	Tint: `0` inclusief tot `360` exclusief, in graden; verzadiging en luminantie: `-100` tot `100`, procent.
add_color_replace_effect	`color`	De vervangingskleur gebruikt kanaalwaarden van `0` tot `255`. Bestaande alfa‑waarden blijven ongewijzigd.
add_blur_effect	`radius`, `grow`	Straal is niet‑negatief en wordt gemeten in punten; `grow` is een Boolean die bepaalt of onscherpe inhoud buiten de oorspronkelijke grenzen mag uitbreiden.
add_alpha_modulate_fixed_effect	`amount`	Niet‑negatief percentage. Gebruik `0` tot `100` voor gewone opaciteits‑schaling: `0` is volledig transparant en `100` behoudt de bestaande alfa.
add_alpha_replace_effect	`alpha`	`0` tot `100`, procent opaciteit.
add_alpha_bi_level_effect	`threshold`	`0` tot `100`, procent alfadrempel. Waarden eronder worden transparant; waarden gelijk aan of hoger worden ondoorzichtig.

Voor vaste alfa‑modulatie zijn transparantie en opaciteit complementair. Bijvoorbeeld, 35 % transparantie komt overeen met een alfa‑modulatie‑waarde van 65 %.

Pas helderheid en contrast toe

ImageTransformOperationCollection.add_brightness_contrast_effect retourneert een BrightnessContrast‑operatie. De scalare instellingen worden meegegeven bij het creëren van de operatie. BrightnessContrast.get_effective retourneert berekende alleen‑lezen waarden die geïnspecteerd of gelogd kunnen worden.

Het volgende voorbeeld verhoogt de helderheid met 15 % en het contrast met 20 %, en rendert vervolgens een voorbeeld zonder de ingebedde afbeelding te wijzigen:

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 is een Office 2010 foto‑effect‑extensie en minder portabel dan het standaard DrawingML‑luminantie‑effect. Wanneer helderheid en contrast na een PPTX‑round‑trip bewerkbaar moeten blijven, gebruik dan ImageTransformOperationCollection.add_luminance_effect en controleer het resultaat na het heropenen van het bestand. De sectie format‑beperkingen legt dit onderscheid uitgebreider uit.

Pas kleuraanpassingen toe

Kleureffecten kunnen onafhankelijk worden toegepast op verschillende foto‑frames die één afbeeldingsbron hergebruiken. Het volgende voorbeeld maakt vijf frames en past grijswaarden, duotone, tint, HSL‑aanpassing en kleurvervanging toe.

Duotone bevat twee onafhankelijk bewerkbare kleurparameters: color1 wijst donkere pixels toe, terwijl color2 lichte pixels toewijst. Dit maakt het een nuttig voorbeeld van een effect waarvan de instellingen complexer zijn dan een enkele scalare waarde.

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 vervangt elke pixel‑kleur door één vaste kleur terwijl alfa behouden blijft. Het verschilt van add_color_change_effect, dat één bronkleur naar een andere map en beide bron‑ en doelkleurformaten blootlegt.

Voeg onscherpte, transparantie en alfa‑effecten toe

add_blur_effect beïnvloedt alle kleurkanalen, inclusief alfa. Stel grow in op True wanneer de onscherpe rand buiten de oorspronkelijke afbeeldingsgrenzen mag uitbreiden.

Voor uniforme transparantie gebruik add_alpha_modulate_fixed_effect. Het vermenigvuldigt elke bestaande alfa‑waarde, dus half‑transparante pixels blijven proportioneel verschillend. add_alpha_replace_effect wijst daarentegen één alfa‑waarde toe aan alle pixels. add_alpha_bi_level_effect zet alfa om in twee niveaus op basis van een drempel.

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)

Andere alfa‑operaties zonder parameters omvatten add_alpha_ceiling_effect, die elke niet‑nul alfa volledig ondoorzichtig maakt; add_alpha_floor_effect, die elke alfa onder 100 % volledig transparant maakt; en add_alpha_inverse_effect, die alfa verandert in 100% - alpha.

Bouw een geordende effectketen

Elke add_..._effect‑methode voegt een nieuwe operatie toe aan het einde van de collectie. De renderer gebruikt de collectie als een geordende pijplijn: de output van operatie 0 wordt de input van operatie 1, enzovoort. Daardoor kan dezelfde reeks operaties in een andere volgorde een ander beeld opleveren.

Bijvoorbeeld, grijswaarden gevolgd door tint verwijdert eerst chromatische informatie en kleurt vervolgens de luminantie‑uitkomst. Tint gevolgd door grijswaarden verwijdert de tint opnieuw. Evenzo kan alfa‑vervanging alfa‑waarden die door eerdere operaties zijn berekend overschrijven, terwijl alfa‑modulatie hun relatieve verschillen behoudt.

Het volgende voorbeeld bouwt een keten van vier operaties, slaat deze op als PPTX, opent de presentatie opnieuw, controleert zowel de operatietypen als hun volgorde, en rendert het heropende resultaat:

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.")

De collectie legt geen compatibiliteitsmatrix op die kleur-, alfa- en onscherpte‑operaties tot afzonderlijke ketens beperkt. Ze kunnen gecombineerd worden, maar combinaties zijn niet altijd nuttig. Een vaste kleurvervanging verwijdert RGB‑variatie die door eerdere kleureffecten is gecreëerd; grijswaarden na duotone verwijdert de twee geselecteerde kleuren; en alfa‑ceiling, -floor, -replace of -bi‑level kunnen alfa‑detail dat eerder is gemaakt, weggooien. Bouw de keten volgens de gewenste volgorde van pixelverwerking in plaats van de items te beschouwen als ongeordende opmaakflags.

Inspecteer bewerkbare en effectieve waarden

Een bewerkbare operatie is het object dat in Picture.image_transform is opgeslagen. Afhankelijk van het effect kan het direct schrijfbare leden blootleggen. Bijvoorbeeld, Blur biedt schrijfbare radius‑ en grow‑eigenschappen, AlphaModulateFixed biedt een schrijfbare amount‑eigenschap, en AlphaBiLevel biedt een schrijfbare threshold‑eigenschap. Kleureffecten zoals Duotone geven mutable ColorFormat‑objecten.

Sommige operaties, waaronder BrightnessContrast, HSL, Tint en AlphaReplace, geven hun creatiescalars niet bloot als schrijfbare eigenschappen. Om die instellingen te wijzigen, verwijder de operatie en voeg een vervanging toe op de gewenste positie.

Effectieve data die door get_effective() wordt geretourneerd, is berekend en alleen‑lezen. Het is nuttig om themagerelateerde kleuren op te lossen en de genormaliseerde waarden die de renderer gebruikt te lezen, maar het is geen extra bewerkingsoppervlak. Het volgende voorbeeld enumerateert de keten en inspecteert effectieve waarden waar de overeenkomstige API ze levert:

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) + "%")

Effecten zonder parameters, zoals grijswaarden, alfa‑ceiling en alfa‑inverse, hebben nog steeds een effectieve‑datobject, maar er zijn geen scalare instellingen om af te drukken. Hun aanwezigheid en positie in de collectie zijn de belangrijke informatie.

Verwijder of wis afbeeldingstransformaties

Gebruik ImageTransformOperationCollection.remove_at om één operatie op index te verwijderen. Omdat indexen na een verwijdering verschuiven, zoekt u eerst het doel en verwijdert u het daarna na enumeratie. Gebruik clear() om de volledige keten te verwijderen.

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)

Het verwijderen of wissen van transformaties wijzigt alleen de foto‑opmaak. Het verwijdert, recomprimeert of wijzigt de hergebruikte PPImage bron niet.

Overweeg presentatieformaten en exportdoelen

Afbeeldingstransformaties ontstaan in DrawingML, dus PPTX is het voorkeurs‑bewerkbare formaat voor effectketens. Zelfs bij PPTX heeft niet elke operatie identieke portabiliteit:

Standaard DrawingML‑operaties zoals luminantie, grijswaarden, duotone, tint, HSL, onscherpte en veelvoorkomende alfa‑operaties hebben de grootste kans om een PPTX‑round‑trip te overleven. Open altijd het gegenereerde bestand opnieuw en inspecteer de collectie wanneer behoud een vereiste is.
BrightnessContrast is een Office 2010‑extensie in plaats van de standaard DrawingML‑luminantie‑operatie. Het kan worden gebruikt voor in‑memory rendering, maar is niet gegarandeerd als bewerkbare BrightnessContrast‑operatie te blijven na opslaan en heropenen van PPTX. Geef de voorkeur aan add_luminance_effect voor blijvende helderheids‑ en contrast‑aanpassingen.
Het binaire PPT‑formaat bestaat vóór het volledige DrawingML‑effectmodel. Opslaan als PPT kan niet‑ondersteunde operaties weglaten, een keten reduceren tot een ondersteund subset, of de weergave benaderen. Gebruik PPT niet als verificatieformaat voor een complexe bewerkbare keten.
Renderen naar PNG, JPEG, TIFF, PDF, SVG, HTML of andere visuele uitvoer past de ondersteunde keten toe op het gerenderde uiterlijk. Die uitvoer bevat geen bewerkbare ImageTransformOperationCollection; rasterformaten flatten het resultaat tot pixels, en document‑ of vectorexporten slaan hun eigen renderingsrepresentatie op.
Effecten maken een gelinkte afbeelding niet zelf‑containend. Het renderen van een gelinkte foto blijft afhankelijk van de beschikbaarheid van de gelinkte bron wanneer de presentatie wordt geladen.

Verschillende presentatie‑consumenten kunnen randgevallen verschillend renderen, vooral wanneer meerdere alfa‑ of kleur‑kwantiserende operaties worden gecombineerd. Test voor kritieke output zowel de bewerkbare round‑trip als het uiteindelijke exportformaat met dezelfde Aspose.Slides‑versie die in productie wordt gebruikt.

FAQ

Veranderen afbeeldingstransformatie‑effecten de ingebedde afbeeldingsdata?

Nee. De operaties behoren tot de Picture die door de foto‑vulling wordt gebruikt. De onderliggende PPImage‑bytes blijven ongewijzigd.

Zullen twee foto‑frames die dezelfde afbeelding hergebruiken elkaars effect delen?

Nee. Het hergebruiken van een PPImage voorkomt dubbele afbeeldingsdata, maar elk foto‑frame heeft normaal gesproken een aparte Picture en een eigen transformatie‑collectie.

Kunnen kleur‑, onscherpte‑ en alfa‑effecten gecombineerd worden?

Ja. De collectie accepteert ze in één geordende keten. Overweeg wat elke operatie met de output van de vorige doet, want vervangings‑ en drempeloperaties kunnen eerder kleur‑ of alfadetail weggooien.

Waarom zijn effectieve waarden alleen‑lezen?

Effectieve data vertegenwoordigt berekende waarden die worden gebruikt voor rendering, inclusief opgeloste kleuren. Bewerk de operatie die in de transformatie‑collectie is opgeslagen waar schrijfbare leden bestaan; anders verwijder deze en voeg een vervanging met nieuwe creatie‑parameters toe.

Welk formaat moet ik gebruiken om een transformatie‑keten te behouden?

Gebruik PPTX en verifieer het bestand door het opnieuw te openen. Oudere PPT kan het volledige DrawingML‑effectmodel niet weergeven, en gerenderde exportformaten behouden alleen het uiterlijk, niet de bewerkbare transformatie‑operaties.

Flash‑objecten extraheren uit presentaties in Python