For SimpleSigner Version 7.x and older please use this page.

Using StepOver SimpleSigner to sign a PDF File

Order	Required	Parameter	Usage
1.	Yes	Filename of the document to sign	c:\Users\max\Desktop\Testfile.pdf
2.	Yes	X1 coordinate	200
3.	Yes	Y1 coordinate	200
4.	Yes	X2 coordintate	400
5.	Yes	Y2 coordinate	400
6.	Yes	Number of the page where the signature shold be added	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.
*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:

Windows

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

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/testfile.pdf 200 200 400 400 -1

Stamp Options for PDF signing

Parameter	Usage
Stamp-	Allows to enable or disable the visible stamp in the signature field Stamp-0 = stamp is disabled Stamp-1 = stamp will be added to the signature
Reason-	Allows to set the Reason entry to be used in the signature field and as stamp "Reason-I agree with the content of the document"
Signer-	Name of the signer. "Signer-Max Power"
Location-	Allows to set the Location entry to be used in the signature field and as stamp "Location-Stuttgart / Germany"

Windows

SimpleSigner.exe "C:\users\max\testfile.pdf" 150 500 330 600 1 "Stamp-1" "Reason-I agree with the content" "Signer-Max Power" "Location-Stuttgart / Germany"

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/demo.pdf 150 500 330 600 1 "Stamp-1" "Reason-I agree with the content" "Signer-Max Power" "Location-Stuttgart / Germany"

Result is a visible stamp which is added under the signature and reason + location which are added to the signature properties.

SimpleSigner.exe "c:\temp\demo.pdf" 150 500 330 600 1 "Stamp-0" "Reason-I agree with the content of the document" "Location-Stuttgart / Germany"

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/demo.pdf 150 500 330 600 1 "Stamp-0" "Reason-I agree with the content of the document" "Location-Stuttgart / Germany"

Result is no visible stamp, the reason and location will be added to the signature properties.

Windows

SimpleSigner.exe "c:\temp\demo.pdf" 150 500 330 600 1 "Stamp-1"

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/demo.pdf 150 500 330 600 1 "Stamp-1"

Result is a visible stamp which contains only the time, the signature properties will stay empty.

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

Order	Parameter	Usage
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 image	150
3.	Y = height of the image	100
*Other Parameters like TextOut, AutoSaveSig...have to placed after the Y Parameter*

A sample could look like this:

Windows

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

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/My Signature.jpeg 200 100

Additional parameter

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

Paramter	Usage
FileProtection-	This parameter allows to set the file protection setting for a signed PDF document. FileProtection-0 = PDF will be saved without read-only attribute FileProtection-1 = PDF will be saved with read-only attribute (default if this parameter is not used) Note: The SimpleSigner will not overwrite/update PDF files with active read-only attribute. Windows SimpleSigner.exe "c:\temp\demo.pdf" 150 500 330 600 1 FileProtection-1 macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/demo.pdf 150 500 330 600 1 FileProtection-1
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: Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "TextOut-Please sign now" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/Test it.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: Windows SimpleSigner.exe "C:\Test\Test it.jpg" 250 100 "TimeOut-20" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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. Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "AutoSaveSig-2" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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. Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "AutoSaveSig-5" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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: Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "AutoSaveSig-5" "CancelLog-Cancel.txt" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/Test.jpg 250 100 "AutoSaveSig-5" "CancelLog-Cancel.txt"
Stretch	Zooms signature image to occupy the whole signature field.
FontSize-	Specifies font size for signature device's LCD. Example: Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "TextOut-Please sign now" "fontsize-12" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/Test.jpg 250 100 "TextOut-Please sign now" "fontsize-12" or Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "TextOut-Please sign now" "fontsize-24" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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: Windows SimpleSigner.exe "signature.bmp" 200 150 res-1024x768 macOS /Applications/SimpleSigner/SimpleSigner 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: Windows SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False viewpdf macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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. Sample: (view page 2 from mustermann.pdf) Windows SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False viewpdf-2 macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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: Windows SimpleSigner.exe "C:\Mustermann.pdf" 200 200 400 350 1 0 False signondoc macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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 depends on the device typ. Colour-Pad: 640x310 Flawless/Comfort: 480x272 Brilliance: 800x310 10.0: 945x600 Sample: Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 "foreground-C:\Test\Image.bmp" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/Test.jpg 250 100 "foreground-C:\Test\Image.bmp"
mouse	enables 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: Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 winSize-500x200 macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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: Windows SimpleSigner.exe "C:\Test\Test.jpg" 250 100 autosavesig-3 hidegui macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/Test.jpg 250 100 autosavesig-3 hidegui
StayOnTop	Allows the simplesigner App to be in foreground*
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: Windows SimpleSigner.exe "C:\users\max\testfile.pdf" 200 200 400 400 1 0 "MainPassword-yourdevicepw" macOS /Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/testfile.pdf 200 200 400 400 1 0 "MainPassword-yourdevicepw"

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

