Gestire i frame immagine nelle presentazioni in .NET

Introduzione

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

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

Suggerimento

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

Crea un Picture Frame

1. Crea un’istanza della classe Presentation.
2. Ottieni il riferimento di una diapositiva tramite il suo indice.
3. Crea un oggetto IPPImage aggiungendo un’immagine alla IImagescollection associata all’oggetto presentation che sarà usato 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 shape associato alla diapositiva di riferimento.
6. Aggiungi un picture frame (contenente l’immagine) alla diapositiva.
7. Scrivi la presentazione modificata in un file PPTX.

Questo codice C# mostra come creare un picture frame:

// Istanzia la classe Presentation che rappresenta un file PPTX
using (Presentation pres = new Presentation())
{
    // Ottiene la prima diapositiva
    ISlide slide = pres.Slides[0];

    // Carica un'immagine e la aggiunge alla collezione di immagini della presentazione
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = pres.Images.AddImage(image);
    image.Dispose();

    // Aggiunge un picture frame con la stessa altezza e larghezza
    IPictureFrame pictureFrame = slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, ppImage.Width, ppImage.Height, ppImage);

    // Applica alcune formattazioni al picture frame
    pictureFrame.LineFormat.FillFormat.FillType = FillType.Solid;
    pictureFrame.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pictureFrame.LineFormat.Width = 20;
    pictureFrame.Rotation = 45;

    // Scrive la presentazione in un file PPTX
    pres.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

I picture frame consentono di creare rapidamente diapositive di presentazione basate su immagini. Quando combini il picture frame 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: convert image to JPG; convert JPG to image; convert JPG to PNG, convert PNG to JPG; convert PNG to SVG, convert SVG to PNG.

Crea un Picture Frame con Scala Relativa

Modificando la scala relativa di un’immagine, puoi creare un picture frame più complesso.

1. Crea un’istanza della classe Presentation.
2. Ottieni il riferimento di una diapositiva tramite il suo indice.
3. Aggiungi un’immagine alla collezione di immagini della presentazione.
4. Crea un oggetto IPPImage aggiungendo un’immagine alla IImagescollection associata all’oggetto presentation che sarà usato per riempire la forma.
5. Specifica la larghezza e altezza relative dell’immagine nel picture frame.
6. Scrivi la presentazione modificata in un file PPTX.

Questo codice C# mostra come creare un picture frame con scala relativa:

// Instanzia la classe Presentation che rappresenta un file PPTX
using (Presentation presentation = new Presentation())
{
    // Carica un'immagine e la aggiunge alla collezione di immagini della presentazione
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = presentation.Images.AddImage(image);
    image.Dispose();

    // Aggiunge un picture frame alla diapositiva
    IPictureFrame pictureFrame = presentation.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, ppImage);

    // Imposta la larghezza e l'altezza della scala relativa
    pictureFrame.RelativeScaleHeight = 0.8f;
    pictureFrame.RelativeScaleWidth = 1.35f;

    // Salva la presentazione
    presentation.Save("Adding Picture Frame with Relative Scale_out.pptx", SaveFormat.Pptx);
}

Estrai Immagini Raster da Picture Frames

Puoi estrarre immagini raster da 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.

using (var presentation = new Presentation("sample.pptx"))
{
    var firstSlide = presentation.Slides[0];
    var firstShape = firstSlide.Shapes[0];

    if (firstShape is IPictureFrame pictureFrame)
    {
        var image = pictureFrame.PictureFormat.Picture.Image.SystemImage;
        image.Save("slide_1_shape_1.png", ImageFormat.Png);
    }
}

Estrai Immagini SVG da Picture Frames

Quando una presentazione contiene grafica SVG inserita all’interno di forme PictureFrame, Aspose.Slides per .NET consente di recuperare le immagini vettoriali originali con piena fedeltà. Attraverso l’analisi della collezione di forme della diapositiva, è possibile identificare ogni 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 picture frame:

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

var slide = presentation.Slides[0];
var shape = slide.Shapes[0];

if (shape is IPictureFrame pictureFrame)
{
    var svgImage = pictureFrame.PictureFormat.Picture.Image.SvgImage;
    if (svgImage != null)
    {
        File.WriteAllText("output.svg", svgImage.SvgContent);
    }
}

Ottieni la Trasparenza di un’Immagine

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

using (var presentation = new Presentation("Test.pptx"))
{
    var pictureFrame = (IPictureFrame)presentation.Slides[0].Shapes[0];
    var imageTransform = pictureFrame.PictureFormat.Picture.ImageTransform;
    foreach (var effect in imageTransform)
    {
        if (effect is IAlphaModulateFixed alphaModulateFixed)
        {
            var transparencyValue = 100 - alphaModulateFixed.Amount;
            Console.WriteLine("Picture transparency: " + transparencyValue);
        }
    }
}

