Hantera bildramar i presentationer i .NET

Vad den här sidan handlar om

Lägg till bildramar i PowerPoint- och OpenDocument-presentationer med Aspose.Slides för .NET. Förenkla ditt arbetsflöde och förbättra bilddesignen.

Introduktion

En bildram är en form som innehåller en bild – den är som ett foto i en ram.

Du kan lägga till en bild på en bildspelssida via en bildram. På så sätt kan du formatera bilden genom att formatera bildramen.

Tip

Aspose erbjuder gratis konverterare—JPEG till PowerPoint och PNG till PowerPoint—som gör det möjligt för användare att snabbt skapa presentationer från bilder.

Skapa en bildram

Skapa en instans av klassen Presentation.
Hämta en bildspelsidas referens via dess index.
Skapa ett IPPImage-objekt genom att lägga till en bild i IImagescollection som är associerad med presentationsobjektet och som kommer att användas för att fylla formen.
Ange bildens bredd och höjd.
Skapa en PictureFrame baserat på bildens bredd och höjd via AddPictureFrame‑metoden som exponeras av formobjektet som är associerat med den refererade bilden.
Lägg till en bildram (som innehåller bilden) på bilden.
Spara den modifierade presentationen som en PPTX‑fil.

Den här C#‑koden visar hur du skapar en bildram:

// Instansierar Presentation-klassen som representerar en PPTX-fil
using (Presentation pres = new Presentation())
{
    // Hämtar den första bilden
    ISlide slide = pres.Slides[0];

    // Laddar en bild och lägger till den i presentationens bildsamling
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = pres.Images.AddImage(image);
    image.Dispose();

    // Lägger till en bildram med samma höjd och bredd
    IPictureFrame pictureFrame = slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, ppImage.Width, ppImage.Height, ppImage);

    // Tillämpar formatering på bildramen
    pictureFrame.LineFormat.FillFormat.FillType = FillType.Solid;
    pictureFrame.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pictureFrame.LineFormat.Width = 20;
    pictureFrame.Rotation = 45;

    // Skriver presentationen till en PPTX-fil
    pres.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

Bildramar gör att du snabbt kan skapa presentationsbilder baserade på bilder. När du kombinerar bildram med sparalternativen i Aspose.Slides kan du manipulera in‑/utdata‑operationer för att konvertera bilder från ett format till ett annat. Du kan vilja se dessa sidor: konvertera bild till JPG; konvertera JPG till bild; konvertera JPG till PNG, konvertera PNG till JPG; konvertera PNG till SVG, konvertera SVG till PNG.

Skapa en bildram med relativ skalning

Genom att ändra en bilds relativa skalning kan du skapa en mer komplex bildram.

Skapa en instans av klassen Presentation.
Hämta en bildspelsidas referens via dess index.
Lägg till en bild i presentationens bildsamling.
Skapa ett IPPImage-objekt genom att lägga till en bild i IImagescollection som är associerad med presentationsobjektet och som kommer att användas för att fylla formen.
Ange bildens relativa bredd och höjd i bildramen.
Spara den modifierade presentationen som en PPTX‑fil.

Den här C#‑koden visar hur du skapar en bildram med relativ skalning:

// Instansierar Presentation-klassen som representerar en PPTX-fil
using (Presentation presentation = new Presentation())
{
    // Laddar en bild och lägger till den i presentationens bildsamling
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = presentation.Images.AddImage(image);
    image.Dispose();

    // Lägger till en bildram på bilden
    IPictureFrame pictureFrame = presentation.Slides[0].Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 100, 100, ppImage);

    // Ställer in relativ skala för bredd och höjd
    pictureFrame.RelativeScaleHeight = 0.8f;
    pictureFrame.RelativeScaleWidth = 1.35f;

    // Sparar presentationen
    presentation.Save("Adding Picture Frame with Relative Scale_out.pptx", SaveFormat.Pptx);
}

Extrahera rasterbilder från bildramar

Du kan extrahera rasterbilder från PictureFrame-objekt och spara dem i PNG, JPG och andra format. Kodexemplet nedan visar hur du extraherar en bild från dokumentet “sample.pptx” och sparar den i PNG‑format.

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

Extrahera SVG‑bilder från bildramar

När en presentation innehåller SVG‑grafik placerad i PictureFrame-former, låter Aspose.Slides för .NET dig hämta de ursprungliga vektorbilderna med fullständig noggrannhet. Genom att traversera bildspelets formsamling kan du identifiera varje PictureFrame, kontrollera om den underliggande IPPImage-objektet innehåller SVG‑innehåll, och sedan spara den bilden till disk eller en ström i dess ursprungliga SVG‑format.

Följande kodexempel visar hur du extraherar en SVG‑bild från en bildram:

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

Hämta transparens för en bild

Aspose.Slides låter dig hämta transparenseffekten som tillämpas på en bild. Denna C#‑kod demonstrerar operationen:

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

Hämta ljusstyrka och kontrast för en bild

Aspose.Slides låter dig hämta ljusstyrka‑ och kontrasteffekten som tillämpas på en bild. Interfacet ILuminance representerar denna bildtransformering.

