Hantera bildramar i presentationer med C++

Introduktion

En bildram är en form som innehåller en bild - den är som en bild i en ram.

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

Tip

Aspose tillhandahåller gratis konverterare-JPEG till PowerPoint och PNG till PowerPoint-som låter användare skapa presentationer snabbt från bilder.

Skapa en bildram

Skapa en instans av Presentation class.
Hämta en slids 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 baserad på bildens bredd och höjd via AddPictureFrame‑metoden som exponeras av formobjektet associerat med den refererade sliden.
Lägg till en bildram (som innehåller bilden) på sliden.
Skriv den modifierade presentationen som en PPTX‑fil.

// Sökvägen till dokumentkatalogen.
const String outPath = u"../out/PictureFrameFormatting_out.pptx";
const String filePath = u"../templates/Tulips.jpg";

// Laddar den önskade presentationen
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// Åtkomst till första sliden
SharedPtr<ISlide> slide = pres->get_Slide(0);

// Laddar bilden som kommer att läggas till i presentationens bildsamling
// Hämtar bilden
auto image = Images::FromFile(filePath);

// Lägger till en bild i presentationens bildsamling
SharedPtr<IPPImage> imgx = pres->get_Images()->AddImage(image);

// Lägger till en bildram på sliden
SharedPtr<IPictureFrame> pf = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, imgx);

// Ställer in relativ skala för bredd och höjd
pf->set_RelativeScaleHeight(0.8);
pf->set_RelativeScaleWidth(1.35);
// Tillämpar någon formatering på bildramen
pf->get_LineFormat()->get_FillFormat()->set_FillType(FillType::Solid);
pf->get_LineFormat()->get_FillFormat()->get_SolidFillColor()->set_Color(Color::get_Blue());
pf->get_LineFormat()->set_Width ( 20);
pf->set_Rotation( 45);

// Skriver PPTX-filen till disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

Bildramar låter dig snabbt skapa presentationsbilder baserade på bilder. När du kombinerar bildram med spara‑alternativen i Aspose.Slides kan du manipulera in‑/ut‑operationer för att konvertera bilder från ett format till ett annat. Du kan vilja titta på 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 skala

Skapa en instans av Presentation class.
Hämta en slids 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.
Skriv den modifierade presentationen som en PPTX‑fil.

// Sökvägen till dokumentkatalogen.
const String outPath = u"../out/AddRelativeScaleHeightPictureFrame_out.pptx";
const String filePath = u"../templates/Tulips.jpg";

// Laddar den önskade presentationen
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// Åtkomst till första sliden
SharedPtr<ISlide> slide = pres->get_Slide(0);

// Laddar bilden som ska läggas till i presentationens bildsamling
// Hämtar bilden
auto image = Images::FromFile(filePath);

// Lägger till en bild i presentationens bildsamling
SharedPtr<IPPImage> imgx = pres->get_Images()->AddImage(image);

// Lägger till en bildram på sliden
SharedPtr<IPictureFrame> pf = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, imgx);

// Ställer in relativ skala för bredd och höjd
pf->set_RelativeScaleHeight (0.8);
pf->set_RelativeScaleWidth(1.35);

