Video EWO

Das Video EWO dient der Anzeige von Video-Streams. Außer der Videoanzeige besitzt das Video EWO keine weiteren Bedienelemente. Das dargestellte Video wird auf die aktuelle Größe des Video EWOs skaliert. Wenn kein Video angezeigt wird, wird ein schwarzer Hintergrund angezeigt.

Methoden

Das EWO unterstützt folgende Methoden:

clear(int dialogIdx)

Löscht den Stream auf dem übergebenen Dialog. Bei dialogIdx=0 werden alle Streams auf allen Dialogen

gelöscht.

this.clear(1);

löscht das aufgeschaltete Bild auf Dialog 1.

clearAll()

Löscht alle aufgeschalteten Streams.

this.clearAll();

setGrid(int dialogCnt, bool clearUnusedDialogs)

Ändert den aktuellen Grid. Gültige Grid Counts sind <1, 4, 6, 12, 24>. Über das Flag clearUnusedDialogs können nicht sichtbare Dialoge gelöscht werden.

this.setGrid(4, 1);

Schaltet den Grid auf 4 (4 Einzelbilder)

void setGridLayout(string layoutName)

Aktiviert den gewünschten Grid über den dazugehörigen Namen.

unsigned getGrid()

Ermittelt den aktuell eingestellten Grid

unsigned actGrid = this.getGrid();

setPlaybackPosition(string newPosition)

Setzt den aktuellen Timeline-Zeitpunkt im Playbackmodus.

setPlayBreaks(bool playBreaks)

Gibt an ob Pausen im Playback in Echtzeit abgespielt oder übersprungen werden sollen.

unsigned getGrid()

Ermittelt den aktuell eingestellten Grid

showLive(string currentStreamInfo, int dialogIdx, [bool bUseOverrideColor=false])

Schaltet den Live Video Stream auf dem übergebenen Dialog auf.

this.showLive(Camera_00001@server1:9375, 2);

Schaltet Kamera 1 auf Dialog 2. Die verfügbaren Streaminginformationen (currentStreamInfo) einer Kamera können über die Funktion VIDEO_OA_getStreamInfo() ermittelt werden. Hierbei muss das erste Element des erhaltenen dyn_strings der VIDEO_OA_getStreamInfo() Funktion an die Funktion showLive übergeben werden. Wird der optionale Parameter bUseOverrideColor mit dem Wert True übergeben, färbt sich der Dialog in der Sequenzerfarbe. Der Parameter wird bei der Aufschaltung von Sequenzen verwendet.

showPlayback(string PlaybackInfo, int dialogIdx);

Schaltet die angegebene Aufnahme auf dem angegebenen Dialog auf. Die verfügbaren Playbackinformationen einer Kamera können über die Funktion VIDEO_OA_getStreamInfo() ermittelt werden. Auch hier muss wieder das erste Element des erhaltenen dyn_strings an die Funktion showPlayback() übergeben werden.

playbackChangeSpeed(int speed)

Ändert die aktuelle Playbackgeschwindigkeit eines laufenden Playbacks.

playbackPause()

Pausiert einen laufenden Playback.

playbackPlay(int speed)

Startet einen Playback mit der angegebenen Geschwindigkeit. Die Geschwindigkeit wird in % der Normalgeschwindigkeit angegeben (z.B. 100 = einfache Geschwindigkeit vorwärts, -200 = doppelte Geschwindigkeit rückwärts).

playbackStepBackward()

Springt ein Bild rückwärts.

playbackStepForward()

Springt ein Bild vorwärts

selectDialogIdx(dialogIdx)

Schaltet den Selektionsrahmen auf den übergebenen Dialog

setIpcEncryptionEnabled(bool enabled)

Aktiviert bzw. deaktiviert die IPC Socket Verschlüsselung für das EWO.

Properties

Das EWO unterstützt folgende Properties:

setLineWidth(uint newWidth)

Breite des Rahmens in Pixel eines Bildes im EWO. Der Wert ist für alle Bilder gleich. Der Defaultwert beträgt 3 Pixel.

this.lineWidth(5);

setzt den Wert auf 5 Pixel

uint getLineWidth()

Liefert Breite des Rahmens in Pixel eines Bildes im EWO. Der Wert ist für alle Bilder gleich. Der Defaultwert beträgt 3 Pixel.

int width = this.getlineWidth(5);

Erfragt die Breite des Rahmens

setTitleText(int dialogIdx, string text)

Setzt den Streaming-Titel eines Bildes. Beim Aufschalten wird hier zunächst der Datenpunktname gesetzt.

this.setTitleText(1, “Hallo”);

Setzt den Streaming-Titel auf “Hallo”.

string getTitleText(int dialogIdx)

Liefert den Streaming-Titel eines Bildes.

string text = this.getTitleText(1);

Liefert den Streaming-Titel von Bild 1

setOverlayText(int dialogIdx, string text)

setzt den Overlaytext auf einem aufgeschalteten Video.

this.setOverlayText(1, “Hallo”);

Schreibt den Text "Hallo" auf das aufgeschaltete Video in Bild 1

setScalingMode(int mode)

Setzt den Scaling Mode aller VideoDialoge im EWO;

Gültige Werte für den Parameter mode sind

  • 0 = FitToSize (Bild wird mit Verzerrung an das EWO angepasst)
  • 1 = KeepAspectRatio (Defaultwert: Bild wird ohne Verzerrung im EWO angezeigt)
  • 2 = ZoomToFill (Bild behält das Seitenverhältnis bei und wird auf die Größe des EWOs gezoomt)
this.setScalingMode(1);

setDebugFlags (uint flags)