Ottieni 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 C# dimostra come ottenere le impostazioni di luminosità e contrasto da un picture frame:

using (var presentation = new Presentation("sample.pptx"))
{
    var slide = presentation.Slides[0];
    var shape = slide.Shapes[0];
    var pictureFrame = (IPictureFrame)shape;

    var imageTransform = pictureFrame.PictureFormat.Picture.ImageTransform;
    foreach (var effect in imageTransform)
    {
        if (effect is ILuminance luminanceEffect)
        {
            var luminance = luminanceEffect.GetEffective();
            var brightness = luminance.Brightness;
            var contrast = luminance.Contrast;

            Console.WriteLine("Brightness: " + brightness);
            Console.WriteLine("Contrast: " + contrast);
        }
    }
}

Tutti gli effetti applicati alle immagini sono disponibili in Aspose.Slides.Effects.

Formattazione del Picture Frame

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

1. Crea un’istanza della classe Presentation.
2. Ottieni il riferimento di una diapositiva tramite il suo indice.
3. Crea un oggetto IPPImage aggiungendo un’immagine alla IImagescollection associata all’oggetto presentation che sarà usato 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 picture frame (contenente l’immagine) alla diapositiva.
7. Imposta il colore della linea del picture frame.
8. Imposta la larghezza della linea del picture frame.
9. Ruota il picture frame 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 picture frame (contenente l’immagine) alla diapositiva.
11. Scrivi la presentazione modificata in un file PPTX.

Questo codice C# dimostra il processo di formattazione del picture frame:

// Instanzia la classe Presentation che rappresenta un file PPTX
using (Presentation presentation = new Presentation())
{
    // Ottiene la prima diapositiva
    ISlide slide = presentation.Slides[0];

    // Carica un'immagine e la aggiunge alla collezione di immagini della presentazione
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = presentation.Images.AddImage(image);
    image.Dispose();

    // Aggiunge un picture frame con l'altezza e la larghezza equivalenti dell'immagine
    IPictureFrame pictureFrame = slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, ppImage.Width, ppImage.Height, ppImage);

    // Applica alcune formattazioni al picture frame
    pictureFrame.LineFormat.FillFormat.FillType = FillType.Solid;
    pictureFrame.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pictureFrame.LineFormat.Width = 20;
    pictureFrame.Rotation = 45;

    // Scrive la presentazione in un file PPTX
    presentation.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

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

Aggiungi un’Immagine come Link

Per ridurre le dimensioni di una presentazione, puoi aggiungere immagini (o video) tramite link invece di incorporare i file direttamente. Questo codice C# mostra come aggiungere un’immagine e un video in un placeholder:

using (var presentation = new Presentation("input.pptx"))
{
    var shapesToRemove = new List<IShape>();
    int shapesCount = presentation.Slides[0].Shapes.Count;

    for (var i = 0; i < shapesCount; i++)
    {
        var autoShape = presentation.Slides[0].Shapes[i];

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

        switch (autoShape.Placeholder.Type)
        {
            case PlaceholderType.Picture:
                var pictureFrame = presentation.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle,
                        autoShape.X, autoShape.Y, autoShape.Width, autoShape.Height, null);

                pictureFrame.PictureFormat.Picture.LinkPathLong =
                    "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:
                var videoFrame = presentation.Slides[0].Shapes.AddVideoFrame(
                    autoShape.X, autoShape.Y, autoShape.Width, autoShape.Height, "");

                videoFrame.PictureFormat.Picture.LinkPathLong =
                    "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg";

                videoFrame.LinkPathLong = "https://youtu.be/t_1LYZ102RA";

                shapesToRemove.Add(autoShape);
                break;
        }
    }

    foreach (var shape in shapesToRemove)
    {
        presentation.Slides[0].Shapes.Remove(shape);
    }

    presentation.Save("output.pptx", SaveFormat.Pptx);
}

Ritaglia Immagini

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

using (Presentation presentation = new Presentation())
{
    // Crea un nuovo oggetto immagine
    IImage image = Images.FromFile(imagePath);
    IPPImage newImage = presentation.Images.AddImage(image);
    image.Dispose();

    // Aggiunge un PictureFrame a una diapositiva
    IPictureFrame picFrame = presentation.Slides[0].Shapes.AddPictureFrame(
        ShapeType.Rectangle, 100, 100, 420, 250, newImage);

    // Ritaglia l'immagine (valori percentuali)
    picFrame.PictureFormat.CropLeft = 23.6f;
    picFrame.PictureFormat.CropRight = 21.5f;
    picFrame.PictureFormat.CropTop = 3;
    picFrame.PictureFormat.CropBottom = 31;

    // Salva il risultato
    presentation.Save("PictureFrameCrop.pptx", SaveFormat.Pptx);
}

