German English
German English

signoPAD-API Java - Bildspeicher

Die signotec LCD Signature Pads haben mehrere Bildspeicher, die von verschiedenen Methoden der Klasse SigPadApi angesprochen werden können. Ein Bildspeicher hat immer die Größe des Bildschirms und kann ein Bild in maximal dieser Größe speichern. Wird einem Speicher ein weiteres Bild hinzugefügt, überschreibt dieses die Bereiche, in denen es sich mit dem vorhandenen Speicherinhalt überlappt. Durch Speichern mehrerer Bilder in einem Speicher kann also eine Collage erstellt werden.

Je nach Modell steht eine unterschiedliche Anzahl an flüchtigen und nichtflüchtigen Speichern zur Verfügung.

Flüchtige Bildspeicher

Alle signotec LCD Signature Pads besitzen mind. zwei flüchtige Bildspeicher, einen, der den aktuellen Bildschirminhalt speichert (Vordergrundpuffer), und einen, in dem ein Bildinhalt zur Anzeige vorbereitet werden kann (Hintergrundpuffer). Grundsätzlich kann immer in beide Speicher geschrieben werden.

Der Inhalt der flüchtigen Bildspeicher geht beim Schließen der Verbindung zum Gerät verloren.

Modell Sigma und Zeta

Die beiden flüchtigen Bildspeicher haben jeweils die Größe des Bildschirms (Sigma 320x160 Pixel, Zeta 320x200 Pixel).

Die Übertragung und Darstellung von Bildern geht in der Regel so schnell, dass es zu keiner sichtbaren Verzögerung kommt. Bei komplexeren Darstellungen, die aus mehreren einzelnen Bildern bestehen, kann es aber sinnvoll sein, diese zuerst im Hintergrundpuffer zu speichern, um sie anschließend in den Vordergrundpuffer zu verschieben.

Modell Omega

Das Omega hat drei flüchtige Bildspeicher, zwei in der doppelten Größe des Bildschirms (640x960 Pixel) als Vorder- und Hintergrundpuffer sowie einen in Größe des Bildschirms (640x480 Pixel) als Overlay-Puffer, dessen Inhalt über den sonstigen Bildschirminhalt übergeblendet werden kann.

Die Geschwindigkeit des Bildaufbaus beim Modell Omega hängt von der Größe und dem Inhalt der Bilder ab, i. d. R. ist der Bildaufbau sichtbar. Daher sollten Bilder immer zunächst im Hintergrundpuffer gespeichert werden, um sie anschließend in den Vordergrundpuffer zu verschieben.

Modell Gamma

Das Gamma hat drei flüchtige Bildspeicher, zwei, die größer sind als der Bildschirm (800x1440 Pixel), als Vorder- und Hintergrundpuffer sowie einen in Größe des Bildschirms (800x480 Pixel) als Overlay-Puffer, dessen Inhalt über den sonstigen Bildschirminhalt übergeblendet werden kann.

Ein Bild wird beim Modell Gamma immer erst angezeigt, nachdem es übertragen worden ist, der Bildaufbau ist nicht sichtbar. Die Geschwindigkeit der Bildübertragung hängt von der Größe und dem Inhalt der Bilder ab sowie von der Betriebsart. Nach Möglichkeit sollte das Gerät immer im WinUSB-Modus betrieben werden, hierzu ist ggf. die separate Installation des signotec WinUSB-Treibers erforderlich. Bei komplexeren Darstellungen, die aus mehreren einzelnen Bildern bestehen, ist es i. d. R. sinnvoll, diese zuerst im Hintergrundpuffer zu speichern, um sie anschließend in den Vordergrundpuffer zu verschieben.

Modell Alpha

Das Alpha hat drei flüchtige Bildspeicher, zwei, die größer sind als der Bildschirm (2048x2048 Pixel), als Vorder- und Hintergrundpuffer sowie einen in Größe des Bildschirms (768x1366 Pixel) als Overlay-Puffer, dessen Inhalt über den sonstigen Bildschirminhalt übergeblendet werden kann.

