Gestire i fotogrammi nelle presentazioni usando Java

Introduzione

Un fotogramma è una forma che contiene un’immagine—è come un’immagine in una cornice.

Puoi aggiungere un’immagine a una diapositiva tramite un fotogramma. In questo modo, puoi formattare l’immagine formattando il fotogramma.

Tip

Aspose fornisce convertitori gratuiti—JPEG to PowerPoint e PNG to PowerPoint—che consentono di creare presentazioni rapidamente a partire dalle immagini.

Creare un fotogramma

1. Crea un’istanza della classe Presentation.
2. Ottieni un riferimento a una diapositiva tramite il suo indice.
3. Crea un oggetto IPPImage aggiungendo un’immagine alla IImagescollection associata all’oggetto presentazione che verrà utilizzata per riempire la forma.
4. Specifica la larghezza e l’altezza dell’immagine.
5. Crea un PictureFrame basato sulla larghezza e altezza dell’immagine tramite il metodo AddPictureFrame esposto dall’oggetto forma associato alla diapositiva di riferimento.
6. Aggiungi un fotogramma (contenente l’immagine) alla diapositiva.
7. Scrivi la presentazione modificata come file PPTX.

Questo codice Java mostra come creare un fotogramma:

// Instanzia la classe Presentation che rappresenta un file PPTX
Presentation pres = new Presentation();
try {
    // Ottiene la prima diapositiva
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Instanzia la classe Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    // Aggiunge un fotogramma con l'altezza e larghezza equivalenti dell'immagine
    sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Scrive il file PPTX su disco
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

I fotogrammi consentono di creare rapidamente diapositive basate su immagini. Quando combini il fotogramma con le opzioni di salvataggio di Aspose.Slides, puoi manipolare le operazioni di input/output per convertire le immagini da un formato all’altro. Potresti voler vedere queste pagine: converti image to JPG; converti JPG to image; converti JPG to PNG, converti PNG to JPG; converti PNG to SVG, converti SVG to PNG.

Creare un fotogramma con scala relativa

Alterando la scala relativa di un’immagine, puoi creare un fotogramma più complesso.

1. Crea un’istanza della classe Presentation.
2. Ottieni un riferimento a una diapositiva tramite il suo indice.
3. Aggiungi un’immagine alla raccolta di immagini della presentazione.
4. Crea un oggetto IPPImage aggiungendo un’immagine alla IImagescollection associata all’oggetto presentazione che verrà utilizzata per riempire la forma.
5. Specifica la larghezza e l’altezza relative dell’immagine nel fotogramma.
6. Scrivi la presentazione modificata come file PPTX.

Questo codice Java mostra come creare un fotogramma con scala relativa:

// Instanzia la classe Presentation che rappresenta il PPTX
Presentation pres = new Presentation();
try {
    // Ottiene la prima diapositiva
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Instanzia la classe Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    
    // Aggiunge un fotogramma con altezza e larghezza equivalenti dell'immagine
    IPictureFrame pf = sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Imposta la scala relativa in altezza e larghezza
    pf.setRelativeScaleHeight(0.8f);
    pf.setRelativeScaleWidth(1.35f);
    
    // Scrive il file PPTX su disco
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Estrarre immagini raster dai fotogrammi

Puoi estrarre immagini raster dagli oggetti PictureFrame e salvarle in PNG, JPG e altri formati. L’esempio di codice sottostante dimostra come estrarre un’immagine dal documento “sample.pptx” e salvarla in formato 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();
}

Estrarre immagini SVG dai fotogrammi

Quando una presentazione contiene grafiche SVG posizionate all’interno di forme PictureFrame, Aspose.Slides per Java permette di recuperare le immagini vettoriali originali con piena fedeltà. Attraverso l’iterazione della raccolta di forme della diapositiva, è possibile identificare ciascun PictureFrame, verificare se l'IPPImage sottostante contiene contenuto SVG e quindi salvare quell’immagine su disco o in uno stream nel suo formato SVG nativo.

Il seguente esempio di codice dimostra come estrarre un’immagine SVG da un fotogramma:

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();
}

Ottenere la trasparenza di un’immagine

Aspose.Slides consente di ottenere l’effetto trasparenza applicato a un’immagine. Questo codice Java dimostra l’operazione:

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);
    }
}

Ottenere luminosità e contrasto di un’immagine

Aspose.Slides consente di ottenere gli effetti di luminosità e contrasto applicati a un’immagine. L’interfaccia ILuminance rappresenta questo effetto di trasformazione dell’immagine.

