Gérer les effets de transformation d'image dans les présentations sur Android

À propos de cette page

Appliquer, chaîner, inspecter, supprimer et vérifier les effets de transformation d’image pour les cadres d’image avec Aspose.Slides pour Android via Java.

Vue d’ensemble

Aspose.Slides représente les ajustements d’image comme une collection ordonnée d’opérations de transformation d’image. Pour un cadre d’image, commencez avec le ISlidesPicture du cadre et accédez à ISlidesPicture.getImageTransform. La IImageTransformOperationCollection retournée vous permet d’ajouter, d’énumérer, d’inspecter, de supprimer et d’effacer les effets sans réécrire les octets d’image originaux.

Cet article montre un flux de travail complet pour la luminosité et le contraste, les transformations de couleur, le flou, la transparence, les chaînes d’effets ordonnées, les valeurs effectives, la suppression et la vérification d’un aller-retour PPTX.

Comprendre la propriété des effets et la réutilisation des images

Une ressource d’image et l’image qui l’affiche sont des objets différents :

• IPPImage stocke ou référence les données d’image source appartenant à la présentation.
• ISlidesPicture appartient à un remplissage d’image et fait référence à une ressource d’image tout en stockant la collection de transformations d’image.
• IPictureFrame est la forme de diapositive qui possède le remplissage d’image concerné, la géométrie, les paramètres de recadrage et les autres mises en forme au niveau du cadre.

Par conséquent, les opérations de transformation d’image ne modifient pas les octets dans IPPImage. Lorsque le même IPPImage est passé à IShapeCollection.addPictureFrame plusieurs fois, chaque nouveau cadre d’image reçoit son propre ISlidesPicture et sa propre collection de transformations. Appliquer le niveau de gris à un cadre ne rend pas les autres cadres en niveaux de gris, même si tous réutilisent la même ressource d’image incorporée.

Le même modèle ISlidesPicture.getImageTransform est également utilisé par d’autres remplissages d’image, tels qu’une forme ou l’arrière‑plan d’une diapositive. Les exemples ci‑dessous se concentrent sur les cadres d’image.

Utiliser des plages de paramètres valides et des unités

Les méthodes présentées utilisent les plages sémantiques et les unités suivantes. Conservez les valeurs dans ces plages même si une version particulière de la bibliothèque ne rejette pas immédiatement chaque valeur hors plage ; le format cible de la présentation peut normaliser, omettre ou refuser les données invalides lors de l’enregistrement ou à l’ouverture du fichier par PowerPoint.

Opération	Paramètres	Plage valide et unité
addBrightnessContrastEffect	brightness, contrast	-100 à 100, pourcentage ; 0 laisse le composant inchangé.
addGrayScaleEffect	Aucun	Aucun paramètre numérique. L’alpha reste inchangé.
addDuotoneEffect	color1, color2	Deux couleurs pour les pixels sombres et clairs. Les valeurs RGB et du canal alpha utilisées par android.graphics.Color vont de 0 à 255.
addTintEffect	hue, amount	La teinte est comprise entre 0 inclus et 360 exclus, en degrés ; la quantité est de -100 à 100, pourcentage.
addHSLEffect	hue, saturation, luminance	La teinte est comprise entre 0 inclus et 360 exclus, en degrés ; saturation et luminance sont de -100 à 100, pourcentage.
addColorReplaceEffect	color	La couleur de remplacement utilise des valeurs de canal de 0 à 255. Les valeurs alpha existantes restent inchangées.
addBlurEffect	radius, grow	Le rayon est non négatif et est mesuré en points ; grow est un booléen qui contrôle si le contenu flou peut dépasser les limites originales.
addAlphaModulateFixedEffect	amount	Pourcentage non négatif. Utilisez 0 à 100 pour un réglage d’opacité ordinaire : 0 est totalement transparent et 100 conserve l’alpha existant.
addAlphaReplaceEffect	alpha	0 à 100, pourcentage d’opacité.
addAlphaBiLevelEffect	threshold	0 à 100, pourcentage de seuil alpha. Les valeurs en dessous deviennent transparentes ; les valeurs égales ou supérieures deviennent opaques.

Pour la modulation alpha fixe, transparence et opacité sont complémentaires. Par exemple, 35 % de transparence correspond à un montant de modulation alpha de 65 %.

Appliquer la luminosité et le contraste

IImageTransformOperationCollection.addBrightnessContrastEffect renvoie une opération IBrightnessContrast. Ses paramètres scalaires sont fournis lors de la création de l’opération. IBrightnessContrast.getEffective renvoie des valeurs calculées en lecture seule qui peuvent être inspectées ou journalisées.

