Merge pull request #157 from icfung828/master

Update Stable.md

Author: lunaaaw

faq/change-dynamsoft-service-certificate.md

@@ -12,11 +12,13 @@ description: How can I change the certificate of the Dynamsoft Service?
 
 ## How can I change the certificate of the Dynamsoft Service?
 
-To replace the default certificates, the steps are:
+To replace the default certificate, the steps are:
 
 - Generate a certificate for `127.0.0.1`
 - Install that certificate
 - Use that certificate to generate public /private keys (pem)
 - Rename these two keys to `server.pem` (public) and `server_key.pem` (private)
 - Replace the old keys in `C:\Windows\SysWOW64\Dynamsoft\DynamsoftServicex64_17\cert`
 - Restart the service
+
+NOTE: For v17.2 or higher versions, you can use the new API <a href="{{site.info}}api/Dynamsoft_WebTwainEnv.html#updatecert" target="_blank">UpdateCert</a> to automatically update the client side certificate.

info/api/WebTwain_Buffer.md

@@ -2262,7 +2262,7 @@ Pair: [from: number, to: number];
 
 ```typescript
 /**
- * Return the tag of a specified image.
+ * Return the tag(s) of a specified image.
  * @argument index Index of the image.
  */
 GetTagListByIndex(index: number):string[]
@@ -2312,10 +2312,10 @@ DWObject.GetTagListByIndex(0);
 
 ```typescript
 /**
- * Create a file folder for image(s).
- * @argument filename Specify the file name.
+ * Create a category for the scanned image(s).
+ * @argument categoryName Specify the category name.
  */
-CreateFile(filename:string):Boolean;
+CreateFile(categoryName:string):Boolean;
 ```
 
 **Availability**
@@ -2351,9 +2351,9 @@ CreateFile(filename:string):Boolean;
 **Example**
 
 ```javascript
