User`s manual

11. Appendix A - Hydra Open Protocol
Barco – iStudio – R5976569 – user's manual – revision 09 – March-2007
__________________________________________________________________________________
11-42
11.3.10 Tally related commands
To administrate tally related information the following commands are available:
Adjust tally
This command applies to software tallies only.
It serves to set the state or color of a software tally. State as well as color information can be transmitted with
the command at the same time. But whether the one or the other is applied, depends on the state of the state
entry of a tally object (section
11.3.4 File content) and the state checkbox on the Properties tab of a tally object
(section
5.6.4 Edit object…) respectively. If that state entry is true, then the tally state information will be adapted;
if that state entry is false, then the color of the tally will be adjusted accordingly.
Information, which was sent while it could not be applied due to the state of the state entry, will be applied as
soon as that state entry changes.
Send
<COMMAND ID="adjusttally" SERIAL="example">
<MODULE ID="module1">
<TALLY ID="0"><STATE>1</STATE></TALLY>
<TALLY ID="80"><STATE>0</STATE></TALLY>
<TALLY ID="120"><COLOR>green</COLOR></TALLY>
<TALLY ID="200">
<STATE>1</STATE>
<COLOR>red</COLOR>
</TALLY>
</MODULE>
</COMMAND>
For each object specify: module name, tally number (0-255), state (0, 1) / color (color name
from rgb.cfg file)
Receive
<COMMANDRESULT SERIAL="example" ERROR="0">
</COMMANDRESULT>
Set source tally on object
Set the tally state of a hardware output tally or a software tally of the video object with the indicated name
(object ID).
Send
<COMMAND ID="setsourcetallyonobject" SERIAL="example">
<MODULE ID="module1">
<OBJECT ID="myobjectname">
<TALLY id="0">
<STATE>0</STATE>
</TALLY>
</OBJECT>
</MODULE>
</COMMAND>
For each object specify: module name, object name, tally number (0-2), tally state (0, 1 [, 2, 3])
Receive
<COMMANDRESULT SERIAL="example" ERROR="0">
</COMMANDRESULT>
Setsourcetallyonobject offers two additional tally states, which can only be set with this XML
command (not available via the iS
TUDIO GUI).
These two additional states are only applicable for source tallies in software mode!
The two additional tally states can only be viewed, if the tally is displayed in a UMD! In a tally ob-
ject they do not become visible. In a tally object the tally states 2 and 3 look the same as the tally
state 1.
Corresponding to the two additional states the colors tally1state2, tally1state3 for tally 1 and
tally2state2, tally2state3 for tally 2 are available with the system colors.