Elimina le Aree Ritagliate di un’Immagine

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

Questo codice C# dimostra l’operazione:

using (Presentation presentation = new Presentation("PictureFrameCrop.pptx"))
{
    ISlide slide = presentation.Slides[0];

    // Recupera il PictureFrame dalla prima diapositiva
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

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

    // Salva il risultato
    presentation.Save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat.Pptx);
}

NOTA

Il metodo IPictureFillFormat.DeletePictureCroppedAreas aggiunge l’immagine ritagliata alla collezione 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 metafili WMF/EMF in immagini PNG raster durante l’operazione di ritaglio.

Comprimi Immagini

Puoi comprimere un’immagine in una presentazione usando 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 la dimensione e la risoluzione dell’immagine in modo simile alla funzionalità di PowerPoint Picture Format → Compress Pictures → Resolution.

I seguenti esempi C# dimostrano come comprimere un’immagine in una presentazione specificando una risoluzione di destinazione e, facoltativamente, rimuovendo le aree ritagliate:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame pictureFrame = slide.Shapes[0] as IPictureFrame;

    // Comprimi l'immagine con una risoluzione target di 150 DPI (risoluzione web) e rimuovi le aree ritagliate.
    bool result = pictureFrame.PictureFormat.CompressImage(true, PicturesCompression.Dpi150);

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

    presentation.Save("CompressedImage.pptx", SaveFormat.Pptx);
}

Oppure usando direttamente un valore DPI personalizzato:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    ISlide slide = presentation.Slides[0];
    IPictureFrame pictureFrame = slide.Shapes[0] as IPictureFrame;

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

    presentation.Save("CompressedImage.pptx", SaveFormat.Pptx);
}

NOTA

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 verrà applicata. Inoltre, la qualità JPEG viene conservata o leggermente ridotta in base alla risoluzione, analogamente a quanto fa PowerPoint con JPEG ad alta risoluzione.

Blocca Rapporto d’Aspetto

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

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

using (Presentation pres = new Presentation("pres.pptx"))
{
    ILayoutSlide layout = pres.LayoutSlides.GetByType(SlideLayoutType.Custom);
    ISlide emptySlide = pres.Slides.AddEmptySlide(layout);

    IImage image = Images.FromFile("image.png");
    IPPImage presImage = pres.Images.AddImage(image);
    image.Dispose();

    IPictureFrame pictureFrame = emptySlide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, presImage.Width, presImage.Height, presImage);

    // Imposta la forma per preservare il rapporto d'aspetto durante il ridimensionamento
    pictureFrame.PictureFrameLock.AspectRatioLocked = true;
}

NOTA

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

Usa 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 lo stretching è specificato per un’immagine, un rettangolo sorgente viene scalato per adattarsi al rettangolo di riempimento specificato. Ogni bordo del rettangolo di riempimento è definito da uno spostamento percentuale dal corrispondente bordo della bounding box della forma. Una percentuale positiva indica un inset, mentre una percentuale negativa indica un outset.

1. Crea un’istanza della classe Presentation.
2. Ottieni il riferimento di 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 l’immagine impostata per riempire la forma.
8. Specifica gli offset dell’immagine rispetto al corrispondente bordo della bounding box della forma.
9. Scrivi la presentazione modificata in un file PPTX.

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

using (Presentation pres = new Presentation())
{
    IImage image = Images.FromFile("image.png");
    IPPImage ppImage = pres.Images.AddImage(image);
    image.Dispose();

    IPictureFrame pictureFrame = pres.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 10, 10, 400, 400, ppImage);

    // Imposta l'immagine stirata da ogni lato nel corpo della forma
    pictureFrame.PictureFormat.PictureFillMode = PictureFillMode.Stretch;
    pictureFrame.PictureFormat.StretchOffsetLeft = 24;
    pictureFrame.PictureFormat.StretchOffsetRight = 24;
    pictureFrame.PictureFormat.StretchOffsetTop = 24;
    pictureFrame.PictureFormat.StretchOffsetBottom = 24;

    pres.Save("imageStretch.pptx", SaveFormat.Pptx);
}

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 coincide con le capacità del motore di conversione di diapositive e immagini.

Come influisce l’aggiunta di decine di immagini grandi sulla dimensione e sulle prestazioni del PPTX?
L’incorporamento di immagini grandi aumenta la dimensione del file e l’utilizzo 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 la dimensione del file.

Come posso bloccare un oggetto immagine per evitare spostamenti o ridimensionamenti accidentali?
Utilizza i lock delle forme per un PictureFrame (ad esempio, disabilitando lo spostamento o il ridimensionamento). Il meccanismo di blocco è descritto per le forme in un articolo di protezione separato ed è supportato per vari tipi di forma, inclusi i 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 memorizzato come vettore è confermato dal comportamento di estrazione.