You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
As presented in the standard [initialization guide]({{site.general-usage}}initialization.html), DWT instantiates a default `WebTwain` object in its default configuration. Here, we offer some alternative ways to instantiate `WebTwain` objects, as well as ways to alter the configuration of `WebTwain` objects.
16
16
17
-
> Note: jsDelivr currently has problems delivering the Dynamsoft Service installer (`https://cdn.jsdelivr.net/npm/dwt@latest/dist/dist/DynamsoftServiceSetup.msi`) due to [size restrictions](https://www.jsdelivr.com/documentation#id-configuring-a-default-file-in-packagejson); please consider hosting this particular resource file elsewhere. UKPKG is currently unaffected. For information about the Dynamsoft Service, learn more [here]({{site.extended-usage}}dynamsoft-service-configuration.html).
17
+
> Note: jsDelivr currently has problems delivering the Dynamic Web TWAIN Service installer (`https://cdn.jsdelivr.net/npm/dwt@latest/dist/dist/DynamicWebTWAINServiceSetup.msi`) due to [size restrictions](https://www.jsdelivr.com/documentation#id-configuring-a-default-file-in-packagejson); please consider hosting this particular resource file elsewhere. UKPKG is currently unaffected. For information about the Dynamic Web TWAIN Service, learn more [here]({{site.extended-usage}}dynamsoft-service-configuration.html).
18
18
19
19
## Auto-Loading with CDN/Package Manager Resources
20
20
@@ -77,7 +77,7 @@ APIs used:
77
77
78
78
Setting values for `Dynamsoft.DWT.AutoLoad` and `Dynamsoft.DWT.Containers` results in identical startup behavior for resources obtained from CDNs and package managers to resources obtained from the official SDK.
79
79
80
-
> Note: jsDelivr currently has problems delivering the Dynamsoft Service installer (`https://cdn.jsdelivr.net/npm/dwt@latest/dist/dist/DynamsoftServiceSetup.msi`) due to [size restrictions](https://www.jsdelivr.com/documentation#id-configuring-a-default-file-in-packagejson); please consider hosting this particular resource file elsewhere. UKPKG is currently unaffected. For information about the Dynamsoft Service, learn more [here]({{site.extended-usage}}dynamsoft-service-configuration.html).
80
+
> Note: jsDelivr currently has problems delivering the Dynamic Web TWAIN Service installer (`https://cdn.jsdelivr.net/npm/dwt@latest/dist/dist/DynamicWebTWAINServiceSetup.msi`) due to [size restrictions](https://www.jsdelivr.com/documentation#id-configuring-a-default-file-in-packagejson); please consider hosting this particular resource file elsewhere. UKPKG is currently unaffected. For information about the Dynamic Web TWAIN Service, learn more [here]({{site.extended-usage}}dynamsoft-service-configuration.html).
Copy file name to clipboardExpand all lines: articles/extended-usage/buffer-caching.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,15 +2,15 @@
2
2
layout: default-layout
3
3
needAutoGenerateSidebar: true
4
4
title: Dynamic Web TWAIN SDK Guide - Buffer Caching
5
-
keywords: Dynamic Web TWAIN, Documentation, Deployment, Dynamsoft Service, caching, buffer,
6
-
breadcrumbText: Dynamsoft Service
7
-
description: Dynamic Web TWAIN SDK Documentation Dynamsoft Service Page
5
+
keywords: Dynamic Web TWAIN, Documentation, Deployment, Dynamic Web TWAIN Service, caching, buffer,
6
+
breadcrumbText: Dynamic Web TWAIN Service
7
+
description: Dynamic Web TWAIN SDK Documentation Dynamic Web TWAIN Service Page
8
8
permalink: /extended-usage/buffer-caching.html
9
9
---
10
10
11
11
# Buffer Caching
12
12
13
-
The DWT image buffer is controlled by the Dynamsoft Service. The Dynamsoft Service can run in either 32-bit mode or 64-bit mode. Before DWT version 15.0, the service ran in 32-bit mode by default. This meant it could not address more than 2GB of physical memory. <!--We introduced the 64-bit version of the service in DWT version 14.0. -->Starting in version 15.0, the Dynamsoft Service runs as 64-bit by default on 64-bit operating systems, which removes the 2GB memory limit. To limit memory usage, DWT can cache data to disk to free up memory.
13
+
The DWT image buffer is controlled by the Dynamic Web TWAIN Service(formerly known as Dynamsoft Service). The Dynamic Web TWAIN Service can run in either 32-bit mode or 64-bit mode. Before DWT version 15.0, the service ran in 32-bit mode by default. This meant it could not address more than 2GB of physical memory. <!--We introduced the 64-bit version of the service in DWT version 14.0. -->Starting in version 15.0, the Dynamic Web TWAIN Service runs as 64-bit by default on 64-bit operating systems, which removes the 2GB memory limit. To limit memory usage, DWT can cache data to disk to free up memory.
14
14
15
15
## Disk Caching
16
16
@@ -24,17 +24,17 @@ You can also set how much memory `Dynamic Web TWAIN` can use before images start
24
24
25
25
Although you can scan and load as many images as you like, you may want to handle them in smaller volumes when doing further processing. For example, when dealing with extremely large volumes, you should not try to upload or save the images all at once as that would be too time consuming and prone to errors.
26
26
27
-
## Save the encrypted image caches in local Dynamsoft Service folder
27
+
## Save the encrypted image caches in local Dynamic Web TWAIN Service folder
28
28
29
29
In certain scenarios, there may be requirements to store encrypted image caches on a local disk for temporary data storage or backup purposes. For instance, when scanning a large batch of documents, accidentally closing the web page can result in the loss of scanned data, necessitating scanning the documents again. This issue can be mitigated by backing up the data before closing the page.
30
30
31
-
Starting from version 18.5, Dynamic Web TWAIN introduces a new feature that facilitates developers in securely storing image caches in encrypted form within the Dynamsoft Service folder. This feature offers several advantages:
31
+
Starting from version 18.5, Dynamic Web TWAIN introduces a new feature that facilitates developers in securely storing image caches in encrypted form within the Dynamic Web TWAIN Service(formerly known as Dynamsoft Service) folder. This feature offers several advantages:
32
32
33
33
- Data is stored securely in encrypted form.
34
34
- The speed of storing data locally and loading it back into the Dynamic Web TWAIN buffer is fast.
35
35
- The stored data remains intact even when the `WebTwain` instance is destroyed.
36
36
37
-
> Note: Since the storage folder is located within the Dynamsoft Service directory, the stored data will be lost if Dynamsoft Service is uninstalled. Upgrading the Dynamsoft Service will not affect the storage folder.
37
+
> Note: Since the storage folder is located within the Dynamic Web TWAIN Service directory, the stored data will be lost if Dynamic Web TWAIN Service is uninstalled. Upgrading the Dynamic Web TWAIN Service will not affect the storage folder.
38
38
39
39
### Create a storage folder
40
40
@@ -50,9 +50,9 @@ var storageItemUid = await DWTObject.createLocalStorage(folderSettings);
50
50
Please ensure to set a strong password to enhance data security, especially in multi-user login scenarios.
51
51
52
52
The local directory of the created storage folder is under
- Windows: `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN Service {versionnumber}\storage`(version 18.5.1 and earlier `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_{versionnumber}\storage`)
54
+
- macOS: `Go > Applications > Dynamsoft > Dynamic Web TWAIN Service {versionnumber} > storage`(version 18.5.1 and earlier `Go > Applications > Dynamsoft > DynamsoftServicex64_{versionnumber} > {installed version No.} > storage`)
55
+
- Linux: `/opt/dynamsoft/Dynamic Web TWAIN Service {versionnumber}/storage`(version 18.5.1 and earlier `/opt/dynamsoft/DynamsoftService/storage`)
> This article is meant exclusively for the Desktop Service Edition of Dynamic Web TWAIN.
15
15
16
-
The Dynamsoft Service is the core piece of Dynamic Web TWAIN when running in Service mode. It handles the communication between hardware (scanner, webcam, etc.) and browser, manages the image buffer, and coordinates data between different modules.
16
+
The Dynamic Web TWAIN Service is the core piece of Dynamic Web TWAIN when running in Service mode. It handles the communication between hardware (scanner, webcam, etc.) and browser, manages the image buffer, and coordinates data between different modules.
17
17
18
18
### IP and ports
19
19
20
-
The Dynamsoft Service uses `localhost` and `18622``18625` ports for HTTP connection and `18623``18626` ports for HTTPS connection.
20
+
The Dynamic Web TWAIN Service uses `localhost` and `18622``18625` ports for HTTP connection and `18623``18626` ports for HTTPS connection.
21
21
These ports can be configured in the `DSConfiguration.ini` file located in:
- Windows: `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_{versionnumber}`)
23
+
- macOS: `Go > Applications > Dynamsoft > Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `Go > Applications > Dynamsoft > DynamsoftServicex64_{versionnumber} > {installed version No.}`)
24
+
- Linux: `/opt/dynamsoft/Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `/opt/dynamsoft/DynamsoftService`)
25
25
26
26
### Access-Control-Allow-Origin
27
27
28
-
For security purposes, you may want the Dynamsoft Service to only respond to requests from specified origins. Starting from Dynamic Web TWAIN version 18.5, this can be achieved by adding `Access-Control-Allow-Origin` in the `DSConfiguration.ini` file.
28
+
For security purposes, you may want the Dynamic Web TWAIN Service to only respond to requests from specified origins. Starting from Dynamic Web TWAIN version 18.5, this can be achieved by adding `Access-Control-Allow-Origin` in the `DSConfiguration.ini` file.
29
29
30
-
By default, the `Access-Control-Allow-Origin` setting is not configured in the ini file. This means that the Dynamsoft Service can respond to requests from any origin.
30
+
By default, the `Access-Control-Allow-Origin` setting is not configured in the ini file. This means that the Dynamic Web TWAIN Service can respond to requests from any origin.
31
31
32
32
You can set multiple origins by using commas as the separator, and `http://` or `https://` needs to be specified before each origin. If there is a port for the origin, please remember to specify it. If not specified, the default port is 80.
33
33
@@ -59,9 +59,9 @@ When a request comes from a different origin, a CORS error message will be displ
On a desktop, when a new user accesses a web page using Dynamic Web TWAIN SDK for the first time, he will be prompted to install the Dynamsoft Service. This is a built-in behaviour of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
64
+
On a desktop, when a new user accesses a web page using Dynamic Web TWAIN SDK for the first time, he will be prompted to install the Dynamic Web TWAIN Service. This is a built-in behaviour of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
65
65
66
66
The prompt comes up when you try to [create a WebTwain instance]({{site.indepth}}features/initialize.html#creating-the-webtwain-instance) in Service mode.
67
67
@@ -74,26 +74,26 @@ On **Linux**, instead of double clicking, the downloaded installer needs to be r
74
74
- Debian / Ubuntu
75
75
76
76
```bash
77
-
sudo dpkg -i DynamsoftServiceSetup.deb
77
+
sudo dpkg -i DynamicWebTWAINServiceSetup.deb
78
78
```
79
79
80
80
- Fedora
81
81
82
82
```bash
83
-
sudo rpm -ivh DynamsoftServiceSetup.rpm
83
+
sudo rpm -ivh DynamicWebTWAINServiceSetup.rpm
84
84
```
85
85
86
86
Once the installation is done, the users can click the orange sentence 'click here to verify completion' or refresh the page to start using Dynamic Web TWAIN.
### Msg: Dynamsoft service is not installed / Dynamic Web TWAIN is not installed
90
+
### Msg: Dynamic Web TWAIN Service is not installed / Dynamic Web TWAIN is not installed
91
91
92
-
If Dynamsoft Service is not installed, users may receive the error 'The Dynamic Web TWAIN module is not installed' when accessing an application that uses Dynamic Web TWAIN.
92
+
If Dynamic Web TWAIN Service is not installed, users may receive the error 'The Dynamic Web TWAIN module is not installed' when accessing an application that uses Dynamic Web TWAIN.
93
93
94
94
## Related Resources:
95
95
96
-
* <ahref="{{site.faq}}what-does-dynamsoft-service-do-on-end-user-machine.html"target="_blank">What does Dynamsoft Service do?</a>
97
-
* <ahref="{{site.faq}}service-prompting-to-install-repeatedly.html"target="_blank">I have installed the Dynamsoft Service on an end-user machine but still got asked to install it repeatedly. Why?</a>
98
-
* <ahref="{{site.faq}}how-to-uninstall-dynamsoft-service.html"target="_blank">How to uninstall Dynamsoft Service?</a>
99
-
* <ahref="{{site.faq}}can-i-install-dynamsoft-service-silently.html"target="_blank">Can I install Dynamsoft Service silently?</a>
96
+
* <ahref="{{site.faq}}what-does-dynamsoft-service-do-on-end-user-machine.html"target="_blank">What does Dynamic Web TWAIN Service do?</a>
97
+
* <ahref="{{site.faq}}service-prompting-to-install-repeatedly.html"target="_blank">I have installed the Dynamic Web TWAIN Service on an end-user machine but still got asked to install it repeatedly. Why?</a>
98
+
* <ahref="{{site.faq}}how-to-uninstall-dynamsoft-service.html"target="_blank">How to uninstall Dynamic Web TWAIN Service?</a>
99
+
* <ahref="{{site.faq}}can-i-install-dynamsoft-service-silently.html"target="_blank">Can I install Dynamic Web TWAIN Service silently?</a>
By default, Dynamic Web TWAIN consists of the Dynamic Web TWAIN Service installed and running on a system, connected to a web application which integrates the Dynamic Web TWAIN SDK. To use DWT to access scanners on other platforms and using other programming languages, you can use the [DWT Service RESTful API]({{ site.api }}restful.html). This allows desktop, mobile, and server-side applications to access the DWT Service installed on the scanner host (local or server) in a simple, stateless, and standardized manner.
14
+
15
+
The RESTful API simply returns scanned documents as streams of image files to the client, and **does not use the DWT Viewer**. This is because **the RESTful API functions entirely using the DWT Service**, and is viewer-agnostic. You may choose to feed the scanned images to any viewer, including a DWT Viewer in your application that you instantiate separately, if desired.
16
+
17
+
Here is a collection of tutorials on creating sample applications that use the DWT RESTful API in various platforms and languages.
0 commit comments