Section B.  Software Questions:    

B1.  Where is the full document describing all of the methods and properties of the SigPlus control ?
B2.  How do I bind a signature to a document ?
B3.  What is the difference between a .sig format signature and a Bitmap ?
B4.  When do I set TabletState to true and false ?
B5.  How do I get rid of the white space around a signature ?
B6.  How do I save a signature in a Memo-Field ?
B7.  When and how should I create an Image file ?
B8.  How do I set the line width for display, printing, and images ?
B9.  How do I set the resolution of a signature file or an image file ?
B10.  How do I Print directly from Visual Basic (VB) ?
B11.  Where is the Forensic and Biometric information ?
B12.  How do I automatically detect if the Tablet is Plugged into the COM port ?
B13.  Can I sign files that are not traditional documents ?
B14.  Explain the SigPlus.ini file
B15.  Explain signature compression and when it should be used ?
B16.  What should be the settings for LogicalX and LogicalY Sizes ?
B17.  What is the installation system script ?
B18.  How do I save and display the time and date stamp and annotation ?
B19.  How do I set the size of the time and date stamp and annotation ?
B20.  How do I capture a signature using Internet Forms ?
B21.  Can you use the Topaz Active-X control with Javascript and Lotus Script ?
B22.  Can I have multiple signatures on the same document ?
B23.  How do I Create an Active-X Control Using VB or VBScript ?
B24.  What options do I have in UNIX-Terminal and UNIX-Windows environments?
B25.  How do I create color signature images using SigToolImager?

Important Note for Visual Basic, VBA, Powerbuilder, etc. users:   Back to Top

For all Properties, the function names are documented in the form of a Get/Set pair for (Visual C++).  For Visual Basic, VBA, Powerbuilder, etc.  users, just use the property name itself, without the Get/Set prefix. 

The full name is used when the object is referenced from a Visual C++ application.  There are syntax differences between the Visual C++ syntax noted herein and VB or VBA syntax, most notably involving the use of the parenthesis in the argument.

B1.  Where is the full document describing all of the methods and properties of the SigPlus control ?

The documentation is in both MS Word or PDF file format, and is available for download. Included are two documents - SigPlus & SigPlus_Tools. Click here to download: sigplusdocs.zip now.

B2.   How do I bind a signature to a document ?    Back to Top

A signature is bound to a document or data by encrypting the signature to a key which is uniquely mathematically related to the document data.  With this technique, if the document data is changed, the key to the encrypted signature is effectively "lost" and the signature cannot be viewed or printed.  Topaz handles all of the complexities of this work by providing the Autokey method and encryption modes.  Encryption and binding only applies to .sig-format data and not to image or bitmap data.  If you need to use image files for reports, viewing or printing, they can be generated from the control using the WriteImageFile method after importing an encrypted signature.  The  encryption key should be regenerated each time a document and signature are validated by using the Autokey function to derive the key from the document data.  Please note the following guidelines when using encryption:  The binding of a signature to a document simply involves encryption and is a separate process from signature capture.  An encrypted signature is no longer an electronic representation of the signature but is just random encrypted data.  It only becomes an electronic version of the signature when it it decrypted within the control.  That is the only way a Topaz signature can be viewed, printed, or used to create an image file.

To bind a signature to a document when the signature is stored separately from the document:
1. Capture the signature with EncryptionMode set to 0.
2. Use AutokeyData, without first using AutoKeyStart, with the argument = the file path and name that you want to bind the signature to.
3. Set EncryptionMode to 1 or 2.  Use mode 1 if you are planning to publish the signature into a .pdf-format document using the Topaz Acrobat Plug-ins.
4. ExportSigFile to the path, and name that you chose.
Or
4. GetSigData to transfer the contents of the signature to your application.

Note:  When using EncryptionMode = 2 especially, the sequence of steps is important

To read in and verify the binding of the signature to the document file, the steps are similar:
1. Set EncryptionMode to 0 and clear the control (ClearTablet)
2. Use AutokeyData, without first using AutoKeyStart, with the argument = the file path and name that you want to bind the signature to.
3. Set EncryptionMode to 1 or 2.  Use mode 1 if you are planning to publish the signature into a .pdf-format document using the Topaz Acrobat Plug-ins.
4. ImportSigFile from the path, and name that you choose.
Or
4. SetSigData to transfer the contents of the signature to the OCX control.
5. To verify the linkage and that the document has not changed, you may view the signature, check automatically to determine the number of strokes, or simply inspect the return value that is generated when using the ImportSigFile or SetSigData methods.

