GroupDocs.Conversion for .NET 25.2 Release Notes

There are 15+ features, improvements, and bug fixes in this release.

Full list of changes in this release

Major Features

• Displaying Comments with Full Names in PDF

  • When converting documents to PDF, comments now retain the full name of the commentator for better clarity.

• MSG to MSG Conversion: Modify Attachments Before Reattachment

  • Added support to modify email attachments in a handler before they are reattached during conversion.

• Improved Font Handling

  • Introduced an option to reset already set custom font folders when converting from Word, PDF, Images, PCL, and Spreadsheets.
  • Custom font folders can now be set at the document level when converting from WordProcessing documents.
  • Improved font substitution mechanism, ensuring better accuracy when converting Word documents.

• Better Watermark and Transparency Handling

  • Resolved issues with image watermark placement in PDFs when exceeding the page size.
  • Improved background rendering when converting PDFs to PNG or TIFF, ensuring transparency settings apply correctly.

• Enhanced Email to PDF Conversion

  • .eml to .pdf conversion now supports different load options for different attachment types.

Public API and backward incompatible changes

1. Introduced a new ResetFontFolders property in the ImageLoadOptions class.

2. Introduced a new ResetFontFolders property in the PdfLoadOptions class.

3. Introduced a new ResetFontFolders property in the SpreadsheetLoadOptions class.

4. Introduced a new ResetFontFolders property in the PclLoadOptions class.

5. New properties are introduced in WordProcessingLoadOptions class.

   var loadOptions = new WordProcessingLoadOptions();    
   loadOptions.FontNameSubstitutionEnabled = true;
   loadOptions.FontConfigSubstitutionEnabled = true;
   loadOptions.FontInfoSubstitutionEnabled = true;
   

   The default value of these is false.

   The order of substituting fonts is:

   • Automatically substitute missing fonts based on font name (if enabled).
   • Automatically substitute missing fonts based on FontConfig (if enabled).
   • Substitute missing fonts based on FontSubstitutes (if set).
   • Automatically substitute missing fonts based on FontInfo (if enabled).
   • Substitute missing fonts based on DefaultFont (if set).

   ---

   New properties ShowFullCommenterName and CommentDisplayMode. The properties specifies how comments should be displayed in the output document:

   FluentConverter.Load("input.docx").WithOptions(new WordProcessingLoadOptions
   {
       CommentDisplayMode = WordProcessingCommentDisplay.Balloon, // default value
       ShowFullCommenterName = true // default false
   })
   .ConvertTo("input.pdf")
   .WithOptions(new PdfConvertOptions())
   .Convert();
   

6. A new property AttachmentContentHandler is introduced in EmailConvertOptions. The property is delegate to handle custom processing of email attachments. The delegate takes the attachment name, content type and original attachment stream as parameters and returns the modified attachment stream.

   using (var converter = new Converter("with-attachments.msg"))
   {
     var options = new EmailConvertOptions
     {
         Format = EmailFileType.Msg,
         AttachmentContentHandler = (name, contentType, sourceStream) =>
         {
             return new MemoryStream(Encoding.UTF8.GetBytes($"Processed attachment: {name}"));
         }
     };
     converter.Convert("converted.msg", options);
   }