Breadcrumbs

signcap – Einstellungen

Alle folgenden Methoden setzen Einstellungen, die beim Aufruf von Capture wirksam werden, und müssen folglich davor aktiviert werden. Die Funktionalität der Schnittstellen unterscheidet sich teilweise; am Anfang jeder Methodenbeschreibung ist gekennzeichnet, für welche Schnittstelle die Methode gültig ist.

Methode SetPenWidth

IPadSignotecSignatureDevice

✔️

IPadTabletPC

✔️

Setzt die Strichstärke der gerenderten Unterschrift für die Eigenschaft Image.
Der Unterschriftenzug kann damit dicker oder dünner gestaltet werden. Alternativ kann der Wert auch über SetImageParameter gesetzt werden.

C#
void SetPenSize(int nPensize);
C++
HRESULT SetPenSize(int nPensize);

Parameter

In

Out

Mögliche

Werte

Beschreibung

nPensize

✔️


1 - 20

Strichstärke in Pixeln


12

Standardwert

Methode SetImageParameter

IPadSignotecSignatureDevice

✔️

IPadTabletPC


Setzt Parameter für das Rendern des Unterschriftenbildes. Das Aussehen der Unterschrift kann damit verändert werden.

C#
void SetImageParameter(
                       short nResolution,
                       int nWidth,
                       int nHeight,
                       short nPenWidth,
                       uint penColor,
                       int nOptions
                       );
C++
HRESULT SetImageParameter(
                          short nResolution,
                          long nWidth,
                          long nHeight,
                          short nPenWidth,
                          unsigned long penColor,
                          long nOptions
                          );

Parameter

In

Out

Mögliche

Werte

Beschreibung

nResolution

✔️


>0

Auflösung in Pixel / Zoll (ppi)

nWidth

✔️


>0

Maximale Breite des zu erstellenden Bildes in Pixeln

nHeight

✔️


>0

Maximale Höhe des zu erstellenden Bildes in Pixeln

nPenWidth

✔️


>0

Strichstärke in Pixeln

Das Setzen hier ist äquivalent zum Setzen mit SetPenWidth.

penColor

✔️


sechsstelliger Hexadezimalwert, je zwei Stellen bestimmen die Stärke der Farbkomponenten RGB

Farbe der Unterschrift


0x000000

schwarz

0xFF0000

blau

0x00FF00

grün

0x0000FF

rot

0x808080

grau

nOptions

✔️


Kombination aus:

Bitmaske


0x0001

Es wird ein visueller Zeitstempel in das Bild unterhalb der Unterschrift integriert.

0x0002

Die Unterschrift wird in das während der Erfassung angezeigte Bild gerendert.

Das Bild hat immer das Seitenverhältnis des verwendeten Displays, nWidth oder nHeight werden gegebenenfalls ignoriert.

0x0004

Die definierten Hotspot-Bereiche werden im Bild geweißt (nur in Verbindung mit 0x0002).

0x0008

Weiße Bereiche an den Seiten der Unterschrift werden nicht abgeschnitten; sind nWidth und nHeight größer 0, wird die Unterschrift je nach Seitenverhältnis in die definierte Höhe oder Breite eingepasst, und das zu erstellende Bild hat exakt die definierte Größe (nur, wenn 0x0002 nicht gesetzt ist).

0x0010

Die Unterschrift wird am linken Bildrand ausgerichtet (nur in Verbindung mit 0x0008).

0x0020

Die Unterschrift wird am rechten Bildrand ausgerichtet (nur in Verbindung mit 0x0008).

0x0040

Die Unterschrift wird am oberen Bildrand ausgerichtet (nur in Verbindung mit 0x0008).

0x0080

Die Unterschrift wird am unteren Bildrand ausgerichtet (nur in Verbindung mit 0x0008).

0x0100

Die Größe des Zeitstempels ist relativ zur Höhe des erzeugten Bildes, nicht zur Höhe des Bildschirms; diese Einstellung ist sinnvoll bei einer vorgegebenen Bildgröße, in die die Unterschrift skaliert wird, damit der Zeitstempel immer unabhängig von der Größe der tatsächlichen Unterschrift ist (nur in Verbindung mit 0x0001).

