GroupDocs.Conversion for .NET 18.4 Release Notes

This page contains release notes for GroupDocs.Conversion for .NET 18.4

Major Features

There are 5+ new features, improvements and fixes in this regular monthly release. The most notable are:

Specify bookmark level, heading level and expanded level when converting Word to PDF and XPS
Linearize PDF Document for the Web when converting to PDF
Resource optimization options when converting to PDF
Option for applying image watermark
Create HTML5 compliant markup when converting to html
Bug fixes

Full List of Issues Covering all Changes in this Release

Key	Summary	Category
CONVERSIONNET‑2434	Specify bookmark level, headings level and expanded level when converting from Words to PDF and XPS	New Feature
CONVERSIONNET‑2457	Implement option for creating linearized PDF when converting to PDF	New Feature
CONVERSIONNET‑2458	Implement option for converting to grayscale PDF	New Feature
CONVERSIONNET‑2459	Implement option for resource optimization when converting to PDF	New Feature
CONVERSIONNET‑2471	Implement option for applying image watermark	New Feature
CONVERSIONNET‑2454	Create HTML 5 compliant markup when converting to html	Improvement
CONVERSIONNET‑2432	Index was outside the bound of the array, when cache is enabled and watermarks are applied	Fix

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in GroupDocs.Conversion for .NET 18.4. It includes not only new and obsoleted public methods, but also a description of any changes in the behavior behind the scenes in GroupDocs.Conversion which may affect existing code. Any behavior introduced that could be seen as a regression and modifies existing behavior is especially important and is documented here.

Introduced new property in WatemarkOptions

/// <summary>
/// Image watermark
/// </summary>
public byte[] Image { get; set; }

Usage

byte[] image = System.IO.File.ReadAllBytes ( "image.jpg" );
var saveOptions = new PdfSaveOptions();
saveOptions.WatermarkOptions.Image = image;

Introduced new property in PdfOptions

/// <summary>
/// Convert a PDF from RGB colorspace to Grayscale
/// </summary>
public bool Grayscale { get; set; }

Usage

var saveOptions = new PdfSaveOptions();
saveOptions.PdfOptions.Grayscale = true;

Introduced new property in PdfOptions

/// <summary>
/// Linearize PDF Document for the Web
/// </summary>
public bool Linearize { get; set; }

Usage

var saveOptions = new PdfSaveOptions();
saveOptions.PdfOptions.Linearize = true;

Introduced new property in PdfOptions

/// <summary>
/// Pdf optimization options
/// </summary>
public PdfOptimizationOptions OptimizationOptions { get; }

Usage

var saveOptions = new PdfSaveOptions();
 
// all images in the document are re-compressed. The compression is defined by the ImageQuality property.
saveOptions.PdfOptions.OptimizationOptions.CompressImages = true;
 
//  value in percent where 100% is unchanged quality and image size. To decrease the image size, use ImageQuality less than 100
saveOptions.PdfOptions.OptimizationOptions.ImageQuality = 50;
 
// Link duplcate streams
saveOptions.PdfOptions.OptimizationOptions.LinkDuplcateStreams = true;
 
// Remove unused objects
saveOptions.PdfOptions.OptimizationOptions.RemoveUnusedObjects = true;
 
// Remove unused streams
saveOptions.PdfOptions.OptimizationOptions.RemoveUnusedStreams = true;
 
// Make fonts not embedded if set to true
saveOptions.PdfOptions.OptimizationOptions.UnembedFonts = true;

Introduced new property WordBookmarkOptions in PdfSaveOptions

/// <summary>
/// If the input document is Word the conversion will handle the word bookmarks regarding this option.
/// </summary>
public WordBookmarksOptions WordBookmarkOptions { get; }

Usage

var saveOptions = new PdfSaveOptions();
saveOptions.WordBookmarkOptions.BookmarksOutlineLevel = 5;
saveOptions.WordBookmarkOptions.HeadingsOutlineLevels = 5;
saveOptions.WordBookmarkOptions.ExpandedOutlineLevels = 9;