L’exemple suivant augmente la luminosité de 15 % et le contraste de 20 %, puis génère un aperçu sans modifier l’image incorporée :

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }
    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 400, 260, image);

    IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
    IBrightnessContrast brightnessContrast = imageTransform.addBrightnessContrastEffect(15f, 20f);

    IBrightnessContrastEffectiveData effectiveValues = brightnessContrast.getEffective();
    System.out.println("Brightness: " + effectiveValues.getBrightness() + "%");
    System.out.println("Contrast: " + effectiveValues.getContrast() + "%");

    IImage preview = slide.getImage();
    try {
        preview.save("brightness-contrast-preview.png", ImageFormat.Png);
    } finally {
        preview.dispose();
    }
} finally {
    presentation.dispose();
}

BrightnessContrast est une extension d’effet d’image Office 2010 et est moins portable que l’effet de luminance standard DrawingML. Lorsque la luminosité et le contraste doivent rester modifiables après un aller‑retour PPTX, utilisez IImageTransformOperationCollection.addLuminanceEffect et vérifiez le résultat après réouverture du fichier. La section sur les limitations de format explique cette distinction plus en détail.

Appliquer des transformations de couleur

Les effets de couleur peuvent être appliqués indépendamment à différents cadres d’image réutilisant la même ressource d’image. L’exemple suivant crée cinq cadres et applique le niveau de gris, le duo‑tone, la teinte, le réglage HSL et le remplacement de couleur.

IDuotone possède deux paramètres de couleur éditables indépendamment : color1 correspond aux pixels sombres, tandis que color2 correspond aux pixels clairs. C’est un exemple utile d’effet dont les paramètres sont plus complexes qu’une simple valeur scalaire.

