将签名屏幕上传到 STU-540 – Developer Support

介绍
安装与操作
Windows 操作
命令行操作
签名SDK API
Windows 注册表 API

介绍

STU-540 数字签名板提供另一种签名操作模式。选择该模式时，签名采集过程中显示的图像将直接从数位板的 ROM 存储器中获取。
这意味着数位板的响应速度更快，因为每次进行签名采集操作时都无需将图像重新发送到数位板，而且按下的按钮可以在本地处理。
图像存储在非易失性 ROM 中，可作为一次性安装程序的一部分进行存储。

当 STU-540 设置为以较慢的串行通信模式运行时，使用存储的图像尤为重要。
在远程桌面配置中有时需要使用串行通信方式。
此处提供了在串行和 USB 通信之间切换 STU-540 的说明：STU 串行连接

如果您计划在串行模式下使用 STU-540，请首先在 USB 模式下使用屏幕上传实用程序高速存储签名。一旦存储完毕，在串行模式下操作时仍可使用。

使用 STU 签名屏幕上传应用程序创建和存储签名图像，供签名 SDK 使用。
最多可定义三个可供选择的签名捕捉屏幕，例如

标准截屏

安装与操作

该工具作为 Signature SDK 的一部分安装，可从 "开始 "菜单运行：

开始…Wacom Signature SDK…Signature Mode Image Uploader

或者找到并运行安装在 Common Files\WacomGSS 中的 .exe 文件：

wgssStuImgUploader.exe

应用程序中的设置保存在配置文件中。
配置文件用于生成上传到 STU 数位板的图像，签名 SDK 在采集签名时也会使用该文件来验证配置是否正确。

Windows 操作

使用方法

Screen number:

选择签名屏幕编号 1..3

Operation:

从可用的操作中选择一个：

set image （使用图片）
delete image （删除图片）
none （无）

为当前屏幕所做的选择将保存在配置文件中。

Text

Reason for signing（签名原因）:

Dynamic (value of “Why” parameter) 动态（参数"Why"的值）
Static 静态

选择 Dynamic（动态）选项可使用在 API 调用中提供的文本开始捕获签名。Static（静态）选项允许定义永久文本。

Signatory（签署人）:

Dynamic (value of “Who” parameter) 动态（参数"Who"的值）
Static 静态

选择 Dynamic （动态）选项可使用在 API 调用中提供的文本开始捕获签名。Static（静态）选项允许定义永久文本。

Location:

Dynamic (value of SetProperty(“Where”)) 动态（SetProperty("Where") 的值）
Static 静态

选择 "动态 "选项，可在开始捕获签名前使用在 SetProperty API 调用中提供的文本。静态选项允许定义永久文本。

Date/time:

Dynamic (from the system clock) 动态（来自系统时钟）
Not shown 不显示

可选择在签名捕捉屏幕中加入日期和时间。

Buttons

使用默认语言值定义 "确定"/"清除"/"取消 "按钮上的文本内容，或定义替代文本。

Font

选择签名捕捉屏幕中文本使用的字体和大小

File

New - 重置配置
Open - 打开现有配置
Save - 替换当前配置
Save As… - 选择文件名并保存当前配置
Exit - 退出应用程序

Tablets

Upload current screen - 上传当前选择的屏幕配置
Upload all screens - 上传所有三种屏幕配置
View current image - 立即显示当前配置的签名屏幕

Help

About - 显示版本信息

命令行操作

使用命令行操作来编写屏幕上传程序：

wgssStuImgUploader.exe [config-file] -q -h

[config-file] - 应用程序保存的配置文件的名称
-q - quiet mode – 上传并退出
-h - 帮助信息

例如，应用程序会处理配置文件中定义的命令：

<?xml version="1.0" encoding="utf-8"?><Screens><Screennumber="1"><Why>I accept the terms of the agreement</Why><Who>Customer</Who><When>0</When><Language>EN</Language><OK>OK</OK><Clear>Clear</Clear><Cancel>Cancel</Cancel><Fontsize="12">Verdana</Font></Screen><Screennumber="2"><Why>Ich akzeptiere die Bedingungen der Vereinbarung</Why><Who>Kunde</Who><When>1</When><Language>DE</Language><OK>OK</OK><Clear>Löschen</Clear><Cancel>Abbrechen</Cancel><Fontsize="12">Verdana</Font></Screen></Screens>