Ein Bild wird beim Modell Alpha immer erst angezeigt, nachdem es übertragen worden ist, der Bildaufbau ist nicht sichtbar. Die Geschwindigkeit der Bildübertragung hängt von der Größe und dem Inhalt der Bilder ab sowie von der Betriebsart. Nach Möglichkeit sollte das Gerät immer im WinUSB-Modus betrieben werden, hierzu ist ggf. die separate Installation des signotec WinUSB-Treibers nötig. Bei komplexeren Darstellungen, die aus mehreren einzelnen Bildern bestehen, ist es i. d. R. sinnvoll, diese zuerst im Hintergrundpuffer zu speichern, um sie anschließend in den Vordergrundpuffer zu verschieben.

Modell Delta

Das Delta hat drei flüchtige Bildspeicher, zwei, die größer sind als der Bildschirm (1280x37600 Pixel), als Vorder- und Hintergrundpuffer sowie einen in Größe des Bildschirms (1280x800 Pixel) als Overlay-Puffer, dessen Inhalt über den sonstigen Bildschirminhalt übergeblendet werden kann.

Ein Bild wird beim Modell Delta immer erst angezeigt, nachdem es übertragen worden ist, der Bildaufbau ist nicht sichtbar. Die Geschwindigkeit der Bildübertragung hängt von der Größe und dem Inhalt der Bilder ab sowie von der Betriebsart. Nach Möglichkeit sollte das Gerät immer im WinUSB-Modus betrieben werden, hierzu ist ggf. die separate Installation des signotec WinUSB-Treibers erforderlich. Bei komplexeren Darstellungen, die aus mehreren einzelnen Bildern bestehen, ist es i. d. R. sinnvoll, diese zuerst im Hintergrundpuffer zu speichern, um sie anschließend in den Vordergrundpuffer zu verschieben.

Pen Display

Ein Pen Display hat keine physikalischen Bildspeicher. Für die Darstellung der grafischen Komponenten werden die zwei flüchtigen Bildspeicher im Arbeitsspeicher in der Größe des Erfassungsbereiches (PenDisplayFacade.setDisplaySize()) simuliert.

Nichtflüchtige Bildspeicher

Die signotec LCD Signature Pads besitzen je nach Modell eine unterschiedliche Anzahl an nichtflüchtigen Bildspeichern. Das Speichern von Bildern in nichtflüchtigen Bildspeichern dauert länger als das Speichern in flüchtigen Bildspeichern, dafür bleibt der Inhalt aber auch nach dem Ausschalten des Gerätes erhalten. Eine intelligente Speicherverwaltung erkennt, ob ein zu speicherndes Bild bereits im Gerät gespeichert ist, so dass es nur beim erstmaligen Speichern zu einer Verzögerung kommt.

Modell Sigma und Zeta

Die Modelle Sigma und Zeta besitzen einen nichtflüchtigen Bildspeicher in der Größe des Bildschirms (Sigma 320x160 Pixel, Zeta 320x200 Pixel), der nur für das Standby-Bild genutzt werden kann. Aufgrund der schnellen Übertragung und Darstellung von Bildern ist es nicht nötig, andere für den Programmablauf nötige Bilder dauerhaft speichern zu können.

Modell Omega

Das Modell Omega besitzt elf nichtflüchtige Bildspeicher, die für das Standby-Bild, die Diaschau und Optimierungen des Programmablaufs verwendet werden können. Die Bildspeicher, die für das Standby-Bild oder die Diaschau verwendet werden, sind schreibgeschützt und können nur durch das Deaktivieren des Standby-Bildes oder der Diaschau wieder freigegeben werden.

Ein nichtflüchtiger Bildspeicher hat die doppelte Größe des Bildschirms (640x960 Pixel), zehn Speicher haben die Größe des Bildschirms (640x480 Pixel).

Soll ein nichtflüchtiger Bildspeicher verwendet werden, muss dieser zunächst reserviert werden. Dies geschieht durch Aufruf der Methode ImageMemory.requestPermanentStore(). Die Größe eines Speichers kann über die Eigenschaften ImageMemory.getWidth() und ImageMemory.getHeight() abgefragt werden.

Modell Gamma

