GroupDocs.Comparison for .NET 19.5 Release Notes

Major Features

Below is the list of most notable changes in release of GroupDocs.Comparison for .NET 19.5:

• Implemented calculation of changes for Diagrams, Slides and PDF formats
• Implemented getting document information method
• Improved exceptions and error handling all around the projects for all supported formats
• Fixed issue with getting images for HTML files
• Fixed issue with Fonts detection
• Fixed incorrect different in PDF
• Improved changes detection in tables on Words documents

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatible Changes

1. Extended PageImage properties
   For now PageImage class was extended by adding 2 public properties Width and Height

   Comparer comparer = new Comparer();
   
   // get the list of pages as images
   List<PageImage> sourceImages = comparer.ConvertToImages(sourcePath);
   // getting sizes of first page
   int h = sourceImages[0].Height;
   int w = sourceImages[0].Width;
   

2. Getting coordinates of changes

   Getting coordinates of specific changes in Result document is working for Slides, PDF and Diagrams documents

   To use this feature you should specify in ComparisonSettings CalculateComponentCoordinates property

   ComparisonSetting settings = new ComparisonSetting
   {
      ...
      CalculateComponentCoordinates = true;
      ...
   }
   

   The coordinates of changes will be stored in Box property of ChangeInfo class

   List<ChangeInfo> changes = new List<ChangeInfo>(result.GetChanges());
   chages[0].Box // coordinates of first change
   

   Example of further using this option:

   ComparisonSettings comparisonsettings = new ComparisonSettings();
   comparisonSettings.StyleChangeDetection = true;
   //this setting specify that we want to have change coordinates
   comparisonSettings.CalculateComponentCoordinates = true;
   comparisonSettings.DetailLevel = DetailLevel.High;
   string sourcePath = "source.pdf";
   string targetPath = "target.pdf";
   string resultPath = "result.pdf;
   Comparer comparer = new Comparer();
   ICompareResult result = comparer.Compare(sourcePath, targetPath, comparisonSettings);
   result.SaveDocument(resultPath);
   
   List<PageImage> resultImages = comparer.ConvertToImages(resultPath);
   List<ChangeInfo> changes = new List<ChangeInfo>(result.GetChanges());
   
   //below the one of cases how we could use changes coordinates.
   //we are passing through pages object and draw a rectangle in the coordinates of changes
   foreach (PageImage image in resultImages)
   {
   	Bitmap bitmap = new Bitmap(image.PageStream);
   	using (Graphics graphics = Graphics.FromImage(bitmap))
   	{
   		foreach (ChangeInfo changeInfo in changes)
   		{
   			//if something was Inserted draw a Blue rectange
   			if (changeInfo.Type == TypeChanged.Inserted)
   				graphics.DrawRectangle(new Pen(Color.Blue), changeInfo.Box.X, changeInfo.Box.Y, changeInfo.Box.Width, changeInfo.Box.Height);
   			//if something was Deleted draw a Red rectange
   			if (changeInfo.Type == TypeChanged.Deleted)
   				graphics.DrawRectangle(new Pen(Color.Red), changeInfo.Box.X, changeInfo.Box.Y, changeInfo.Box.Width, changeInfo.Box.Height);
   			//if something was Changes draw a Green rectange
   			if (changeInfo.Type == TypeChanged.StyleChanged)
   				graphics.DrawRectangle(new Pen(Color.Green), changeInfo.Box.X, changeInfo.Box.Y, changeInfo.Box.Width, changeInfo.Box.Height);
   		}
   	}
   	bitmap.Save(savePath + @"/Result_Pages/result_" + image.PageNumber + ".png");
   	bitmap.Dispose();
   }
   

3. New DocumentInfo class

   New DocumentInfo class was added. This class contains following properties:

   NumberOfPages (read only) - the count of document pages
   PagesData (read only) - the list of PageInfo classes

   PageInfo class contains following properties:
   Width - the width of page
   Height - the height of page

   Informer informer = new Informer();
   //get information about document from filePath
   DocumentInfo documentInfo = informer.GetDocumentInfo(filePath);