STU-540 Signature Capture Mode Configuration and Operation – Developer Support

Signature Capture Mode Reference

In Signature Capture mode a predefined screen is displayed, ready for the user to sign, for example:

Signature Mode

In addition to pen colour and thickness, the WILL option (Wacom Ink Layer) can be enabled so that a smooth pen trace is displayed with variable thickness dependent on pen pressure.

Image Design

Define up to three signature capture designs. Each design defines the images used for normal and button pushed displays in the following format:

Signature Mode

Below is an example of a normal image followed by a corresponding keys pushed image:

Signature Mode

Signature Area

After entering Signature Capture mode, the signature screen from the normal image is shown. The signature area size is 800 dots * 431 dots.
Additional information such as name and reason, can be shown by writing to the signature area after setting the Signature Capture mode.

Operation Area

Button images are included in the normal image. Pushed button images are included in the button pushed image. When a button is pushed, the corresponding button image is displayed. The size and location of each button:

Button No	Size (w * h)	Location (x,y)
1	265 * 48	0, 431
2	265 * 48	266, 431
3	265 * 48	532, 431

Signature Image settings

Each signature screen requires the settings:

Item	Pattern 1
Image design number	Image design number 1..3
Signature screen (Normal)	Image data includes normal buttons, initial message and background image
Signature screen (button pushed)	Image data includes pushed buttons and background image
Keys Enabled setting	The bitmask (1..3) allows individual keys/buttons to be enabled (1) or disabled (0) as follows: Bit 0: key1 - Cancel. Bit 1: key2 - Clear. Bit 2: key3 - OK

Signature Capture Operation

Before entering Signature Capture mode the images and settings must be stored. The following options must be set when entering Signature Capture mode:

Item	Description
Signature Screen Select	Select Signature screen design from pattern 1..3
MessageBox id after Enter	MessageBox screen to show after Enter was pressed
MessageBox id after Cancel	MessageBox screen to show after Cancel was pressed

Signature Capture Return

UI Event Data reports the selected key number:

Item	Description
Key value	0: *Cancel* 1: *Enter* 2: *Clear*

In addition to sending the report:

Button	Description
OK	Clear screen and return to Normal mode
Clear	Clear screen and redisplay the initial signature capture box screen
Cancel	Clear screen and return to Normal mode

Signature Capture logic

Signature Mode

API Reference

Function	Description
initializeSignature	Signature Capture settings
writeRomImage	Tablet write ROM functions
setOperationMode	Select Signature Capture mode

Code illustration

Upload Image

See STU-540 ROM Store

Requires image descriptor:

romStartImageData = initializeSignature(m_encodingMode, pushed, SIG_IMAGE_NUM, array<bool, 3>{ true, true, true}) );

Start Signature mode

// 0=Cancel; 1=Enter; 2=Clear
OperationMode_Signature sigOpMode{ SIG_IMAGE_NUM,{ 2, 0, 1 }, 0, 0 };
OperationMode opMode = initializeSignature(sigOpMode);
m_tablet.setOperationMode(opMode);

Receive Pen Data

Decode Pen Data from ReportHandler
onReport(PenData & v)
{
  save(penData);
  PostMessage(m_hwnd, WM_USER, 0, 0);
}
...

// Dialog callback

case WM_USER:
    processPenData();
...

Receive the UI Event

Decode the UI Event data from ReportHandler
onReport(EventDataSignature & eventDataSignature)
{
  switch (eventDataSignature.keyValue)
  {
  case 0:
    processCancel();

  case 1:
    processOK();

  case 2:
    processClear();
  }
}
...