209: Rotate display 90°

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:

Windows

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

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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)

Windows

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"

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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:

Windows

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

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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)

Windows

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

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/Mustermann.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:

Windows

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

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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:

Windows

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

(

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/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-

rectsigr-

rectsigt-

rectsigb-

These 4 parameters can be used to overwrite the signing area on the signature pad.

rectsigl = Reactangle Signature left which is the point at the left side of the screen where the signature capture begins in horizontal direction.

rectsigr = Reactangle Signature Right which is the point at the right side of the screen where the signature capture ends in horizontal direction.

rectsigt = Reactangle Signature Top which is the point at the top side of the screen where the signature capture begins in vertical direction.

rectsigb = Reactangle Signature bottom which is the point at the bottom side of the screen where the signature capture ends in vertical direction.

Note :

all values are in pixels.
1. for duraSign 10.0 the display size in 1024 x 600 minus 74px for the button bar
2. for duraSign Brilliance the display size us 800x480 minus 71px for the button bar
if the display size is not known then rectsigr and rectsigb can be set to a higher value for eg rectsigr-9999 , rectsigb-9999 internally it will be set to max allowed value for the device.

Sample :

Windows

SimpleSigner.exe "C:\users\max\testfile.pdf" 200 200 400 400 -1 rectsigl-0 rectsigr-954 rectsigt-0 rectsigb-600

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/testfile.pdf 200 200 400 400 -1 rectsigl-0 rectsigr-954 rectsigt-0 rectsigb-600

Encryption Setting

StepOver Signature Pads with Firmware 7.x or higher support bigger encryption keys for the biometric and the digital signature. The Pads have at least 3 sets of encryption Keys. The First (ID=0) has keys with the length of 2048 which was the standard of the pads until 2020. The new Firmware supports biodata encryption with a key of 4096 and the digital signature (only without "noconfirm" parameter) of 3072. The default by a Pad with Firmware 7.x is the set with the highest Encryption set (ID=2), by older devices there is only 1 set which is automatically used.

Company	ID	Name	DigitalSig Keypair	Biometric Key
StepOver GmbH	0	StepOver cryptoIdv1	2048	2048
	1	StepOver 2048/4096	2048	4096
	2	StepOver 3072/4096	3072	4096
StepOver International	0	StepOver cryptoIdv1	2048	2048
	1	StepOver Int 2048/4096	2048	4096
	2	StepOver Int 3072/4096	3072	4096

cryptoid-<ID>

Define the encryption set by the ID.

Sample:

Windows

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

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/document.pdf 200 200 400 350 1 0 False "cryptoid-1"

cryptoid-<Name>

Define the encryption set by the Name.

Sample:

Windows

SimpleSigner.exe "C:\document.pdf" 200 200 400 350 1 0 False "cryptoid-StepOver 2048/4096"

macOS

/Applications/SimpleSigner/SimpleSigner /Users/max/Documents/pdfs/document.pdf 200 200 400 350 1 0 False "cryptoid-StepOver 2048/4096"

Returnvalue

Value	Description
2	TCP/IP Connection Timeout
1	successfull
-1	Abort with Cancel button (inside SimpleSigner or on the device)
-2	Error occured, no info about cause.
-3	Error while embedding the signature into the PDF
-4	Timeserver access error (NOT IMPLEMENTED YET.SHOULD NEVER OCCURE)
-5	unhandled application crash (Exception) occured
-6	Timeout occured by the timeout set by Timeout- variable
-7	User exits the application by using the X on the GUI
-8	Error saving file. Possible reasons are permission issues or readonly file attribute (one of the optional parameter)
-12	temp file hash is incorrect
-20	document is not loaded. not existing or not accessible
-21	document erroneous (biodata string or container defect)
-22	document is sealed oder hash is encrypted with unknown key
-26	the signatureimage is wrong (max 5 pixel signature or max 50 biodata frames embedded)
-28	failure in imagestream from pad
-29	signature field is too small, height and width need to be higher than 20
-30	image could not be saved
-300	SimpleSigner,eSignatureOffice,WebSign,SecureSign is already running

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

Browser not supported