web twain 19.2

Author: tony-xlh

_articles/extended-usage/buffer-caching.md

@@ -48,10 +48,7 @@ var storageItemUid = await DWTObject.createLocalStorage(folderSettings);
 
 Please ensure to set a strong password to enhance data security, especially in multi-user login scenarios.
 
-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`)
-  - 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`)
-  - Linux: `/opt/dynamsoft/Dynamic Web TWAIN Service {versionnumber}/storage`(version 18.5.1 and earlier `/opt/dynamsoft/DynamsoftService/storage`)
+The local directory of the created storage folder is under the service's [intallation folder](/_articles/extended-usage/dynamsoft-service-configuration.md#installation-folder).
 
 **Save image caches**
 

_articles/extended-usage/dynamsoft-service-configuration.md

@@ -10,17 +10,58 @@ description: Dynamic Web TWAIN SDK Documentation Dynamic Web TWAIN Service Page
 
 # Configuring the Dynamic Web TWAIN Service
 
-> This article is meant exclusively for the Desktop Service Edition of Dynamic Web TWAIN.
+The Dynamic Web TWAIN Service is the core piece of Dynamic Web TWAIN. It handles the communication between hardware (scanner, webcam, etc.) and browser, manages the image buffer, and coordinates data between different modules.
 
-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.
+
+## Installation of Dynamic Web TWAIN Service
+
+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 behavior of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
+
+The prompt comes up when you try to [create a WebTwain instance](/_articles/extended-usage/advanced-initialization.md#instantiating-webtwain-without-onwebtwainready).
+
+![Initialization](/assets/imgs/Initialization-1.png)
+
+On **Windows and macOS**, double click the downloaded installer to install the service. 
+
+On **Linux**, instead of double clicking, the downloaded installer needs to be run using one of the following commands:
+
+- Debian / Ubuntu
+
+  ```bash 
+  sudo dpkg -i DynamicWebTWAINServiceSetup.deb
+  ```
+
+- Fedora
+
+  ```bash 
+  sudo rpm -ivh DynamicWebTWAINServiceSetup.rpm
+  ```
+
+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.
+
+![Initialization](/assets/imgs/Initialization-2.png)
+
+## Installation Folder
+
+The service is installed in the following folders on different platforms by default.
+
+- Windows:
+  - version 19.0 and later: `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN Service {versionnumber}`
+  - version 18.5.1 and earlier: `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_{versionnumber}`)
+- macOS: 
+  - version 19.2 and later: `/Users/{username}/Applications/Dynamsoft/Dynamic Web TWAIN Service {versionnumber}`
+  - version 19.0-19.1: `/Applications/Dynamsoft/Dynamic Web TWAIN Service {versionnumber}`
+  - version 18.5.1 and earlier: `/Applications/Dynamsoft/DynamsoftServicex64_{versionnumber}/{installed version No.}`)
+- Linux: 
+  - version 19.0 and later:  `/opt/dynamsoft/Dynamic Web TWAIN Service {versionnumber}`
+  - version 18.5.1 and earlier: `/opt/dynamsoft/DynamsoftService`
 
 ## IP and ports
 
 The Dynamic Web TWAIN Service uses `localhost` and `18622` `18625` ports for HTTP connection and `18623` `18626` ports for HTTPS connection.  
-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}`)
-  - macOS: `Go > Applications > Dynamsoft > Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `Go > Applications > Dynamsoft > DynamsoftServicex64_{versionnumber} > {installed version No.}`)
-  - Linux: `/opt/dynamsoft/Dynamic Web TWAIN Service {versionnumber}`(version 18.5.1 and earlier `/opt/dynamsoft/DynamsoftService`)
+
+These ports can be configured in the `DSConfiguration.ini` file located in the service's installatin folder.
+
 
 ## Access-Control-Allow-Origin
 
@@ -58,33 +99,40 @@ When a request comes from a different origin, a CORS error message will be displ
 
   ![CORS-error-console](/assets/imgs/CORS-error-console.png)
 
-## Installation of Dynamic Web TWAIN Service
 
-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 behavior of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
+## Web Setup
 
