Global

The Global Web TWAIN properties and methods on this page live in the namespace {Dynamsoft.DWT},

Methods

Properties

Events

CreateDWTObject()

Creates a new WebTwain instance that listens to the specified host & ports. An UI element specified by the parameter ContainerId which is typically a <div> is required. The library will generate UI and bind it to this element.

Syntax

CreateDWTObject(
    ContainerId: string, 
    successCallBack: (DWObject: WebTwain) => void,
    failureCallBack: (errorString: string) => void
): boolean;

CreateDWTObject(
    ContainerId: string, 
    host: string, 
    port: string | number, 
    portSSL: string | number, 
    successCallBack: (DWObject: WebTwain) => void,
    failureCallBack: (errorString: string) => void
): boolean;

Parameters

ContainerId: Specify the id of HTML element (typically of the type HTMLDivElement) to hold the UI.

host: Specify the host. Default value: "127.0.0.1"

port: Specify the port. Default value: 18622

portSSL: Specify the SSL port. Default value: 18623

successCallback: A callback function that is executed if the request succeeds.

• DWObject: The WebTwain instance.

failureCallback: A callback function that is executed if the request fails.

• errorString: The error string.

Availability

Example

var DWObject;
Dynamsoft.DWT.CreateDWTObject('dwtcontrolContainer',"127.0.0.1", 18622, 18623,
    function (DWTObject) { 
        DWObject = DWTObject;
        DWObject.SelectSourceAsync().then(function () {
        DWObject.AcquireImageAsync({ 
            IfCloseSourceAfterAcquire: true 
        });
    }).catch(function (exp) {
        alert(exp.message);
    });}, 
    function (errorString) {console.log(errorString);}
);

OR

var DWObject;
Dynamsoft.DWT.CreateDWTObject('dwtcontrolContainer',
        function (DWTObject) { 
            DWObject = DWTObject;
            DWObject.SelectSourceAsync().then(function () {
            DWObject.AcquireImageAsync({ 
                IfCloseSourceAfterAcquire: true 
            });
        }).catch(function (exp) {
            alert(exp.message);
        });}, 
        function (errorString) {console.log(errorString);}
);

CreateDWTObjectEx()

Creates a new UI-less WebTwain instance. This instance will be uniquely identified by the parameter WebTwainId.

Syntax

CreateDWTObjectEx(
  dwtInitialConfig: DWTInitialConfig, 
  successCallBack: (DWObject: WebTwain) => void, 
  failureCallBack: ({code: number, message: string}) => void
): boolean;

Parameters

dwtInitialConfig: Specify the initial configuration of the instance. Please refer to DWTInitialConfig.

successCallback: A callback function that is executed if the request succeeds.

• DWObject: The WebTwain instance.

failureCallback: A callback function that is executed if the request fails.

• code: The error code.
• message: The error string.

Availability

Example

var DWObject;
Dynamsoft.DWT.CreateDWTObjectEx({
      WebTwainId: 'dwtId',
      Host: "127.0.0.1",
      Port: 18622,
      PortSSL : 18623
  },function (DWTObject) {
      DWObject = DWTObject;
      DWObject.Viewer.bind("dwtcontrolContainer");
      DWObject.Viewer.show();
      DWObject.SelectSourceAsync().then(function () {
              DWObject.AcquireImageAsync({ 
                  IfCloseSourceAfterAcquire: true 
              });
          }).catch(function (exp) {
              alert(exp.message);
          });
  }, function (errorString) {
      console.log(errorString);
});

DeleteDWTObject()

Delete and destroy the specified WebTwain instance.

Syntax

DeleteDWTObject(Id: string): boolean;

Parameters

Id: Specify the instance with its ContainerId or WebTwainId.

Return Value

true: Successfully.

false: Failed.

Availability

GetWebTwain()

Return the WebTwain instance by its ContainerId or WebTwainId.

Syntax

GetWebTwain(ContainerIdOrWebTwainId?: string): WebTwain;

Parameters

ContainerIdOrWebTwainId: Specify the instance with its ContainerId or WebTwainId.

Availability

Example

var DWObject;
function Dynamsoft_OnReady() {
    DWObject = Dynamsoft.DWT.GetWebTwain('dwtcontrolContainer'); // Get the Dynamic Web TWAIN object that is embeded in the div with id 'dwtcontrolContainer'
}

Usage Note

• If no parameter is provided, the first valid WebTwain instance is returnd.

Load()

Initiates the library. If there are predefined Containers, one WebTwain instance will be created for each Container.

Syntax

Load(): Promise<void>;

Availability

Example

Dynamsoft.DWT.Load();

Usage Note

• Only used if AutoLoad is set to false.

RegisterEvent()

Registers an environmental event.

Syntax

Dynamsoft.DWT.RegisterEvent(eventName: string, listener: (...arguments: any[])=>any): boolean;

Parameters

eventName: Specify the event. Supported events: OnWebTwainReady, OnWebTwainError, OnWebTwainPostExecute, OnWebTwainPreExecute

listener: Specify the callback.

Availability

Example

Dynamsoft.DWT.RegisterEvent('OnWebTwainReady',
 Dynamsoft_OnReady //The typical function for initalizing the environment once the resources have loaded
);
 
function Dynamsoft_OnReady() {
DWObject = Dynamsoft.DWT.GetWebTwain('dwtcontrolContainer'); // Get the Dynamic Web TWAIN object that is embeded in the div with id 'dwtcontrolContainer'
}
 
