User`s manual
11. Appendix A - Hydra Open Protocol
Barco – iStudio – R5976569 – user's manual – revision 09 – March-2007
__________________________________________________________________________________
11-44
11.4 Events
11.4.1 Definition
Events are messages that provide information about state changes on the HYDRA. They can come in at any time.
By default all events are turned off. This means that you need to activate the events that you are interested in.
You can also deactivate events once they are no longer useful. It is possible to open more than one event con-
nection at the same time, and to specify for each connection specific events.
Enabling events can be done with a packet that looks like this:
<XML>
<PACKET MODULE="HYDRA" VERSION="1.0">
<EVENT ID="eventname" SERIAL="example">
<ENABLE>
...
</ENABLE>
<DISABLE>
...
</DISABLE>
</EVENT>
</PACKET>
</XML>
You will receive a confirmation, which contains the serial and an error flag that indicates if your changes have
been accepted:
<XML>
<PACKET MODULE="HYDRA" VERSION="1.0">
<EVENTRESULT SERIAL="example" ERROR="0">
</EVENTRESULT>
</PACKET>
</XML>
When an event is enabled and generated, you will receive a packet like this:
<XML>
<PACKET MODULE="HYDRA" VERSION="1.0">
<EVENT ID="eventname" ...>
...
</EVENT>
</PACKET>
</XML>
11.4.2 Events – OverView
All available events of the open XML protocol are listed in the table below in alphabetic order together with a
short description. The related syntax can be found in the next section.
Event Description
alarmchanged an alarm of a source has changed
filechanged a file has been saved or deleted
freezechanged the freeze-state of a source has changed
modulechanged a module setup has been changed
layoutchanged the layout for a module has been updated
sourcechanged a source setup has been changed
tallychanged the tally state of a source has changed
wallchanged the configuration of the wall has changed
Table 11-2
Overview of events