Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ParamterUsage
TextOut-This parameter shows a line of text on the screen of the signature device.

The output text has to be entered directly after the TextOut- Parameter, e.g.:
TextOut-Text

Be careful with spaces:
If you are going to use spaces you will have to place the parameters in quotation marks.
"TextOut-Written text"

Texts with a number of lines:
You can enter a number of consecutive TextOut- parameters. The first parameter appears on the first line, the second on the second line, etc:
"TextOut-this text will appear first," "TextOut-this other one will follow "

Spaces:
If you only handle the TextOut parameter (followed by a space) a space will appear on the pad screen.
"TextOut-1. line," TextOut- "TextOut-3. line."


In combination with the parameters for creating a JPEG from a signature, the startup parameters could be as follows:
SimpleSigner.exe "C:\Test\Test.jpg" 250 100" "TextOut-Please sign now"
Timeout-

If SimpleSigner is started to make a signature:

This parameter indicates the number of seconds after which signing will automatically close. Should the signing not have started after the time indicated, the program will close itself.
When signing has been started, the clock will cancel itself and the program will act as it would do without this parameter.

The number of seconds has to be entered after the parameter, for example:
"TimeOut-15"
In this case 15 seconds would be counted.

In combination with the parameters for creating a JPEG from a signature, the startup parameters could be as follows:
SimpleSigner.exe "C:\Test\Test it.jpg" 250 100 TimeOut-20


If SimpleSigner is started to seal a document:

The parameter indicates how long the notification window with Sealing succeeded or Sealing failed message should be shown. If TimeOut-0 is specified, notification window is not shown. Nevertheless, exit code and CancelLog is set correctly.

AutoSaveSig-

This parameter saves the signature automatically two seconds after signing is completed.

SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "AutoSaveSig-2"

To give the user more than two seconds, the number which appears after the AutoSaveSig- parameter can be changed.
SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "AutoSaveSig-5"
In this last example, the signature will be saved 5 seconds after the signing process on the pad ends.

Note: This Parameter is not working with TCP Client (Serversonet), because TCP Client has an own Parameter for this function. You can find more Informations about this Functions in the Manual of TCP Client.

CancelLog-

If SimpleSigner is started to make a signature:

If cancelled this creates a file in the meta directory with the text "Signature cancelled".


If SimpleSigner is started to seal a document:

String "Sealed=true" or "Sealed=false" is written to the log file.
The name of the file is entered after the CancelLog parameter. If a file name is not given, the file will be given the default name "CancelLog.ret".

Example:
SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "AutoSaveSig-5" "CancelLog-Cancel.txt"

StretchZooms signature image to occupy the whole signature field.
FontSize-

Specifies font size for signature device's LCD.

Example:
SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "TextOut-Please sign now" "fontsize-12"

or

SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "TextOut-Please sign now" "fontsize-24"

Res-This parameter allows you to override the signature image size and use a different value than size of signature window.
By default the signature image (bmp or jpeg) is created with the same size (X1 by Y1).
The res- parameter allows to create images of arbitrary size.

Example:
SimpleSigner.exe "signature.bmp" 200 150 res-1024x768
noconfirm

Hides document hash confirmation dialog

viewpdf

View document on device before signing, actual signing started after click on green sign button on device's LCD.
This Button is only available on pads with colour display.

Sample:
SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False viewpdf

viewpdf-

View defined page of document on device before signing, actual signing started after click on green sign button on device's LCD.
This Button is only available on pads with colour display.

negative values are pages from the end, positive from beginning of document.

Sample: (view page 2 from mustermann.pdf)
SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False viewpdf-2

signondoc

This signature mode shows the document background during the signature on the device

Sample:
SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False signondoc

foreground-

To change the background iImage for the default signmode. The format must be BMP and the Size 640x310.

Sample:
SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "foreground-C:\Test\Image.bmp"

mouseenables the Mouse as drawing device for the simplesigner. The mouse counts as Tablet PC, therefor the This parameter is for pre-selecting the mouse cursor as signature device (TabletPC Extension is required)
penThis parameter is for pre-selecting the pen as signature device (TabletPC Extension is required)
touchThis parameter is for pre-selecting the touch as signature device (TabletPC Extension is required.)
winSize-

This parameter allows to configure the Windows Size of the SimpleSigner and was added for the usaged with TabletPC to increase the signing area.

Sample:

SimpleSigner.exe "C:\Test\Test.jpg" 250 100 winSize-500x200

hidegui 

With this Parameter the SimpleSigner Windows is not showed anymore, only the Pad Search Dialog will be visible.

Sample:

SimpleSigner.exe "C:\Test\Test.jpg" 250 100 autosavesig-3 hidegui 

location

Allows to set the Location entry to be used in the signature field.
This entry will be used in the visual stamp also.

SimpleSigner.exe  dokument.pdf  100 300 300 500 1 0 "I agree" "John Doe"   "Location-Stuttgart / Germany"

StayOnTopAllows the simplesigner App to be in foreground (Only in dotnet )
MainPassword-

This parameter is only the the NextGen devices. If the main page is protected with a password, you need to use this parameter to allow the SimpleSigner the access to the device.

Sample:

SimpleSigner.exe "C:\users\max\testfile.pdf" 200 200 400 400 1 0 "MainPassword-yourdevicepw"

...