Aspose.Slides for C++ 23.12 Release Notes

Supported Platforms

• Aspose.Slides for C++ for Windows x64/x86 (Microsoft Visual Studio 2017 or later).
• Aspose.Slides for C++ for Linux (Clang 3.9 or later, GCC 6.1 or later, glibc 2.23 or later).
• Aspose.Slides for C++ for macOS x86_64/ARM64 (Xcode 13.4 or later).

New Features and Enhancements

Other Improvements and Changes

Public API Changes

Handout Presentation export layout mode added

A new Handout presentation export layout mode was added. It represents the corresponding PowerPoint “Print as Handouts” feature. An enumeration HandoutType represents the possible handout types:

• One slide per page
• Two slides per page
• Three slides per page
• Four slides per page in a horizontal sequence
• Four slides per page in a vertical sequence
• Six slides per page in a horizontal sequence
• Six slides per page in a vertical sequence
• Nine slides per page in a horizontal sequence
• Nine slides per page in a vertical sequence

Below is an example of rendering of a presentation in the Handout layout:

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

auto handoutLayoutingOptions = System::MakeObject<HandoutLayoutingOptions>();
handoutLayoutingOptions->set_Handout(HandoutType::Handouts4Horizontal);
handoutLayoutingOptions->set_PrintSlideNumbers(false);

auto options = System::MakeObject<RenderingOptions>();
options->set_SlidesLayoutOptions(handoutLayoutingOptions);

System::Drawing::Size size(1920, 1080);
pres->get_Slide(0)->GetThumbnail(options, size)->Save(u"pres-handout.png");

To export presentation in the Handout layout to PDF:

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

auto handoutLayoutingOptions = System::MakeObject<HandoutLayoutingOptions>();
handoutLayoutingOptions->set_Handout(HandoutType::Handouts4Horizontal);

auto options = System::MakeObject<PdfOptions>();
options->set_SlidesLayoutOptions(handoutLayoutingOptions);

pres->Save(u"pres.pdf", SaveFormat::Pdf, options);

get_NotesCommentsLayouting() method is obsolete for RenderingOptions, HtmlOtions, PdfOptions, and TiffOptions classes

The get_NotesCommentsLayouting() method declared as obsolete for RenderingOptions, HtmlOtions, PdfOptions, and TiffOptions classes. The method will be removed after the release of version 24.3.

Please use set_SlidesLayoutOptions() method instead:

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

auto notesCommentsLayoutingOptions = System::MakeObject<NotesCommentsLayoutingOptions>();
notesCommentsLayoutingOptions->set_NotesPosition(NotesPositions::BottomTruncated);

auto options = System::MakeObject<PdfOptions>();
options->set_SlidesLayoutOptions(notesCommentsLayoutingOptions);

pres->Save(u"pres.pdf", SaveFormat::Pdf, options);

InkOptions class has been added

The new InkOptions class and the corresponding IInkOptions interface have been added. It provides options that control the look of Ink objects in exported documents.

The get_HideInk() and set_HideInk() methods allow to show or hides Ink elements in exported document. The get_InterpretMaskOpAsOpacity() and set_InterpretMaskOpAsOpacity() methods can be used to set ROP operation or Opacity for rendering brush.

Example:

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

auto options = System::MakeObject<PdfOptions>();
options->get_InkOptions()->set_HideInk(true);

pres->Save(u"output.pptx", SaveFormat::Pdf, options);

IPictureFillFormat::DeletePictureCroppedAreas() method has been added

The IPictureFillFormat::DeletePictureCroppedAreas() method allows the cropped areas of the fill Picture:

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

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

// Deletes cropped areas of the PictureFrame image
auto croppedImage = picFrame->get_PictureFormat()->DeletePictureCroppedAreas();

This can help to reduce the size of the presentation.

Shape::get_IsDecorative() and Shape::set_IsDecorative() methods have been added

The new Shape::get_IsDecorative() and Shape::set_IsDecorative() methods allows to set if the shape is “decorative” (used for decorative purposes, for example, some stylistic objects).

Example:

auto pres = System::MakeObject<Presentation>(u"sample.pptx");
pres->get_Slide(0)->get_Shape(0)->set_IsDecorative(true);