In Visual Basic, to Autokey to a path and file name, use the following technique:
Dim text1 As String
text1 = "c:\windows\file.ext";  note that this should contain your path and file name, the quotes are needed.
SigPlus1.AutoKeyData = text1
SigPlus1.EncryptionMode = 1

To bind a signature to a document when the signature is stored within the document (within each instance of the control placed in the document, note the following example written in VBA for Word:

Private Sub Done_Click();   This is the signature encryption step, binding to the document
                                            The signature would have already been captured into the control
                                            by setting EncryptionMode = 0 and then TabletState = 1.
SigPlus1.TabletState = 0;      Always set TabletState to zero when done with signature capture.
Dim text3 As String
text3 = ActiveDocument.Content;  This is a Word VBA command
SigPlus1.AutoKeyStart
SigPlus1.AutoKeyData = text3
SigPlus1.AutoKeyFinish
SigPlus1.EncryptionMode = 1; or Encryption Mode = 2;  
SigPlus1.ExportSigFile ("");     ("") is used to store the signature within the control
End Sub

Private Sub Document_Open();  This is a Word event that occurs on document opening
SigPlus1.ClearTablet                  ;  Clears the control prior to keying and signature import.
SigPlus1.EncryptionMode = 0     ;  Clears EncryptionMode prior to keying
Dim text3 As String
text3 = ActiveDocument.Content  ;  uses the content of the document to generate sig encryption key.
SigPlus1.AutoKeyStart                ;  here the Autokey mode is used to bind to text data
SigPlus1.AutoKeyData = text3  ;  rather than a file
SigPlus1.AutoKeyFinish
SigPlus1.JustifyMode = 5             ;  this does the auto-zooming to fill white space.
SigPlus1.DisplayPenWidth = 12   ;  this sets the display and printing pen width to suit your application
SigPlus1.EncryptionMode = 1       ;  or EncryptionMode = 2;
SigPlus1.ImportSigFile ("")           ; ("") is used to retrieve the signature within the control.
End Sub

B3.  What is the difference between a .sig format signature and a Bitmap ?   Back to Top

Topaz .sig-format data is vector file containing the original signature data from the tablet at high speed.  The signature data is captured directly and is not passed through a driver layer.  This means that the .sig data represents the entire signature and the exact sequence of all of the points, loops, strokes, and timing data.  A standard .sig file will typically take 5K bytes.  A .sig-format data file consists of the full-tablet high-resolution signature.  It can be compressed using the CompressionMode property to under 500 bytes.   An image or bitmap file on the other hand does not store a signature in a vector stroke format, but in an X-Y matrix of points.  It is typically much larger than a .sig file, and it contains none of the biometric or forensic information such as the sequence and timing of the loops, strokes, and segments.

B4.   When do I set TabletState to true and false ?   Back to Top

The TabletState is what turns on and off the capture of signatures via the pen and tablet.  If you are not using an instance of the control to capture a signature from a tablet, you should leave TabletState = 0.

Whenever a signature is captured and completed, the TabletState should be set to zero.  This will ensure that the first control has let go of the com port or interface when you go to capture a second signature.

If you are using the JustifyMode = 5 (AutoJustify) to zoom the signature to fill the control and eliminate white space from the control, the TabletState must be set to zero. The Auto-justify action will only occur when TabletState = 0.

Be sure that tablet state is off when selecting com port.  COM port must be selected first, and then tablet state turned on.  Also be sure to set tablet state off before exiting the application.

B5.  How do I get rid of the white space around a signature ?   Back to Top

Be sure to set JustifyMode.   The signature will zoom with the correct aspect ratio into any size of control, from anywhere on the tablet, if TabletState = 0 and if the justify mode is being used.  

0 Normal, no justification
1 Auto-Justify signature to upper left corner of signature box.
2 Auto-Justify signature to upper right corner of signature box.
3 Auto-Justify signature to lower right corner of signature box.
4 Auto-Justify signature to lower-left corner of signature box.
5 Auto-Justify signature to center of signature box.
Add 16 Changes autojustify to justify the signature based on the median of the signature data
Add 32 Changes autojustify to justify the signature based on the mean of the signature data
Add 48 Changes autojustify to justify the signature based on the mode of the signature data
The Add modes are useful in re-creating a consistent synthetic baseline when using the autojustify feature. For example, to Autojustify the median value of the signature data to the center of the OCX box, you would set JustifyMode to 16 + 5 = 21. When using autojustify modes 1-5 and Add modes, a border area around the signature limits can be set in logical tablet coordinates using the JustifyX and JustifyY values.

B6.   How do I save a signature in a Memo-Field ?   Back to Top

To save .sig data in a Memo field of a database, use the SigString property when getting data from the control or setting data into the control.  This property in versions 3.00 and above are recommended over the older method of using TabletMode = 1024.

To put the signature into the control:
SigCtl.SigString = SigData

To get the signature from the control:
SigData = SigCtl.SigString

If you want to store a signature in binary format, you may wish to refer to the Microsoft KB article ID # Q103257, ACC: Reading, Storing, and Writing Binary Large Objects (BLOBS).  Binary data is the default setting for the control.

For a full example of Memo-field storage in an Access Database, download an Access 2000 example SignMeUp.zip.
You can also download an Access 97 example at SignMeUp97.zip.

B7.   When and how should I create an Image file ?   Back to Top

Image files of a signature are useful in many applications for printing, viewing or merging into reports.  They allow a significant level of versatility with a wide range of application programs.   For example, if you need to support an application that does not support Active-X controls, you can still use a VB supervisor to capture, bind, and store signatures and documents.  You put the signature into the (non-active-x app) by having the VB supervisor program retrieve the document and signature data and de-crypt and import the signature into a control and then create and image file from the re-generated signature which is placed as an image into a forms or reports program for printing.  The method for writing an image file is:

SigPlus1.WriteImageFile c:\test.bmp

See the property "SetImageFileFormat" to set an image type other than bitmap. Other supported image formats include JPG, TIF, WMF, and EMF  The full Filename must be provided, including the standard file extension.

B8.  How do I set the line width for display, printing, and images ?   Back to Top

The pen width for direct display and printing of the signature from the control is set by the DisplayPenWidth property.   The width specified is in pixels:

SigPlus1.DisplayPenWidth = 12

The pen width for creating image files and bitmaps of the signature from the control is set by the ImagePenWidth property.   The width is specified in pixels.   The decimal integer representing the number of pixels of width to make the pen width for image files. Default is 1.  This property does not affect the pen width shown in the control signature window. You will notice a natural interaction in perceived pen thickness depending upon the x and y resolution selected for the image.

SigPlus1.ImagePenWidth = 4

B9.  How do I set the resolution of a signature file or an image file ?   Back to Top

The resolution of a signature file or image file is normally set by default upon software installation to match the resolution of the tablet being used.  To reduce the resolution of an image file, use the ImageXSize and ImageYSize properties to directly set the resolution of the image file.  We recommend that the aspect ratio of the image file match the aspect ratio of the control.  Normally, with the SignatureGem tablet settings, you would get a bitmap resolution of 2000 x 600, which are the LogicalX and Y values.  To reduce the resolution by a factor of 2, you would use:

SigPlus1.ImageXSize = 1000
SigPlus1.ImageYSize = 300

ImageSize Defaults to 0, which links image size to equal LogicalYSize value.

B10.  How do I Print directly from Visual Basic (VB) ?   Back to Top

VB applications require printing in a different WMF format that other higher-resolution windows applications such as Word.   Therefore to set the control to properly render in VB for printing, use DisplayWindowRes = 1 to print directly from VB.

This new property is now recommended and is easier to set than the older technique of using TabletMode = add 32.

B11.  Where is the Forensic and Biometric information ?   Back to Top

All of the data needed for forensic and biometric verification of a signature is stored in the .sig format data.  As a user of the .sig format data, you cannot view this forensic and biometric information.   The objective of the Topaz system is to only allow forensic or biometric characteristics to be available to a handwriting expert and forensic document examiner.  

If we were to format the display or printing of the signature to show biometric and forensic cues, we would potentially be providing cues to a potential forger.  Therefore, by design, the Topaz displayed or printed signature is very "flat" with no stress shading or line width variations.  This provides a valuable extra level of biometric and forensic security to your signature.

B12.  How do I automatically detect if the Tablet is Plugged into the COM port ?   Back to Top

Use the TabletComTest = 1.   This is the preferred method in version 3.00 and above instead of the older TabletMode = Add 128 mode.   In this mode,  If a Topaz tablet is plugged into the selected COM port, the TabletState can be set to 1. If tablet is not plugged into serial port, TabletState cannot be set to 1.  A tablet plug-in detection scheme is shown below and assumes that the COM port was set in the Sigplus.ini file during install.

TabletState = 0
Dim TabletConnect as String
SigPlus1.TabletComTest = 1
SigPlus1.TabletState = 1
TabletConnect = SigPlus1.TabletState;  If TabletConnect = 1, then the tablet is connected, if 0, then not connected

B13.  Can I sign files that are not traditional documents ?   Back to Top

YES.  A simple VB supervisor program can be used to sign all kinds of files, drawings, notes, or documents for approval and archival purposes.  To do so, the file to be signed would be file.ext in the example below. A simple VB dialog box utilizing the Autokey method can be used to sign a file of virtually any type or origin.

Dim text1 As String
text1 = "c:\windows\file.ext"; note that this should contain your path and file name, the quotes are needed.
SigPlus1.AutoKeyData = text1
SigPlus1.EncryptionMode = 1

B14.   Explain the SigPlus.ini file    Back to Top

The SigPlus setup.exe program installs the OCX control together (optionally) with the SigPlus.ini file in the windows directory.  You can choose not to install the .ini file by selecting "SKIP" during install.  If you have already installed the .ini file, you may edit it or delete it easily.  This .ini is not functional unless it is placed in the windows directory.  If the .ini file is not present, then the properties of the control in your application are unaffected and the application runs on it's own.  When the .ini file is present in the windows directory, the values present are used to override the properties set in the control proper in the application.  The properties set by the .ini file would also apply to any applications that you would subsequently compile.   The .ini file allows a common application to use different tablet types and interfaces.  For example, if one machine uses the signature pad on COM1, another on COM2 and yet a third on the USB port, the SigPlus.ini files for these three instances would be:

TabletType settings:
0. Normal mode.  When tablet is activated it will accept input from the selected com port, Default is 0.
1 WinTab mode,when the tablet is activated, it will accept data from the Topaz WinTab driver only.
2 USB mode, when the tablet is activated, it will accept data from the Topaz USB driver
4 SigLite mode, when the tablet is activated, it will accept data from the touchpad driver.

It is very important to note that the .ini settings can only be used to override the OCX default property settings.  If coding or script is used to override a property setting in your application, the .ini settings will not override the scripted setting.

For a full explanation of the SigPlus.ini, please download and read SigPlus.doc

B15.  Explain signature compression and when it should be used ?   Back to Top

Signature compression is to be used whenever it is absolutely essential to get the smallest signature file size, because hundreds of thousands of signatures will be stored together with very limited document data.  A retail POS signature system makes good use of compression, since the data is only a few dozen bytes, such as the amount of the purchase, time, date, and credit card information.  If a document is to be signed, there is usually little to be gained from signature compression because the document size is greater than 10K bytes.

B16.  What should be the settings for LogicalX and LogicalY Sizes ?   Back to Top

The LogicalX and Logical Y sizes control the scaling of the signature data output.  These are set to the appropriate tablet resolution using the Topaz.ini file in the Windows directory.  Normally, LogicalXSize is set to XStop minus XStart and LogicalYSize is set to YStop minus YStart.

B17.   What is the installation system script ?   Back to Top

In order to make your own installation script rather than using the Topaz Setup.exe, use and locate the following files where noted and then self-register OCXs and DLLs.  If you installed the SigPlus control onto your system using the Topaz setup.exe, then the source location for the reference files is the same as the destination location listed below.
MFC42.dll install to Windows\System\
OLE32.dll install to Windows\System\
OLEAUT32.dll install to Windows\System\
MSVCRT.dll install to Windows\System\
SigPlus.ocx install to Windows\SigPlus\
SigPlus.ini install to Windows directory for .ini override of OCX tablet and Com source.

B18.  How do I save and display the time and date stamp and annotation ?   Back to Top

To set the time and date and annotation stamps to display and to be sure to save the time and date and annotation data within the .sig date, you must set the following properties:

SigPlus1.DisplayAnnotate = True
SigPlus1.DisplayTimeStamp = True
SigPlus1.SaveSigData = True

B19.  How do I set the size of the time and date stamp and annotation ?    Back to Top

To set the time and date and annotation stamp sizes use the properties shown below.  The size of the text is specified proportional to the LogicalYSize settings of that particular control instance.   If the LogicalYSize is 600 for example, the size of the text in the example below would be 1/3 of the control height (200/600).

SigPlus1.DisplayAnnotateSize = 200
SigPlus1.DisplayTimeStampSize = 200

B20.  How do I capture a signature using Internet Forms ?    Back to Top

Capture the signature and then export the signature using SigString to a database or to an invisible memo field within the form.   To view the signature, extract the SigString-format data from the forms memo field and import into the control using the SigString property.  To transfer the signature data from the client to the server, use a session variable. You may also use the FORM tag with either method=GET or POST, and pass the signature like you would any other string value. If you would like an HTML signature demo, please download:
VBScript-based HTML Internet Signature Examples,  HTMLDemo.zip
Javascript-based HTML Internet Signature Examples,  HTMLDemoJavascript.zip

B21.  Can you use the Topaz Active-X control with Javascript and Lotus Script?    Back to Top

Lotus Script for Notes and Domino - YES
Use tbe SigSign Dialog-Box Active-X control to capture a signature and then transfer it into a SigPlus control on a Lotus Form.  The signature can then be be saved and retrieved relative to a database field using the SigString property. 
Download SigSample.nsf, a Lotus Notes and Domino Signature Capture front-end example

To run signature capture under Java, download SigPlusJava software, documentation, and basic demos. Version 2.06
Operating System independent - Links with standard Java com-port software supporting your O/S Platform.

Javascript-based HTML Internet Signature Examples,  HTMLDemoJavascript.zip

B22.  Can I have multiple signatures in the same document ?    Back to Top

YES, as many as you need without limitation.   And there are several ways to do so.  You can use SigPlus controls as placeholders and import the signatures from an external forms program or a database.  Or you can store each signature within the control instance itself, such as we do in the supplied MS Word Plug-in.  In this case, each signature is stored within the instance of the control and the signature travels along in the control and embedded in the document.  Also, the Acrobat plug-in will publish as many signatures you need into truly portable .pdf documents.

B23.  How do I Create an instance of the SigPlus Active-X Control Using Script ?     Back to Top

Topaz has a limited UNIX capture (SigX) utility available for download at www.topazsystems.com/Software.  This code manages the com port and creates a .sig file in human-readable format.  To directly display or print a signature captured with this code within UNIX, you will have to write the display and printer driver for your system.  The source code for the capture utility is provided to facilitate this.  In a terminal environment, you will normally need a second com port to connect the capture tablet to the computer.  If you wish to share the RS-232 com port used by the terminal, the Topaz MicroGem and PortShare products may be appropriate, but only if you are prepared to work with the capture source code to optimize it to your system.  This approach is not recommended for a small installation, and is not done "out-of-the-box"

If your UNIX system supports Java, you may use the Topaz SigPlus Java bean signature capture control. 
To run signature capture under Java, download SigPlusJava software, documentation, and basic demos. Version 2.06

B25.  How do I create color signature images using SigToolImager?    Back to Top

First, locate the SigPlus.ini file located in your WIN directory, and open it. Locate the EnableColor parameter. By default, EnableColor=0. To activate color capability, please change this to EnableColor=1, then save the SigPlus.ini file and close.

Next, locate the SigToolImager.ini file, also located in your WIN directory, and open it. Find the foreground and background parameters, which are:

ForeColor
BackColor

By default, ForeColor=-21474833630, and BackColor=-2147483633. The ForeColor represents the ink color, and the BackColor is the area behind the signature.

To change the colors, please choose a color from the following list, and replace the decimal value of the ForeColor and BackColor with the new color's decimal value.

Black=0
White=16777215
Light Blue=16776960
Dark Blue=16711680
Red=255
Green=65280
Yellow=65535
Light Gray=14671839
Dark Gray=8355711
Pink=12615935
Purple=16711808

For example:
For dark blue ink on a yellow background, change the parameters in the SigToolImager.ini as follows:
ForeColor=16711680
BackColor=65535

To determine a specific color's decimal value, please first determine the hex value of your color (the RGB value). For example, perfect blue would be 0000FF (where there is 0 red, 0 green, and 255 blue). Next, flip the value backwards (so instead of 0000FF, it becomes FF0000.)
Finally, using the Calculator program provided in Start...Programs...Accessories, click on the View menu. Choose the Scientific calculator. Choose Hex in the radio button selection. Type in your 6-digit hex value, as determined in the above instructions (for our example, type in 0000FF for perfect blue). Finally, choose Dec in the radio button selection, and the Hex value will be converted into the Decimal value necessary for the ForeColor and BackColor parameters in the SigToolImager.ini (as you will see, the Decimal value for perfect blue is 16711680).

For assistance, please contact Topaz at support@topazsystems.com, or call at (805) 520-8286.