0x0200

Die Unterschrift wird unabhängig von allen anderen Einstellungen niemals weichgezeichnet. Durch diese Einstellung können sehr kleine Dateien erzeugt werden.

0x0400

Die Unterschrift wird unabhängig von allen anderen Einstellungen immer weichgezeichnet.

0x0800

Das Bild enthält ein gegebenenfalls angezeigtes Overlay Rechteck (nur in Verbindung mit 0x0002).

0x1000

Weiße Bereiche werden transparent gespeichert (nur wenn 0x0002 nicht gesetzt ist und als Dateiformat PNG ausgewählt ist).

0x2000

Es wird nicht der während der Erfassung angezeigte, sondern der aktuelle Bildschirminhalt als Hintergrundbild verwendet (nur in Verbindung mit 0x0002).

0x4000

Die Stiftbreite wird um den angegebenen Wert in Abhängigkeit der Druckwerte variiert.

Methode SetWindowText

IPadSignotecSignatureDevice

✔️

IPadTabletPC

✔️

Setzt den Text der Titelleiste des modalen Dialogs, der beim Aufruf von Capture angezeigt wird. Zum Beispiel kann damit der Name des Unterzeichners eingeblendet werden.

C#
void SetWindowText(string bstrText);
C++
HRESULT SetWindowText(BSTR bstrText);

Parameter

In

Out

Mögliche

Werte

Beschreibung

bstrText

✔️


string

Text für die Titelleiste des Capture-Dialoges


“signotec”

Standardtext

Methode SelectDialog

IPadSignotecSignatureDevice

✔️

IPadTabletPC

✔️

Diese Methode fügt zusätzliche Elemente zum Benutzerdialog während des Unterschriftenprozesses hinzu.

Zum einen kann ein Text angezeigt werden, der vom Benutzer bestätigt werden muss. Auf Pads erscheint dazu vor dem Unterschreiben ein zusätzlicher Dialog mit dem angegebenen Text. Der Benutzer kann den Text dann entweder bestätigen oder den Unterschriftenprozess abbrechen. Für Tablet PCs wird dem Dialogfenster stattdessen eine Checkbox mit dem angegebenen Text hinzugefügt, die angehakt werden muss, bevor die Unterschrift bestätigt werden kann.

Zudem kann dem Unterschriftendialog eine “Überspringen”-Schaltfläche hinzugefügt werden. Dieser ist allerdings nur auf Sigma und Zeta Signature Pads verfügbar.

C#
void SelectDialog (short nIndex, string bstrConfirmationtext);
C++
HRESULT SelectDialog (short nIndex, BSTR bstrConfirmationtext);

Parameter

In

Out

Mögliche

Werte

Beschreibung

nIndex

✔️


0

Es wird keine “Überspringen”-Schaltfläche angezeigt.

1

Die “Überspringen”-Schaltfläche wird angezeigt.

bstrConfirmationtext

✔️


string,

Länge > 0

angezeigter Text, der bestätigt werden muss (nur wenn nIndex = 1)

leerer String

Bestätigung nicht anfordern

Methode SetButtonPosition

IPadSignotecSignatureDevice

✔️

IPadTabletPC


Bestimmt die Position der interaktiven Schaltflächen auf dem LCD des Pads während des Erfassens.

C#
void SetButtonPosition(int nButtonPosition);
C++
HRESULT SetButtonPosition(int nButtonPosition);

Parameter

In

Out

Mögliche

Werte

Beschreibung

nType

✔️


0

Schaltflächen Oben

1

Schaltflächen Unten

2

Schaltflächen Links

3

Schaltflächen Rechts

Methode SetPadType

IPadSignotecSignatureDevice

✔️

IPadTabletPC


Setzt den Anschlusstyp des zu verwendeten Pads.

C#
void SetPadType(short nType);
C++
HRESULT SetPadType(short nType);

Parameter

In

Out

Mögliche

Werte

Beschreibung

nType

✔️


101

USB oder IP (wenn SetIPAddress aufgerufen wurde)

102

seriell / Virtual Channel

Methode SetComPort

IPadSignotecSignatureDevice

✔️

IPadTabletPC