Signature SDK API

通过设置以下属性，在调用签名捕捉时启用 STU 签名模式：

stuSigModeConfig

值（字符串）[配置文件的完整路径名]，[签名屏幕编号 1...3］
其中签名屏幕编号值（DWORD）为：

0 - 不使用签名模式
1 - 使用签名屏幕 1
2 - 使用签名屏幕 2
3 - 使用签名屏幕 3

示例 1

var dc  = new ActiveXObject("Florentis.DynamicCapture");
var sig = new ActiveXObject("Florentis.SigCtl");

dc.SetProperty("stuSigModeConfig", "c:\\config\\STU-screens.config,1");
dc.Capture(sig, "Customer", "I accept the terms of the agreement");

应用注意事项：

如果上传到数位板的图像与配置中定义的图像不匹配，捕获将失败。
签名捕获必须获得授权。如果未获得许可，图像对比将因添加了评估水印而失败。
如果配置指定了原因/签名人/位置的静态值，则传给捕获()的 Who 和 Why 参数以及传给 SetProperty("Where") 的 Where 值必须匹配。
SetProperty("stuSigModeConfig")应传入配置文件的名称（必要时包括路径）+ 屏幕编号（1 至 3），中间用逗号隔开。

如果省略屏幕编号，Capture 将使用在配置文件中找到的第一个屏幕，屏幕编号也可以通过前面的调用指定：

SetProperty("stuSigModeScreenNum", <num>);

除了提供配置文件外，还可以通过一系列带有属性名称的 SetProperty 调用，以编程方式指定配置：

"stuSigModeScreenNum"
"stuSigModeWhy"
"stuSigModeWho"
"stuSigModeWhen"
"stuSigModeOK"
"stuSigModeClear"
"stuSigModeCancel"
"stuSigModeFontName"
"stuSigModeFontSize"
"stuSigModeConfig"

这些值将与上传到 STU 数位板的配置进行验证。

示例 2

var dc  = new ActiveXObject("Florentis.DynamicCapture");
var sig = new ActiveXObject("Florentis.SigCtl");//  replace dc.SetProperty("stuSigModeConfig", szSigConfig);
    dc.SetProperty("stuSigModeScreenNum",1);
//  dc.SetProperty("stuSigModeWhy",szWhy);       dynamic//  dc.SetProperty("stuSigModeWho",szWho);       dynamic
    dc.SetProperty("stuSigModeWhen",1);
    dc.SetProperty("stuSigModeOK","OK (screen 1)");
    dc.SetProperty("stuSigModeClear","Clear");
    dc.SetProperty("stuSigModeCancel","Cancel");
    dc.SetProperty("stuSigModeFontName","Verdana");
    dc.SetProperty("stuSigModeFontSize",10);
 
 dc.Capture(sig, "Customer", "I accept the terms of the agreement");

使用 query.exe（STU 串行连接实用程序）验证签名屏幕图像是否已上传。例如

...
RomImageHash[Signature,1,normal]          = 6686b765cb00bcdefd40a0f53c58d46a 
RomImageHash[Signature,1,pushed]          = 1b4bf1afd08396de7fd8715749bd9274
RomImageHash[Signature,2,normal]          = 47954cb7e99c36b8ee9b4df6f8425edd
RomImageHash[Signature,2,pushed]          = cf9d9d2727f0eef1cd646c2864e6a428
RomImageHash[Signature,3,normal]          = not stored
RomImageHash[Signature,3,pushed]          = not stored
...

Windows 注册表 API

要在传统系统中使用 STU 签名模式，除了在应用程序中调用 SetProperty 之外，还可以在注册表中设置相应的值。

Key

32 bit: HKLM\Software\Wow6432Node\Florentis\sd
64 bit: HKLM\Software\Florentis\sd

Property: stuSigModeConfig