-//the image you scanned will belong to File1.
-DWObject.CreateFile("File1");
-DWObject.OpenFile("File1"); //Need to call OpenFile after CreateFile.
+//Store the scanned image(s) under 'Category1'.
+DWObject.CreateFile("Category1");
+DWObject.OpenFile("Category1"); //Need to call OpenFile after CreateFile.
 DWObject.AcquireImage(successCallback, failureCallback);
 
 function successCallback() {
@@ -2367,8 +2367,8 @@ function failureCallback(errorCode, errorString) {
 
 **Usage notes**
 
-1. If the documents have been sorted before scanning, you can use <a href="{{site.info}}api/WebTwain_Buffer.html#createfile" target="_blank">CreateFile</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#openfile" target="_blank">OpenFile</a> to manage each type of document.
-2. If the documents are out of order before scanning and you want to scan them in first and then sort them, use tags to manage the documents. Relevant APIs: <a href="{{site.info}}api/WebTwain_Buffer.html#setdefaulttag" target="_blank">SetDefaultTag</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#tagimages" target="_blank">TagImages</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#gettaglist" target="_blank">GetTagList</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#filterimagesbytag" target="_blank">FilterImagesByTag</a>
+1. If the documents are already sorted before scanning, you can use <a href="{{site.info}}api/WebTwain_Buffer.html#createfile" target="_blank">CreateFile</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#openfile" target="_blank">OpenFile</a> to group the documents.
+2. If the documents are not already sorted before scanning and you want to first scan, then sort, you can use tags to manage that. Relevant APIs: <a href="{{site.info}}api/WebTwain_Buffer.html#setdefaulttag" target="_blank">SetDefaultTag</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#tagimages" target="_blank">TagImages</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#gettaglist" target="_blank">GetTagList</a>, <a href="{{site.info}}api/WebTwain_Buffer.html#filterimagesbytag" target="_blank">FilterImagesByTag</a>
 
 ---
 
@@ -2378,10 +2378,10 @@ function failureCallback(errorCode, errorString) {
 
 ```typescript
 /**
- * Open the specified file folder.
- * @argument filename Specify the file name.
+ * Use the specified category for the scanned image(s)
+ * @argument categoryName Specify the category name.
  */
-OpenFile(filename:string):Boolean;
+OpenFile(categoryName:string):Boolean;
 ```
 
 **Availability**
@@ -2417,10 +2417,11 @@ OpenFile(filename:string):Boolean;
 **Example**
 
 ```javascript
-DWObject.CreateFile("File1");
-DWObject.CreateFile("File2");
-DWObject.CreateFile("File3");
-DWObject.OpenFile("File2"); //Need to call OpenFile after CreateFile.
+//Stored the scanned image(s) under 'Category2'.
+DWObject.CreateFile("Category1");
+DWObject.CreateFile("Category2");
+DWObject.CreateFile("Category3");
+DWObject.OpenFile("Category2"); //Need to call OpenFile after CreateFile.
 DWObject.AcquireImage(successCallback, failureCallback);
 
 function successCallback() {
@@ -2440,7 +2441,7 @@ function failureCallback(errorCode, errorString) {
 
 ```typescript
 /**
- * Get the current file name. The default value is 'dynamsoft-dvs-file'.
+ * Get the current category name. The default value is 'dynamsoft-dvs-file'. Scanned image(s) are stored in this category by default if no category name is created.
  */
 GetCurrentFileName():String;
 ```
@@ -2483,10 +2484,10 @@ GetCurrentFileName():String;
 
 ```typescript
 /**
- * Remove all images in the specified file.
- * @argument filename Specify the file name.
+ * Delete the specified category and all images in it.
+ * @argument categoryName Specify the category name.
  */
-RemoveFile(filename:string):Boolean;
+RemoveFile(categoryName:string):Boolean;
 ```
 
 **Availability**
@@ -2527,13 +2528,13 @@ RemoveFile(filename:string):Boolean;
 
 ```typescript
 /**
- * Get the file info list.
+ * Get the list of all categories and their information.
  */
 GetFileInfoList():Json
 
 Json:
 [{
-   name: "fileName",
+   name: "categoryName",
    imageIds:[23122335, 25566822323]
 },
 {……}]

info/schedule/Stable.md

@@ -10,14 +10,24 @@ description: Dynamic Web TWAIN SDK Documentation Schedule Stable Release Page
 
 # Stable Releases
 
+## 17.2.5 (03/29/2022)
+
+### Improved Features 
+
+ - Updated the files *dynamsoft.webtwain.initiate.js* and *dynamsoft.webtwain.addon.camera.js* for better performance of mobile document capturing when using Safari on iOS/iPadOS 13+
+
+### Bug Fixed
+
+ - Updated the file *dynamsoft.webtwain.initiate.js* to resolve a memory leak issue in v17.2.1 on Chrome 98+ when the <a href="{{site.info}}api/WebTwain_Viewer.html?ver=latest#setviewmode" target="_blank">view mode</a> is set to (-1, -1) or if a <a href="{{site.info}}api/WebTwain_Viewer.html?ver=latest#createthumbnailviewer" target="_blank">thumbnail viewer</a> is used.
+
 ## 17.2.1 (02/24/2022)
 
 ### Improved Features 
 
  - Made changes to handle <a href="https://developer.chrome.com/blog/private-network-access-preflight/" target="_blank">CORS preflight requests</a> sent by Chrome from V98. Learn more <a href="https://www.dynamsoft.com/web-twain/docs/faq/private-network-access-in-chrome101.html" target="_blank">here</a>. 
  - For Chromium V84+, use userAgentData instead of userAgent in response to UserAgent String phasing out issue. 
 
-### Bug Fixed
+### Bug Fixes
 
  - Fixed a bug where Dynamsoft Service installation/uninstallation failed due to the current user account does not match the user account under C:\Users{account}. Learn more <a href="https://www.dynamsoft.com/web-twain/docs/faq/service-installation-issue.html?ver=latest" target="_blank">here</a>. 
  - [HTML5 on MacOS] Fixed a bug where the short key (set by <a href="{{site.info}}api/Dynamsoft_WebTwainEnv.html#organizationid" target="_blank">organizationID</a>) did not work on macOS 12+.
@@ -59,7 +69,7 @@ description: Dynamic Web TWAIN SDK Documentation Schedule Stable Release Page
 * Modified DynamicImage.dll(DynamicImagex64.dll) to improve encoding and decoding mode of TIFF files.
 * Updated Barcode Reader library to version 8.6. Check out the release notes for <a href="https://www.dynamsoft.com/barcode-reader/programming/javascript/release-notes/js-8.html?ver=latest#860-08312021" target="_blank">Barcode Reader JavaScript SDK - 8.6</a>
 
-### Bug Fixed
+### Bug Fixes
 
 * Fixed a bug where the image displayed in the thumbnail may be inconsistent with that on the canvas when switching tags through `FilterImageByTag`.
 * Fixed a bug that Dynamic Web TWAIN object could not be initialized when using iframe in Edge.