-The prompt comes up when you try to [create a WebTwain instance](/_articles/extended-usage/advanced-initialization.md#instantiating-webtwain-without-onwebtwainready) in Service mode.
+The service provides a web page to know its status and make basic configurations. You can access it through <http://127.0.0.1:18625>.
 
-![Initialization](/assets/imgs/Initialization-1.png)
+For security reasons, the web setup is disabled by default. You can add the following line to `DSConfiguration.ini` to enable it.
 
-On **Windows and macOS**, double click the downloaded installer to install the service. 
+```
+EnableWebSetup=TRUE
+```
 
-On **Linux**, instead of double clicking, the downloaded installer needs to be run using one of the following commands:
+Screenshots:
 
-- Debian / Ubuntu
+* Default:
 
-  ```bash 
-  sudo dpkg -i DynamicWebTWAINServiceSetup.deb
-  ```
+   ![home](/assets/imgs/service-web-setup/home.jpg)
 
-- Fedora
+* External Access Tab:
 
-  ```bash 
-  sudo rpm -ivh DynamicWebTWAINServiceSetup.rpm
-  ```
+   ![external access setup](/assets/imgs/service-web-setup/external-access-setup.jpg)
 
-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.
+On the left of the page, you can check the service's status and update the [`LogLevel`](/_articles/info/api/WebTwain_Util.md#loglevel).
+
+On the right of the page, you can configure the service through the local access tab and the external access tab.
+
+In the local access tab, you can update the SSL certificate for domains bound to `127.0.0.1`.
+
+In the external access tab, you can update the following settings:
+
+1. Host: configure an external IP so that it can be accessed by other devices.
+2. Firewall exception: add exception rules to the firewall to avoid the traffic being blocked by the firewall (only for Windows).
+3. Domain: bind a domain to the IP of your service and configure its SSL certificate.
+4. Bonjour service: enable Bonjour service to allow service discovery in local networks. It is needed for the [Remote Scan solution](https://www.dynamsoft.com/remote-scan/docs/introduction/).
 
-![Initialization](/assets/imgs/Initialization-2.png)
 
 ## Msg: Dynamic Web TWAIN Service is not installed / Dynamic Web TWAIN is not installed
 

_articles/faq/dwt-with-annotation.md

@@ -34,7 +34,7 @@ Deliver the SDK dependencies with either the [jsDelivr](https://jsdelivr.com/) o
 
   ```html
     <!--Dynamic Web TWAIN-->
-    <script src="https://cdn.jsdelivr.net/npm/dwt@19.1.0/dist/dynamsoft.webtwain.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/dwt@19.2.0/dist/dynamsoft.webtwain.min.js"></script>
     <!--Dynamsoft Document Viewer-->
     <script src="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@3.0.0/dist/ddv.js"></script>
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@3.0.0/dist/ddv.css">
@@ -44,7 +44,7 @@ Deliver the SDK dependencies with either the [jsDelivr](https://jsdelivr.com/) o
 
   ```html
     <!--Dynamic Web TWAIN-->
-    <script src="https://unpkg.com/dwt@19.1.0/dist/dynamsoft.webtwain.min.js"></script>
+    <script src="https://unpkg.com/dwt@19.2.0/dist/dynamsoft.webtwain.min.js"></script>
     <!--Dynamsoft Document Viewer-->
     <script src="https://unpkg.com/dynamsoft-document-viewer@3.0.0/dist/ddv.js"></script>
     <link rel="stylesheet" href="https://unpkg.com/dynamsoft-document-viewer@3.0.0/dist/ddv.css">
@@ -120,7 +120,7 @@ API Reference
 // You can request a 30-day trial key from https://www.dynamsoft.com/customer/license/trialLicense/?product=dwtddv
 Dynamsoft.DWT.ProductKey = "DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9";
 Dynamsoft.DWT.UseDefaultViewer = false;
-Dynamsoft.DWT.ResourcesPath = "https://cdn.jsdelivr.net/npm/dwt@19.1.0/dist";
+Dynamsoft.DWT.ResourcesPath = "https://cdn.jsdelivr.net/npm/dwt@19.2.0/dist";
 // You need to set the service installer location here since the installer's size exceeds jsdelivr's limit. You'd better host the installers in your own environment.
 Dynamsoft.DWT.ServiceInstallerLocation = 'https://download2.dynamsoft.com/Demo/DWT/Resources/dist/';
 
@@ -279,7 +279,7 @@ API Reference
 <html>
 <head>
     <title>HelloWorld</title>
-    <script src=" https://cdn.jsdelivr.net/npm/dwt@19.1.0/dist/dynamsoft.webtwain.min.js"></script>
+    <script src=" https://cdn.jsdelivr.net/npm/dwt@19.2.0/dist/dynamsoft.webtwain.min.js"></script>
     <script src="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@3.0.0/dist/ddv.js"></script>
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/dynamsoft-document-viewer@3.0.0/dist/ddv.css">
 </head>
@@ -316,7 +316,7 @@ let DWObject, editViewer, ddvDoc;
     // Create Dynamic Web TWAIN object
     Dynamsoft.DWT.ProductKey = license;
     Dynamsoft.DWT.UseDefaultViewer = false;
-    Dynamsoft.DWT.ResourcesPath = "https://cdn.jsdelivr.net/npm/dwt@19.1.0/dist";
+    Dynamsoft.DWT.ResourcesPath = "https://cdn.jsdelivr.net/npm/dwt@19.2.0/dist";
     // You need to set the service installer location here since the installer's size exceeds jsdelivr's limit. You'd better host the installers in your own environment.
     Dynamsoft.DWT.ServiceInstallerLocation = 'https://download2.dynamsoft.com/Demo/DWT/Resources/dist/';
 

_articles/general-usage/image-export/local-export.md

@@ -87,4 +87,4 @@ The Base 64 string accessible through the `result` argument of the success callb
 
 ## Print
 
-Finally, DWT can also print directly to a printer through the [ `Print()` ](/_articles/info/api/WebTwain_IO.md#print) API. This API brings all images from the image buffer into the browser's print dialog. Alternatively, while running in Windows Service Mode, the API can also take an argument to use the Windows OS print dialog instead.
+Finally, DWT can also print directly to a printer through the [ `Print()` ](/_articles/info/api/WebTwain_IO.md#print) API. This API brings all images from the image buffer into the browser's print dialog. Alternatively, while running on Windows, the API can also take an argument to use the Windows OS print dialog instead.

_articles/general-usage/resource-loading.md

@@ -21,7 +21,7 @@ The official SDK installers store the installers under the `/dist` directory, an
 
 The official [DWT installer](https://www.dynamsoft.com/web-twain/downloads) installs the SDK with a 30-day free trial (license key included), and contains the resource scripts, along with SDK documentation, and samples. This method is useful for developers to quickly evaluate the SDK. The resource files may be obtained from the following locations after installation:
 
-- On Windows: `C:\Program Files (x86)\Dynamsoft\Dynamic WebTWAIN SDK {version number}/Resources`
+- On Windows: `C:\Program Files (x86)\Dynamsoft\Dynamic WebTWAIN SDK {version number}\Resources`
 - On Linux: Where you extracted the SDK archive file to - `{extracted directory}/Dynamic Web TWAIN SDK {version number}/Resources`
 - On MacOS: `/Applications/Dynamsoft/Dynamic Web TWAIN SDK {version number}/Resources`
 
@@ -95,6 +95,7 @@ Note that jsDelivr currently has problems delivering the Dynamic Web TWAIN Servi
         <script>
             Dynamsoft.DWT.ResourcesPath = "https://cdn.jsdelivr.net/npm/dwt@latest/dist"; // Load supporting resources from here
             Dynamsoft.DWT.ProductKey = ""; // Add product key here
+            Dynamsoft.DWT.ServiceInstallerLocation = 'https://unpkg.com/dwt/dist/dist/'; // Set the service installers' location
         </script>
     </body>
 </html>

_articles/hello-world/scanning.md

@@ -21,7 +21,7 @@ Create a `HelloWorld.html` file anywhere and copy the `Resources` folder to the
 
 - Windows: `C:\Program Files (x86)\Dynamsoft\Dynamic Web TWAIN SDK {Version Number}\`
 - Linux: Within the decompressed file `Dynamic Web TWAIN SDK {Version Number}/`
-- MacOS: `Applications/Dynamsoft/Dynamic Web TWAIN SDK {Version Number}/`
+- MacOS: `/Applications/Dynamsoft/Dynamic Web TWAIN SDK {Version Number}/`
 
 ### Include the DWT Scripts
 

_articles/indepth/development/angular.md

@@ -28,7 +28,7 @@ ng new dwt-angular
 ### **cd** to the root directory of the application and install the dependencies
 
 ``` cmd
-npm install dwt@19.1.0
+npm install dwt@19.2.0
 ```
 
 ## Configure the project

_articles/indepth/development/react.md

@@ -40,7 +40,7 @@ npm install
 ```
 
 ``` cmd
-npm install dwt@19.1.0 ncp
+npm install dwt@19.2.0 ncp
 ```
 
 > `ncp` is used to copy static resources files.

_articles/indepth/development/vue.md

@@ -33,7 +33,7 @@ vue create dwt-vue
 ### Navigate to the root directory of the application and install the `dwt` and `ncp` package
 
 ``` cmd
-yarn add dwt@19.1.0
+yarn add dwt@19.2.0
 ```
 
 ``` cmd
@@ -232,7 +232,7 @@ npm install
 ```
 
 ``` cmd
-npm install dwt@19.1.0
+npm install dwt@19.2.0
 ```
 
 ``` cmd

_articles/info/api/WebTwain_Buffer.md

@@ -942,7 +942,7 @@ GetImagePartURL(index: number, width: number, height: number): string;
 
 The returned URL looks like this: 'dwt://dwt_trial_13000404/img?id=306159652&index=0&t=1502184632022'.
 
-You get the original size (a, b) of the image in PNG format in Service Mode
+You get the original size (a, b) of the image in PNG format
 
 - if either width or height is not set or
 - if either width or height is set to -1 or
@@ -999,7 +999,7 @@ GetImageURL(index: number, width: number, height: number): string;
 
 The returned URL looks like this: "https://127.0.0.1:18623/dwt/dwt_17110818/img?id=795151779&index=1&t=1640936181588".
 
-You get the original size (a, b) of the image in PNG format in Service Mode
+You get the original size (a, b) of the image in PNG format
 
 - if either width or height is not set or
 - if either width or height is set to -1 or
@@ -1713,9 +1713,9 @@ IsBlankImageAsync(index: number,
 
 <tr>
 <td align="center">v18.4+</td>
-<td align="center">N/A</td>
-<td align="center">N/A</td>
-<td align="center">N/A</td>
+<td align="center">v19.2+</td>
+<td align="center">v19.2+</td>
+<td align="center">v19.2+</td>
 </tr>
 
 </table>