Gérer les cadres d’image dans les présentations avec Java

Introduction

Un cadre d’image est une forme qui contient une image — c’est comme une photo dans un cadre.

Vous pouvez ajouter une image à une diapositive via un cadre d’image. Ainsi, vous formatez l’image en formatant le cadre d’image.

Conseil

Aspose propose des convertisseurs gratuits — JPEG to PowerPoint et PNG to PowerPoint — qui permettent de créer rapidement des présentations à partir d’images.

Créer un cadre d’image

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive via son indice.
Créez un objet IPPImage en ajoutant une image à la IImagescollection associée à l’objet de présentation qui sera utilisé pour remplir la forme.
Précisez la largeur et la hauteur de l’image.
Créez un PictureFrame à partir de la largeur et de la hauteur de l’image via la méthode AddPictureFrame exposée par l’objet shape associé à la diapositive référencée.
Ajoutez un cadre d’image (contenant l’image) à la diapositive.
Enregistrez la présentation modifiée sous forme de fichier PPTX.

Ce code Java montre comment créer un cadre d’image :

// Instancie la classe Presentation qui représente un fichier PPTX
Presentation pres = new Presentation();
try {
    // Obtient la première diapositive
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Instancie la classe Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    // Ajoute un cadre d’image avec la même hauteur et largeur que l’image
    sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Enregistre le fichier PPTX sur le disque
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Les cadres d’image vous permettent de créer rapidement des diapositives de présentation à partir d’images. Lorsque vous combinez le cadre d’image avec les options d’enregistrement Aspose.Slides, vous pouvez manipuler les opérations d’entrée/sortie pour convertir des images d’un format à un autre. Vous pouvez consulter ces pages : convertir image to JPG ; convertir JPG to image ; convertir JPG to PNG, convertir PNG to JPG ; convertir PNG to SVG, convertir SVG to PNG.

Créer un cadre d’image avec mise à l’échelle relative

En modifiant la mise à l’échelle relative d’une image, vous pouvez créer un cadre d’image plus complexe.

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive via son indice.
Ajoutez une image à la collection d’images de la présentation.
Créez un objet IPPImage en ajoutant une image à la IImagescollection associée à l’objet de présentation qui sera utilisé pour remplir la forme.
Précisez la largeur et la hauteur relatives de l’image dans le cadre d’image.
Enregistrez la présentation modifiée sous forme de fichier PPTX.

Ce code Java montre comment créer un cadre d’image avec mise à l’échelle relative :

// Instancie la classe Presentation qui représente le PPTX
Presentation pres = new Presentation();
try {
    // Obtient la première diapositive
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Instancie la classe Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    
    // Ajoute un cadre d’image avec la hauteur et la largeur équivalentes à l’image
    IPictureFrame pf = sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Définit la mise à l’échelle relative en largeur et hauteur
    pf.setRelativeScaleHeight(0.8f);
    pf.setRelativeScaleWidth(1.35f);
    
    // Enregistre le fichier PPTX sur le disque
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Extraire des images raster à partir de cadres d’image

Vous pouvez extraire des images raster à partir d’objets PictureFrame et les enregistrer en PNG, JPG et d’autres formats. L’exemple de code ci‑dessous montre comment extraire une image du document « sample.pptx » et l’enregistrer au format PNG.

Presentation presentation = new Presentation("sample.pptx");

try {
    ISlide firstSlide = presentation.getSlides().get_Item(0);
    IShape firstShape = firstSlide.getShapes().get_Item(0);

    if (firstShape instanceof IPictureFrame) {
        IPictureFrame pictureFrame = (IPictureFrame) firstShape;
        try {
			IImage slideImage = pictureFrame.getPictureFormat().getPicture().getImage().getImage();
			slideImage.save("slide_1_shape_1.png", ImageFormat.Png);
		} finally {
			if (slideImage != null) slideImage.dispose();
		}
    }
} catch (IOException e) {
} finally {
    presentation.dispose();
}

Extraire des images SVG à partir de cadres d’image

Lorsqu’une présentation contient des graphiques SVG placés à l’intérieur de formes PictureFrame, Aspose.Slides for Java vous permet de récupérer les images vectorielles originales avec une fidélité totale. En parcourant la collection de formes de la diapositive, vous pouvez identifier chaque PictureFrame, vérifier si l’IPPImage sous‑jacente contient du contenu SVG, puis enregistrer cette image sur disque ou dans un flux au format SVG natif.

L’exemple de code suivant montre comment extraire une image SVG d’un cadre d’image :

Presentation presentation = new Presentation("sample.pptx");

try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IShape shape = slide.getShapes().get_Item(0);

    if (shape instanceof IPictureFrame) {
        IPictureFrame pictureFrame = (IPictureFrame) shape;
        ISvgImage svgImage = pictureFrame.getPictureFormat().getPicture().getImage().getSvgImage();

        FileOutputStream fos = new FileOutputStream("output.svg");
        fos.write(svgImage.getSvgData());
        fos.close();
    }
} catch (IOException e) {
    System.out.println(e.getMessage());
} finally {
    presentation.dispose();
}

Obtenir la transparence d’une image

Aspose.Slides vous permet d’obtenir l’effet de transparence appliqué à une image. Ce code Java montre l’opération :

Presentation presentation = new Presentation("Test.pptx");

var pictureFrame = (IPictureFrame) presentation.getSlides().get_Item(0).getShapes().get_Item(0);
var imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
for (var effect : imageTransform) {
    if (effect instanceof IAlphaModulateFixed) {
        var alphaModulateFixed = (IAlphaModulateFixed) effect;
        var transparencyValue = 100 - alphaModulateFixed.getAmount();
        System.out.println("Picture transparency: " + transparencyValue);
    }
}

Mise en forme d’un cadre d’image

Aspose.Slides propose de nombreuses options de mise en forme pouvant être appliquées à un cadre d’image. En utilisant ces options, vous pouvez modifier un cadre d’image pour qu’il corresponde à des exigences spécifiques.

Créez une instance de la classe Presentation.
Obtenez la référence d’une diapositive via son indice.
Créez un objet IPPImage en ajoutant une image à la IImagescollection associée à l’objet de présentation qui sera utilisé pour remplir la forme.
Précisez la largeur et la hauteur de l’image.
Créez un PictureFrame à partir de la largeur et de la hauteur de l’image via la méthode AddPictureFrame exposée par l’objet IShapes associé à la diapositive référencée.
Ajoutez le cadre d’image (contenant l’image) à la diapositive.
Définissez la couleur du contour du cadre d’image. 8