Gestisci i Frame Immagine nelle Presentazioni usando JavaScript

Introduzione

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

Puoi aggiungere un’immagine a una diapositiva tramite un frame immagine. In questo modo, formatti l’immagine formattando il frame immagine.

Tip

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

Crea Frame Immagine

Crea un’istanza della classe Presentation.
Ottieni un riferimento a una diapositiva tramite il suo indice.
Crea un oggetto PPImage aggiungendo un’immagine alla ImagesCollection associata all’oggetto presentazione che verrà usato per riempire la forma.
Specifica la larghezza e l’altezza dell’immagine.
Crea un PictureFrame basato sulla larghezza e altezza dell’immagine tramite il metodo addPictureFrame esposto dall’oggetto forma associato alla diapositiva di riferimento.
Aggiungi un frame immagine (contenente l’immagine) alla diapositiva.
Scrivi la presentazione modificata in un file PPTX.

Questo codice JavaScript mostra come creare un frame immagine:

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

I frame immagine ti consentono di creare rapidamente diapositive basate su immagini. Quando combini il frame immagine con le opzioni di salvataggio di Aspose.Slides, puoi manipolare le operazioni di input/output per convertire le immagini da un formato all’altro.

Crea Frame Immagine con Scala Relativa

Crea un’istanza della classe Presentation.
Ottieni un riferimento a una diapositiva tramite il suo indice.
Aggiungi un’immagine alla collezione di immagini della presentazione.
Crea un oggetto PPImage aggiungendo un’immagine alla ImagesCollection associata all’oggetto presentazione che verrà usato per riempire la forma.
Specifica la larghezza e l’altezza relative dell’immagine nel frame immagine.
Scrivi la presentazione modificata in un file PPTX.

Questo codice JavaScript mostra come creare un frame immagine con scala relativa:

// Istanzia la classe Presentation che rappresenta il PPTX
var pres = new aspose.slides.Presentation();
try {
    // Ottieni la prima diapositiva
    var sld = pres.getSlides().get_Item(0);
    // Istanzia la classe Image
    var imgx = pres.getImages().addImage(java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "asp1.jpg")));
    // Aggiungi un Frame Immagine con altezza e larghezza equivalenti dell'Immagine
    var pf = sld.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    // Imposta larghezza e altezza di scala relativa
    pf.setRelativeScaleHeight(0.8);
    pf.setRelativeScaleWidth(1.35);
    // Scrivi il file PPTX su disco
    pres.save("RectPicFrame.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Estrai Immagini Raster da Frame Immagine

Puoi estrarre immagini raster da oggetti PictureFrame e salvarle in PNG, JPG e altri formati. L’esempio di codice seguente dimostra come estrarre un’immagine dal documento “sample.pptx” e salvarla in formato PNG.

var presentation = new aspose.slides.Presentation("sample.pptx");
try {
    var firstSlide = presentation.getSlides().get_Item(0);
    var firstShape = firstSlide.getShapes().get_Item(0);
    if (java.instanceOf(firstShape, "com.aspose.slides.IPictureFrame")) {
        var pictureFrame = firstShape;
        try {
            var slideImage = pictureFrame.getPictureFormat().getPicture().getImage().getImage();
            slideImage.save("slide_1_shape_1.png", aspose.slides.ImageFormat.Png);
        } finally {
            if (slideImage != null) {
                slideImage.dispose();
            }
        }
    }
} catch (e) {console.log(e);
} finally {
    presentation.dispose();
}

Estrai Immagini SVG da Frame Immagine

Quando una presentazione contiene grafica SVG inserita all’interno di forme PictureFrame, Aspose.Slides per Node.js tramite Java consente di recuperare le immagini vettoriali originali con completa fedeltà. Scorrendo la collezione di forme della diapositiva, è possibile identificare ogni PictureFrame, verificare se il relativo PPImage 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 frame immagine:

var presentation = new aspose.slides.Presentation("sample.pptx");

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

    if (java.instanceOf(shape, "com.aspose.slides.IPictureFrame")) {
        const svgImage = shape.getPictureFormat().getPicture().getImage().getSvgImage();

        if (svgImage) {
            fs.writeFileSync("output.svg", svgImage.getSvgData());
        }
    }
} catch (e) {
    console.log(e);
} finally {
    presentation.dispose();
}