//Skriver PPTX-filen till disk
pres->Save(outPath, Aspose::Slides::Export::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 man extraherar en bild från dokumentet “sample.pptx” och sparar den i PNG‑format.

auto presentation = MakeObject<Presentation>(u"sample.pptx");
auto firstSlide = presentation->get_Slide(0);
auto firstShape = firstSlide->get_Shape(0);
    
if (ObjectExt::Is<IPictureFrame>(firstShape))
{
    auto pictureFrame = ExplicitCast<IPictureFrame>(firstShape);
    auto image = pictureFrame->get_PictureFormat()->get_Picture()->get_Image()->get_SystemImage();

    image->Save(u"slide_1_shape_1.png", ImageFormat::get_Png());
}

presentation->Dispose();

Extrahera SVG‑bilder från bildramar

När en presentation innehåller SVG‑grafik placerad i [PictureFrame]-former låter Aspose.Slides för C++ dig hämta de ursprungliga vektor bilderna med fullständig noggrannhet. Genom att gå igenom slidens formkollektion kan du identifiera varje [PictureFrame], kontrollera om den underliggande [IPPImage] innehåller SVG‑innehåll, och sedan spara den bilden till disk eller en ström i dess ursprungliga SVG‑format.

Följande kodexempel demonstrerar hur man extraherar en SVG‑bild från en bildram:

auto presentation = MakeObject<Presentation>(u"sample.pptx");

auto slide = presentation->get_Slide(0);
auto shape = slide->get_Shape(0);

if (ObjectExt::Is<IPictureFrame>(shape))
{
    auto pictureFrame = ExplicitCast<IPictureFrame>(shape);
    auto svgImage = pictureFrame->get_PictureFormat()->get_Picture()->get_Image()->get_SvgImage();
    if (svgImage != nullptr)
    {
        File::WriteAllText(u"output.svg", svgImage->get_SvgContent());
    }
}

presentation->Dispose();

Hämta transparens för en bild

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

auto presentation = System::MakeObject<Presentation>(u"Test.pptx");
auto pictureFrame = System::ExplicitCast<IPictureFrame>(presentation->get_Slide(0)->get_Shape(0));
auto imageTransform = pictureFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
for (auto&& effect : imageTransform)
{
    if (System::ObjectExt::Is<IAlphaModulateFixed>(effect))
    {
        float transparencyValue = 100.0f - (System::ExplicitCast<IAlphaModulateFixed>(effect))->get_Amount();
        System::Console::WriteLine(System::String(u"Picture transparency: ") + transparencyValue);
    }
}

Alla effekter som applicerats på bilder kan hittas i Aspose::Slides::Effects.

Hämta ljusstyrka och kontrast för en bild

Aspose.Slides låter dig hämta ljusstyrke‑ och kontrasteffekten som applicerats på en bild. Interfacet [ILuminance] representerar denna bildtransformering.

Denna C++‑kod demonstrerar hur man får ljusstyrke‑ och kontrastinställningarna från en bildram:

auto presentation = System::MakeObject<Presentation>(u"sample.pptx");
auto slide = presentation->get_Slide(0);

auto shape = slide->get_Shape(0);
auto pictureFrame = System::ExplicitCast<IPictureFrame>(shape);

auto imageTransform = pictureFrame->get_PictureFormat()->get_Picture()->get_ImageTransform();
for (auto&& effect : imageTransform)
{
    if (System::ObjectExt::Is<ILuminance>(effect))
    {
        auto luminance = System::ExplicitCast<ILuminance>(effect)->GetEffective();
        auto brightness = luminance->get_Brightness();
        auto contrast = luminance->get_Contrast();

        Console::WriteLine(System::String(u"Brightness: ") + brightness);
        Console::WriteLine(System::String(u"Contrast: ") + contrast);
    }
}

presentation->Dispose();

Formatering av bildram

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

Skapa en instans av Presentation class.
Hämta en slids 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 ett PictureFrame baserat på bildens bredd och höjd via AddPictureFrame-metoden som exponeras av IShapes‑objektet associerat med den refererade sliden.
Lägg till bildramen (som innehåller bilden) på sliden.
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å sliden.
Skriv den modifierade presentationen som en PPTX‑fil.

// Sökvägen till dokumentkatalogen.
const String outPath = u"../out/AddRelativeScaleHeightPictureFrame_out.pptx";
const String filePath = u"../templates/Tulips.jpg";

// Laddar den önskade presentationen
SharedPtr<Presentation> pres = MakeObject<Presentation>();

// Åtkomst till första sliden
SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// Laddar bilden som ska läggas till i presentationens bildsamling
// Hämtar bilden
auto image = Images::FromFile(filePath);

// Lägger till en bild i presentationens bildsamling
SharedPtr<IPPImage> imgx = pres->get_Images()->AddImage(image);

// Lägger till en bildram på sliden
SharedPtr<IPictureFrame> pf = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50, 50, 100, 100, imgx);

// Ställer in relativ skala för bredd och höjd
pf->set_RelativeScaleHeight (0.8);
pf->set_RelativeScaleWidth(1.35);

// Skriver PPTX-filen till disk
pres->Save(outPath, Aspose::Slides::Export::SaveFormat::Pptx);

Tip

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 presentationer 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 man lägger till en bild och video i en platshållare:

auto presentation = System::MakeObject<Presentation>(u"input.pptx");
auto shapesToRemove = System::MakeObject<System::Collections::Generic::List<System::SharedPtr<IShape>>>();
auto shapes = presentation->get_Slides()->idx_get(0)->get_Shapes();

