Aspose.Words for Java 13.12.0 Release Notes

Aspose.Words for Java has been updated to version 13.12.0 and we are pleased to announce this release brings the addition of 109 new useful improvements.

Using Aspose.Words for Java you can work with DOC, OOXML, RTF, HTML, OpenDocument, PDF, XPS, EPUB and other formats in your applications. You can also view, generate, modify, convert, render and print documents all without using Microsoft Word.

Visit the documentation to learn how to get started with Aspose.Words for Java.

Note this download contains a fully working version of the product, however without a license set it will run in evaluation mode with some limitations. To test Aspose.Words without these evaluation limitations you can request a free 30-day temporary license.

The following is a list of changes in this version of Aspose.Words.

Major Features

  • Improved tight wrapping text flow around floating objects
  • Curved WordArt objects rendering implemented (WordArt shapes fit to frames defined by Bezier curves)
  • DrawingML “Glow” effect rendering implemented
  • DrawingML “Outer Shadow” effect rendering implemented
  • DrawingML “Reflection” effect rendering implemented

All Changes

Key Summary Category
WORDSJAVA-690 Saving WordArt with Webdings font to non-Microsoft formats Bug
WORDSJAVA-771 Investigate why does the default locale of JVM changes randomly Bug
WORDSJAVA-805 Text form fields turn into square boxes when converting to PDF over CentOS Bug
WORDSJAVA-807 Exception while converting MS Word document to Pdf after merging Bug
WORDSJAVA-812 Incorrect Wingdings font rendering issue while conversion from Docx to PNG Bug
WORDSJAVA-794 Exception while downloading Aspose.Words for Java examples Exception
WORDSNET-1988 Support transparency in EMF emulated by SRCPAINT and SRCAND raster operations. Bug
WORDSNET-2141 Interval after paragraph is exported incorrectly when paragraph in table cell Bug
WORDSNET-4219 Open template document in SilverLight demos doesn’t work in IE Bug
WORDSNET-4258 UserDocsApiLinker: Paragraph constructor does not link properly Bug
WORDSNET-4948 Image moves to the next page in ODT format Bug
WORDSNET-5445 Text box is rendered with a greater width and less height than it should. Bug
WORDSNET-5451 Text box content is rendered lower than it should be. Bug
WORDSNET-6245 With Aspose generated input Pdf file, PDFBox engine exports image incorrectly(or misplaced) Bug
WORDSNET-8757 A symbol is not preserved during open/save a RTF Bug
WORDSNET-8944 UpdateFields does not respect \n switch inside TOC field Bug
WORDSNET-8951 Indentation of list items increases after DOCX-HTML-DOCX round trip Bug
WORDSNET-8952 Distance between list item label and list item text increases after DOCX-HTML-DOCX round trip Bug
WORDSNET-8955 List item indentation increases after DOCX-HTML-DOCX round trip Bug
WORDSNET-8956 ‘Space After’ value of list items increases after DOCX-HTML-DOCX round-trip Bug
WORDSNET-8957 Header and footer of an empty section become visible when exported to HTML Bug
WORDSNET-8958 Hyperlink text formatting is lost during conversion to HTML Bug
WORDSNET-8979 /Word 2002-2007 style evaluation rules/ Docx to Fixed file format conversion issue with content rendering Bug
WORDSNET-8980 /Word 2002-2007 style evaluation rules/ Text moves to next page after conversion from Docx to Fixed file format. Bug
WORDSNET-9010 Aspose.Words.Document does not import the html styles correctly. Bug
WORDSNET-9048 GetShapeRenderer().Save method incorrectly save DrawingML Bug
WORDSNET-9115 AutoShape objects are not preserved during open/save a RTF Bug
WORDSNET-9177 Incorrect positioning of frame elements after appending two documents Bug
WORDSNET-9219 HTML to Docx conversion issue with table’s cell layout Bug
WORDSNET-9226 Paragraphs are not preserved during open/save a DOCX Bug
WORDSNET-9257 Height/Width of SVG is not same in output Docx/Pdf Bug
WORDSNET-9267 An image is not preserved during open/save RTF Bug
WORDSNET-9269 Character in some words are rendering with different font formatting in HtmlFixed Bug
WORDSNET-9270 A tiff image is incorrectly imported from Aspose.Email generated MHTML file Bug
WORDSNET-9271 Relative position of nested floating Text Boxes is unexpected when rendering Bug
WORDSNET-9274 Aspose.Words throws many warnings when loading DigitalSignature in DOCX Bug
WORDSNET-9275 DocProperty field values are not preserved during open/save a DOCX Bug
WORDSNET-9278 Aspose.Words doesn’t use a barcode font during rendering Bug
WORDSNET-9279 Comment’s alignment is changed from right to left after conversion from Docx to Pdf Bug
WORDSNET-9281 UpdateFields causes TOC to display NO TABLE OF CONTENTS ENTRIES FOUND message Bug
WORDSNET-9282 Unexpected Paragraphs are being displayed in TOC when calling UpdateFields method Bug
WORDSNET-9283 UpdateFields does not build the TOC field correctly Bug
WORDSNET-9284 First page contents are truncated after conversion from Doc to Pdf file format Bug
WORDSNET-9289 A Pie chart and it’s data labels are not rendering correctly in PDF Bug
WORDSNET-9293 Image effect is not preserved in output Pdf file Bug
WORDSNET-9297 Chart does not render correctly in Pdf file after conversion from Docx Bug
WORDSNET-9309 Hyperlinks color is changed after conversion from HTML to Docx/Pdf Bug
WORDSNET-9314 Font changes from Arial to Courier New during open/save a RTF Bug
WORDSNET-9332 Aspose.Words produces a corrupt DOCX file. Bug
WORDSNET-9333 Lines of text imported from <pre> HTML elements have non-zero spacing Bug
WORDSNET-9336 Left and Hanging indentation values are incorrectly imported from HTML Bug
WORDSNET-9337 StructuredDocumentTag does not export correctly in output Doc/Pdf files Bug
WORDSNET-9341 Styles are imported with incorrect settings when importing sections Bug
WORDSNET-9347 Empty spaces are added in table’s cell after conversion from RTF to Doc Bug
WORDSNET-9348 Table’s layout is changed after conversion from RTF to Doc Bug
WORDSNET-9360 BuiltInDocumentProperties.Words return incorrect value Bug
WORDSNET-9379 Images overlap each other in converted HTML file Bug
WORDSNET-9385 Invalid Signature message appear in output Pdf file after conversion from Docx Bug
WORDSNET-9407 Formatting of Paragraph in Shape is not preserved during open/save an ODT Bug
WORDSNET-9427 Aspose.Words renders an invalid signature in PDF/Image formats Bug
WORDSNET-9434 Aspose.Words.FileCorruptedException is thrown while loading Doc file Bug
WORDSNET-1787 Import < thead > and < th > in tables properly Enhancement
WORDSNET-1869 font.color and td.bgcolor are not imported during HTML import. Enhancement
WORDSNET-3855 Shape extrusion doesn’t work Enhancement
WORDSNET-4436 “!Syntax Error” is shown after updating fields. Enhancement
WORDSNET-4630 The copyright year in the CHM documentation is incorrect Enhancement
WORDSNET-4797 There is no documentation for the Underline enumeration Enhancement
WORDSNET-5852 WordArt advanced // While docx to Pdf, Text render incorrectly. Enhancement
WORDSNET-596 Using BR tags within table cells leads to incorrect output Enhancement
WORDSNET-6914 WordArt // Bezier // shape is not rendering correctly in PDF Enhancement
WORDSNET-7422 Disregard paragraph space after for tight wrapping Enhancement
WORDSNET-7465 Incorrect image size and text wrapping Enhancement
WORDSNET-764 Update DocumentBuilder.InsertHtml method with correct handling of runs containing mixed rtl/ltr text. Enhancement
WORDSNET-8017 Add support shape fit to Bezier curves (for all all wordart shapes except ArchUp(Curve), ArchDown(Curve), Circle(Curve), Button(Curve)). Enhancement
WORDSNET-8168 Images are moved towards right Page edge in PDF Enhancement
WORDSNET-8607 An extra blank page is introduced in PDF Enhancement
WORDSNET-8771 Add a remark to the API docs that SVG images are inserted as vector image format EMF Enhancement
WORDSNET-8910 Implement a mechanism to apply several depended CSS properties together to a model format Enhancement
WORDSNET-9015 Add support of :link selectors Enhancement
WORDSNET-9017 Add support of “pre-line” and “pre-wrap” values of “white-space” css property. Enhancement
WORDSNET-9028 Extra paragraph is added to table’s cell so cell becomes higher in HTML import. Enhancement
WORDSNET-9119 Allow more control on how CSS styles are saved when saving to HtmlFixed format Enhancement
WORDSNET-9120 Add HtmlFixedSaveOptions.FontsFolder and HtmlFixedSaveOptions.FontsFolderAlias properties in API Enhancement
WORDSNET-9155 Incorrect text wrapping around a tight-wrapped image Enhancement
WORDSNET-9244 Contents move to next page after conversion from Docx to fixed file format Enhancement
WORDSNET-9261 Move Conversions Explicit long running Unit Tests into the new project Aspose.Words.Test.Longrun Enhancement
WORDSNET-9292 Inaccurate WordArt rendering in output Pdf file Enhancement
WORDSNET-9300 Unsupported path type and rendering mode are encountered during rendering WordArt shapes to PDF Enhancement
WORDSNET-9316 At slash sign a line of text is broken into two lines in PDF Enhancement
WORDSNET-8115 Document.Save method throws System.NullReferenceException on saving Docx to Pdf Exception
WORDSNET-8978 Clickonce network error when installing dashboard Exception
WORDSNET-9251 Null reference exception in PDF conversion Exception
WORDSNET-9280 AcceptAllRevisions throws InvalidCastException Exception
WORDSNET-9302 Aspose.Words.FileCorruptedException occurs when loading HTML file Exception
WORDSNET-9327 An exception is thrown when an HTML document contains the Unicode Noncharacter (U+FFFF) Exception
WORDSNET-9338 OleFormat.SuggestedExtension throws System.IO.EndOfStreamException Exception
WORDSNET-9363 Aspose.Words.FileCorruptedException is thrown while loading MHTML file Exception
WORDSNET-1503 FootNote/Endnote fields inside another Hyperlink field is not converted as separate links during converting the .DOC to .HTML. Feature
WORDSNET-2104 Improve automatic spacing between paragraphs on HTML import Feature
WORDSNET-228 Add “blockquote” tag importing Feature
WORDSNET-6052 Implement Load and Save warnings for ODT format Feature
WORDSNET-7195 3D WordArt doesn’t support shape fit to Bezier curves and has some fill issues Feature
WORDSNET-8818 Contents position is changed after conversion from RTF to Pdf Feature
WORDSNET-8870 Text is missing after conversion from RTF to Pdf Feature
WORDSNET-8959 Second page header and footer become visible in HTML Feature
WORDSNET-9118 Save SVG resources to files when exporting a document to Fixed HTML format. Feature
WORDSNET-9209 Preserve trackmoves revision upon DOCX round-trip. Feature
WORDSNET-9247 Aspose.Words does not use the same font as MS Word does for html to PDF conversion Feature
WORDSNET-9256 A paragraph in cell breaks into two lines when converting to fixed page formats Feature