Setzt die DebugFlags. Die gesetzten Flags wirken sich global auf alle EWO-Instanzen im gleichen PVSSProzeß aus. Die folgenden Flags stehen zur Verfügung (Default ist 0x2) und können bitweise kombiniert werden:

  • DF_WARNING_MSG = 0x2: Aktiviert die Ausgabe von Warnmeldungen nach stderr.
  • DF_DEBUG_MSG = 0x4: Aktiviert die Ausgabe von Debugmeldungen nach stdout.
setDebugFlags(6)

Setzt beide Debug-Flags.

uint getDebugFlags()

Hiermit können die aktuellen Debug-Flags abgefragt werden.

unsigned flags = getDebugFlags();

string getCurrentStreamInfo(int dialogIdx)

Ermittelt die aktuelle Streaminformation eines Dialogs.

setPlaybackZoomRange(string startPosition, string endPosition)

Mit diesem Aufruf wird für ein Playback verfügbarer Zoombereich eingestellt.

setDialogBackgroundColor(string backColor)

Setzt die Hintergrundfarbe der Dialoge.

setDialogSelectedBackgroundColor(string backColor)

Setzt die Hintergrundfarbe des ausgewählten Dialogs.

setDialogFrameColor(string frameColor)

Setzt die Rahmenfarbe der Dialoge.

setDialogSelectedFrameColor(string frameColor)

Setzt die Rahmenfarbe des ausgewählten Dialogs.

setDialogBackgroundImage(string filePath)

Legt ein Hintergrundbild für die Dialoge fest.

setDialogStatusLineVisible(bool bVisible)

Legt fest ob die Statusleiste der Videodialoge angezeigt wird.

setDialogBackgroundColor("red");
setDialogSelectedBackgroundColor("green");
setDialogFrameColor("blue");
setDialogSelectedFrameColor("#FFD700");
setDialogBackgroundImage("D:/pictures/background.png");

scaleMode()

Setzt den Scaling Mode aller VideoDialoge im EWO;

  • 0 = FitToSize (Bild wird mit Verzerrung an das EWO angepasst)
  • 1 = KeepAspectRatio (Defaultwert: Bild wird ohne Verzerrung im EWO angezeigt)
  • 2 = ZoomToFill (Bild behält das Seitenverhältnis bei und wird auf die Größe des EWOs gezoomt)

transportOption()

Definiert die Übertragungsart von Video-Streams.

  • 0 = UDP Unicast vom Interface
  • 1 = UDP Multicast vom Interface
  • 2 = TCP Unicast vom Interface
  • 5 = Multicast von der Quelle

playBreaks()

Definiert, ob Pausen im Playback in Echtzeit abgespielt oder übersprungen werden sollen.

errorTexts()

Overlaytext der im Fall eines Fehlers angezeigt wird.

dialogBackgroundColor()

Definiert die Hintergrundfarbe der Dialoge.

dialogFrameColor()

Definiert die Rahmenfarbe der Dialoge.

dialogSelectedBackgroundColor()

Definiert die Hintergrundfarbe des ausgewählten Dialogs.

dialogSelectedFrameColor()

Definiert die Rahmenfarbe des ausgewählten Dialogs.

dialogStatusLineVisible()

Definiert ob die Statuszeile des Dialogs angezeigt werden soll.

encryptIpcSockets()

Aktiviert bzw. deaktiviert die IPC Socket Verschlüsselung für das EWO.

Events

Folgende Events werden unterstützt:

onContentChanged (int dialogIdx, int mode, string streamId, string interfaceInfo)

Wird ausgelöst, wenn sich der Inhalt eines Videodialoges ändert.

  • dialogIdx = Nummer des Dialoges dessen Inhalt sich geändert hat.
  • imode = Wiedergabemodus (derzeit nur Livestreams).
  • streamId = Streaminformationen des neuen Inhalts.

onGridChanged (int dialogCnt)

Wird ausgelöst, wenn das Grid des EWOs geändert wurde.

onDrop (string droppedText, int dragType, int dialogIdx)

Wird ausgelöst, wenn ein (Text-)Objekt per Drag und Drop über dem EWO fallen gelassen wird und übergibt die Nummer des Displays in welches geklickt wurde.

onClicked(int dialogIdx)

Wird ausgelöst, wenn mit der linken Maustaste in das EWO geklickt wird und übergibt die Nummer des Displays in welches geklickt wurde.

onRightClicked(int dialogIdx)

Wird ausgelöst, wenn mit der rechten Maustaste in das EWO geklickt wird und übergibt die Nummer des Displays in welches geklickt wurde.

onStreamStateChanged(int dialogIdx, uint mode, uint state)

Wird ausgelöst, wenn sich der Status des aktuellen Streams ändert.

Mögliche Werte für mode:

  • MODE_NONE = 0x00
  • MODE_LIVE = 0x01
  • MODE_PLAYBACK = 0x10
  • MODE_SEQUENCE = 0x20

Mögliche Werte für state:

  • CONST_ERROR_BASE = 0x1000;
  • STATE_STOPPED = 0x00
  • STATE_STREAMING = 0x01
  • STATE_ERROR = CONST_ERROR_BASE+0x01,
  • STATE_ERROR_UNKNOWN_CHANNEL = CONST_ERROR_BASE+0x02,

onTimelineUpdateEvent(string timelineStartTS, string timelineEndTS, string currentPosTS)

Wird ausgelöst wenn sich die Timelineinformationen ändern.

  • timelineStartTS = frühester Zeitpunkt einer Aufzeichnung für die aufgeschalteten Kameras
  • timelineEndTS = letzter Zeitpunkt einer Aufzeichnung für die aufgeschalteten Kameras
  • currentPosTS = aktueller Zeitpunkt der Timeline