Historie
Die auf dieser Seite erklärten Attribute und Funktionen sind in der Kategorie History zu finden.
Das Image Watch-Control bietet die Möglichkeit, eine festgelegte Anzahl von empfangenen Bildern temporär zu speichern. Um die History Funktionen verwenden und diese Bilder auswählen und anzeigen zu können, muss die Eigenschaft ImageFreeze als Vorrausetzung aktiviert werden.
Eigenschaft: QueueSize
Die Eigenschaft QueueSize legt fest, wie viele der zuletzt empfangenen Bilder gespeichert werden sollen und dementsprechend auch, wie groß die History-Queue ist. Mit 0 kann die Bild-History Funktionalität deaktiviert werden. Wenn die Queue voll ist und ein weiteres Bild empfangen wird, wird nach dem FIFO-Prinzip (First In First Out) das älteste Bild gelöscht. Um auf die History zugreifen zu können, muss ImageFreeze aktiviert sein. Dann kann per QueueIndex bestimmt werden, welches Bild angezeigt werden soll. Der Eintrag 0 entspricht immer dem neusten Bild, welches in der Queue ganz oben liegt und zuletzt empfangen wurde.
Eigenschaft: ImageTimestamp (read only)
Über die Eigenschaft ImageTimestamp kann der Zeitstempel des aktuell ausgewählten History-Bildes im Millisekunden-Format ausgelesen werden. Um diesen z.B. zur Anzeige weiterzuverarbeiten, bietet sich die Klasse Date von JavaScript an, wie folgendes Beispiel zeigt:
new Date(/**TimestampSymbol**/).toLocaleString()
// output: "4/8/2025, 1:45:13 PM"Funktion: clearHistory
Die Funktion clearHistory löscht die gesamte History-Queue.
Temporäre Datenhaltung
Die Bilddaten der History-Queue werden temporär gespeichert und beim Freigeben der jeweiligen ImageWatch-Control Instanz gelöscht. Dies passiert z.B. beim Verlassen einer Seite oder bei einem Wechsel eines Contents.
Performance
Bei der Konfiguration der QueueSize sollte vor allem auf die Bildgröße geachtet werden. Diese ist von der Bildauflösung, der Anzahl der Kanäle und dem Übertragungsformat abhängig. Die konvertierte Bildgröße kann den Statistiken in der Server-Erweiterung entnommen werden. Beim Übertragungsformat BMP liegen die Bilddaten unkomprimiert vor, was zu einer größeren Datenmenge führt. In Verbindung mit einer größeren QueueSize kann dies zu „OutOfMemory Exceptions“ vom Browser führen. Daher empfehlen wir zum Einen die QueueSize nicht zu groß zu wählen und zum Anderen die komprimierten Übertragungsformate JPEG oder PNG zu verwenden.