Denna C#‑kod visar hur du hämtar ljusstyrke‑ och kontrastinställningarna från en bildram:

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

Alla effekter som tillämpas på bilder finns i Aspose.Slides.Effects.

Formatering av bildram

Aspose.Slides tillhandahåller många formateringsalternativ som kan tillämpas på en bildram. Med dessa alternativ kan du ändra en bildram så att den uppfyller specifika krav.

Skapa en instans av klassen Presentation.
Hämta en bildspelsidas referens via dess index.
Skapa ett IPPImage-objekt genom att lägga till en bild i IImagescollection som är associerad med presentationsobjektet och som kommer att användas för att fylla formen.
Ange bildens bredd och höjd.
Skapa en PictureFrame baserat på bildens bredd och höjd via metoden AddPictureFrame som exponeras av IShapes-objektet som är associerat med den refererade bilden.
Lägg till bildramen (som innehåller bilden) på bilden.
Ställ in bildramens linjefärg.
Ställ in bildramens linjebredd.
Rotera bildramen genom att ge den ett positivt eller negativt värde.
- Ett positivt värde roterar bilden medurs.
- Ett negativt värde roterar bilden moturs.
Lägg till bildramen (som innehåller bilden) på bilden.
Spara den modifierade presentationen som en PPTX‑fil.

Den här C#‑koden demonstrerar processen för formatering av bildram:

// Instansierar Presentation-klassen som representerar en PPTX-fil
using (Presentation presentation = new Presentation())
{
    // Hämtar den första bilden
    ISlide slide = presentation.Slides[0];

    // Laddar en bild och lägger till den i presentationens bildsamling
    IImage image = Images.FromFile("aspose-logo.jpg");
    IPPImage ppImage = presentation.Images.AddImage(image);
    image.Dispose();

    // Lägger till en bildram med bildens motsvarande höjd och bredd
    IPictureFrame pictureFrame = slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 150, ppImage.Width, ppImage.Height, ppImage);

    // Tillämpar formatering på bildramen
    pictureFrame.LineFormat.FillFormat.FillType = FillType.Solid;
    pictureFrame.LineFormat.FillFormat.SolidFillColor.Color = Color.Blue;
    pictureFrame.LineFormat.Width = 20;
    pictureFrame.Rotation = 45;

    // Skriver presentationen till en PPTX-fil
    presentation.Save("RectPicFrameFormat_out.pptx", SaveFormat.Pptx);
}

Aspose har nyligen utvecklat en gratis Collage Maker. Om du någonsin behöver sammanfoga JPG/JPEG eller PNG‑bilder, skapa rutnät från foton, kan du använda den här tjänsten.

Lägg till en bild som en länk

För att undvika stora presentationsstorlekar kan du lägga till bilder (eller videor) via länkar istället för att bädda in filerna direkt i presentationerna. Denna C#‑kod visar hur du lägger till en bild och en video i en platshållare:

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

Beskär bilder

Denna C#‑kod visar hur du beskär en befintlig bild på en bildspelssida:

using (Presentation presentation = new Presentation())
{
    // Skapar ett nytt bildobjekt
    IImage image = Images.FromFile(imagePath);
    IPPImage newImage = presentation.Images.AddImage(image);
    image.Dispose();

    // Lägger till en PictureFrame på en bild
    IPictureFrame picFrame = presentation.Slides[0].Shapes.AddPictureFrame(
        ShapeType.Rectangle, 100, 100, 420, 250, newImage);

    // Beskär bilden (procentvärden)
    picFrame.PictureFormat.CropLeft = 23.6f;
    picFrame.PictureFormat.CropRight = 21.5f;
    picFrame.PictureFormat.CropTop = 3;
    picFrame.PictureFormat.CropBottom = 31;

    // Sparar resultatet
    presentation.Save("PictureFrameCrop.pptx", SaveFormat.Pptx);
}

Ta bort beskurna områden i en bildram

Om du vill ta bort de beskurna områdena i en bild som finns i en ram kan du använda metoden IPictureFillFormat.DeletePictureCroppedAreas. Denna metod returnerar den beskurna bilden eller originalbilden om beskärning är onödig.

Denna C#‑kod demonstrerar operationen:

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

    // Hämtar PictureFrame från den första bilden
    IPictureFrame picFrame = slide.Shapes[0] as IPictureFrame;

    // Tar bort beskurna områden i PictureFrame-bilden och returnerar den beskurna bilden
    IPPImage croppedImage = picFrame.PictureFormat.DeletePictureCroppedAreas();

    // Sparar resultatet
    presentation.Save("PictureFrameDeleteCroppedAreas.pptx", SaveFormat.Pptx);
}

NOTE

Metoden IPictureFillFormat.DeletePictureCroppedAreas lägger till den beskurna bilden i presentationens bildsamling. Om bilden endast används i den bearbetade PictureFrame, kan denna inställning minska presentationsstorleken. Annars kommer antalet bilder i den resulterande presentationen att öka.

