Installation
1. Introduction
2. Internet Explorer - Javascript
3. Netscape Browser - Javascript
4. Java Application
5. .NET Application
6. Scripted Installation
1 Introduction
An application developed using the Wacom STU SDK can be installed on a target system with only those components from the SDK required by the development language and environment.
The full set of components:
Component | Description |
---|---|
wgssSTU.dll | Contains the executable API code |
wgssSTU.pdb | Debug database contains debug information |
Interop.wgssSTU.dll | Interface to wgssSTU.dll for .NET applications |
wgssSTU.jar | Interface to wgssSTU.dll for Java applications |
Note that different versions of the files are provided for 32-bit and 64-bit applications, contained in folders Win32 and x64 respectively.
The full STU SDK installation includes documentation, and the complete set of components for 32-bit applications.
Different development languages require different components and these are outlined below.
2 Internet Explorer and/or Javascript
Internet Explorer requires only the ActiveX control:
wgssSTU.dll
Installation can be one of the methods described below, including the scripted method.
Once the file is installed and registered, the API can be accessed via ActiveX.
N.B. Please note that Internet Explorer is no longer officially supported by Microsoft but the dll is still relevant for use with pure Javascript.
3 Netscape Browser - Javascript
The STU SigCaptX cross-browser component is required for browsers other than Internet Explorer because they do not support ActiveX. These include versions of Edge, Firefox and Chrome.
4 Java Application
A Java application requires the following files:
- wgssSTU.dll - contains the executable API code
- wgssSTU.jar - interface to wgssSTU.dll for Java applications
To deploy the application the files can be copied. There is no need to register wgssSTU.dll.
Note that separate file versions are supplied for 32-bit and 64-bit applications.
Also included: wgssSTU.15.jar
Use this version if necessary for Java 1.5 support (the standard .jar requires Java 1.7 as a minimum). In version 1.5 the Tablet class is not supported. Full STU functionality is provided through the Protocol class but the automatic error handling from Tablet is not available.
5 .NET Application
To develop a .NET application these two files are required:
- wgssSTU.dll - contains the executable API code
- Interop.wgssSTU.dll - interface to wgssSTU.dll for .NET applications
Note that separate file versions are supplied for 32-bit and 64-bit applications. The way the application is built will affect deployment:
- Standard ActiveX – access the API using ActiveX via interop+wgssSTU.dll
- Embedded interop – optionally embed the interop file in the .exe
- Side-by-Side execution – access the API by direct access to wgssSTU.dll
Standard ActiveX operation will need wgssSTU.dll to be installed and registered using any one of the installation methods.
Visual Studio can embed Interop.wgssSTU.dll in the .exe by setting project properties, for example:
Target framework: .NET Framework 4
Properties for the Reference to Interop.wgssSTU.dll can then be set to:
Embed Interop Type True
If the file is embedded in the .exe it is no longer needed as a separate file for deployment.
Side by Side operation requires access to the wgssSTU.dll and interop files (no registration required).
This method of operation is achieved in the project manifest file, for example:
<dependency><dependentAssembly><assemblyIdentitytype="win32"name="wgssSTU"version="2.1.2.0"/></dependentAssembly></dependency>
If side-by-side execution is selected wgssSTU.dll can be copied with the .exe without registration.
6 Scripted Installation
For basic ActiveX operation wgssSTU.dll can be copied to a folder and registered in Windows, for example, start a Command Prompt as Administrator:
regsvr32.exewgssSTU.dll
Once the file is installed and registered, the API can be accessed via ActiveX calls.
Note that separate file versions are supplied for 32-bit and 64-bit applications.