for (auto& autoShape : shapes)
{
    if (autoShape->get_Placeholder() == nullptr)
        continue;

    switch (autoShape->get_Placeholder()->get_Type())
    {
        case Aspose::Slides::PlaceholderType::Picture:
        {
            auto pictureFrame = shapes->AddPictureFrame(Aspose::Slides::ShapeType::Rectangle, autoShape->get_X(), autoShape->get_Y(), autoShape->get_Width(), autoShape->get_Height(), nullptr);
            pictureFrame->get_PictureFormat()->get_Picture()->set_LinkPathLong(u"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:
        {
            auto videoFrame = shapes->AddVideoFrame(autoShape->get_X(), autoShape->get_Y(), autoShape->get_Width(), autoShape->get_Height(), u"");
            videoFrame->get_PictureFormat()->get_Picture()->set_LinkPathLong(u"https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg");
            videoFrame->set_LinkPathLong(u"https://youtu.be/t_1LYZ102RA");
            shapesToRemove->Add(autoShape);
            break;
        }
    }
}

for (auto& shape : shapesToRemove)
{
    shapes->Remove(shape);
}

presentation->Save(u"output.pptx", Aspose::Slides::Export::SaveFormat::Pptx);

Beskär bilder

Denna C++‑kod visar hur man beskär en befintlig bild på en slide:

using namespace Aspose::Slides;
using namespace Aspose::Slides::Export;
using namespace System::Drawing;
    
auto presentation = System::MakeObject<Presentation>();
// Skapar ett nytt bildobjekt
auto newImage = presentation->get_Images()->AddImage(Images::FromFile(imagePath));

// Lägger till en bildram på en slide
auto picFrame = presentation->get_Slides()->idx_get(0)->get_Shapes()->AddPictureFrame(Aspose::Slides::ShapeType::Rectangle, 100.0f, 100.0f, 420.0f, 250.0f, newImage);

// Beskär bilden (procentvärden)
picFrame->get_PictureFormat()->set_CropLeft(23.6f);
picFrame->get_PictureFormat()->set_CropRight(21.5f);
picFrame->get_PictureFormat()->set_CropTop(3.0f);
picFrame->get_PictureFormat()->set_CropBottom(31.0f);

// Sparar resultatet
presentation->Save(outPptxFile, Aspose::Slides::Export::SaveFormat::Pptx);

Ta bort beskurna områden av en bild

Om du vill ta bort de beskurna områdena av en bild som finns i en ram kan du använda metoden [IPictureFillFormat::DeletePictureCroppedAreas()] . Denna metod returnerar den beskurna bilden eller ursprungsbilden om beskärning inte behövs.

Denna C++‑kod demonstrerar operationen:

System::SharedPtr<Presentation> presentation = System::MakeObject<Presentation>(u"PictureFrameCrop.pptx");
System::SharedPtr<ISlide> slide = presentation->get_Slide(0);

// Gets the PictureFrame from the first slide
System::SharedPtr<IPictureFrame> picFrame = System::AsCast<IPictureFrame>(slide->get_Shape(0));

// Deletes cropped areas of the PictureFrame image and returns the cropped image
System::SharedPtr<IPPImage> croppedImage = picFrame->get_PictureFormat()->DeletePictureCroppedAreas();

// Saves the result
presentation->Save(u"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 presentationens storlek. Annars ökar antalet bilder i den resulterande presentationen.

Denna metod konverterar WMF/EMF‑metafiler till raster‑PNG‑bild 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 reducera 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å samma sätt som PowerPoints Picture Format -> Compress Pictures -> Resolution‑funktion.

Följande C++‑exempel demonstrerar hur man komprimerar en bild i en presentation genom att ange en målupplösning och eventuellt ta bort beskurna områden:

auto presentation = System::MakeObject<Presentation>(u"demo.pptx");
auto slide = presentation->get_Slide(0);
auto pictureFrame = System::AsCast<IPictureFrame>(slide->get_Shape(0));

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

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

presentation->Save(u"CompressedImage.pptx", SaveFormat::Pptx);
presentation->Dispose();

Eller genom att använda ett anpassat DPI‑värde direkt:

auto presentation = System::MakeObject<Presentation>(u"demo.pptx");
auto slide = presentation->get_Slide(0);
auto pictureFrame = System::AsCast<IPictureFrame>(slide->get_Shape(0));

// Komprimera bilden till 150 DPI (webbupplösning) och ta bort beskurna områden.
pictureFrame->get_PictureFormat()->CompressImage(true, 150.0f);

presentation->Save(u"CompressedImage.pptx", SaveFormat::Pptx);
presentation->Dispose();

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 kompression inte att tillämpas. JPEG‑kvaliteten bevaras eller minskas något beroende på upplösning, på samma sätt som PowerPoint hanterar högupplösta JPEG‑bilder.

Lås bildförhållande

Om du vill att en form som innehåller en bild ska behålla sitt bildförhållande även efter att du ändrat bildens dimensioner kan du använda metoden [set_AspectRatioLocked()] för att ställa in Lock Aspect Ratio-inställningen.

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

System::SharedPtr<Presentation> pres = System::MakeObject<Presentation>(u"pres.pptx");

System::SharedPtr<ILayoutSlide> layout = pres->get_LayoutSlides()->GetByType(SlideLayoutType::Custom);
System::SharedPtr<ISlide> emptySlide = pres->get_Slides()->AddEmptySlide(layout);

System::SharedPtr<IImage> image = Images::FromFile(u"image.png");
System::SharedPtr<IPPImage> presImage = pres->get_Images()->AddImage(image);

System::SharedPtr<IPictureFrame> pictureFrame = emptySlide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 50.0f, 150.0f, static_cast<float>(presImage->get_Width()), static_cast<float>(presImage->get_Height()), presImage);

// set shape to have to preserve aspect ratio on resizing
pictureFrame->get_PictureFrameLock()->set_AspectRatioLocked(true);

NOTE

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

Använd StretchOff‑egenskapen

Genom att använda egenskaperna StretchOffsetLeft, StretchOffsetTop, StretchOffsetRight och StretchOffsetBottom från IPictureFillFormat‑interfacet och PictureFillFormat‑klassen kan du specificera en fyllningsrektangel.

När sträckning av en bild anges skalas en källrektangel för att passa den specificerade fyllningsrektangeln. Varje kant av fyllningsrektangeln definieras av en procentuell offset från motsvarande kant av formens begränsningsruta. En positiv procent anger ett inskjut. En negativ procent anger ett utskjut.

Skapa en instans av [Presentation]-klassen.
Hämta en slids 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.
Specificera bildens offset från motsvarande kant av formens begränsningsruta
Skriv den modifierade presentationen som en PPTX‑fil.

Denna C++‑kod demonstrerar en process i vilken StretchOff‑egenskapen används:

auto pres = System::MakeObject<Presentation>();
auto ppImage = pres->get_Images()->AddImage(Images::FromFile(u"image.png"));
auto slide = pres->get_Slide(0);
auto pictureFrame = slide->get_Shapes()->AddPictureFrame(ShapeType::Rectangle, 10.0f, 10.0f, 400.0f, 400.0f, ppImage);

// Ställer in bilden som sträcks från varje sida i formens innehåll
auto pictureFormat = pictureFrame->get_PictureFormat();
pictureFormat->set_PictureFillMode(PictureFillMode::Stretch);
pictureFormat->set_StretchOffsetLeft(24.0f);
pictureFormat->set_StretchOffsetRight(24.0f);
pictureFormat->set_StretchOffsetTop(24.0f);
pictureFormat->set_StretchOffsetBottom(24.0f);

pres->Save(u"imageStretch.pptx", SaveFormat::Pptx);

FAQ

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

Aspose.Slides stödjer både rasterbilder (PNG, JPEG, BMP, GIF osv.) och vektorbilder (t.ex. SVG) via bildobjektet som tilldelas en [PictureFrame]. Listan över stödda format överlappar i allmänhet med funktionerna i slide‑ och bildkonverteringsmotorn.

Hur påverkar det PPTX‑storleken och prestanda att lägga till dussintals stora bilder?

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

Hur kan jag låsa ett bildobjekt så att det inte av misstag flyttas/ändras i storlek?

Använd [shape locks] för en [PictureFrame] (t.ex. inaktivera flytt eller storleksändring). Låsningsmekanismen beskrivs för former i en separat protection article och stöds för olika formtyper, inklusive [PictureFrame].

Bevaras SVG‑vektorns integritet vid export av en presentation till PDF/bilder?

Aspose.Slides låter dig extrahera en SVG från en [PictureFrame] som den ursprungliga vektorn. Vid export to PDF eller raster formats kan resultatet rasteriseras beroende på exportinställningarna; att den ursprungliga SVG‑filen lagras som en vektor bekräftas av extraheringsbeteendet.