Questo codice Java dimostra come ottenere le impostazioni di luminosità e contrasto da un fotogramma:

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

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

    IImageTransformOperationCollection imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
    for (IImageTransformOperation effect : imageTransform) {
        if (effect instanceof ILuminance) {
            ILuminanceEffectiveData luminance = ((ILuminance) effect).getEffective();
            float brightness = luminance.getBrightness();
            float contrast = luminance.getContrast();

            System.out.println("Brightness: " + brightness);
            System.out.println("Contrast: " + contrast);
        }
    }
} finally {
    presentation.dispose();
}

Formattazione del fotogramma

Aspose.Slides fornisce molte opzioni di formattazione che possono essere applicate a un fotogramma. Utilizzando queste opzioni, è possibile modificare un fotogramma per farlo corrispondere a requisiti specifici.

1. Crea un’istanza della classe Presentation.
2. Ottieni un riferimento a una diapositiva tramite il suo indice.
3. Crea un oggetto IPPImage aggiungendo un’immagine alla IImagescollection associata all’oggetto presentazione che verrà utilizzata per riempire la forma.
4. Specifica la larghezza e l’altezza dell’immagine.
5. Crea un PictureFrame basato sulla larghezza e altezza dell’immagine tramite il metodo AddPictureFrame esposto dall’oggetto IShapes associato alla diapositiva di riferimento.
6. Aggiungi il fotogramma (contenente l’immagine) alla diapositiva.
7. Imposta il colore della linea del fotogramma.
8. Imposta lo spessore della linea del fotogramma.
9. Ruota il fotogramma fornendo un valore positivo o negativo.
   • Un valore positivo ruota l’immagine in senso orario.
   • Un valore negativo ruota l’immagine in senso antiorario.
10. Aggiungi nuovamente il fotogramma (contenente l’immagine) alla diapositiva.
11. Scrivi la presentazione modificata come file PPTX.

Questo codice Java dimostra il processo di formattazione del fotogramma:

// Istanzia la classe Presentation che rappresenta il PPTX
Presentation pres = new Presentation();
try {
    // Ottiene la prima diapositiva
    ISlide sld = pres.getSlides().get_Item(0);
    
    // Istanzia la classe Image
    IPPImage imgx = pres.getImages().addImage(new FileInputStream(new File("asp1.jpg")));
    
    // Aggiunge un fotogramma con altezza e larghezza equivalenti dell'immagine
    IPictureFrame pf = sld.getShapes().addPictureFrame(ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    
    // Applica una formattazione al PictureFrameEx
    pf.getLineFormat().getFillFormat().setFillType(FillType.Solid);
    pf.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE);
    pf.getLineFormat().setWidth(20);
    pf.setRotation(45);
    
    // Scrive il file PPTX su disco
    pres.save("RectPicFrame.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Tip

Aspose ha recentemente sviluppato un free Collage Maker. Se hai bisogno di unire JPG/JPEG o immagini PNG, creare griglie da foto, puoi utilizzare questo servizio.

Aggiungere un’immagine come collegamento

Per ridurre le dimensioni delle presentazioni, è possibile aggiungere immagini (o video) tramite collegamenti anziché incorporare i file direttamente nella presentazione. Questo codice Java mostra come aggiungere un’immagine e un video in un segnaposto:

Presentation presentation = new Presentation("input.pptx");
try {
    ArrayList<IShape> shapesToRemove = new ArrayList<IShape>();
    int shapesCount = presentation.getSlides().get_Item(0).getShapes().size();

    for (int i = 0; i < shapesCount; i++)
    {
        IShape autoShape = presentation.getSlides().get_Item(0).getShapes().get_Item(i);

        if (autoShape.getPlaceholder() == null)
        {
            continue;
        }

        switch (autoShape.getPlaceholder().getType())
        {
            case PlaceholderType.Picture:
                IPictureFrame pictureFrame = presentation.getSlides().get_Item(0).getShapes().addPictureFrame(ShapeType.Rectangle,
                        autoShape.getX(), autoShape.getY(), autoShape.getWidth(), autoShape.getHeight(), null);

                pictureFrame.getPictureFormat().getPicture().setLinkPathLong(
                        "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");

                shapesToRemove.add(autoShape);
                break;

            case PlaceholderType.Media:
                IVideoFrame videoFrame = presentation.getSlides().get_Item(0).getShapes().addVideoFrame(
                        autoShape.getX(), autoShape.getY(), autoShape.getWidth(), autoShape.getHeight(), "");

                videoFrame.getPictureFormat().getPicture().setLinkPathLong(
                        "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");

                videoFrame.setLinkPathLong("https://youtu.be/t_1LYZ102RA");

                shapesToRemove.add(autoShape);
                break;
        }
    }

    for (IShape shape : shapesToRemove)
    {
        presentation.getSlides().get_Item(0).getShapes().remove(shape);
    }

    presentation.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Ritagliare le immagini

Questo codice Java mostra come ritagliare un’immagine esistente su una diapositiva:

Presentation pres = new Presentation();
// Crea nuovo oggetto immagine
try {
    IPPImage picture;
    IImage image = Images.fromFile(imagePath);
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Aggiunge un PictureFrame a una diapositiva
    IPictureFrame picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(
            ShapeType.Rectangle, 100, 100, 420, 250, picture);

    // Ritaglia l'immagine (valori percentuali)
    picFrame.getPictureFormat().setCropLeft(23.6f);
    picFrame.getPictureFormat().setCropRight(21.5f);
    picFrame.getPictureFormat().setCropTop(3);
    picFrame.getPictureFormat().setCropBottom(31);

    // Salva il risultato
    pres.save(outPptxFile, SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Eliminare le aree ritagliate di un fotogramma

Se vuoi eliminare le aree ritagliate di un’immagine contenuta in un fotogramma, puoi utilizzare il metodo deletePictureCroppedAreas() . Questo metodo restituisce l’immagine ritagliata o l’immagine originale se il ritaglio non è necessario.

Questo codice Java dimostra l’operazione:

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

    // Ottiene il PictureFrame dalla prima diapositiva
    IPictureFrame picFrame = (IPictureFrame)slide.getShapes().get_Item(0);

    // Elimina le aree ritagliate dell'immagine del PictureFrame e restituisce l'immagine ritagliata
    IPPImage croppedImage = picFrame.getPictureFormat().deletePictureCroppedAreas();

    // Salva il risultato
    presentation.save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

NOTE

Il metodo deletePictureCroppedAreas() aggiunge l’immagine ritagliata alla raccolta di immagini della presentazione. Se l’immagine è utilizzata solo nel PictureFrame elaborato, questa impostazione può ridurre le dimensioni della presentazione. Altrimenti, il numero di immagini nella presentazione risultante aumenterà.

Questo metodo converte i metafili WMF/EMF in immagini raster PNG durante l’operazione di ritaglio.

Comprimere le immagini

Puoi comprimere un’immagine in una presentazione utilizzando il metodo IPictureFillFormat.compressImage . Questo metodo comprime un’immagine riducendone le dimensioni in base alla dimensione della forma e alla risoluzione specificata, con l’opzione di eliminare le aree ritagliate.

Regola le dimensioni e la risoluzione dell’immagine in modo simile alla funzione Picture Format → Compress Pictures → Resolution di PowerPoint.

I seguenti esempi Java dimostrano come comprimere un’immagine in una presentazione specificando una risoluzione target e, facoltativamente, rimuovendo le aree ritagliate:

Presentation presentation = new Presentation("demo.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = (IPictureFrame)slide.getShapes().get_Item(0);

    // Comprimi l'immagine con una risoluzione target di 150 DPI (risoluzione Web) e rimuovi le aree ritagliate.
    boolean result = pictureFrame.getPictureFormat().compressImage(true, PicturesCompression.Dpi150);

    // Verifica il risultato della compressione.
    if (result) {
        System.out.println("Image successfully compressed.");
    } else {
        System.out.println("Image compression failed or no changes were necessary.");
    }

    presentation.save("CompressedImage.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Oppure usando direttamente un valore DPI personalizzato:

Presentation presentation = new Presentation("demo.pptx");
try {
    ISlide slide = presentation.getSlides().get_Item(0);
    IPictureFrame pictureFrame = (IPictureFrame)slide.getShapes().get_Item(0);

    // Comprimi l'immagine a 150 DPI (risoluzione web), rimuovendo le aree ritagliate.
    pictureFrame.getPictureFormat().compressImage(true, 150f);

    presentation.save("CompressedImage.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

NOTE

Il metodo converte l’immagine a una risoluzione inferiore in base alle dimensioni della forma e al DPI fornito. Le regioni ritagliate possono anche essere eliminate per ottimizzare la dimensione del file.
Se l’immagine è un metafile (WMF/EMF) o SVG, la compressione non viene applicata. Inoltre, la qualità JPEG viene conservata o leggermente ridotta in base alla risoluzione, similmente a quanto fa PowerPoint con JPEG ad alta risoluzione.

Bloccare il rapporto d’aspetto

Se desideri che una forma contenente un’immagine mantenga il rapporto d’aspetto anche dopo aver modificato le dimensioni dell’immagine, puoi usare il metodo setAspectRatioLocked per impostare l’opzione Lock Aspect Ratio.

Questo codice Java mostra come bloccare il rapporto d’aspetto di una forma:

Presentation pres = new Presentation("pres.pptx");
try {
    ILayoutSlide layout = pres.getLayoutSlides().getByType(SlideLayoutType.Custom);
    ISlide emptySlide = pres.getSlides().addEmptySlide(layout);
    IPPImage picture;
    IImage image = Images.fromFile("image.png");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }
    IPictureFrame pictureFrame = emptySlide.getShapes().addPictureFrame(
            ShapeType.Rectangle, 50, 150, presImage.getWidth(), presImage.getHeight(), picture);

    // imposta la forma per mantenere il rapporto d'aspetto durante il ridimensionamento
    pictureFrame.getPictureFrameLock().setAspectRatioLocked(true);
} catch(IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

NOTE

Questa impostazione Lock Aspect Ratio preserva solo il rapporto d’aspetto della forma e non quello dell’immagine contenuta.

Utilizzare la proprietà StretchOff

Utilizzando le proprietà StretchOffsetLeft, StretchOffsetTop, StretchOffsetRight e StretchOffsetBottom dell’interfaccia IPictureFillFormat e della classe PictureFillFormat, è possibile specificare un rettangolo di riempimento.

Quando viene specificato lo stretching per un’immagine, un rettangolo sorgente viene scalato per adattarsi al rettangolo di riempimento indicato. Ogni bordo del rettangolo di riempimento è definito da uno spostamento percentuale dal corrispondente bordo della bounding box della forma. Una percentuale positiva indica un’inserzione, mentre una percentuale negativa indica un’espansione.

1. Crea un’istanza della classe Presentation.
2. Ottieni un riferimento a una diapositiva tramite il suo indice.
3. Aggiungi un rettangolo AutoShape.
4. Crea un’immagine.
5. Imposta il tipo di riempimento della forma.
6. Imposta la modalità di riempimento immagine della forma.
7. Aggiungi un’immagine di riempimento alla forma.
8. Specifica gli spostamenti dell’immagine rispetto al bordo corrispondente della bounding box della forma.
9. Scrivi la presentazione modificata come file PPTX.

Questo codice Java dimostra un processo in cui viene utilizzata la proprietà StretchOff:

// Istanzia la classe Presentation che rappresenta un file PPTX
Presentation pres = new Presentation();
try {
    // Ottiene la prima diapositiva
    ISlide slide = pres.getSlides().get_Item(0);

    // Istanzia la classe ImageEx
    IPPImage picture;
    IImage image = Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) image.dispose();
    }

    // Aggiunge un AutoShape impostato su Rettangolo
    IAutoShape aShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 300, 300);

    // Imposta il tipo di riempimento della forma
    aShape.getFillFormat().setFillType(FillType.Picture);

    // Imposta la modalità di riempimento immagine della forma
    aShape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);

    // Imposta l'immagine per riempire la forma
    aShape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);

    // Specifica gli offset dell'immagine rispetto al bordo corrispondente della bounding box della forma
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetLeft(25);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetRight(25);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetTop(-20);
    aShape.getFillFormat().getPictureFillFormat().setStretchOffsetBottom(-10);
    
    //Scrive il file PPTX su disco
    pres.save("StretchOffsetLeftForPictureFrame_out.pptx", SaveFormat.Pptx);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

FAQ

Come posso scoprire quali formati immagine sono supportati per PictureFrame?

Aspose.Slides supporta sia immagini raster (PNG, JPEG, BMP, GIF, ecc.) sia immagini vettoriali (ad esempio SVG) tramite l’oggetto immagine assegnato a un PictureFrame. L’elenco dei formati supportati si sovrappone generalmente alle capacità del motore di conversione diapositive e immagini.

Come influisce l’aggiunta di decine di immagini di grandi dimensioni sulle dimensioni e sulle prestazioni del PPTX?

Incorporare immagini grandi aumenta la dimensione del file e l’uso di memoria; collegare le immagini aiuta a mantenere ridotte le dimensioni della presentazione ma richiede che i file esterni rimangano accessibili. Aspose.Slides offre la possibilità di aggiungere immagini tramite collegamento per ridurre la dimensione del file.

Come posso bloccare un oggetto immagine per impedirne spostamenti o ridimensionamenti accidentali?

Utilizza i shape locks per un PictureFrame (ad esempio, disabilitare lo spostamento o il ridimensionamento). Il meccanismo di blocco è descritto per le forme in un articolo sulla protezione separato ed è supportato per vari tipi di forma, inclusi i PictureFrame.

La fedeltà vettoriale SVG è preservata quando si esporta una presentazione in PDF/immagini?

Aspose.Slides consente di estrarre un SVG da un PictureFrame come vettore originale. Quando si esporta in PDF o in formati raster, il risultato può essere rasterizzato a seconda delle impostazioni di esportazione; il fatto che l’SVG originale sia memorizzato come vettore è confermato dal comportamento di estrazione.