Dynamsoft.DWT.RegisterEvent("OnWebTwainError", function (error) {
});
 
Dynamsoft.DWT.RegisterEvent("OnWebTwainPostExecute", function () {
});
 
Dynamsoft.DWT.RegisterEvent("OnWebTwainPreExecute", function () {
});

Unload()

Destroys all WebTwain instances and cuts off the connection to the Dynamsoft Service.

Syntax

Unload(): void;

Availability

AutoLoad

Specifies whether or not to load the Web TWAIN environment when the Dynamic Web TWAIN scripts are loaded into memory.

Syntax

AutoLoad: boolean;

Availability

Usage Notes

Default value: true.

Containers

Defines the Id and UI of the WebTwain instances.

Syntax

Containers: Container[];

Please refer to Container.

Availability

CustomizableDisplayInfo

Define the display info.

Syntax

CustomizableDisplayInfo: DisplayInfo;

Please refer to DisplayInfo.

Availability

DeviceFriendlyName

This property allows you to specify a specified name to the client machine that will be used to identify the client machine when using Dynamsoft License Server. If this is not set, a randomly generated non-tracable UID will be generated.

Syntax

DeviceFriendlyName: string;

Availability

Host

Specify the target address for the local Dynamsoft Service.

Syntax

Host: string;

Availability

Usage Notes

Default value: 127.0.0.1.

IfAddMD5InUploadHeader

Whether or not an md5 header dwt-md5 should be included in HTTP upload requests. Note that this header is not a standard header and may be deemed invalid on some web servers.

Syntax

IfAddMD5InUploadHeader: boolean;

Availability

Usage Notes

Default value: false.

IfConfineMaskWithinTheViewer

This property defines whether any Dynamic Web TWAIN generated masks will apply to the entire window or just the Viewer object. Setting this property to true will confine the mask to the Viewer object.

Syntax

IfConfineMaskWithinTheViewer: boolean;

Availability

Usage Notes

Default Value: false.

IfUseActiveXforIE10Plus

This property specifies whether Dynamic Web TWAIN will be loaded using HTML5 or ActiveX when loaded in Internet Explorer 10+.

Syntax

IfUseActiveXForIE10Plus: boolean;

Availability

Usage Notes

• Default value: false.
• If set to true, ActiveX will be used, else HTML5 will be used.
• This property needs to be set before Dynamic Web TWAIN loads.

JSVersion

This is a readonly property that specifies what version the server side Dynamic Web TWAIN resources are being used with the web application.

Syntax

readonly JSVersion: string;

Availability

ProductKey

Sets or returns the product key for the library. A valid product key is required for each module of Dynamic Web TWAIN.

Syntax

ProductKey: string;	

Availability

Example

Dynamsoft.DWT.ProductKey = 't0076lQAAAGNcO61He******';

If you have multiple license keys, separate them with semicolons like below:

Dynamsoft.DWT.ProductKey = 't0076lQAAAGNcO61He******;t0076lQAAAGNcO61He******';

ResourcesPath

Sets or returns where the path to the Dynamic Web TWAIN resource files are hosted.

Syntax

ResourcesPath: string;

Availability

ServiceInstallerLocation

Sets or returns where the path to the Dynamsoft Service installers are hosted.

Syntax

ServiceInstallerLocation: string;

Availability

UseDefaultViewer

Whether to use the built-in viewer.

Syntax

UseDefaultViewer: boolean;

Availability

Usage Notes

• If it is set to false, the file dynamsoft.webtwain.viewer.js is not loaded at all and there is no way to add it back later. Therefore, only set it to false when you absolutely won’t need the viewer or will be building your own viewer.

OnWebTwainReady

A built-in callback triggered when the Web TWAIN resources have completed loading

Syntax

RegisterEvent("OnWebTwainReady", function () {});

Availability

Example

Dynamsoft.DWT.RegisterEvent('OnWebTwainReady', 
  Dynamsoft_OnReady //The typical function for initalizing the environment once the resources have loaded
); 

var DWObject;

function Dynamsoft_OnReady() {
  DWObject = Dynamsoft.DWT.GetWebTwain('dwtcontrolContainer'); // Get the Dynamic Web TWAIN object that is embeded in the div with id 'dwtcontrolContainer'
}

OnWebTwainError

A built-in callback triggered when an error is detected when loading the Web TWAIN environment.

Syntax

RegisterEvent("OnWebTwainError", function () {});

Availability

Example

Dynamsoft.DWT.RegisterEvent('OnWebTwainError', 
  Dynamsoft_OnError 
); 

 
function Dynamsoft_OnError(error){
  // error handling
  console.error(error.message);
} 

OnWebTwainPostExecute

This event triggers at the resolution of an asynchronous API.

The default behaviour is to hide the mask and loading spinner triggered by OnWebTwainPreExecute.

You may override this function to implement your own post-excecute scenario. Please refer to this article.

Syntax

RegisterEvent("OnWebTwainPostExecute", function () {});

Availability

OnWebTwainPreExecute

This event triggers at the beginning of an asynchronous API.

The default behaviour is to display a mask and a loading spinner.

You may override this function to either hide the default loading spinner, or define your own. Please refer to this article.

Syntax

RegisterEvent("OnWebTwainPreExecute", function () {});

Availability