Convert Slide

Aspose.Slides for C++ allows you to convert slides (in presentations) to images. These are the supported image formats: BMP, PNG, JPG (JPEG), GIF, and others.

To convert a slide to an image, do this:

  1. First,

    • convert the slide to a Bitmap first by using the GetThumbnail method or
    • render the slide to a Graphics object by using the RenderToGraphics method from the ISlide interface.

  2. Second, set additional options for conversion and convertible slide objects through

About Bitmap and Other Image Formats

A Bitmap is an object that allows you to work with images defined by pixel data. You can use an instance of this class to save images in a wide range of formats (BMP, JPG, PNG, etc.).

Converting Slides to Bitmap and Saving the Images in PNG

This C++ code shows you how to convert the first slide of a presentation to a bitmap object and then how to then save the image in the PNG format:

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

// Convert the first slide of the presentation to a Bitmap object
System::SharedPtr<Bitmap> bmp = pres->get_Slides()->idx_get(0)->GetThumbnail();
                 
// Save the image in PNG format
bmp->Save(u"Slide_0.png", ImageFormat::get_Png());

This sample code shows you how to convert the first slide of a presentation to a bitmap object using the RenderToGraphics method:

auto pres = System::MakeObject<Presentation>(u"Presentation.pptx");
// Gets the presentation slide size
Size slideSize = pres->get_SlideSize()->get_Size().ToSize();

// Creates a Bitmap with the slide size
auto slideImage = System::MakeObject<Bitmap>(slideSize.get_Width(), slideSize.get_Height());

// Renders the first slide to the Graphics object
auto graphics = Graphics::FromImage(slideImage);
pres->get_Slides()->idx_get(0)->RenderToGraphics(MakeObject<RenderingOptions>(), graphics);

slideImage->Save(u"Slide_0.png", ImageFormat::get_Png());

Converting Slides to Images with Custom Sizes

You may need to get an image of a certain size. Using an overload from the GetThumbnail or RenderToGraphics method, you can convert a slide to an image with specific dimensions (length and width).

This sample code demonstrates the proposed conversion using the GetThumbnail method in C++:

auto pres = System::MakeObject<Presentation>(u"Presentation.pptx");
// Converts the first slide in the presentation to a Bitmap with the specified size
auto bmp = pres->get_Slides()->idx_get(0)->GetThumbnail(Size(1820, 1040));
// Saves the image in the JPEG format
bmp->Save(u"Slide_0.jpg", ImageFormat::get_Jpeg());

This C++ code demonstrates how to convert the first slide to the framed image with the RenderToGraphics method:

auto pres = System::MakeObject<Presentation>(u"Presentation.pptx");
Size slideSize(1820, 1040);

// Creates a Bitmap with the specified size (slide size + fields)
auto slideImage = System::MakeObject<Bitmap>(slideSize.get_Width() + 50, slideSize.get_Height() + 50);

auto graphics = Graphics::FromImage(slideImage);
// Fills and translates Graphics to create a frame around the slide
graphics->Clear(Color::get_Red());
graphics->TranslateTransform(25.f, 25.f);

// Renders the first slide to Graphics
pres->get_Slides()->idx_get(0)->RenderToGraphics(MakeObject<RenderingOptions>(), graphics, slideSize);

// Saves the image in the JPEG format
slideImage->Save(u"FramedSlide_0.jpg", ImageFormat::get_Jpeg());

Converting Slides With Notes and Comments to Images

Some slides contain notes and comments.

Aspose.Slides provides two interfaces—ITiffOptions and IRenderingOptions—that allow you to control the rendering of presentation slides to images. Both interfaces house the INotesCommentsLayoutingOptions interface that allows you to add notes and comments on a slide when you are converting that slide to an image.

This C++ code demonstrates the conversion process for a slide with notes and comments:

auto pres = System::MakeObject<Presentation>(u"PresentationNotesComments.pptx");
// Creates the rendering options
auto options = System::MakeObject<RenderingOptions>();
auto notesCommentsLayouting = options->get_NotesCommentsLayouting();
// Sets the position of the notes on the page
notesCommentsLayouting->set_NotesPosition(NotesPositions::BottomTruncated);
// Sets the position of the comments on the page 
notesCommentsLayouting->set_CommentsPosition(CommentsPositions::Right);
// Sets the width of the comment output area
notesCommentsLayouting->set_CommentsAreaWidth(500);
// Sets the color for the comments area
notesCommentsLayouting->set_CommentsAreaColor(Color::get_AntiqueWhite());

// Converts the first slide of the presentation to a Bitmap object
auto bmp = pres->get_Slides()->idx_get(0)->GetThumbnail(options, 2.f, 2.f);

// Saves the image in the GIF format
bmp->Save(u"Slide_Notes_Comments_0.gif", ImageFormat::get_Gif());

This C++ code demonstrates the conversion process for a slide with notes using the RenderToGraphics method:

auto pres = System::MakeObject<Presentation>(u"PresentationNotes.pptx");
// Gets the presentation notes size
Size notesSize = pres->get_NotesSize()->get_Size().ToSize();

// Creates the rendering options
auto options = System::MakeObject<RenderingOptions>();
// Sets the position of the notes
options->get_NotesCommentsLayouting()->set_NotesPosition(NotesPositions::BottomTruncated);

// Creates a Bitmap with the notes' size
auto slideImage = System::MakeObject<Bitmap>(notesSize.get_Width(), notesSize.get_Height());

// Renders the first slide to Graphics
auto graphics = Graphics::FromImage(slideImage);
pres->get_Slides()->idx_get(0)->RenderToGraphics(options, graphics, notesSize);

// Saves the image in PNG format
slideImage->Save(u"Slide_Notes_0.png", ImageFormat::get_Png());

Converting Slides to Images Using ITiffOptions

The ITiffOptions interface gives you more control (in terms of parameters) over the resulting image. Using this interface, you get to specify the size, resolution, color palette, and other parameters for the resulting image.

This C++ code demonstrates a conversion process where ITiffOptions is used to output a black and white image with a 300dpi resolution and 2160 × 2800 size:

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

// Get a slide by its index
System::SharedPtr<ISlide> slide = pres->get_Slides()->idx_get(0);

// Create TiffOptions object
System::SharedPtr<TiffOptions> options = System::MakeObject<TiffOptions>();
options->set_ImageSize(Size(2160, 2880));

// Set font used in case source font is not found
options->set_DefaultRegularFont(u"Arial Black");

// Set the position of the notes on the page 
options->get_NotesCommentsLayouting()->set_NotesPosition(NotesPositions::BottomTruncated);

// Set pixel format (black and white)
options->set_PixelFormat(ImagePixelFormat::Format1bppIndexed);

// Set resolution
options->set_DpiX(300);
options->set_DpiY(300);

// Convert slide to a Bitmap object
System::SharedPtr<Bitmap> bmp = slide->GetThumbnail(options);

// Save the image in BMP format
bmp->Save(u"PresentationNotesComments.bmp", ImageFormat::get_Tiff());

Converting All Slides to Images

Aspose.Slides allows you to convert all slides in a single presentation to images. Essentially, you get to convert the presentation (in its entirety) to images.

This sample code shows you how to convert all slides in a presentation to images in C++:

// Path to output directory
System::String outputDir = u"D:\\PresentationImages";

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

// Render presentation to images array slide by slide
for (int32_t i = 0; i < pres->get_Slides()->get_Count(); i++)
{
    // Control hidden slides (do not render hidden slides)
    if (pres->get_Slides()->idx_get(i)->get_Hidden())
    {
        continue;
    }

    // Convert slide to a Bitmap object
    auto bmp = pres->get_Slides()->idx_get(i)->GetThumbnail(2.f, 2.f);

    // Create file name for an image
    auto outputFilePath = Path::Combine(outputDir, String(u"Slide_") + i + u".jpg");

    // Save the image in PNG format
    bmp->Save(outputFilePath, ImageFormat::get_Png());
}
Clone Slides Compare Slides