Legt die anzusteuernde serielle Schnittstelle (COM-Port), an die das Pad angeschlossen ist, manuell fest. Nur wirksam, wenn mit SetPadType der entsprechende Padtyp eingestellt wurde.

C#
void SetComPort(short nPort);
C++
HRESULT SetComPort(short nPort);

Parameter

In

Out

Mögliche

Werte

Beschreibung

nPort

✔️


1 – 256

zu verwendender COM-Port

0

Es wird an allen COM-Ports gesucht. Dieser Prozess kann unter Umständen sehr lange dauern.

Methode SetIPAddress

IPadSignotecSignatureDevice

✔️

IPadTabletPC


Setzt die IP Adresse, über den das Pad angesprochen werden soll. Nur wirksam, wenn mit SetPadType der entsprechende Padtyp eingestellt wurde.

C#
void SetIPAddess(string bstrIPAddress);
C++
HRESULT SetIPAddess(BSTR bstrIPAddress);

Parameter

In

Out

Mögliche

Werte

Beschreibung

bstrIPAddress

✔️


string

Gültige IP-Adresse : Port

Beispiel: “IP=192.168.100.100:1002”

Methode SetLCDText

IPadSignotecSignatureDevice

✔️

IPadTabletPC


Schreibt frei definierbare Textzeilen auf das LC-Display des Pads. Die Ausgabe erfolgt in der Schriftart „Arial“, die Schriftgröße und der Schriftstil können verändert werden.

Der gewünschte Text wird mittels eines Textfelds eingebracht, dessen oberer, linker Eckpunkt in Pixel angegeben werden muss. Das Koordinatensystem hat dabei seinen Ursprung in der oberen, linken Ecke des LCD. Die Höhe und Breite des Textfelds wird automatisch bestimmt und ist von der Menge des Textes und der Parameter für diesen abhängig. Es kann daher dazu kommen, dass Textfelder über den Rand des Pads hinausreichen.

Der Text wird erst bei Aufruf der Capture-Methode angezeigt.

C#
HRESULT SetLCDText (
                    int x,
                    int y,
                    string bstrText,
                    int nTextSize,
                    int bBold,
                    int nIndex
                    );
C++
HRESULT SetLCDText (
                    int x,
                    int y,
                    BSTR bstrText,
                    int nTextSize,
                    long bBold,
                    int nIndex
                    );

Parameter

In

Out

Mögliche

Werte

Beschreibung

x

✔️


>=0

Der Wert der X-Koordinate für die Position, an der das Textfeld beginnen soll.

y

✔️


>=0

Der Wert der Y-Koordinate für die Position, an der das Textfeld beginnen soll.

bstrText

✔️


Null-terminierte Wide-Char Zeichenkette

Text, der auf dem LCD dargestellt werden soll

nTextSize

✔️


>=12

Schriftgröße

Maximal- und Minimalwert sind abhängig von der gewählten Schriftart. Wenn die angegebene Schriftgröße kleiner als 12 ist, wird die Schriftgröße 12 verwendet.

bBold

✔️


0

Normalschrift

1

Fettschrift

nIndex

✔️


0

reserviert

Methode SetSampleRate

IPadSignotecSignatureDevice

✔️

IPadTabletPC


Mit dieser Methode kann der Abtastmodus eingestellt werden, in dem die Unterschrift erfasst wird. Der Wert wird dauerhaft im Pad gespeichert. Standardmäßig ist Modus 1 (250 Hz) eingestellt. Dieser Modus bietet sehr gute Unterschriftsdaten bei gleichzeitig moderater Größe des Datensatzes. Bei schnellen Datenleitungen kann dieser Wert problemlos auf 2 (500 Hz) eingestellt werden. Es kann aber auch die Abtastrate übernommen werden, die aktuell im Gerät eingestellt ist.

C#
void SetSampleRate (int nSampleRate);
C++
HRESULT SetSampleRate (long nSampleRate);

Parameter

In

Out

Mögliche

Werte

Beschreibung

nSampleRate

✔️


-1

Abtastrate aus Unterschriftenpad übernehmen

0

125 Hz

1

250 Hz (Standard)

2

500 Hz