Aspose.Slides for .NET 25.11 Release Notes

New Features and Improvements

Updates to Supported Target Platforms

Starting with version 25.11, Aspose.Slides for .NET no longer includes assemblies targeting the outdated .NET Framework versions 2.0, 3.5, and 4.0. These have been replaced with assemblies built for more modern and secure .NET versions, ensuring improved performance, compatibility, and security.

We recommend updating your projects to use the supported .NET target frameworks.

For more details about these updates, please refer to this article.

Public API Changes

Complete Transition to Modern API

In version 25.11, we have completed the transition to the Modern API.

As previously noted in the 24.4 Release Notes , the public Aspose.Slides API has completely discontinued the use of types associated with the System.Drawing.Common assembly.

Methods and properties that used these types were previously marked as obsolete and have now been completely removed in this release.

Please note that types from System.Drawing.Primitives remain in the public API, as this assembly is part of the .NET Base Class Library (BCL).

This change not only allows us to further enhance the cross-platform capabilities of the product, but also significantly improves compatibility with other Aspose products and third-party solutions.

Added New Events: MarkdownSaveOptions.ImageSaving and MarkdownSaveOptions.SvgImageSaving

New Events ImageSaving and SvgImageSaving added to the MarkdownSaveOptions class. These events allow developers to control the process of saving images and generating links to them in the resulting Markdown file.

• MarkdownSaveOptions.ImageSaving - occurs for each image except SVG. Allows overriding the default image saving behavior and specifying a custom link (such as a relative path, absolute path, or external URL).

• MarkdownSaveOptions.SvgImageSaving - occurs only when saving SVG images. Allows manually saving SVG data and defining a custom Markdown link.

The following code sample demonstrates how to use these events:

var options = new MarkdownSaveOptions()
{
    ImagesSaveFolderName = "Images",
    ExportType = MarkdownExportType.Visual
};

options.ImageSaving += (IImage image, ImageFormat format, ref string link) =>
{
    string imagesDir = "ExportedImages";
    format = ImageFormat.Jpeg; //Force output format to JPEG for all images.
    string fileName = "Image_" + Guid.NewGuid().ToString("N") + ".jpg";

    link = Path.Combine(imagesDir, fileName);
    image.Save(link, format);

    return true;
};

options.SvgImageSaving += (ISvgImage svgImage, ref string link) =>
{
    string imagesDir = "ExportedImages";
    string fileName = "Svg_" + Guid.NewGuid().ToString("N") + ".svg";

    link = Path.Combine(imagesDir, fileName);
    File.WriteAllBytes(link, svgImage.SvgData);

    return true;
};

using (var presentation = new Presentation("demo.pptx"))
{
    presentation.Save("output.md", SaveFormat.Md, options);
}

Added New Method: IFontsManager.GetSubstitutions

The new method, GetSubstitutions(int[] slides), has been added to the IFontsManager interface and implemented in the FontsManager class. This enhancement allows developers to obtain information about fonts that will be substituted during the rendering of the specified slides.

The following code sample demonstrates how to use this method:

using (Presentation pres = new Presentation("pres.pptx"))
{
    int[] targetSlides = { 1, 2, 5 };
    foreach (var fontSubstitution in pres.FontsManager.GetSubstitutions(targetSlides))
    {
        Console.WriteLine("{0} -> {1}", fontSubstitution.OriginalFontName, fontSubstitution.SubstitutedFontName);
    }
}

Added New Class: MathPhantom

The MathPhantom class and the IMathPhantom interface have been added. They represent a phantom math object (<m:phant>) that affects the layout of its child element without necessarily displaying it. A phantom can hide its base expression while preserving its width, height, or depth - useful for aligning formulas or reserving space. Visibility and geometry behavior are controlled by properties such as Show, ZeroWid, ZeroAsc, ZeroDesc, and Transp.

Example:

//...
var phant = new MathPhantom(new MathFraction(new MathematicalText("1"), new MathematicalText("2"))) 
{ 
    Show = false, 
    ZeroAsc = true 
}
//...

Added New Property: ISlideShowTransition.Duration

The new property, Duration, has been added to the ISlideShowTransition interface and implemented in the SlideShowTransition class. This property gets or sets the duration of the slide transition effect in milliseconds. It corresponds to the p14:dur attribute of the p:transition element in the PresentationML schema. If not set, the duration is determined automatically based on the Speed property and the transition type.

Example:

//...
presentation.Slides[0].SlideShowTransition.Duration = 500; // Sets the transition duration to 500 ms
//...

Added New Property: ITextSearchOptions.IncludeNotes

The new property, IncludeNotes, has been added to the ITextSearchOptions interface and implemented in the TextSearchOptions class. This property allows including text contained in slide notes when performing text replacement or highlighting operations using the Presentation.ReplaceText or Presentation.HighlightText methods.

Behavior:

• true - text inside slide notes is included in the replacement or highlighting process.
• false (default) - text inside slide notes is ignored.

The following code sample demonstrates how to use this option:

using (Presentation presentation = new Presentation("demo.pptx"))
{
    var options = new TextSearchOptions
    {
        IncludeNotes = true,
        WholeWordsOnly = true
    };

    presentation.ReplaceText("Aspose", "Aspose.Slides", options, null);
    presentation.Save("demo_out.pptx", SaveFormat.Pptx);
}

Removed Obsolete Interface: INotesCommentsLayoutingOptions

The obsolete INotesCommentsLayoutingOptions interface has been removed. Please use the ISlidesLayoutOptions interface instead.

Removed Obsolete Property: ISwfOptions.NotesCommentsLayouting

The obsolete NotesCommentsLayouting property has been removed from ISwfOptions interface and SwfOptions class. Please use the SlidesLayoutOptions property instead.

Removed Obsolete Property: IHtml5Options.NotesCommentsLayouting

The obsolete NotesCommentsLayouting property has been removed from IHtml5Options interface and Html5Options class. Please use the SlidesLayoutOptions property instead.