Public API and Backwards Incompatible Changes

The following is a list of any changes made to the public API such as added, renamed, removed or deprecated members as well as any non-backward compatible change made to Aspose.Words for .NET. If you have concerns about any change listed, please raise it on the Aspose.Words support forum.

DrawingML.GetShapeRenderer Behavior Changed

In earlier versions Aspose.Words always used to use the fallback shape when rendering DrawingML as Aspose.Words was not able to properly render DrawingML. Fallback shapes are prerendered shapes included by Microsoft Word or the host program when the graphics object is created. The current version version can render DrawingMLs on almost the same level as VML Shapes so the behavior of this method has been switched to render the original DrawingML instead of fall back to VML rendering.h3. ExportEmbeddedSvg Property Added to HtmlFixedSaveOptions

The ExportEmbeddedSvg boolean property has been added to HtmlFixedSaveOptions that controls how SVG resources are exported when a document is saved to fixed-page HTML.If the property is set to true (which is the default value) SVG resources are embedded in the HTML document, as before however if the property is set to false, SVG resources are saved to external files. The files are named “svg1.svg”, “svg2.svg”, etc and are placed next to other resource files of the document. If the user provides a callback using HtmlFixedSaveOptions.ResourceSavingCallback this callback will be called for each SVG file. As with images Aspose.Words remembers all SVG files already exported for the document and reuses them to prevent duplication.h3. FirstPageHeaderFooterPerSection Option Added to ExportHeadersFootersMode

