Using StepOver SimpleSigner to sign a PDF/A File

OrderRequiredParameterUsage

1.

YesFilename of the document to signc:\Users\max\Desktop\Testfile.pdf
2.YesX1 coordinate200
3.YesY1 coordinate200
4.YesX2 coordintate400
5.YesY2 coordinate400
6.YesNumber of the page where the signature shold be added
Default: 1  
you can give the direct page number or use '-' prefix to start from the end of the document
-1 last page; -2 the page before the last page; etc. 
7.Optional1 = Add a stamp with name, reason and the actual date below the signature
Default = 0  
 
8.OptionalReason for signing"I agree with the content of the documet"
9.OptionalName of the signer

"Max Power"

10.OptionalSave File with attribtue write protecteddefault = true
Other Parameters like TextOut, noconfirm, viewpdf...have to placed after the required parameter

The Parameters 2-5 (X1, Y1, X2, Y2) indicate the left upper and the lower right coordinates of a rectangle on the given page. The visible signature will be added into the coordinates of the rectangle

The parameters can be handed to SimpleSigner from a customer applicatione.g. a batch-file. it is highly recommended that you set every parameter into quotation marks because spaces in a parameter (e.g. filename) will be interpreted as a new parameter.

A  sample could look like this:

SimpleSigner.exe "C:\users\max\testfile.pdf" 200 200 400 400 -1 1 "I agree with the content of the document" "Max Power" true

 

Using StepOver SimpleSigner to save an image of the signature as .bmp or .jpg

OrderParameterUsage
1.

Filename where the image shold be saved
(File extensioncould be *.bmp *.jpg or *.jpeg) 

"C:\Users\Max\Desktop\MySignature.jpg"
2.X = width of the image150
3.Y = height of the image100
Other Parameters like TextOut, AutoSaveSig...have to placed after the Y Parameter

A  sample could look like this:

SimpleSigner.exe "C:\users\max\My Signature.jpeg" 200 100

Additional parameter

the following parameter have to ba at the end at the starting parameter described above

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.

Default value is 5 seconds. 

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 the naturaSign Pad Colour and Brilliance Pad

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

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 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 

 

By default the SimpleSigner is managing the button behavior from the device, the Parameter buttonconfig allows to change the default behavior, for example to disable spezific Buttons.

buttonconfig-

The Parameter contains values for the ButtonID, Mode, Status and Colour for a single or for multiple buttons. The HashDialog is not effected from this Parameter and only effects the ColourDevices (ColourPad, Comfort, Flawless and Brilliance). To disable the Hashdialog use "noconfirm" Parameter.

Syntax:

-ButtonOptions-ButtonID-Mode-Status-Colour:ButtonID-Mode-Status-Colour:...


Arguments:

ButtonID

    200: Zoom into Page

    201: Zoom out of Page

    202: Next Page or Signature

    203: Previous Page or Signature

    204: Start Sign from Pad

    205: Rotate Display (left / right hand mode)

    206: OK

    207: Repeat

    208: Cancel

ModeType

0: default signature mode (Flags in Background)

5: Document view mode

6: sign in document mode

Enabled / Visable

0: disable

1: enable

Color

BGR color of the button, 32 Bit (TColor type in Delphi):

Bit 31 - 24 : 00h (all zero)

Bit 23 - 16 : Intensity of Blue

Bit 15 - 08 : Intensity of Green

Bit 07 - 00 : Intensity of Red

The value 00FF0000 represents full-intensity, pure blue.

The value 0000FF00 is full intensity pure green.

The value 000000FF is pure red.

The value 00000000 is black.

The value 00FFFFFF is white.

 

The default used color values are:

    Blue      = 00FF0000

    Green   = 00369000

    Yellow   = 0038CCF0

    Red      = 001A00E2

    White   = 00FFFFFF

    Grey    = 00B5B5B5


Sample:

SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False signondoc "buttonconfig-205-0-0-0:205-5-0-0"

(disable the Rotation Button for DocumentView und defaultSignmode)

SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False signondoc "buttonconfig-206-6-0-0:207-6-0-0:208-6-0-0"

(disable the OK / Repeat / Cancel button inside the SignInDocument Mode)

Zoom/Placement Options

The following options allows to modfiy the default settings of the SignInDoc mode

zoomsigx-

zoomsigy-

Parameter force the to show the signature fields in a specific size (mm) on the pad display. You can either use zoomsigx for forcing the width or zoomsigy for forcing the height

 

Sample:

SimpleSigner.exe "C:\document.pdf" 200 200 400 350 1 0 False signondoc zoomsigx-100

(signature field has a width of 100mm, the height depends of the Y coordinates)

SimpleSigner.exe "C:\document.pdf" 200 200 400 350 1 0 False signondoc zoomsigy-50

(signature field has a height of 50mm, the width depends of the X coordinates)

possigx-

possigy-

Parameter to define the placement based on the bottom/left corner of the signature pad. The 2 Parameter can be combined and the value is in mm.

 

Sample:

SimpleSigner.exe "C:\document.pdf" 200 200 400 350 1 0 False signondoc possigx-30 possigy-50

(signature field is placed 3cm right into right and 5cm into top, from bottom/left)

areasig-

Parameter to set how much percent of display should be filled with the signature field. For duraSign Pad 10.0 the zoomsig and possig have to be set 0.

 

Sample:

SimpleSigner.exe "C:\document.pdf" 200 200 400 350 1 0 False signondoc zoomsigx-0 zoomsigy-0 possigx-0 possigy-0 areasig-50

(50% signature field for duraSign Pad 10.0)

rectsigl-

rectsigt-

rectsigr-

rectsigb-

Parameters which allow the restrict the signing area were you can draw the signature

 

Sample:

SimpleSigner.exe "C:\document.pdf" 200 200 400 350 1 0 False rectsigl-49 rectsigr-895 rectsigt-303 rectsigb-534

(defines the signature area by the duraSign Pad 10.0 to the grey area)

 

 

Calculation of the PDF coordinates

The top/left has the value 0/0 and for the calculation you can yuse the following formula:

A4= 8.27 x 11.69 inch with 72points/inch = 595x842 points

1 point = 0.03527777778 centimeters

1point = 0.01388888889 inch

Example: 5cm are 142 points (5cm / 0.03527777778 = 141,7323)