Release Notes

2.0 (08/20/2024)

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 <static> 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 <static> 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’.

1.1 (01/12/2024)

Improved

• Optimized compatibility with browsers. » Detail

Added

• Added the namespace Dynamsoft.DDV.Core.

• Added the property license to specify the license string.

• Added the property engineResourcePath to specify the path leading to a folder containing the distributed WASM files.

• Added the property deviceFriendlyName to specify a human-readable name for the device which corresponds to its UUID.

• Added the method loadWasm() to load WASM modules before initializing.

• Added the method init() to initialize DDV.

• Added the method insertBlankPage() to insert a blank page to the document.

Removed

The following API is removed.

1.0.0 (12/26/2023)

Dynamsoft Document Viewer (DDV) is a versatile SDK designed to offer a range of viewers for configuring and executing various document processing workflows.

Highlights

Efficient Data Management

Organize, retrieve, and manage documents and pages efficiently:

• Document Management: Document creation/deletion/merging, etc.
• Page management: Pages in documents loading/saving/deleting/moving, etc.

Various Viewers

Various kinds of viewers implement different document processing flows:

• Edit Viewer: Edit the pages in document, such as, rotating, cropping, filtering, etc. and adjust the layout of the display.
• Capture Viewer: Control camera, play video stream, and capture the images from camera.
• Perspective Viewer: Do page boundaries manual adjustment & perspective transformation.
• Browse Viewer: Display pages in multiple-mode, pages can be multiple selected.
• Custom Viewer: No built-in UI or functionality, which is used for creating your own viewer.

Flexible Customization

Besides using the default user interface and viewer directly, developers can easily and flexibly customize them:

• User Interface: Layout, elements
• Viewer: Styles, viewer properties

Advanced Features

DDV provides methods to access document boundaries detection and image filter algorithms.

• Image filter: Image filter algorithm which is used by Filter element in Edit Viewer.
• Document detection: Document boundaries detection algorithm which is used during capturing images. Recommend using Dynamsoft Document Normalizer.