| 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 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. | Optional | 1 = Add a stamp with name, reason and the actual date below the signature Default = 0 | |
| 8. | Optional | Reason for signing | "I agree with the content of the documet" |
| 9. | Optional | Name of the signer | "Max Power" |
| 10. | Optional | Save File with attribtue write protected | default = 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
| Order | Parameter | Usage |
|---|---|---|
| 1. | Filename where the image shold be saved | "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:
SimpleSigner.exe "C:\users\max\My Signature.jpeg" 200 100
the following parameter have to ba at the end at the starting parameter described above
| Paramter | Usage |
|---|---|
| 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. The number of seconds has to be entered after the parameter, for example: In combination with the parameters for creating a JPEG from a signature, the startup parameters could be as follows: 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" 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. |
| Stretch | Zooms signature image to occupy the whole signature field. |
| FontSize- | Specifies font size for signature device's LCD. 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. Sample: |
| signondoc | This signature mode shows the document background during the signature on the device Sample: |
| foreground- | To change the background iImage for the default signmode. The format must be BMP and the Size 640x310. Sample: |
| 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: 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) |
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) |
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)