Merge pull request #595 from ztyyLV/Jackson-branch

Jackson branch

Author: ztyyLV

info/api/WebTwain_Acquire.md

@@ -345,10 +345,12 @@ DWObject.AcquireImage(successCallback,failureCallback);
 
 function successCallback() {
   console.log("successful");
+  DWObject.CloseSource();
 }
 
 function failureCallback(errorCode, errorString) {
   alert(errorString);
+  DWObject.CloseSource();
 }
 ```
 
@@ -558,7 +560,7 @@ OpenSource(): boolean;
 **Example**
 
 ```javascript
-DWObject.GetSourceNames() // for example ['PaperStream IP fi-7300NX Net', 'TWAIN2 FreeImage Software Scanner']
+DWObject.GetSourceNames(); // for example ['PaperStream IP fi-7300NX Net', 'TWAIN2 FreeImage Software Scanner']
 DWObject.SelectSourceByIndex(0); // choose scanner with the name "PaperStream IP fi-7300NX Net"
 DWObject.OpenSource();
 DWObject.AcquireImage();
@@ -841,7 +843,6 @@ SelectSourceAsync(deviceType?: Dynamsoft.DWT.EnumDWT_DeviceType | number): Promi
 
 </table>
 </div>
----
 
 **Example**
 
@@ -856,6 +857,8 @@ DWObject.SelectSourceAsync()
   });
 ```
 
+---
+
 ## SelectSourceByIndex
 
 Select a data source by its index.
@@ -897,7 +900,8 @@ SelectSourceByIndex(index: number): boolean;
 **Example**
 
 ```javascript
-DWObject.SelectSourceByIndex(0);
+DWObject.GetSourceNames(); // for example ['PaperStream IP fi-7300NX Net', 'TWAIN2 FreeImage Software Scanner']
+DWObject.SelectSourceByIndex(0); // choose scanner with the name "PaperStream IP fi-7300NX Net"
 DWObject.OpenSource();
 DWObject.AcquireImage();
 ```
@@ -998,7 +1002,7 @@ SetOpenSourceTimeout(duration: number): boolean;
 
 ```javascript
 DWObject.SelectSource(function () {
-  DWObject.SetOpenSourceTimeout(3000);
+  DWObject.SetOpenSourceTimeout(3000); // stop the opening process if the source cannot be opened within 3000 ms.
   DWObject.OpenSource();
   DWObject.AcquireImage();
 });
@@ -1382,6 +1386,13 @@ CloseSourceManager(): boolean;
 
 </table>
 </div>
+
+**Example**
+
+```javascript
+DWObject.CloseSourceManager();
+```
+
 ---
 
 ## CloseSourceManagerAsync
@@ -1538,10 +1549,15 @@ GetCustomDSData(fileName: string): boolean;
 </table>
 </div>
 
+**Usage notes**
+
+Typically, the data source data file is set by the method [SetCustomDSData()](#setcustomdsdata).
+
 **Example**
 
 ```javascript
-DWObject.GetCustomDSData("C:\\customDSData");
+// Please note, the API only works for TWAIN driver.
+DWObject.GetCustomDSData("C:\\Users\\UserName\\Desktop\\ProfileName");
 ```
 
 ---
@@ -1580,6 +1596,17 @@ GetCustomDSDataEx(): string;
 </table>
 </div>
 
+**Usage notes**
+
+Typically, the data source data file is set by the method [SetCustomDSDataEx()](#setcustomdsdataex).
+
+**Example**
+
+```javascript
+// Please note, the API only works for TWAIN driver.
+DWObject.GetCustomDSDataEx(); // Return a base64 string
+```
+
 ---
 
 ## GetSourceNameItems
@@ -1620,6 +1647,13 @@ GetSourceNameItems(index: number): string;
 </table>
 </div>
 
+**Example**
+
+```javascript
+DWObject.GetSourceNames(); // [scanner 1, scanner 2, scanner 3...]
+DWObject.GetSourceNameItems(0); // return the name of scanner 1
+```
+
 ---
 
 ## OpenSourceManager
@@ -1660,6 +1694,12 @@ OpenSourceManager(): boolean;
 
 If application identification needs to be set, it should be set before this API.
 
+**Example**
+
+```javascript
+DWObject.OpenSourceManager(); 
+```
+
 ---
 
 ## OpenSourceManagerAsync
@@ -1823,6 +1863,13 @@ SetCustomDSData(fileName: string): boolean;
 
 Typically, the data source data file is created by the method [GetCustomDSData()](#getcustomdsdata).
 
+**Example**
+
+```javascript
+// Please note, the API only works for TWAIN driver.
+DWObject.SetCustomDSData("C:\\Users\\UserName\\Desktop\\ProfileName");
+```
+
 ---
 
 ## SetCustomDSDataEx
@@ -1867,6 +1914,11 @@ SetCustomDSDataEx(dsDataString: string): boolean;
 
 Typically the data source data string is created by the method [GetCustomDSDataEx()](#getcustomdsdataex)
 
+```javascript
+// Please note, the API only works for TWAIN driver.
+DWObject.SetCustomDSData("the base64 string of your profile");
+```
+
 ---
 
 ## SetFileXferInfo