Denna metod konverterar WMF/EMF‑metafiler till raster‑PNG‑bilder i beskärningsoperationen.

Komprimera bilder

Du kan komprimera en bild i en presentation med hjälp av metoden IPictureFillFormat.CompressImage. Denna metod komprimerar en bild genom att minska dess storlek baserat på formens storlek och angiven upplösning, med möjlighet att ta bort beskurna områden.

Den justerar bildens storlek och upplösning på liknande sätt som PowerPoints Picture Format → Compress Pictures → Resolution‑funktion.

Följande C#‑exempel visar hur du komprimerar en bild i en presentation genom att ange en måluplösning och eventuellt ta bort beskurna områden:

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

    // Komprimera bilden med en målupplösning på 150 DPI (web-upplösning) och ta bort beskurna områden.
    bool result = pictureFrame.PictureFormat.CompressImage(true, PicturesCompression.Dpi150);

    // Kontrollera resultatet av kompressionen.
    if (result)
    {
        Console.WriteLine("Image successfully compressed.");
    }
    else
    {
        Console.WriteLine("Image compression failed or no changes were necessary.");
    }

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

Eller genom att ange ett eget DPI‑värde direkt:

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

    // Komprimera bilden till 150 DPI (web-upplösning) och ta bort beskurna områden.
    pictureFrame.PictureFormat.CompressImage(true, 150f);

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

NOTE

Metoden konverterar bilden till en lägre upplösning baserat på formens storlek och angivet DPI. Beskurna regioner kan också tas bort för att optimera filstorleken.
Om bilden är en metafil (WMF/EMF) eller SVG, kommer komprimering inte att tillämpas. Dessutom bevaras JPEG‑kvaliteten eller minskas något beroende på upplösning, på samma sätt som PowerPoint hanterar högupplösta JPEG‑filer.

Låsa bildförhållandet

Om du vill att en form som innehåller en bild ska behålla sitt bildförhållande även efter att du ändrar bildens dimensioner kan du använda egenskapen IPictureFrameLock.AspectRatioLocked för att ange inställningen Lock Aspect Ratio.

Denna C#‑kod visar hur du låser en formes bildförhållande:

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

    // Ställer in formen att bevara bildförhållandet vid storleksändring
    pictureFrame.PictureFrameLock.AspectRatioLocked = true;
}

NOTE

Denna Lock Aspect Ratio-inställning bevarar endast formens bildförhållande och inte bilden den innehåller.

Använd egenskapen StretchOff

Genom att använda egenskaperna StretchOffsetLeft, StretchOffsetTop, StretchOffsetRight och StretchOffsetBottom från gränssnittet IPictureFillFormat och klassen PictureFillFormat kan du ange en fyllningsrektangel.

När stretching anges för en bild skalas en källrektangel för att passa den angivna fyllningsrektangeln. Varje kant av fyllningsrektangeln definieras av en procentuell förskjutning från motsvarande kant på formens begränsningsruta. En positiv procentsats anger en infogning medan en negativ procentsats anger en utskjutning.

Skapa en instans av klassen Presentation.
Hämta en bildspelsidas referens via dess index.
Lägg till en rektangel AutoShape.
Skapa en bild.
Ställ in formens fyllningstyp.
Ställ in formens bildfyllningsläge.
Lägg till en bild för att fylla formen.
Ange bildens förskjutningar från motsvarande kant på formens begränsningsruta
Spara den modifierade presentationen som en PPTX‑fil.

Denna C#‑kod demonstrerar en process där StretchOff‑egenskapen används:

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

    // Ställer in bilden så att den sträcks från varje sida i formens kropp
    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

Hur kan jag ta reda på vilka bildformat som stödjs för PictureFrame?

Aspose.Slides stödjer både rasterbilder (PNG, JPEG, BMP, GIF, etc.) och vektorbilder (till exempel SVG) via bildobjektet som tilldelas en PictureFrame. Listan över stödjade format överlappar generellt med funktionerna i bildspels- och bildkonverteringsmotorn.

Hur påverkar tillägg av dussintals stora bilder PPTX‑storleken och prestandan?

Att bädda in stora bilder ökar filstorlek och minnesanvändning; att länka bilder hjälper hålla presentationsstorleken nere men kräver att de externa filerna förblir tillgängliga. Aspose.Slides erbjuder möjlighet att lägga till bilder via länk för att minska filstorleken.

Hur kan jag låsa ett bildobjekt så att det inte av misstag flyttas/skalas?

Använd shape locks för en PictureFrame (till exempel inaktivera flyttning eller skalning). Låsningsmekanismen beskrivs för former i en separat protection article och stöds för olika formtyper, inklusive PictureFrame.

Behålls SVG‑vektorfidelity vid export av en presentation till PDF/bilder?

Aspose.Slides tillåter att extrahera en SVG från en PictureFrame som den ursprungliga vektorn. När du exporterar till PDF eller rasterformat kan resultatet rasteriseras beroende på exportinställningarna; det faktum att den ursprungliga SVG:n lagras som en vektor bekräftas av extraheringsbeteendet.