Skip to content

Commit add50e0

Browse files
update to Document-Viewer-Javascript 3.0
1 parent 450cab2 commit add50e0

17 files changed

+864
-386
lines changed

LICENSE.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Copyright © 2003–2024 Dynamsoft. All Rights Reserved.
1+
Copyright © 2003–2025 Dynamsoft. All Rights Reserved.
22

33
The use of this software is governed by the Dynamsoft Terms and Conditions.
44
https://www.dynamsoft.com/company/license-agreement/

README.md

Lines changed: 52 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -4,72 +4,81 @@
44
![downloads](https://img.shields.io/npm/dm/dynamsoft-document-viewer.svg)
55
![jsdelivr](https://img.shields.io/jsdelivr/npm/hm/dynamsoft-document-viewer.svg)
66

7+
## Table of Contents
8+
9+
- [Introduction](#introduction)
10+
- [System Requirements](#system-requirements)
11+
- [License Key](#license-key)
12+
- [Adding the dependency](#adding-the-dependency)
13+
- [Creating HelloWorld](#creating-helloworld)
14+
- [Documentation](#documentation)
15+
- [Features](#features)
16+
- [Contact Us](#contact-us)
17+
- [License Agreement](#license-agreement)
18+
- [Changelog](#changelog)
19+
20+
## Introduction
21+
722
[Dynamsoft Document Viewer (DDV)](https://www.dynamsoft.com/document-viewer/docs/introduction/index.html) is a browser-based JavaScript SDK designed for viewing and editing images and PDFs. It provides a wide range of functionalities, including PDF annotation, page manipulation, image quality enhancement, and document saving.
823

9-
#### Security
10-
Dynamsoft Document Viewer is independently developed and does not rely on any external third-party open-source software. All processing, such as rendering and editing, is securely performed within the browser using a web assembly module. This architecture eliminates the need for a server-side backend, ensuring security compliance and scalability.
24+
### Security
25+
26+
Dynamsoft Document Viewer does not rely on any external third-party JavaScript library. All processing, such as rendering and editing, is securely performed within the browser. This architecture eliminates the need for a server-side backend, ensuring security compliance and scalability.
27+
28+
### Browser and Platform Compatibility
1129

12-
#### Browser and Platform Compatibility
1330
Dynamsoft Document Viewer is designed to work seamlessly across different browsers and platforms. It is compatible with major browsers like Chrome, Firefox, Safari, and Edge, ensuring a consistent user experience. Additionally, it supports various operating systems, including Windows, macOS, Linux, iOS, and Android, allowing users to access documents from any device.
1431

15-
#### Supported File Types
16-
Users can open, edit, and save PDFs, as well as various image formats such as JPEG, PNG, and TIFF.
32+
### Supported File Types
33+
34+
Users can open, edit, and save PDFs, as well as images in various formats, such as JPEG, PNG, and TIFF.
35+
36+
### Annotation Types
1737

18-
#### Annotation Types
1938
Dynamsoft Document Viewer supports a variety of annotation types to enhance document interaction and collaboration. Users can add, edit, and delete annotations such as:
2039

2140
- text
22-
- images
23-
- signature
24-
- shapes
25-
- stamps
26-
- freehand drawings
41+
- highlight
42+
- underline
43+
- strikeout
44+
- shape
45+
- stamp
46+
- freehand drawing
47+
48+
### Data Management Concepts
2749

28-
#### Data Management Concepts
29-
Dynamsoft Document Viewer organizes data using two main concepts: “document” and “page.” A document can contain one or multiple pages, and each page must belong to a single document.
50+
Dynamsoft Document Viewer organizes data using two main concepts: "document" and "page". A document can contain one or multiple pages, and each page must belong to a single document.
3051

31-
Page: The smallest unit of data management, currently represented as an image. Each page has a unique pageUid.
32-
Document: A collection of pages, each with a unique docUid. Documents collectively make up the entire data set.
52+
- Page: The smallest unit of data management, currently represented as an image. Each page has a unique pageUid.
53+
- Document: A collection of pages, each with a unique docUid. Documents collectively make up the entire data set.
3354
Managing data, therefore, involves managing documents and pages.
3455

3556
If you are using the default UI of DDV, data processing and management are handled internally.
3657

37-
#### UI Customization
38-
The SDK offers extensive customization options, enabling developers to tailor the interface, toolbar, and annotation tools to meet specific application needs and branding requirements.
58+
### UI Customization
3959

40-
#### Designed with Camera Capture in Mind
41-
Dynamsoft Document Viewer is designed for seamless integration with camera capture. It features five built-in viewer types, with the first three optimized for camera capture scenarios:
42-
- Edit Viewer: Provides image quality enhancement filters.
60+
The SDK offers extensive customization options, enabling developers to tailor the UI to meet specific application needs and branding requirements.
4361

44-
- Capture Viewer: Includes built-in camera control for continuous capture.
62+
### Designed with Camera Capture in Mind
4563

46-
- Perspective Viewer: Equipped with document cropping features; for document detection, using Dynamsoft Document Normalizer is recommended.
64+
Dynamsoft Document Viewer is designed for seamless integration with camera capture. It features five built-in viewer types, with the first three optimized for camera capture scenarios:
4765

66+
- Edit Viewer
67+
- Capture Viewer
68+
- Perspective Viewer
4869
- Browse Viewer
49-
5070
- Custom Viewer
5171

52-
As part of the Mobile Web Capture solution, this viewer helps developers create efficient, accurate, and user-friendly workflows, from camera capture to document finalization.
72+
The viewers help developers create efficient, accurate, and user-friendly workflows, from camera capture to document finalization.
5373

54-
## Table of Contents
55-
56-
- [System Requirements](#system-requirements)
57-
- [License Key](#license-key)
58-
- [Adding the dependency](#adding-the-dependency)
59-
- [Creating HelloWorld](#creating-helloworld)
60-
- [Documentation](#documentation)
61-
- [Features](#features)
62-
- [Contact Us](#contact-us)
63-
- [License Agreement](#license-agreement)
64-
- [Changelog](#changelog)
6574

66-
# System Requirements
75+
## System Requirements
6776

6877
The SDK requires the following features to work:
6978

7079
- `WebAssembly`, `Blob`, `URL`/`createObjectURL`, `Web Workers`
7180

72-
## Supported Browsers
81+
Supported Browsers:
7382

7483
The following table is a list of supported browsers based on the above requirements:
7584

@@ -84,17 +93,17 @@ Apart from the browsers, the operating systems may impose some limitations of th
8493

8594
## License Key
8695

87-
[![](https://img.shields.io/badge/Get-30--day%20FREE%20Trial%20License-blue)](https://www.dynamsoft.com/customer/license/trialLicense/?product=mwc&utm_source=npm)
96+
[![](https://img.shields.io/badge/Get-30--day%20FREE%20Trial%20License-blue)](https://www.dynamsoft.com/customer/license/trialLicense/?product=ddv&utm_source=npm)
8897

89-
## Adding the dependency
98+
## Adding the Dependency
9099

91100
Please refer to [this article](https://www.dynamsoft.com/document-viewer/docs/gettingstarted/add_dependency.html).
92101

93102
## Creating HelloWorld
94103

95-
[How to create HelloWorld](https://www.dynamsoft.com/document-viewer/docs/gettingstarted/helloworld.html)
104+
Please refer to the guide: [How to create HelloWorld](https://www.dynamsoft.com/document-viewer/docs/gettingstarted/helloworld.html)
96105

97-
Review the complete code:
106+
Complete code:
98107

99108
```html
100109
<!DOCTYPE html>
@@ -128,14 +137,13 @@ Review the complete code:
128137
<script type="module">
129138
(async () => {
130139
// Public trial license which is valid for 24 hours
131-
// You can request a 30-day trial key from https://www.dynamsoft.com/customer/license/trialLicense/?product=mwc
140+
// You can request a 30-day trial key from https://www.dynamsoft.com/customer/license/trialLicense/?product=ddv
132141
Dynamsoft.DDV.Core.license = "DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9";
133142
Dynamsoft.DDV.Core.engineResourcePath = "https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@latest/dist/engine";
134143
await Dynamsoft.DDV.Core.init();
135-
Dynamsoft.DDV.setProcessingHandler("imageFilter", new Dynamsoft.DDV.ImageFilter());
136144
const editViewer = new Dynamsoft.DDV.EditViewer({
137145
container: "container",
138-
uiConfig: Dynamsoft.DDV.getDefaultUiConfig("editViewer", {includeAnnotationSet: true}),
146+
uiConfig: Dynamsoft.DDV.getDefaultUiConfig("editViewer"),
139147
});
140148
})();
141149
</script>
@@ -147,30 +155,6 @@ Review the complete code:
147155
* [Developer's Guide](https://www.dynamsoft.com/document-viewer/docs/introduction/index.html)
148156
* [API Reference](https://www.dynamsoft.com/document-viewer/docs/api/index.html)
149157

150-
## Features
151-
152-
Generally, the features of DDV can be divided to two parts as below.
153-
154-
### Data Management
155-
156-
Data management is to manage the data which is imported into DDV. It is managed from the following three aspects:
157-
158-
- Document Management: Document creation/deletion/merging, etc.
159-
- Page management: Pages in documents loading/saving/deleting/moving, etc.
160-
- Annotation management: Adding/deleting/selecting/dragging/resizing/rotating annotations, etc.
161-
162-
### Viewers
163-
164-
Viewers are used to display the data. According to the different uses of viewers, DDV provides five different viewer types, which are implemented through five viewer classes.
165-
166-
- Edit Viewer: Edit the pages in document, such as, rotating, cropping, filtering, annotating, etc. and adjust the layout of the display.
167-
- Capture Viewer: Control camera, play video stream, and capture the images from camera.
168-
- Perspective Viewer: Do page boundary manual adjustment & perspective transformation.
169-
- Browse Viewer: Display pages in multiple-mode, pages can be multiple selected.
170-
- Custom Viewer: No built-in UI or functionality, which is used for creating your own viewer.
171-
172-
[More](https://www.dynamsoft.com/document-viewer/docs/features/index.html)
173-
174158
## Contact Us
175159

176160
[Contact Dynamsoft](https://www.dynamsoft.com/company/contact/) to resolve any issue you encounter with the library.

dist/ddv.css

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

dist/ddv.es.js

Lines changed: 5 additions & 5 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

dist/ddv.js

Lines changed: 10 additions & 10 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

dist/engine/ddv-crypto.wasm

-602 KB
Binary file not shown.

dist/engine/ddv-imagecore.wasm

-1.46 MB
Binary file not shown.

dist/engine/ddv-imageio.wasm

5.49 MB
Binary file not shown.

dist/engine/ddv-imageio.worker.js

Lines changed: 10 additions & 12 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.
730 KB
Binary file not shown.

0 commit comments

Comments
 (0)