2.0.0

We are excited to introduce version 2.0, which focuses on adding a powerful new annotation feature. This release includes comprehensive support for various types of annotations, new APIs for managing annotations, and advanced UI capabilities for seamless interaction.

Supported Annotation Types:

• Rectangle
• Ellipse
• Polygon
• Polyline
• Line
• Ink
• TextBox
• TextTypewriter
• Stamp

Built-in UI for Annotation

Direct Annotation Operations in the UI

• Add, select, and delete annotations
• Drag, resize, and rotate selected annotations
• Real-time editing of annotation styles using the palette

New Built-in Elements

• Added built-in elements to enhance UI configuration flexibility.

New APIs for Annotation

• Added the namespace Dynamsoft.DDV.annotationManager and APIs for annotation management:

• Create, delete, and retrieve annotations based on various conditions

• Adjust annotation hierarchy

• Handle events triggered by annotation operations

• Added the property annotationConfig to EditViewerConstructorOptions for configuring the annotations in the viewer, including the toolbar, palette, and default annotation style:

• annotationSelectionStyle: Defines the style of annotation selection.

• inkCreateDelay: Specifies the delay for ink creation to support annotations created in multiple strokes.

• showOnTopWhenSelected: Determines whether the selected annotation should be displayed on the top layer.

• Added the method addFonts() to add fonts to the library.

• Added the method selectAnnotations() to select the specified annotation(s) on the current page.

• Added the method getSelectedAnnotations() to retrieve selected annotation(s).

• Add properties mediaBox and cropBox to PageData for accurate annotation position calculation.

• Added the property annotationMode to specify or return the annotation mode of the viewer.

• Add the property saveAnnotation to the interfaces SavePngSettings, SaveJpegSettings, or SaveTiffSettings to determine whether annotations are saved as part of the image when calling document.saveToPng(), document.saveToJpeg(), or document.saveToTiff().

• Added the property saveAnnotation to the interface SavePdfSettings to configure whether annotations should be saved when document.saveToPdf() is called.

• Add the parameter defaultUiConfigOptions to getDefaultUiConfig() to retrieve configurations including annotations.

• Add the parameter printSettings to the document.print() to specify whether printable annotations should be included in the print.

• Added the type annotation to ToolMode to enable a mode that allows annotations to be manipulated via the UI.

• Added the type annotationSelectionStyle to EditViewerStyleName for retrieving or updating the annotation selection style.

Other New APIs

Additionally, we’ve optimized performance and added several new features to enhance the overall user experience.

• Added the property password to the interface SavePdfSettings for configuring the password of the PDF file to save when document.saveToPdf() is called.

• Added the property imageScaleFactor to the interface SavePdfSettings for configuring the image scale factor of the PDF file to be saved when document.saveToPdf() is called.

Improved

• Optimize the display effect of images in thumbnails.
• Optimize the interactive experience of scaling.
• Modified the type of PdfSource.renderOptions.renderAnnotations to support reading annotations.
• The method openDocument() supports the UID or the document object. This affects the openDocument() method in the EditViewer, PerspectiveViewer, CaptureViewer, and BrowseViewer classes.

Changed

• Change the length unit from pixel to point for functions and events related to cropping, for example, crop(), getCropRect(), setCropRect(), cropRectDrawn, cropRectDeleted,cropRectModified.
• Change the units of the parameters pageWidth and pageHeight in the method insertBlankPage from inches to points.
• The related date string format change shifts from format D:YYYYMMDDHHmmSS to D:YYYYMMDDHHmmSSOHH’mm’.