Das Modell Gamma besitzt zehn nichtflüchtige Bildspeicher, die für das Standby-Bild, die Diaschau und Optimierungen des Programmablaufs verwendet werden können. Die Bildspeicher, die für das Standby-Bild oder die Diaschau verwendet werden, sind schreibgeschützt und können nur durch das Deaktivieren des Standby-Bildes oder der Diaschau wieder freigegeben werden.

Die zehn nichtflüchtigen Speicher haben die gleiche Größe wie der Bildschirm (800x480 Pixel).

Soll ein nichtflüchtiger Bildspeicher verwendet werden, muss dieser zunächst reserviert werden. Dies geschieht durch Aufruf der Methode ImageMemory.requestPermanentStore(). Die Größe eines Speichers kann über die Eigenschaften ImageMemory.getWidth() und ImageMemory.getHeight() abgefragt werden.

Im Gegensatz zum Omega ist die Verwendung der nichtflüchtigen Speicher beim Gamma zur Optimierung des Programmablaufs in der WinUSB-Betriebsart nicht nötig, weil die Bildübertragung sehr schnell ist. Das hängt aber immer vom Einzelfall und sollte individuell vom Entwickler entschieden werden.

Modell Alpha

Das Modell Alpha besitzt zehn nichtflüchtige Bildspeicher, die für das Standby-Bild, die Diaschau und Optimierungen des Programmablaufs verwendet werden können. Die Bildspeicher, die für das Standby-Bild oder die Diaschau verwendet werden, sind schreibgeschützt und können nur durch das Deaktivieren des Standby-Bildes oder der Diaschau wieder freigegeben werden.

Die zehn nichtflüchtigen Speicher haben die gleiche Größe wie flüchtigen Speicher (2048x2048 Pixel).

Soll ein nichtflüchtiger Bildspeicher verwendet werden, muss dieser zunächst reserviert werden. Dies geschieht durch Aufruf der Methode ImageMemory.requestPermanentStore(). Die Größe eines Speichers kann über die Eigenschaften ImageMemory.getWidth() und ImageMemory.getHeight() abgefragt werden.

Im Gegensatz zum Omega ist die Verwendung der nichtflüchtigen Speicher beim Alpha zur Optimierung des Programmablaufs in der WinUSB-Betriebsart nicht nötig, weil die Bildübertragung sehr schnell ist. Das hängt aber immer vom Einzelfall und sollte individuell vom Entwickler entschieden werden.

Modell Delta

Das Modell Delta besitzt 32 nichtflüchtige Bildspeicher, die für das Standby-Bild, die Diaschau und Optimierungen des Programmablaufs verwendet werden können. Die Bildspeicher, die für das Standby-Bild oder die Diaschau verwendet werden, sind schreibgeschützt und können nur durch das Deaktivieren des Standby-Bildes oder der Diaschau wieder freigegeben werden.

Die 32 nichtflüchtigen Speicher haben die gleiche Größe wie der Bildschirm (1280x800 Pixel).

Soll ein nichtflüchtiger Bildspeicher verwendet werden, muss dieser zunächst reserviert werden. Dies geschieht durch Aufruf der Methode ImageMemory.requestPermanentStore(). Die Größe eines Speichers kann über die Eigenschaften ImageMemory.getWidth() und ImageMemory.getHeight() abgefragt werden.

Im Gegensatz zum Omega ist die Verwendung der nichtflüchtigen Speicher beim Delta zur Optimierung des Programmablaufs in der WinUSB-Betriebsart nicht nötig, weil die Bildübertragung sehr schnell ist. Das hängt aber immer vom Einzelfall und sollte individuell vom Entwickler entschieden werden.

Pen Display

Ein Pen Display hat keine nichtflüchtigen Bildspeicher.

Kopieren zwischen Bildspeichern

Zwischen den meisten verfügbaren Bildspeichern kann der Inhalt kopiert werden. Der Inhalt des Hintergrundpuffers kann nicht in den Vordergrundpuffer kopiert, sondern nur verschoben werden. Der Inhalt des Overlay-Puffers kann nicht kopiert, sondern nur über den Bildschirminhalt übergeblendet werden.