import com.aspose.slides.*;
import android.graphics.Color;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame grayFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 20, 180, 120, image);
    grayFrame.getPictureFormat().getPicture().getImageTransform().addGrayScaleEffect();

    IPictureFrame duotoneFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 220, 20, 180, 120, image);
    IDuotone duotone = duotoneFrame.getPictureFormat().getPicture().getImageTransform().addDuotoneEffect();
    duotone.getColor1().setColor(Color.rgb(0, 0, 128));
    duotone.getColor2().setColor(Color.rgb(255, 215, 0));

    IPictureFrame tintFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 420, 20, 180, 120, image);
    tintFrame.getPictureFormat().getPicture().getImageTransform().addTintEffect(210f, 35f);

    IPictureFrame hslFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 120, 170, 180, 120, image);
    hslFrame.getPictureFormat().getPicture().getImageTransform().addHSLEffect(30f, 20f, -10f);

    IPictureFrame replacementFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 320, 170, 180, 120, image);
    IColorReplace colorReplacement = replacementFrame.getPictureFormat().getPicture().getImageTransform().addColorReplaceEffect();
    colorReplacement.getColor().setColor(Color.rgb(100, 149, 237));

    presentation.save("color-transformations.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

addColorReplaceEffect remplace la couleur de chaque pixel par une couleur fixe tout en conservant l’alpha. Il diffère de addColorChangeEffect, qui mappe une couleur source vers une autre et expose les formats couleur source et cible.

Ajouter des effets de flou, de transparence et d’alpha

addBlurEffect affecte tous les canaux couleur, y compris l’alpha. Réglez grow sur true lorsque le bord flou peut dépasser les limites d’origine de l’image.

Pour une transparence uniforme, utilisez addAlphaModulateFixedEffect. Il multiplie chaque valeur alpha existante, de sorte que les pixels partiellement transparents restent proportionnellement différents. addAlphaReplaceEffect attribue quant à lui une même valeur alpha à tous les pixels. addAlphaBiLevelEffect convertit l’alpha en deux niveaux selon un seuil.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }

    IPictureFrame blurredFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 20, 200, 140, image);
    IBlur blur = blurredFrame.getPictureFormat().getPicture().getImageTransform().addBlurEffect(4.5, true);
    blur.setRadius(5);

    IPictureFrame transparentFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 240, 20, 200, 140, image);
    IAlphaModulateFixed alphaModulate = transparentFrame.getPictureFormat().getPicture().getImageTransform().addAlphaModulateFixedEffect(65f);
    alphaModulate.setAmount(60f);

    IPictureFrame uniformAlphaFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 20, 180, 200, 140, image);
    uniformAlphaFrame.getPictureFormat().getPicture().getImageTransform().addAlphaReplaceEffect(55f);

    IPictureFrame binaryAlphaFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 240, 180, 200, 140, image);
    IAlphaBiLevel alphaBiLevel = binaryAlphaFrame.getPictureFormat().getPicture().getImageTransform().addAlphaBiLevelEffect(50f);
    alphaBiLevel.setThreshold(45f);
    binaryAlphaFrame.getPictureFormat().getPicture().getImageTransform().addAlphaInverseEffect();

    presentation.save("blur-and-alpha-effects.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

D’autres opérations alpha sans paramètres incluent addAlphaCeilingEffect qui rend chaque alpha non nul totalement opaque ; addAlphaFloorEffect qui rend chaque alpha inférieur à 100 % totalement transparent ; et addAlphaInverseEffect qui change l’alpha en 100% - alpha.

Construire une chaîne d’effets ordonnée

Chaque méthode add...Effect ajoute une nouvelle opération à la fin de la collection. Le moteur de rendu utilise la collection comme pipeline ordonné : la sortie de l’opération 0 devient l’entrée de l’opération 1, et ainsi de suite. En conséquence, les mêmes opérations dans un ordre différent peuvent produire une image différente.

Par exemple, le niveau de gris suivi d’une teinte supprime d’abord les informations chromatiques puis recolore le résultat de luminance. Une teinte suivie de niveau de gris supprime de nouveau la teinte. De même, le remplacement d’alpha peut écraser les valeurs alpha calculées par les opérations précédentes, tandis que la modulation d’alpha préserve leurs différences relatives.

L’exemple suivant crée une chaîne de quatre opérations, l’enregistre en PPTX, rouvre la présentation, vérifie les types d’opérations ainsi que leur ordre, puis rend le résultat rouvert :

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPPImage image;
    IImage sourceImage = Images.fromFile("photo.png");
    try {
        image = presentation.getImages().addImage(sourceImage);
    } finally {
        sourceImage.dispose();
    }
    IPictureFrame pictureFrame = slide.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 50, 400, 260, image);

    IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
    imageTransform.addGrayScaleEffect();
    imageTransform.addTintEffect(220f, 25f);
    imageTransform.addBlurEffect(2.5, false);
    imageTransform.addAlphaModulateFixedEffect(80f);

    presentation.save("image-transform-chain.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Presentation reopenedPresentation = new Presentation("image-transform-chain.pptx");
try {
    IShape reopenedShape = reopenedPresentation.getSlides().get_Item(0).getShapes().get_Item(0);

    if (reopenedShape instanceof IPictureFrame) {
        IPictureFrame reopenedFrame = (IPictureFrame) reopenedShape;
        IImageTransformOperationCollection reopenedTransform = reopenedFrame.getPictureFormat().getPicture().getImageTransform();
        boolean orderIsPreserved = reopenedTransform.size() == 4 && 
                reopenedTransform.get_Item(0) instanceof IGrayScale && 
                reopenedTransform.get_Item(1) instanceof ITint && 
                reopenedTransform.get_Item(2) instanceof IBlur && 
                reopenedTransform.get_Item(3) instanceof IAlphaModulateFixed;
        System.out.println(orderIsPreserved ? "The effect chain was preserved." : "The effect chain changed during the round trip.");

        IImage renderedSlide = reopenedPresentation.getSlides().get_Item(0).getImage();
        try {
            renderedSlide.save("reopened-effect-chain.png", ImageFormat.Png);
        } finally {
            renderedSlide.dispose();
        }
    } else {
        System.out.println("The reopened shape is not a picture frame.");
    }
} finally {
    reopenedPresentation.dispose();
}

La collection n’impose pas de matrice de compatibilité qui séparerait les opérations de couleur, d’alpha et de flou en chaînes distinctes. Elles peuvent être combinées, mais les combinaisons ne sont pas toujours utiles. Un remplacement de couleur fixe supprime la variation RGB créée par les effets couleur précédents ; le niveau de gris après duo‑tone élimine les deux couleurs sélectionnées ; et les opérations alpha plafond, plancher, remplacement ou bi‑niveau peuvent éliminer les détails alpha créés plus tôt. Construisez la chaîne selon la séquence de traitement des pixels souhaitée plutôt que de traiter ses éléments comme des drapeaux de formatage non ordonnés.

Inspecter les valeurs modifiables et effectives

Une opération modifiable est l’objet stocké dans ISlidesPicture.getImageTransform. Selon l’effet, elle peut exposer directement des membres accessibles en écriture. Par exemple, IBlur expose les valeurs radius et grow modifiables, IAlphaModulateFixed expose un amount modifiable, et IAlphaBiLevel expose un threshold modifiable. Les effets couleur comme IDuotone exposent des objets IColorFormat mutables.

Certaines interfaces d’opération, dont IBrightnessContrast, IHSL, ITint et IAlphaReplace, n’exposent pas leurs scalaires de création en tant que propriétés modifiables. Pour modifier ces réglages, supprimez l’opération et ajoutez-en une de remplacement à la position requise.

Les données effectives renvoyées par getEffective() sont calculées et en lecture seule. Elles sont utiles pour résoudre les couleurs dépendantes d’un thème et lire les valeurs normalisées utilisées par le moteur de rendu, mais ce n’est pas une autre surface d’édition. L’exemple suivant parcourt la chaîne et inspecte les valeurs effectives lorsque l’API correspondante les fournit :

import com.aspose.slides.*;

Presentation presentation = new Presentation("image-transform-chain.pptx");
try {
    IPictureFrame pictureFrame = null;

    for (IShape shape : presentation.getSlides().get_Item(0).getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();

        for (int index = 0; index < imageTransform.size(); index++) {
            IImageTransformOperation operation = imageTransform.get_Item(index);
            System.out.println(index + ": " + operation.getClass().getSimpleName());

            if (operation instanceof IBrightnessContrast) {
                IBrightnessContrastEffectiveData data = ((IBrightnessContrast) operation).getEffective();
                System.out.println("  Brightness: " + data.getBrightness());
                System.out.println("  Contrast: " + data.getContrast());
            } else if (operation instanceof ILuminance) {
                ILuminanceEffectiveData data = ((ILuminance) operation).getEffective();
                System.out.println("  Brightness: " + data.getBrightness());
                System.out.println("  Contrast: " + data.getContrast());
            } else if (operation instanceof IDuotone) {
                IDuotoneEffectiveData data = ((IDuotone) operation).getEffective();
                System.out.println("  Dark color: " + data.getColor1());
                System.out.println("  Light color: " + data.getColor2());
            } else if (operation instanceof IColorReplace) {
                IColorReplaceEffectiveData data = ((IColorReplace) operation).getEffective();
                System.out.println("  Replacement color: " + data.getColor());
            } else if (operation instanceof IHSL) {
                IHSLEffectiveData data = ((IHSL) operation).getEffective();
                System.out.println("  HSL: " + data.getHue() + ", " + data.getSaturation() + ", " + data.getLuminance());
            } else if (operation instanceof ITint) {
                ITintEffectiveData data = ((ITint) operation).getEffective();
                System.out.println("  Tint: " + data.getHue() + ", " + data.getAmount());
            } else if (operation instanceof IBlur) {
                IBlurEffectiveData data = ((IBlur) operation).getEffective();
                System.out.println("  Blur radius: " + data.getRadius() + " pt");
            } else if (operation instanceof IAlphaModulateFixed) {
                IAlphaModulateFixedEffectiveData data = ((IAlphaModulateFixed) operation).getEffective();
                System.out.println("  Alpha amount: " + data.getAmount() + "%");
            } else if (operation instanceof IAlphaReplace) {
                IAlphaReplaceEffectiveData data = ((IAlphaReplace) operation).getEffective();
                System.out.println("  Replacement alpha: " + data.getAlpha() + "%");
            } else if (operation instanceof IAlphaBiLevel) {
                IAlphaBiLevelEffectiveData data = ((IAlphaBiLevel) operation).getEffective();
                System.out.println("  Alpha threshold: " + data.getThreshold() + "%");
            }
        }
    }
} finally {
    presentation.dispose();
}

Les effets sans paramètres comme le niveau de gris, le plafond alpha et l’inverse alpha possèdent également un objet de données effectives, mais il n’y a aucun paramètre scalaire à afficher. Leur présence et leur position dans la collection sont les informations importantes.

Supprimer ou effacer les transformations d’image

Utilisez IImageTransformOperationCollection.removeAt pour supprimer une opération par son indice. Comme les indices se décalent après une suppression, recherchez d’abord la cible puis supprimez‑la après l’énumération. Utilisez ImageTransformOperationCollection.clear pour supprimer l’ensemble de la chaîne.

import com.aspose.slides.*;

Presentation presentation = new Presentation("image-transform-chain.pptx");
try {
    IPictureFrame pictureFrame = null;

    for (IShape shape : presentation.getSlides().get_Item(0).getShapes()) {
        if (shape instanceof IPictureFrame) {
            pictureFrame = (IPictureFrame) shape;
            break;
        }
    }

    if (pictureFrame != null) {
        IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
        int blurIndex = -1;

        for (int index = 0; index < imageTransform.size(); index++) {
            if (imageTransform.get_Item(index) instanceof IBlur) {
                blurIndex = index;
                break;
            }
        }

        if (blurIndex >= 0) {
            imageTransform.removeAt(blurIndex);
            System.out.println("The blur operation was removed.");
        }

        imageTransform.clear();
        System.out.println("Remaining operations: " + imageTransform.size());
        presentation.save("image-transforms-cleared.pptx", SaveFormat.Pptx);
    }
} finally {
    presentation.dispose();
}

Supprimer ou effacer les transformations ne modifie que le formatage de l’image. Cela ne supprime pas, ne recomprime pas et ne modifie pas la ressource IPPImage réutilisée.

Considérer les formats de présentation et les cibles d’exportation

Les transformations d’image proviennent de DrawingML, donc le PPTX est le format éditable privilégié pour les chaînes d’effets. Même avec le PPTX, toutes les opérations ne possèdent pas la même portabilité :

• Les opérations DrawingML standard telles que luminance, niveau de gris, duo‑tone, teinte, HSL, flou et les opérations alpha courantes ont le meilleur pronostic de survie lors d’un aller‑retour PPTX. Ré‑ouvrez toujours le fichier généré et inspectez la collection lorsque la préservation est requise.
• BrightnessContrast est une extension Office 2010 plutôt que l’opération de luminance standard DrawingML. Elle peut être utilisée pour le rendu en mémoire, mais elle n’est pas garantie de rester un IBrightnessContrast modifiable après sauvegarde et réouverture du PPTX. Privilégiez addLuminanceEffect pour des réglages de luminosité et de contraste persistants.
• Le format PPT binaire précède le modèle complet d’effets DrawingML. En enregistrant au format PPT, les opérations non prises en charge peuvent être omises, la chaîne peut être réduite à un sous‑ensemble pris en charge ou le rendu peut être approximé. N’utilisez pas le PPT comme format de vérification pour une chaîne éditable complexe.
• Le rendu vers PNG, JPEG, TIFF, PDF, SVG, HTML ou d’autres sorties visuelles applique la chaîne prise en charge à l’apparence rendue. Ces sorties ne contiennent pas de IImageTransformOperationCollection éditable ; les formats raster aplatissent le résultat en pixels, et les exports document/vecteur stockent leur propre représentation de rendu.
• Les effets ne rendent pas une image liée autonome. Le rendu d’une image liée dépend toujours de la disponibilité de la ressource liée lors du chargement de la présentation.

Différents consommateurs de présentations peuvent rendre les cas limites différemment, surtout lorsque plusieurs opérations alpha ou de quantification de couleur sont combinées. Pour des résultats critiques, testez à la fois le cycle éditable et le format d’export final avec la même version Aspose.Slides utilisée en production.

FAQ

Les effets de transformation d’image modifient-ils les données d’image incorporées ?

Non. Les opérations appartiennent au ISlidesPicture utilisé par le remplissage d’image. Les octets sous‑jacents du IPPImage restent inchangés.

Deux cadres d’image réutilisant la même image partageront‑ils leurs effets ?

Non. Réutiliser un IPPImage évite la duplication des données d’image, mais chaque cadre d’image possède normalement son propre ISlidesPicture et sa propre collection de transformations.

Les effets de couleur, de flou et d’alpha peuvent‑ils être combinés ?

Oui. La collection les accepte dans une chaîne ordonnée. Considérez ce que chaque opération fait à la sortie de la précédente, car les opérations de remplacement et de seuil peuvent éliminer les détails couleur ou alpha créés antérieurement.

Pourquoi les valeurs effectives sont‑elles en lecture seule ?

Les données effectives représentent les valeurs calculées utilisées pour le rendu, y compris les couleurs résolues. Modifiez l’opération stockée dans la collection de transformations là où des membres sont accessibles en écriture ; sinon, supprimez‑la et ajoutez‑en une de remplacement avec de nouveaux paramètres de création.

Quel format dois‑je utiliser pour préserver une chaîne de transformations ?

Utilisez le PPTX et vérifiez le fichier en le réouvrant. Le PPT hérité ne peut pas représenter le modèle complet d’effets DrawingML, et les formats d’exportation rendus conservent uniquement l’apparence, pas les opérations de transformation éditables.