Ottieni Trasparenza dell’Immagine

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

var presentation = new aspose.slides.Presentation("Test.pptx");
var pictureFrame = presentation.getSlides().get_Item(0).getShapes().get_Item(0);
var imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
for (var i = 0; i < imageTransform.size(); i++) {
    var effect = imageTransform.get_Item(i);
    if (java.instanceOf(effect, "com.aspose.slides.IAlphaModulateFixed")) {
        var alphaModulateFixed = effect;
        var transparencyValue = 100 - alphaModulateFixed.getAmount();
        console.log("Picture transparency: " + transparencyValue);
    }
}

Ottieni Luminosità e Contrasto di un’Immagine

Aspose.Slides consente di ottenere l’effetto di luminosità e contrasto applicato a un’immagine. La classe Luminance rappresenta questo effetto di trasformazione dell’immagine.

Questo codice JavaScript dimostra come ottenere le impostazioni di luminosità e contrasto da un frame immagine:

const presentation = new aspose.slides.Presentation("sample.pptx");

try {
    const slide = presentation.getSlides().get_Item(0);
    const shape = slide.getShapes().get_Item(0);
    const pictureFrame = shape;

    const imageTransform = pictureFrame.getPictureFormat().getPicture().getImageTransform();
    for (let i = 0; i < imageTransform.size(); i++) {
        const effect = imageTransform.get_Item(i);
        if (java.instanceOf(effect, "com.aspose.slides.Luminance")) {
            const luminance = effect.getEffective();
            const brightness = luminance.getBrightness();
            const contrast = luminance.getContrast();

            console.log("Brightness: " + brightness);
            console.log("Contrast: " + contrast);
        }
    }
} finally {
    presentation.dispose();
}

Formattazione del Frame Immagine

Aspose.Slides offre molte opzioni di formattazione che possono essere applicate a un frame immagine. Utilizzando queste opzioni, è possibile modificare un frame immagine per soddisfare requisiti specifici.

Crea un’istanza della classe Presentation.
Ottieni un riferimento a una diapositiva tramite il suo indice.
Crea un oggetto PPImage aggiungendo un’immagine alla ImagesCollection associata all’oggetto presentazione che verrà usato per riempire la forma.
Specifica la larghezza e l’altezza dell’immagine.
Crea un PictureFrame basato sulla larghezza e altezza dell’immagine tramite il metodo addPictureFrame esposto dall’oggetto Shapes associato alla diapositiva di riferimento.
Aggiungi il frame immagine (contenente l’immagine) alla diapositiva.
Imposta il colore del bordo del frame immagine.
Imposta lo spessore del bordo del frame immagine.
Ruota il frame immagine fornendogli un valore positivo o negativo.
- Un valore positivo ruota l’immagine in senso orario.
- Un valore negativo ruota l’immagine in senso antiorario.
Aggiungi il frame immagine (contenente l’immagine) alla diapositiva.
Scrivi la presentazione modificata in un file PPTX.

Questo codice JavaScript dimostra il processo di formattazione del frame immagine:

// Istanzia la classe Presentation che rappresenta il PPTX
var pres = new aspose.slides.Presentation();
try {
    // Ottiene la prima diapositiva
    var sld = pres.getSlides().get_Item(0);
    // Istanzia la classe Image
    var imgx = pres.getImages().addImage(java.newInstanceSync("java.io.FileInputStream", java.newInstanceSync("java.io.File", "asp1.jpg")));
    // Aggiunge un Frame Immagine con altezza e larghezza equivalenti dell'Immagine
    var pf = sld.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 150, imgx.getWidth(), imgx.getHeight(), imgx);
    // Applica alcune formattazioni a PictureFrameEx
    pf.getLineFormat().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    pf.getLineFormat().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    pf.getLineFormat().setWidth(20);
    pf.setRotation(45);
    // Scrive il file PPTX su disco
    pres.save("RectPicFrame.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Tip

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

Aggiungi Immagine come Link

Per evitare presentazioni di grandi dimensioni, puoi aggiungere immagini (o video) tramite link anziché incorporare i file direttamente nelle presentazioni. Questo codice JavaScript mostra come aggiungere un’immagine e un video in un segnaposto:

var presentation = new aspose.slides.Presentation("input.pptx");
try {
    var shapesToRemove = java.newInstanceSync("java.util.ArrayList");
    var shapesCount = presentation.getSlides().get_Item(0).getShapes().size();
    for (var i = 0; i < shapesCount; i++) {
        var autoShape = presentation.getSlides().get_Item(0).getShapes().get_Item(i);
        if (autoShape.getPlaceholder() == null) {
            continue;
        }
        switch (autoShape.getPlaceholder().getType()) {
            case aspose.slides.PlaceholderType.Picture :
                var pictureFrame = presentation.getSlides().get_Item(0).getShapes().addPictureFrame(aspose.slides.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 aspose.slides.PlaceholderType.Media :
                var 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 (var i = 0; i < shapesToRemove.length; i++) {
        var shape = shapesToRemove.get_Item(i);
        presentation.getSlides().get_Item(0).getShapes().remove(shape);
    }
    presentation.save("output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

Ritaglia Immagine

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

var pres = new aspose.slides.Presentation();
// Crea un nuovo oggetto immagine
try {
    var picture;
    var image = aspose.slides.Images.fromFile(imagePath);
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) {
            image.dispose();
        }
    }
    // Aggiunge un PictureFrame a una diapositiva
    var picFrame = pres.getSlides().get_Item(0).getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 100, 100, 420, 250, picture);
    // Ritaglia l'immagine (valori percentuali)
    picFrame.getPictureFormat().setCropLeft(23.6);
    picFrame.getPictureFormat().setCropRight(21.5);
    picFrame.getPictureFormat().setCropTop(3);
    picFrame.getPictureFormat().setCropBottom(31);
    // Salva il risultato
    pres.save(outPptxFile, aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Elimina Aree Ritagliate dell’Immagine

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

Questo codice JavaScript dimostra l’operazione:

var presentation = new aspose.slides.Presentation("PictureFrameCrop.pptx");
try {
    var slide = presentation.getSlides().get_Item(0);
    // Ottiene il PictureFrame dalla prima diapositiva
    var picFrame = slide.getShapes().get_Item(0);
    // Elimina le aree ritagliate dell'immagine del PictureFrame e restituisce l'immagine ritagliata
    var croppedImage = picFrame.getPictureFormat().deletePictureCroppedAreas();
    // Salva il risultato
    presentation.save("PictureFrameDeleteCroppedAreas.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (presentation != null) {
        presentation.dispose();
    }
}

NOTE

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

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

Comprimi Immagini

Puoi comprimere un’immagine in una presentazione usando il metodo PictureFillFormat.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 la dimensione e la risoluzione dell’immagine in modo simile alla funzione di PowerPoint Formato Immagine → Comprimi immagini → Risoluzione.

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

const presentation = new aspose.slides.Presentation("demo.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const pictureFrame = slide.getShapes().get_Item(0);

    // Comprimi l'immagine con una risoluzione target di 150 DPI (risoluzione Web) ed elimina le aree ritagliate.
    const result = pictureFrame.getPictureFormat().compressImage(true, aspose.slides.PicturesCompression.Dpi150);

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

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

Oppure utilizzando un altro valore DPI predefinito:

const presentation = new aspose.slides.Presentation("demo.pptx");
try {
    const slide = presentation.getSlides().get_Item(0);
    const pictureFrame = slide.getShapes().get_Item(0);

    // Comprimi l'immagine a 96 DPI (risoluzione email), rimuovendo le aree ritagliate.
    pictureFrame.getPictureFormat().compressImage(true, aspose.slides.PicturesCompression.Dpi96);

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

NOTE

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

Blocca 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 utilizzare il metodo setAspectRatioLocked per impostare l’opzione Lock Aspect Ratio.

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

var pres = new aspose.slides.Presentation("pres.pptx");
try {
    var layout = pres.getLayoutSlides().getByType(aspose.slides.SlideLayoutType.Custom);
    var emptySlide = pres.getSlides().addEmptySlide(layout);
    var picture;
    var image = aspose.slides.Images.fromFile("image.png");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) {
            image.dispose();
        }
    }
    var pictureFrame = emptySlide.getShapes().addPictureFrame(aspose.slides.ShapeType.Rectangle, 50, 150, presImage.getWidth(), presImage.getHeight(), picture);
    // imposta la forma per conservare il rapporto d'aspetto durante il ridimensionamento
    pictureFrame.getPictureFrameLock().setAspectRatioLocked(true);
} catch (e) {console.log(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.

Utilizza la Proprietà StretchOff

Usando i metodi setStretchOffsetLeft, setStretchOffsetTop, setStretchOffsetRight e setStretchOffsetBottom della classe PictureFillFormat, è possibile specificare un rettangolo di riempimento.

Quando è specificata l’allungamento per un’immagine, un rettangolo sorgente viene scalato per adattarsi al rettangolo di riempimento specificato. Cada lato del rettangolo di riempimento è definito da uno spostamento percentuale rispetto al corrispondente lato del riquadro delimitante della forma. Una percentuale positiva indica un inset, mentre una percentuale negativa indica un outset.

Crea un’istanza della classe Presentation.
Ottieni un riferimento a una diapositiva tramite il suo indice.
Aggiungi un rettangolo AutoShape.
Crea un’immagine.
Imposta il tipo di riempimento della forma.
Imposta la modalità di riempimento immagine della forma.
Aggiungi un’immagine impostata per riempire la forma.
Specifica gli offset dell’immagine rispetto al corrispondente lato del riquadro delimitante della forma
Scrivi la presentazione modificata in un file PPTX.

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

// Instanzia la classe Presentation che rappresenta un file PPTX
var pres = new aspose.slides.Presentation();
try {
    // Ottiene la prima diapositiva
    var slide = pres.getSlides().get_Item(0);
    // Instanzia la classe ImageEx
    var picture;
    var image = aspose.slides.Images.fromFile("aspose-logo.jpg");
    try {
        picture = pres.getImages().addImage(image);
    } finally {
        if (image != null) {
            image.dispose();
        }
    }
    // Aggiunge un AutoShape impostato a Rectangle
    var aShape = slide.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 100, 100, 300, 300);
    // Imposta il tipo di riempimento della forma
    aShape.getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Picture));
    // Imposta la modalità di riempimento immagine della forma
    aShape.getFillFormat().getPictureFillFormat().setPictureFillMode(aspose.slides.PictureFillMode.Stretch);
    // Imposta l'immagine per riempire la forma
    aShape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture);
    // Specifica gli offset dell'immagine rispetto al corrispondente bordo del riquadro 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", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(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 generalmente si sovrappone alle capacità del motore di conversione slide e immagini.

Qual è l’impatto dell’aggiunta di decine di immagini grandi sulle dimensioni e sulle prestazioni del PPTX?

Incapsulare immagini grandi aumenta le dimensioni del file e l’uso della 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 link per ridurre le dimensioni del file.

Come posso bloccare un oggetto immagine per evitare spostamenti/ridimensionamenti accidentali?

Utilizza i blocco forme per un PictureFrame (ad esempio per disabilitare lo spostamento o il ridimensionamento). Il meccanismo di blocco è supportato per vari tipi di forma, incluso PictureFrame.

La fedeltà vettoriale SVG viene 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 conservato come vettore è confermato dal comportamento di estrazione.