A new enumeration value of FirstPageHeaderFooterPerSection has been added to HtmlSaveOptions.ExportHeaderFootersMode that allows you to export first page headers and footers instead of primary headers and footers while exporting to HTML-based formats.h3. Rendering of DrawingML Glow Effect

Starting from 13.12.0 version Aspose.Words supports rendering DrawingML glow effect. The glow effect can be rendered in one of three modes:

  • Simplified (default) - Soft edges are simulated using several layers with different transparency, which gives acceptable result with higher performance than in Fine mode.
  • Fine - Blur filter is applied, which gives the same result as MS Word, but with lower performance because of complexity of convolution filter.
  • None - In this mode no DrawingML effects are rendered.

The different modes can be set using new property: SaveOptions.DmlEffectsRenderingMode.h3. Rendering of DrawingML Glow Effect

Starting from 13.12.0 version Aspose.Words supports rendering of outer shadow DrawingML effect. Effect can be rendered in two modes:

ResourceFileUri Property Added to ResourceSavingArgs

We have added ResourceSavingArgs.ResourceFileUri property that allows users to provide custom uniform resource identifiers (URI) for resources saved to external files during export to SVG and fixed-page HTML formats. When Aspose.Words calls an instance of IResourceSavingCallback provided by user the ResourceFileUricontains the URI generated by Aspose.Words for the resource file.The properties HtmlFixedSaveOptions.ResourcesFolderAlias and SvgSaveOptions.ResourcesFolderAlias already exist that modify URIs of external resources, but these properties have the following limitations:

  • It is impossible to provide different aliases for individual resource files. 
  • Generated URIs have the form “alias/filename”, which is fixed. For example, it is impossible to change the order of the alias and the file name or remove the slash character that separates them.

The new property ResourceSavingArgs.ResourceFileUri does not have the limitations of resource aliases and allows more control over URI construction. However, resource aliases are still useful in simple scenarios where resource saving callbacks introduce unnecessary overhead.h3. SaveOptions.DmlRenderingMode Introduced

Within a separate fix a new option SaveOptions.DmlRenderingMode was introduced. It allows users to control how DrawingML shapes are rendered to fixed page formats. It has two possible values:

TOC Field Switch to Omit Page Numbers is Supported

The “\n” switch in TOC fields to omit page numbering during field generation is now supported. Any TOC field with this switch present will have page numbering removed. In previous versions this switch was ignored.h3. Trackmove Revisions Supported upon DOCX Round-trip

In previous versions moving a portion of a document to another part of the document when tracked changed enabled would create a separate delete and insertion revision for the move. In this version the trackmove revision is now supported and the same edit will appear as a single move operation.