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.
BEISPIEL
this.clear(1);
löscht das aufgeschaltete Bild auf Dialog 1.
clearAll()
Löscht alle aufgeschalteten Streams.
BEISPIEL
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.
BEISPIEL
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
BEISPIEL
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.
BEISPIEL
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.
BEISPIEL
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.
BEISPIEL
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.
BEISPIEL
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.
BEISPIEL
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)
BEISPIEL
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.
BEISPIEL
setDebugFlags(6)
Setzt beide Debug-Flags.
uint getDebugFlags()
Hiermit können die aktuellen Debug-Flags abgefragt werden.
BEISPIEL
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.
BEISPIEL
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
