Dynamic Web TWAIN SDK for Scanner and Camera
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. To see it in action, please visit this online demo
Note: Dynamic Web TWAIN SDK v18.4.2 is built in this package. For more detail, check the Version Info.
Table of Contents
- Supported Environments
- License Key
- Installation
- Deployment
- Quick Start
- Documentation
- Features
- Contact Us
- License Agreement
- Versions
Supported Environments
Supported Image Capturing Devices
- Physical Document Scanners
- Desktop Webcam
- Mobile Camera
Supported Web Browsers
- Chrome
- Firefox
- Edge
- Safari
Supported OSs
- Windows
- Linux
- macOS
- Android
- iOS (Remote scanner)
Supported CPU Architectures
- x86/x64
- MIPS64
- ARM64
License Key
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.
Read more here.
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...';
Dynamsoft.DWT.Containers = [{ ContainerId: 'dwtcontrolContainer', Width: 270, Height: 350 }];
</script>
</body>
</html>Note that
ResourcesPathmust be set in order to use the library.
-
ResourcesPathis 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
Dynamsoft.DWT.Containers = [{ ContainerId: 'dwtcontrolContainer', Width: 270, Height: 350 }];
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.SelectSourceAsync().then(function(){
return DWObject.AcquireImageAsync({
PixelType: Dynamsoft.DWT.EnumDWT_PixelType.TWPT_RGB,
Resolution: 200,
IfCloseSourceAfterAcquire: true
});
}).catch(function (exp) {
alert(exp.message);
});
}
}
</script>
</body>
</html>Documentation
Features
Dynamsoft Service for Scanner
| Features | Windows | Linux | macOS |
|---|---|---|---|
| Supports up to TWAIN specification 2.3 | ✔️ | ❌ | ❌ |
| SANE compatible | ❌ | ✔️ | ❌ |
| Supports up to TWAIN specification 1.9; ICA compatible | ❌ | ❌ | ✔️ |
| Supports capturing document | ✔️ | ✔️ | ✔️ |
| Supports editing document | ✔️ | ✔️ | ✔️ |
| Optional disk caching mechanism for high volume scanning (thousands of pages) | ✔️ | ✔️ | ✔️ |
| Built-In Auto Document Feeder (ADF) and multiple image acquisition | ✔️ | ✔️ | ✔️ |
| Offers duplex scanning mode | ✔️ | ✔️ | ✔️ |
| Supports blank page detection | ✔️ | ✔️ | ✔️ |
| Supports setting up image acquisition parameters (resolution, pixel type, bit depth, brightness, contrast, page size, unit, etc.) | ✔️ | ✔️ | ✔️ |
| Provides native and disk file image transfer modes | ✔️ | ✔️ | ✔️ |
| Buffered memory transfer mode | ✔️ | ❌ | ❌ |
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)v18.4.2 (build version 1, 8, 4, 1110)
Dynamsoft Service Manager (DWASManager_18421110.dll, 64bit)v18.4.2 (build version 18, 4, 2, 1110)
Device Manager (DeviceManager_18400926.dll, 64bit)v18.4.2 (build version 18, 4, 0, 0926)
Dynamic Web TWAIN (dwt_18.4.2.1110.dll, 64bit)v18.4.2 (build version 18,4, 2, 1110)
Dynamsoft PDF Rasterizer (DynamicPdfRx64_11.5.1.0926.dll, 64bit)v18.4.2 (build version 11, 5, 1, 0926)
Dynamsoft Barcode Reader (dbrx64_9.6.0.0926.dll, 64bit)v9.6.0 (build version 9, 6, 0, 0926)
Dynamsoft Webcam Addon (DynamicWebcamx64_15.0.0.0625.dll, 64bit)v18.4.2 (build version 15, 0, 0, 0625)
Dynamsoft Upload Module (UploadModule_1.8.4.0926.dll, 64bit)v18.4.2 (build version 1, 8, 4, 0926)
Changelog
Check out the release notes of the Dynamic Web TWAIN library.
Note
If you are upgrading from the old versions to V17.1+, please add the following code after Dynamsoft.DWT.ProductKey to make Dynamsoft.DWT.Load take effect.
Dynamsoft.DWT.Containers = [{ ContainerId: 'dwtcontrolContainer', Width: 270, Height: 350 }];
Otherwise, the initialization will fail.
