Dynamic Web TWAIN SDK for Scanners

Cross-platform and cross-browser JavaScript library for web document scanning. Interact with document scanners from Chrome, Firefox and more.

Introduction
Online Demo
License Key
Installation
Deployment
Quick Start
Documentation
Features
Contact Us
License Agreement
Versions

Introduction

Dynamic Web TWAIN is a cross-platform scanning SDK designed for web document management applications. With just a few lines of JavaScript code, you can develop robust web applications to scan documents, edit images and save them to file systems on Windows, Linux and macOS. You can even use your mobile devices running iOS | iPadOS | Android with the library starting in 17.0!

Supported OSs

Windows
Linux
macOS
Android / iOS (Remote scanner or camera)

Supported CPU Architectures

x86/x64
MIPS64
ARM64

Supported Web Browsers

Firefox
Edge
Chrome
Safari

Online Demo

Interact with document scanners from Chrome, Firefox and more

https://demo.dynamsoft.com/web-twain/

License Key

To get a free trial, please visit https://www.dynamsoft.com/customer/license/trialLicense?product=dwt.

Installation

Official web site

Dynamic Web TWAIN SDK for Windows, Linux, macOS
NPM
```
npm install dwt
```

A Virtual Scanner

If you do not have a physical scanner to test on Windows, you can install a virtual scanner.

Virtual Scanner for Windows

Deployment

Dynamic Web TWAIN relies on the files in the /dist/ folder to work. Make sure to put these files on your server and correctly refer to them by specifying the path with ResourcesPath (relative and absolute paths are both fine).

If you are making use of the CDN jsDelivr, you will still need to host the /dist/ folder somewhere on your server and refer to it by specifying the path with ResourcesPath. This is because file types like .msi are not allowed by this CDN.

Quick Start

Step 1 Create a HTML page and load `dynamsoft.webtwain.min.js` into your page:

<!DOCTYPE html>
<html>
<head>
 <title>Hello World</title>
 <script src="dist/dynamsoft.webtwain.min.js"></script>
</head>
<body>
</body>
</html>

Note that a relative path is used. You might want to change it based on where you are putting your code. The best practise is to put all the files on your own server and under the same domain as your web application.

Step 2 Add a script tag and make initial settings:

<!DOCTYPE html>
<html>
<head>
 <title>Hello World</title>
 <script src="dist/dynamsoft.webtwain.min.js"></script>
</head>
<body>
 <script type="text/javascript">
   Dynamsoft.DWT.ResourcesPath = "dist";
   Dynamsoft.DWT.ProductKey = 't0140cQMAA...';
 </script>
</body>
</html>

Note that ResourcesPath must be set in order to use the library.

ResourcesPath is a relative path to where you put the directory "/dist/" and all the files in it.
If you don't have a valid ProductKey, you can request a trial key to use.

Step 3 Write code to use the package to do a simple document scan

The following code demonstrates the minimum code needed to use the package. Note the addition of HTML elements as well as JavaScript code. For more sophisticated sample or demo, check out the Sample Gallery and our Github Repositories.

<!DOCTYPE html>
<html>
<head>
 <title>Hello World</title>
 <script src="dist/dynamsoft.webtwain.min.js"></script>
</head>
<body>
 <input type="button" value="Scan" onclick="AcquireImage();" />
 <div id="dwtcontrolContainer"></div>
 <script type="text/javascript">
   Dynamsoft.DWT.ResourcesPath = "dist";
   Dynamsoft.DWT.ProductKey = 't0140cQMAA...'; // Put your own key here
   window.onload = function () {
     Dynamsoft.DWT.Load();
   };
   var DWObject;
   function Dynamsoft_OnReady() {
     // dwtcontrolContainer is the id of the DIV to create the WebTwain instance in.
     DWObject = Dynamsoft.DWT.GetWebTwain('dwtcontrolContainer');
   }
   function AcquireImage() {
     if (DWObject) {
       DWObject.SelectSource(function () {
         DWObject.OpenSource();
         DWObject.AcquireImage(
           {
             PixelType: Dynamsoft.EnumDWT_PixelType.TWPT_RGB,
             Resolution: 200,
             IfDisableSourceAfterAcquire: true
           },
           function () {
             console.log("Successful!");
           },
           function (settings, errCode, errString) {
             alert(errString)
           }
         );
       }, function () {
         alert('SelectSource failed!');
       });
     }
   }
 </script>
</body>
</html>

Documentation

Features

Document Scanning
Document Editing
Saving, Uploading and Downloading
Opening Local Files

Document Scanning	Desktop	Mobile
Supports up to TWAIN specification 2.3	Windows Client Only	N/A
SANE compatible	Linux Client Only	N/A
Supports up to TWAIN specification 1.9; ICA compatible	macOS Client Only	N/A
Supports capturing via built-in mobile camera	N/A	✓
Optional disk caching mechanism for high volume scanning (thousands of pages)	✓	N/A
Built-In Auto Document Feeder (ADF) and multiple image acquisition	✓	N/A
Offers duplex scanning mode	✓	N/A
Supports blank page detection	✓	N/A
Built-in wizard mode intelligently manages TWAIN states	✓	N/A
Supports setting up image acquisition parameters (resolution, pixel type, bit depth, brightness, contrast, page size, unit, etc.)	✓	N/A
Provides native and disk file image transfer modes	✓	N/A
Buffered memory transfer mode	Windows Client Only	N/A

Contact Us

Contact Dynamsoft to resolve any issue you encounter with the library.

License Agreement

https://www.dynamsoft.com/Products/WebTWAIN_License.aspx

Versions

Dynamsoft Service (DynamsoftService.exe, 64bit)

v17.1 (build version 1, 7, 0, 0330)

Dynamsoft Service Manager (DWASManager_17100525.dll, 64bit)

v17.1 (build version 17, 1, 0, 0525)

Dynamic Web TWAIN (dwt_17.1.0.0525.dll, 64bit)

v17.1 (build version 17, 1, 0, 0525)

Dynamsoft PDF Rasterizer (DynamicPdfRx64_11.2.0.0330.dll, 64bit)

v17.1 (build version 11, 2, 0, 0330)

Dynamsoft OCR Basic Engine (DynamicOCRx64_10.0.0.0618.dll, 64bit)

v17.1 (build version 10, 0, 0, 0618)

Dynamsoft Barcode Reader (dbrx64_8.2.0.0525.dll, 64bit)

v8.2.0 (build version 8, 2, 0, 0525)

Dynamsoft Webcam Addon (DynamicWebcamx64_15.0.0.0625.dll, 64bit)

v17.1 (build version 15, 0, 0, 0625)

Dynamsoft Upload Module (UploadModule_1.7.1.0525.dll, 64bit)

v17.0 (build version 1, 7, 1, 0525)

Changelog

Check out the release notes of the Dynamic Web TWAIN library.

cyhuauin / dynamic-web-twain Goto Github PK

dynamic-web-twain's Introduction