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

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

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.