Typische Kopiervorgänge sind das Kopieren aus einem nichtflüchtigen Bildspeicher in einen flüchtigen Bildspeicher und das Kopieren aus dem flüchtigen Hintergrundpuffer in den Vordergrundpuffer. Das Kopieren eines Bildspeichers innerhalb des Gerätes ist immer schneller als das Senden dieses Bildes vom PC zum Gerät. Details zum Kopieren entnehmen Sie bitte der Beschreibung der Methoden SigPadApi.setImageFromStore() und SigPadApi.setOverlayArea().

Der typische Ablauf

Die meisten Anwendungen verwenden für den Unterschriftvorgang immer die gleichen Bilder mit evtl. variablen Anteilen (z. B. dokumentenbezogene Texte). Daher ist es sinnvoll, Bilder, die bei jedem Ablauf gleich sind, nach Möglichkeit in einem der nichtflüchtigen Bildspeicher abzulegen. Nachfolgend der typische Ablauf für dieses Szenario:

Zunächst werden die Bilder geladen, die dauerhaft im Gerät gespeichert werden sollen, da sie sich selten verändern. Dafür wird die statische Methode ImageMemory.requestPermanentStore() verwendet. Die Methode gibt eine Referenz auf einen nichtflüchtigen Bildspeicher zurück, die dann verwendet werden kann, um Bilder oder Texte diesem Speicher hinzuzufügen. Steht kein nichtflüchtiger Bildspeicher zur Verfügung, gibt die Methode eine Referenz auf einen flüchtigen Speicher zurück, die verwendet werden kann, um Bilder oder Texte dem Hintergrundspeicher hinzuzufügen.

Um immer das ggf. aus mehreren Texten und Bildern zusammengesetzte Bild mit dem bereits im Gerät gespeicherten Bild vergleichen zu können, werden die Texte und die Bilder, die einem nichtflüchtigen Speicher hinzugefügt werden, zunächst nur lokal gespeichert und erst beim Aufruf von SigPadApi.setImageFromStore() oder SigPadApi.configSlideShow() tatsächlich an das Gerät gesendet. Erst beim Aufruf einer dieser Methoden kommt es damit ggf. zu einer merklichen Verzögerung.

Java
ImageMemory store = ImageMemory.requestPermanentStore();
padApi.setImage(10, 10, img1, store);
padApi.setText(220, 160, SigPadAlign.LEFT, "Signature:", store);
padApi.setImage(220, 400, img2, store);

Die Inhalte können nun in einen der flüchtigen Bildspeicher kopiert werden, i. d. R. sollte das der Hintergrundpuffer sein. Sollten die Bilder bereits in den Hintergrundpuffer geschrieben worden sein, weil kein nichtflüchtiger Speicher zur Verfügung stand (s. o.), hat folgende Methode keinerlei Funktion, produziert aber auch keinen Fehler, kann also gefahrlos aufgerufen werden.

Java
ImageMemory backBuffer = ImageMemory.requestBackgroundBuffer();
padApi.setImageFromStore(dest1, backBuffer);

Nun können dem Hintergrundpuffer Inhalte hinzugefügt werden, die sich bei jedem Unterschriftenvorgang verändern.

Java
padApi.setImage(120, 400, img3, backBuffer);
padApi.setText(220, 180, SigPadAlign.LEFT, "01.01.2010", backBuffer);

Im Hintergrundpuffer befindet sich jetzt eine Collage aus zwei Bildern und einem Text, die aus einem nichtflüchtigen Bildspeicher kopiert worden sind, und einem Bild und einem Text, die vom PC gesendet worden sind. Diese Collage kann jetzt in den Vordergrundpuffer kopiert und somit auf dem Bildschirm angezeigt werden. Der gesamte Bildaufbau vorher ist im Hintergrund geschehen und somit „unsichtbar“.

Java
padApi.setImageFromStore(backBuffer);

Der beschriebene Ablauf muss nach jedem Öffnen einer Verbindung erneut durchgeführt werden. Beim Schließen einer Verbindung gehen alle Informationen über reservierte Speicher verloren. Nur die Information, welcher Bildinhalt in welchem nichtflüchtigen Speicher enthalten ist, bleibt im Gerät erhalten (auch wenn es stromlos gesetzt wird).