User’s manual iStudio
R5976569, current version Title: ID-no.: Revision: Date: iSTUDIO – user’s manual R5976569 09 March-2007 main issue chapter 1 chapter 2 chapter 3 chapter 4 chapter 5 chapter 6 chapter 7 chapter 8 chapter 9 chapter 10 chapter 11 chapter 12 chapter 13 new: corr.: add.: update add. The corresponding chapters are new or completely revised. Passages of the corresponding chapter were corrected; see modification bars. Passages of the corresponding chapter were added; see modification bars.
Trademarks Brand and product names mentioned in this manual may be trademarks, registered trademarks or copyrights of their respective holders. All brand and product names mentioned in this manual serve as comments or examples and are not to be understood as advertising for the products or their manufacturers.
Revision sheet To: • Barco Control Rooms GmbH An der Rossweid 5, D-76229 Karlsruhe Phone: +49-721-6201-0, Fax: +49-721-6201-298 E-mail: docu.de.bcd@barco.com, Web: www.barcocontrolrooms.
Contents 1 Introduction......................................................................................................................................... 1-1 1.1 How this manual is organized .....................................................................................................................1-2 1.2 Styles and symbols.......................................................................................................................................1-3 1.3 Online manual ..............
5.2.1 Wall Layout ..........................................................................................................................................5-5 5.2.2 Wall alarms area..................................................................................................................................5-7 5.2.3 Wall scenario........................................................................................................................................5-8 5.2.4 Wall script....................
5.7.8 Standard grid configurations.............................................................................................................5-92 5.7.9 Increasing and decreasing the grid ..................................................................................................5-93 5.8 Language ....................................................................................................................................................5-94 5.9 Release information ..............................
11.1.2 Packets .............................................................................................................................................11-3 11.1.3 Error notification ..............................................................................................................................11-4 11.2 Connections ..............................................................................................................................................11-5 11.2.1 Transactions ..........
1. Introduction 1 Introduction This chapter explains the structure of the manual itself and the used typographic styles and symbols.
1. Introduction 1.1 How this manual is organized This manual describes the functionality of the iSTUDIO software that serves to operate HYDRA, HYDRA COMPACT and HYDRA COMPACT TWIN controllers from Barco. (In the following only the term HYDRA will be used, which herewith implies HYDRA, HYDRA COMPACT and HYDRA COMPACT TWIN, as the operation of iSTUDIO does not differ for these devices. If a differentiation is necessary both devices will be mentioned explicitly.
1. Introduction 1.2 Styles and symbols The typographic styles and the symbols used in this document have the following meaning: Bold Labels, menus and buttons are printed in Bold font. Condensed Links to both other chapters of this manual and to sites in the Internet are printed condensed. In the on-line version of this manual all hyperlinks appear teal. Courier Names of files and parts from programs are printed in the Courier font.
1. Introduction 1.3 Online manual On the iSTUDIO documentation CD R5976593 this manual R5976569 as well as the HYDRA user’s manuals can be found in electronically form. Insert the CD in the CD ROM drive to view the manual. If autorun is enabled on the computer the start page of the CD comes up automatically. Else open the start page index.html of the CD manually. On this start page you will find a link to the user’s manual of iStudio. Acrobat Reader can be used to view the file.
2. Summary 2 Summary This chapter gives an overview about the features of iSTUDIO.
2. Summary 2.1 Properties iSTUDIO is a complete video, audio and data monitoring system. It typically consists of one or more HYDRA controllers, a visualization system (usually a rear projection Display Wall) and the iSTUDIO software. The HYDRA is controlled via a PC with a standard up to date web browser. The PC is connected to the HYDRA via the LAN.
2. Summary Hydra HYDRA is the hardware part of the iSTUDIO system. Different video signals (analog, SDI or HD-SDI, streaming video), RGB data as well as audio sources (analog, digital, embedded or streamed audio meters) can be connected to a HYDRA module.
3. Getting started 3 Getting started This chapter describes in short the hardware that enables the operation of the iSTUDIO software. It contains instructions to install and configure the system. It also introduces the usage of multiple HYDRAS.
3. Getting started 3.1 Hardware devices iSTUDIO runs on a HYDRA controller and is controlled via the operator PC. 3.1.1 Hydra The HYDRA controller boots from CD ROM. When connecting to the HYDRA from a PC within the same LAN, the select mode page of iSTUDIO opens and allows the user to log in on the HYDRA and to operate the system. 3.1.2 Operator PC The operator PC is used to connect to the HYDRA and by this to the iSTUDIO software.
3. Getting started 3.2 Switching on and off This section describes how one or more HYDRAS are switched on or off. In addition if a HYDRA is switched on for the first time the network settings must be configured, please refer to section 3.2.3 Adjusting a Hydra to the LAN. 3.2.1 Connecting from a user PC to the Hydra Switch on the HYDRA as explained in the HYDRA user’s manual. Take care that the iSTUDIO CD-ROM is inserted in the CD-ROM drive.
3. Getting started Once connected to the HYDRA, the initial select mode screen of iSTUDIO will appear in the browser. Figure 3-3 iSTUDIO select mode Click the Admin button or the User button in the upper right corner to log in, depending on your privileges and intention. After this a dialog appears that asks, if you want to trust the signed Barco Java applet. This applet is only required for the functioning of the show viewer command, please refer to section 5.6.9 Show viewer.
3. Getting started Now the Login window is displayed. Figure 3-5 Login window Into the Password box insert the required password and click Login or press the Enter key. Now the iSTUDIO software can be used. The factory set passwords are: Administrator: admin User: user Table 3-2 Factory set passwords Switching on multiple Hydras Switch on all HYDRAS with the power button at the front of the HYDRA. Start the iSTUDIO software by connecting to one of the HYDRAS with the web-browser, as explained above.
3. Getting started 3.2.3 Adjusting a Hydra to the LAN Before the HYDRA is connected to your LAN, its network settings have to be adapted accordingly. If the HYDRA is already configured to your location you can skip this section. For the configuration you need a crossed network cable to connect a PC to the HYDRA. Please follow the steps below. • First consult your network administrator to get a valid IP address and hostname. • Disconnect your PC from the LAN.
3. Getting started • Reboot the HYDRA to make the changes become effective. This can be done by the command reboot module from the Module menu, please refer to section 5.3.2 Module control. • Disconnect the crossed network cable from the HYDRA and connect the HYDRA to your companies LAN. • Readjust the network settings of your PC. If you have to adjust multiple HYDRAS configure them one after the other in the way explained above.
4. Basics 4 Basics This chapter explains the principles of the iSTUDIO GUI and gives a short introduction in the use of iSTUDIO. An extensive reference to the iSTUDIO software can be found in the chapters 5 Menu and toolbar and 6 Further GUI elements.
4. Basics 4.1 Quick guide to iStudio This section gives an introduction in the use of iSTUDIO. It explains the user interface and provides a guide to create a first layout and display it on the connected projection module. It is not meant to be complete. Only the most common actions are explained to give an idea how iSTUDIO can be used. An extensive reference to the iSTUDIO software can be found in the next two chapters. They will answer remaining questions. 4.1.
4. Basics Shortcut menu With a right click into the work area or on module-, wall layout- or layout-items in the tree a shortcut menu [5] appears. It offers quick access the most important commands in this context. In the work area this is to switch layouts and to edit the selected object and the source assigned to it. Functionality which is made available with it is explained in the sections 5.3 Modules and source und 5.6 Object.
4. Basics Dialog boxes Dialog boxes are used to show information and to allow users to input or change data and settings. Two types of dialog boxes can be opened: • Normal Dialog boxes to control and insert data The iSTUDIO GUI is grayed while such a dialog box is opened and can not be accessed unless the dialog box gets closed. The messagebar displays the title of the dialog box • Dialog boxes to start a wall scenario or a wall script The dialog box runs as an individual application.
4. Basics 4.1.2 Creating objects Objects play a central role in iSTUDIO. They are visual containers that can display various types of information. Creating objects . The new object will be disCreate a new object on the work area by pressing the new object button played in the upper left corner of the work area and will not have specific properties. Clicking the new object button multiple times creates multiple new objects. They are stacked one on the other in the upper left corner.
4. Basics 4.1.3 Defining the object properties Double click on an object to open the Edit object dialog box. Within this dialog box all properties of this object can be set. Most important is to specify on the first tab the type of the object. Video, Audio, Text, UMD, Tally, Logo, Clock, Timer, Stopwatch, Alarm, Viewer or Application can be selected. The type dependant properties must be set on the Properties tab. Here you can select the video source, if you have an object of type video.
4. Basics 4.1.4 Group functionality To ease editing, objects can be grouped to a selection, see section 5.5 Group (selection). This is achieved by switch. Now each object on the work area can be added to the group by ing on the group selection toggle button a double click on it. A selection allows moving all objects by just moving one of its objects (provided that fixed movement is off). Objects contained in the group are marked with a small square in the lower right corner.
4. Basics 4.1.7 Layouts A layout is a collection of objects with their associated properties. Layouts can be saved for later use. Please refer to section 5.4 Layout. • A layout can be saved with the blue save layout button • The available layouts are listed in the tree. Click on a layout name to load that layout on the work area. • With the new layout button • To display a layout on the projection module it first must be loaded. Then the . the work area is cleared and a new layout can be started.
4. Basics 4.2 Additional video related input The HYDRA and iSTUDIO is able to detect and display video related information such as closed caption (CC), teletext (TT), extended data structure (XDS), vertical interval time code (VITC), wide screen signaling (WSS) and video index information coding (VLI) and embedded audio. Furthermore GPIO’s can be processed and LTC can be used for genlock. Under monitor displays (UMD) can be displayed in video windows.
4. Basics 4.3 System performance optimization 4.3.1 Performance iSTUDIO is, just as any other product, susceptible to performance limitations imposed by the different technologies used. Practical experience has shown that iSTUDIO will perform well under almost all circumstances. Factors that have been recognized to influence system load to a high extend are the amount of API calls and the fonts that are used.
5. Menu and toolbar 5 Menu and toolbar The menu bar provides access to almost all the possible operations within iSTUDIO. Commands that are often used can also be accessed using the buttons on the tool bar. A small icon on the left of the menu entry on the respective command will indicate this. The most important commands are also accessible by means of shortcut keys.
5. Menu and toolbar 5.1 Overview of shortcut keys and toolbar buttons Access to almost all operations is provided by the menu; nevertheless, often used commands can also be accessed by the buttons of the toolbar or by the shortcut keys. The following table lists these buttons and the available shortcut keys, with a reference to the section where they are explained in detail. Button Shortcut key Description section undo 5.6.1 Undo and redo redo 5.6.
5. Menu and toolbar Edit Objects Ctrl+O Ctrl+E Ctrl+X Ctrl+C Ctrl+V Alt+V create a new object 5.6.2 New object and fill grid save the properties of the selected object edit the properties of the selected object copy the properties of the selected object and delete the object copy the properties of the selected object paste the copied properties in the selected object create a new object with the copied properties 5.6.
5. Menu and toolbar Selection (Group) Alt+G group selection active/not active 5.5.1 Enable group selection Alt+A select all objects 5.5.2 Selecting objects Alt+U deselect all objects 5.5.2 Selecting objects Alt+O select objects by means of the mouse load objects properties to all objects of the selection delete the selected objects 5.5.2 Selecting objects paste the properties from the copied or cut object to the selected objects move selected objects to the front 5.5.
5. Menu and toolbar 5.2 Wall By means of the Wall menu, the grid toolbar and the shortcut menus, which appear when clicking on the modules main entry and on the Wall layouts entries in the tree, the wall settings can be accomplished and general administration can be done. If multiple HYDRAS are used to control multiple projection modules all these HYDRA modules can be controlled by one iSTUDIO terminal.
5. Menu and toolbar A list with all modules appendant to the wall can be found in the Module column. The Load layout checkbox must be selected for each module where a layout shall be assigned. If the Load layout checkbox is not selected the respective module becomes not updated when a wall layout is loaded. In the Layout list finally an existing layout can be assigned to a module. After assigning the layouts as desired the wall layout can be saved, therefore click the Save button.
5. Menu and toolbar 5.2.2 Wall alarms area If you switch the wall alarm toggle button on, the work area is reduced and the wall alarms area is displayed below it. The wall alarms area displays a list with all alarms on all connected modules. Figure 5-4 Wall alarm list toggled on (left) and off (right) The list contains the state of an alarm, the module name, source name, alarmtype and start and stop date and time of the occurrence of the alarm.
5. Menu and toolbar 5.2.3 Wall scenario The Wall scenario command enables to display various wall layouts in a user-defined chronology. The Wall layouts list provides all wall layouts. With the Add button a selected wall layout can be added to the Scenario list. The Cut button removes a selected item from the Scenario list. The New button clears the whole Scenario list. The time each wall layout is displayed can be inserted in seconds into the Wait box.
5. Menu and toolbar 5.2.4 Wall script Wall scripts provide further functionality to control the display of HYDRA and the HYDRA itself. Wall scripts can be started with the Wall script dialog box. The same functionality as the scripting language provides the XML based open protocol of HYDRA, which is more convenient than the scripting language and will be supported in further releases of iSTUDIO. Notice that scripts will not be supported in future releases of iSTUDIO.
5. Menu and toolbar 5.2.5 Wall Control The following commands are applied to all HYDRA devices of the wall. Please refer to section 5.3.2 Module control for an instruction how to control a single HYDRA. Halt wall With the Halt wall command all HYDRAS belonging to the wall can be halted. A warning dialog appears. After confirming this dialog the shutdown screen is displayed while halting. When halted the display is just black and the HYDRAS can be switched off, please refer to the HYDRA user’s manual.
5. Menu and toolbar 5.2.6 User settings Setup password… The Setup password command opens the Setup password dialog box. By means of this dialog box the passwords of the administrator and of the user can be changed. This feature is only accessible for the Administrator. Figure 5-8 Setup password dialog box Setup user mode… With the Setup user mode dialog box the privileges of the user can be set and changed and the default language after program start in user mode can be chosen.
5.
5. Menu and toolbar 5.2.7 Time setup Each HYDRA module has an internal clock and thus for each HYDRA module the time can be set. Furthermore the HYDRA modules can be synchronized with each other via an NTP synchronization mechanism. Finally a time zone can be specified. With the Setup time dialog box these configurations can be set. It is opened with the command Setup time.
5. Menu and toolbar Time Setup – Wall – NTP Select NTP from the Sync mode list to synchronize the wall with external NTP servers via the NTP synchronization mechanism. Select in the Modules list all HYDRA modules that shall synchronize with one or multiple external NTP servers. Modules not selected in this list will internally synchronize to the externally synchronized modules, which result in the whole wall is synchronized. Under NTP server all IP addresses of the external NTP servers must be listed.
5. Menu and toolbar Changing the NTP server: • Change the NTP settings in the Setup time dialog. • EITHER switch of the previously configured NTP server. • THEN wait until the HYDRA modules loose there synchronization. (You see this when the NTP alarm of the modules becomes active) • THEN within about 5 minutes after the alarms appeared, apply the command Reset software (Wall), see section 5.2.5 Wall Control. • OR apply the command Reboot wall, see section 5.2.5 Wall Control.
5. Menu and toolbar Time Setup – Wall – LTCVITC Apart from NTP signals also an LTC (longitudinal time code) or VITC (vertical interval time code) signal can be used for the external synchronization of the time of the HYDRA wall. Select in the Modules list all HYDRA modules that shall synchronize with an LTC or VITC signal. Modules not selected in this list will internally synchronize via NTP to the externally synchronized modules, which result in the whole wall is synchronized.
5. Menu and toolbar Time Setup – Wall – manual configuration The manual configuration enables to set the time for the clocks of all HYDRA modules to the date and time specified in the text boxes of the Manual time configuration dialog. Pressing the Get button shows the current time and date of that HYDRA that is used for the connection to the operator PC. Instead of the Get command, data and time can be entered manually.
5. Menu and toolbar Time Setup – Module Selecting the Module mode enables to choose the time configuration for each module individually. This implies that the modules are not synchronized with each other. First select the HYDRA module you want to configure from the Module list. Then select the synchronization Mode. The same modes Manual, NTP, NTP Date and LTC/VITC like for the wall configuration can be used.
5. Menu and toolbar Timezone setup On the Timezone setup tab the time zone for the whole wall or for an individual module can be set. Therefore select either Wall to set one time zone for all HYDRA modules or select Module and chose the respective HYDRA module from the list. To specify your timezone, first the Timezone checkbox must be selected, then after clicking the ... button on the right, the Select a timezone dialog appears.
5. Menu and toolbar 5.2.8 Setup timings The Setup timing dialog allows to define timings or to change the settings of an existing timing. To use these timings please refer to section 5.3.4 Setup module (Screen tab). The timings list contains all stored timings. Click the Add button to add a new timing. In the Add timing dialog enter the name of the new timing. If you want to use an existing timing as template, select Copy from existing timing and choose the respective timing from the list.
5. Menu and toolbar 5.2.9 Setup hardware The setup hardware dialog serves to re-assign the known configuration of boards and sources after adding or removing boards from the HYDRA or after reordering them. After each startup the HYDRA checks, if the detected hardware has still the same parameters like before halting it. If it detects differences, it displays in the message bar the text “The hardware configuration has changed” together with the names of the concerned module to notify you from the changes.
5. Menu and toolbar 5.2.10 Setup audio... With the Setup audio dialog the transition levels for the individual audio scales can be set. The transition level defines the value at which the audio bar changes its color. Two transition levels exist per audio scale. To change a level, just select a different number from the respective dBfs list. With the Undo button the changes of the currently selected audio scale can be revoked. This can be done several times for different audio scales.
5. Menu and toolbar 5.2.11 Setup NGM-164… The NGM-164 encodes for up to 64 audio sources audio meters and audio alarms into one compound audio stream. If this stream is available on the network to that the HYDRA connects to, the HYDRA is able to decode the stream and provide the contained audio sources for monitoring. The Setup NGM-164 dialog provides access to the configuration of the NGM-164 and allows the configuration of the scales of the audio sources.
5. Menu and toolbar When clicking the Configure scales button the Configure scales dialog comes up. It serves to configure the used scales for the sources of the selected NGM-164 device. On the Configure scales dialog first click the Load configuration button. This starts a communication with the selected NGM-164. Messages about the communication state are displayed in the list at the bottom of the dialog.
5. Menu and toolbar 5.3 Modules and sources Properties of the projection modules and of encoders, streams and sources can be set by means of the commands in the Layout toolbar and of the Module menu or the shortcut menu. Figure 5-23 Layout toolbar, Module menu and shortcut menus If multiple HYDRAS are used it must be distinguished between them. This is done by means of the tree, please refer to section 6.2.1 Modules. Clicking on the respective HYDRA name in the tree switches to the respective HYDRA.
5. Menu and toolbar 5.3.1 Updating work- and display area Auto update If the command Auto update is selected the layout from the work area is updated to the projection modules reiteratively. This comprises the arrangement of objects and the object definitions. The iSTUDIO software checks if a conflict occurs (e.g. one source is used for two objects) and will display a warning in this case. Clicking OK will display the invalid layout anyhow. Clicking Cancel will prevent from updating.
5. Menu and toolbar 5.3.2 Module control The following commands are applied to the selected HYDRA. Please refer to section 5.2.5 Wall Control for an instruction how all HYDRA devices of a wall can be controlled. Halt module With the Halt module command the selected HYDRAS can be halted. A warning dialog appears. After confirming this dialog the shutdown screen is displayed while halting. When halted the display is just black and the HYDRA can be switched off.
5. Menu and toolbar 5.3.3 Module status The command Module status… displays a message window. You can select one of four kinds of status messages from the message list: Note, Warning, Error or Alarm. The clear button clears the window such that only new events will be displayed. With OK you close the window again. Each line displays a message starting with date and time, when it occurred, continuing with the concerned source or hardware part and finally listing the event.
5. Menu and toolbar 5.3.4 Setup module The command Setup module… opens the Module properties dialog. By means of this dialog the properties of the projection module and the HYDRA can be set. These are: • General settings (name, geometry, region, etc.
5. Menu and toolbar General tab Figure 5-25 Module properties dialog – General tab On the General tab the settings of the projection module must be inserted. Insert a unique module name in the Name field. The name of the wall must be typed into the Wallname field. Take care to insert for each HYDRA of the wall the same wall name. With the X and Y list the position of the projection module within that indicated wall must be specified. The X coordinate counts from left to right.
5. Menu and toolbar Screen tab On the Screen tab the format for internal data processing is set. These are usually also the output settings. Anyhow, depending on the output card, also differing output resolution and timing can be set. This is done on the Boards tab, please see below. Figure 5-26 Module properties dialog – Screen tab The Resolution list provides a collection of settings, either named after the device, or after resolution and timing itself.
5.
5.
5. Menu and toolbar If the physical aspect ratio of the display differs from the aspect ratio that is displayed on it this can be committed with the aspect ratio list.
5. Menu and toolbar Network tab On the Network tab the Hostname, the IP address and the Netmask must be inserted. The indication of the Gateway is optional. To send SNMP traps the IP address of a connected service must be specified in the SNMP box. To add an SNMP recipient press the Add button to open the Add SNMP Manager dialog. In this dialog enter the IP address, of the SNMP manager, where the SNMP traps should be sent to and click OK.
5. Menu and toolbar Boards tab On the Boards tab all slots of the HYDRA are listed including the inserted boards and their version. The number in square brackets indicates the slot, followed by the type of board, while v0, v1, ... stands for version 0, version 1 and so on.
5. Menu and toolbar Output boards In the Resolution list is by default the same setting indicated as in the Resolution list on the Screen tab. For DVI-DVI digital/analog output cards (output v8, output v9), DVI-DVI digital output cards with scaling (output v12) and DVI video output cards (output v4) the output resolution can be changed. Dual resolutions are not available in the resolution list. Settings on the Boards tab refer to individual outputs.
5. Menu and toolbar • If on the Screen tab a setting suitable for output at the BNC connector is selected, then this resolution is used for output at the BNC connector. On the Boards tab the setting for the DVI output is pre-selected in the Resolution list and cannot be changed. The SDI resync checkbox must be enabled. In addition the Genlock on first source checkbox on the Screen tab may not be selected.
5.
5. Menu and toolbar Startup tab On the Startup tab, the layout of the module during HYDRA startup can be chosen. As default a black screen with the IP address of the HYDRA and the version of iSTUDIO will be displayed. Alternatively to that, the layout that was displayed at the shutdown can be displayed or a layout from the layouts list can be chosen. Alarm tab In order to notify of a general HYDRA alarm one tally of a video source can be selected.
5.
5. Menu and toolbar Protocols tab On the Protocols tab the settings for the logical signal processing system Andromeda can be set. Andromeda is a protocol used to control the contents of UMDs (source name) and tallies. It is based on RS-232 serial communication. Therefore the serial port [1] on the single board computer on the HYDRA must be used and for Device on the Andromeda tab the entry ttyS0 must be selected. With the Baudrate list select the relevant value of the signal.
5. Menu and toolbar 5.3.5 Setup encoders With the command Setup encoders... the Setup encoders dialog is opened to configure the settings for each type of encoder, that provides a video stream, monitored by the HYDRA module. To define a new encoder type, enter its name into the Name field and click Add. The new encoder is displayed in the Encoders list and has default settings. To delete an already defined encoder select it with the mouse from the Encoders list and click Delete.
5. Menu and toolbar The following table lists the encoder specific values. They are valid with STREAMING VIDEO CARD with firmware 6.0. The values for TCP and Video PID must be entered not into the Setup encoders dialog but into the Setup Streams dialog, please refer to the next section. The compression algorithm must be entered in the Setup module dialog on the boards tab; please refer to section 5.3.4 Setup module.
5.
5. Menu and toolbar Encoder compression IP Skip at Skip at Stream manufacturer – type algorithm protocol start end type NiceVision – Recorder Pro mpeg4 RTP 0 0 auto TCP Video PID OFF 0 Only CIF resolution, only I and P frames are used. No successive Video Object Plane (VOP) start markers without data (used in recorded streams); Stream must be multicasted and always available on the network (no stream setup signaling required).
5. Menu and toolbar Encoder compression IP Skip at Skip at Stream manufacturer – type algorithm protocol start end type VideoLAN – VideoLAN (VLC/VLS) mpeg2 mpeg4 mjpeg see below: 0 0 auto TCP Video PID OFF 0 OFF 0 For IP protocol multicast, unicast, UDP or RTP is possible. Vorx – VON v1.0 mpeg2 mpeg4 UDP 0 0 auto Decoding of AES streams is not supported.
5. Menu and toolbar 5.3.6 Setup streams With the command Setup streams... the Setup streams dialog is opened. It serves to configure the settings needed to connect to the video streams monitored by the HYDRA. Like on the Setup encoders dialog with the Name field and the Add and Delete button, streams can be added and removed, please see the section above. To edit the settings of a stream, the stream must be selected in the Streams list; a purple bar then marks it.
5. Menu and toolbar 5.3.7 Setup source One possibility to open the Source properties dialog is to use the command Setup source… of the Module menu or the shortcut menu, if a video object on the work area is selected. The displaying properties and other related properties of the source of this object can be changed. The other possibility is to open the Module properties dialog, select the respective source on the source tab and press the properties button to edit the properties, please refer to section 5.3.
5. Menu and toolbar Setting Applies to Meaning Video cards: Automatic Chrominance Gain Control Crop settings Default Type Type selection Automatic gain control for chrominance values of the video signal switched on or off Opens the Crop settings dialog, to adjust the all cards visible part of the video; see below.
5. Menu and toolbar M – Video Tab streaming video via Streaming video board Brightness Contrast Sat HUE 0-255 0-255 0-255 0-360 R – RGB Tab RGB input card HStart HActiveWidth VStart VActiveWidth HTotal Phase Clamp position Clamp width Red gain Red offset Green gain Green offset Blue gain Blue offset 0-2047 0-2047 0-2047 0-2047 0-4095 0-31 0-255 0-255 0-255 0-127 0-255 0-127 0-255 0-127 Table 5-11 Settings of video and RGB sources On the Crop settings dialog the visible area of the video can be set.
5. Menu and toolbar Audio tab The Audio tab serves to select the audio sources, which can be displayed with up to 16 audio bars located on the left and right or the top side of an object. First the Audio mode has to be selected to define the type of the displayed audio sources, please see the table below. Audio mode Meaning Embedded External NGM-164 Available sources Embedded audio sources available via SDI and HD-SDI sources 16 audio sources per source. Numbering refers to the four group channels.
5. Menu and toolbar Furthermore two Phase bars, each showing the phase between two adjacent audio channels, can be displayed. Therefore the respective phase bar checkbox must be selected and the two audio channels must be chosen from the list. The phase bars are then displayed on top of the respective object. The phase bar is displayed as a gray bar with a scale from -1 to +1. Positive values are displayed as a green block ranging from 0 to the value.
5. Menu and toolbar Alarm tab On the Alarm tab the alarms can be configured. The meaning of the alarms and their value ranges are explained in section 7.1 Source related errors. Also a tally can be selected. To enable an alarm or a tally to be shown select the alarm or tally name in the select alarm list. Its name is then displayed red. Click the Enabled checkbox to activate it. The bullet in front of the alarm’s name becomes green instead of red.
5.
5. Menu and toolbar Alarm tab – Define intervals Intervals are used to specify times during which alarms shall be monitored. These time spans are listed in the Active at field. Also the lack of an alarm can be reported. These time spans are listed in the Active and inverted at field. Active and inverted serves to detect for example the presence of a video signal when there is no signal expected. The first line of the dialog is used to add a new interval.
5. Menu and toolbar • Start timer on tally A count-up timer is placed in the first UMD line next to the UMD text starting with 00:00:00, when the tally is set. When the tally is cleared the counter gets removed. This can for instance be used to show the time a program is running by setting the tally when the program starts and clearing it when it is done. In combination with Set tally on alarm this can be used to show how long an alarm is present.
5. Menu and toolbar VBI tab For sources of a Quad SDI video card or a Quad analog video card also the VBI tab is available. By means of this tab the line where vertical interval time code (VITC) is contained can be selected for PAL or NTSC sources. Copy tab The Copy tab serves to copy properties of the selected source to other sources. The active source is indicated in the title bar. Those sources that shall have the same properties can be selected from the Sources list on the right.
5. Menu and toolbar 5.4 Layout A layout contains the arrangement of the objects and their properties as well as a background. It comprises what is displayed on one projection module. A layout can be saved, edited and deleted. Furthermore its background can be defined. The related commands are in the Layout menu, in the Layout toolbar as well as in the layout shortcut menus. Figure 5-42 Layout toolbar, menu and shortcut menu 5.4.
5. Menu and toolbar Save layout… With the Save layout dialog a layout can be saved. In the Save layout dialog box type the template name into the Filename box and press OK. This command is also accessible via the button. Save layout as… A layout can also be saved under another name. With the command Save layout as… the dialog box can be opened. Type the layout name in the Filename box and press OK. Delete layout… With the Delete layout dialog box a layout can be deleted.
5. Menu and toolbar 5.5 Group (selection) In the Group menu you find the commands to select objects to a group as well as the operations which can be performed on an object selection. A selection is used as a temporary group to facilitate editing. A group selection is not saved in a layout. Objects can be selected and deselected. Object properties can be loaded to all objects of the group. The whole group can be deleted, stacked or hidden.
5. Menu and toolbar 5.5.2 Selecting objects Select all objects The command Select all objects selects all objects on the work area. To select all objects, use also the shortcut key Alt+A or the button. Unselect all objects The command Unselect all objects deselects all objects. To deselect all objects, use also the shortcut key Alt+U or the button. Select objects The command Select objects supports to select multiple objects by means of the mouse. It enables to span a rectangular array.
5. Menu and toolbar 5.5.3 Load, cut and paste object properties The following commands have mostly the same function as the respective commands for a single object. They help to assign object properties, but instead of assigning it to a single object they are assigned to all objects of the selection. All properties of an object except position, size and the source can be saved as template and reassigned. For comparison please refer to section 5.6.5 Cut, copy, paste and paste new object properties.
5. Menu and toolbar 5.5.4 Stacking order of objects Move objects to front The command Move objects to front stacks the selected objects to the topmost position. The stacking order within the selection remains. To stack the objects, alternatively use the button. Move objects to back The command Move objects to back stacks the selected objects to the undermost position. The stacking order within the selection remains. To stack the objects, alternatively use the button. 5.5.
5. Menu and toolbar In the figure above the blue video object is the most on the left. The red logo object and the black clock object are aligned to its upper side. The Y coordinates of the teal application object do not overlap with the other objects; therefore it is not aligned. Align vertically The command Align vertically aligns all objects of the selection whose X coordinates overlap. The upper sides of these objects will be aligned to the left side of the most top of these objects.
5. Menu and toolbar 5.6 Object Objects can be created (New object). They can be edited (Edit object…). This means various properties can be assigned like the type, border color, position, size etc. Most of these properties can be saved as an object template (Save object…) to the objects folder in the tree, a template can be assigned to another object (Load object…) or be deleted (Delete object…). Most actions done with an object can be revoked (Undo) and again restored (Redo).
5. Menu and toolbar 5.6.1 Undo and redo With the Undo last action button most of the actions done with an object can be revoked. Explicit exceptions are all kind of Save, Load and Delete actions. They can not be revoked. Pressing the redo button restores actions which were revoked before. 5.6.2 New object and fill grid New object The command New object creates a new object on the work area. The object is located in the upper left corner and has the size of one grid cell.
5. Menu and toolbar 5.6.3 Load, save or delete objects Load object… The properties of an object except position, size and the source can be saved and stored in templates. The saved object-properties templates are listed in the tree structure under the Objects entry. To assign one of the stored object templates to an object on the work area, the respective object must be selected.
5. Menu and toolbar 5.6.4 Edit object… The command Edit object opens the Edit object dialog box. To open the Edit object dialog box, use also the shortcut key Ctrl+E or the button (Edit object) The most convenient way to open the Edit object dialog box is a double click on the respective object on the work area. But this is only possible, if the group selection. button (group selection) is not enabled, see section 5.5.
5. Menu and toolbar With the Type list the type of the object can be determined. 13 different types are available. Depending on the type, the color of the filling changes. Also the properties tab differs depending on the type.
5. Menu and toolbar Border tab On the Border tab, the way the border of the object is displayed on the projection module can be determined. Figure 5-53 Edit object dialog box – Border The Separator slider determines the width of an invisible border that embraces the object for better visibility. The Width slider ranges form 1 to 20 pixels. In the Color list the available colors are listed. The Border can be displayed in plain style or in 3D style.
5. Menu and toolbar Parent tab On the Parent tab objects can be assigned to each other. One parent object can have multiple child objects. Some commands and operations are applied also on all child objects. These commands and operations are: • Movement of parent object on the work area • Changing the stacking of the parent object Figure 5-54 Edit object dialog box – Parent An object can only serve as parent, if it has a unique name, which is also different from the object type identification.
5. Menu and toolbar Properties tab The functionality of the Properties tab depends on the object type. Properties tab – Video A video object displays a video or RGB source. Additional information can be arranged over or beside the video. On the Properties tab there are again nine tabs arranged, to configure all this information.
5.
5.
5.
5. Menu and toolbar Properties tab – Audio An audio object is used to display the audio sources assigned to one video or RGB signal. The video/RGB signal itself is not shown. For an audio object there are two tabs available on the Properties tab. The table below lists the options on the tabs and their meaning: For audio sources of NGM-164 the scale type selected in this dialog has no influence on the scale used for data formatting but is only used as decoration.
5.
5. Menu and toolbar Properties tab – Text The text object is able to display up to 16 lines of text. By means of the Properties tab of the object up to four lines can be edited and displayed. If more than four lines shall be displayed, the XML open protocol can be used, please refer to section 11.3.9 Object related commands (Adjust Text). On the Properties tab text fields you can insert text.
5. Menu and toolbar Properties tab – Tally The Tally object displays a matrix of up to 16 tallies. With the X and Y lists the number of tallies in X (horizontal) and Y (vertical) direction can be determined. First select the number of tallies in X direction because the number of available tallies in Y direction depends on this. Depending on this selection on the left side there is displayed the corresponding amount of items with their matrix coordinates.
5. Menu and toolbar Properties tab – Logo With a logo-object a bitmap can be displayed on the projection module. Non-animated as well as animated bitmaps can be displayed. The logo can be loaded. Non-animated logos may have gif, jpg or bmp format. Animated logos may have gif, mpg or avi format. Whether the checkbox Animation is selected or not, determines if the Name list shows the animated or the non-animated bitmaps. To transfer bitmaps to the HYDRA, please see section 8.1 Data structure and data access.
5. Menu and toolbar Properties tab – Timer The timer counts downwards to the indicated time. When the time is reached it counts onwards. The time can either be inserted in 24 hours mode or in am/pm mode. Therefore the respective option button must be selected. With the Tomorrow checkbox additional 24 hours are added to the specified time. With the Foreground and Background list the colors for the foreground and the background can be chosen.
5. Menu and toolbar Properties tab – Alarm The alarm object provides a list of the alarms that occur on the HYDRA module that displays the alarm object. The alarms are sorted by their occurrence, where the latest alarm is listed most top. The alarm object can be sized as big as required. If there are anyhow more alarms than fit in the object, the least recent once will not be displayed.
5. Menu and toolbar Properties tab – Application The Properties tab for an application object contains a command line to execute an application from the directory /home/hydra/flash/apps of HYDRA. With the Environment field an environment variable can be set for the application. This has only an impact on this application but not to any other application. With the Environment field e.g. the local time for a clock application could be set.
5. Menu and toolbar UMD tab On the UMD tab the display of an under monitor display (UMD) can be defined. It provides two lines to display additional text. • The Visible checkbox activates or deactivates the UMD lines. The content of the lines is configured individually: • If Visible is checked the first line is displayed at any rate. • If the Text checkbox of the first line is selected, the text inserted in the text box is displayed. If it is deselected the video name is displayed instead.
5. Menu and toolbar 5.6.5 Cut, copy, paste and paste new object properties The following commands can be used to assign properties from one object to another object. The original object might be deleted or left unchanged; the properties can be assigned to an existing object or by creating a new one. Please refer also to section 5.5.3 Load, cut and paste object properties where properties are assigned to a group of objects.
5. Menu and toolbar 5.6.7 Hide/unhide object With the command Hide/unhide object, it can be chosen whether the selected object shall be displayed on the projection module or not. With the default setting an object is visible as soon as an object type is assigned. To hide an object, choose the command Hide/unhide object. If an object is hidden, it is crossed out on the work area. After a refresh it is no longer visible on the display area. The default for a new object is to be visible.
5. Menu and toolbar 5.6.9 Show viewer With the command Show viewer the content of a selected viewer object can be displayed in a separate window directly on the monitor connected to the operator PC. To be able to show a viewer content locally, the Barco Java Applet must be confirmed when starting the iSTUDIO GUI; please refer to section 3.2.1 Connecting from a user PC to the Hydra. Before the window shows up a dialog asks for the connection password. This is by default glad01.
5. Menu and toolbar 5.7 Grid The functionality of the grid can be managed with the commands of the Grid menu. Figure 5-65 Grid toolbar and Grid menu 5.7.1 Fixed movement If the command Fixed movement is checked, an object will be lined up with the grid as soon as it is moved. The upper left corner of the object will be positioned to the upper left corner of the grid cell on which the mouse drags the object.
5. Menu and toolbar 5.7.2 Lock objects If the command Lock objects is checked, objects can not be moved or sized by means of the mouse. This prevents to move them if not intended. Nevertheless objects can be moved and sized with the Edit object menu. To check and uncheck Lock objects, alternatively use the shortcut key Ctrl+L or the toggle button on the tool bar. The red corner indicates that Lock objects is checked: Figure 5-67 Toggle button – Lock objects 5.7.
5. Menu and toolbar 5.7.4 Maintain aspect ratio If the command Maintain aspect ratio is checked, the used work area and display area is of the same aspect ratio as the used projection module, but the area reserved in the GUI to show the work and display area might be of another aspect ratio. This means that there might be some extra space that is not used for the work and display area; it is displayed in a dark Grey above and below (left and right) of the used area.
5. Menu and toolbar 5.7.6 Aspect ratio The command 4 by 3 aspect ratio or 16 by 9 aspect ratio determines the aspect ratio of the grid cells to 4×3 or to 16×9. Depending on the aspect ratio of the projection module not the whole work area will fit into the grid. The command Use vertical helps to fit the grid in horizontal or vertical direction into the work area. The command Align grid to top/bottom/left/right/center helps to align the grid within the work area.
5. Menu and toolbar 5.7.9 Increasing and decreasing the grid The following buttons help to configure the grid. Their functionality is not accessible by means of the menu. Decrease grid in both directions The decrease grid in both directions button reduces the number of grid rows and columns by one. Increase grid in both directions The increase grid in both directions button raises the number of grid rows and columns by one.
5. Menu and toolbar 5.8 Language The language of the user interface can be selected with the option buttons in the Language menu. Figure 5-72 Language menu To display Japanese characters by the Hydra, in the dialogs of the user interface where text is edited the font Mincho or Gothics must be selected, please refer also to section 4.3.2 Japanese fonts ! 5.9 Release information You find the release information in the Help menu under the topic About ….
6. Further GUI elements 6 Further GUI elements This chapter lists and explains all elements of the GUI of iSTUDIO not explained in the chapter above. This are the administrator and user log in buttons, the tree and the state- and message bars.
6. Further GUI elements 6.1 Administrator / user mode iSTUDIO can be operated in two access modes: as administrator or as user. The following list shows in which situations they should be used: • administrator The administrator account provides full access to the whole functionality of the iSTUDIO software. • user The administrator can adapt the functionality of the user account. This enables to protect single interactions, like switching modules off or on, deleting layouts, etc.
6. Further GUI elements 6.2 Tree This section provides detailed information of how to work with the tree. The tree provides easy and fast access to different kind of basic functionality. Even though there are two different appearances of the tree – standard view tree and fast view tree – the functionality is the same. (To switch between both views please refer to section 5.2.6 User settings.
6. Further GUI elements Standard view tree In standard view tree the items of the tree are arranged in a folder like structure. To expand or collapse a folder, double click on the red bullet or the name. The subentries appear or disappear. Multiple entries can be expanded at the same time.
6. Further GUI elements 6.2.4 Objects In the Objects list object templates with defined properties are stored. These object properties contain the type of the object, border settings, etc except size, position and source of the object. Clicking on an object template in this list assigns its properties to the active object in the work area. 6.2.5 Sources The Sources folder contains all sources of that HYDRA module that is indicated in the statebar (6.3.1 Statebar).
6. Further GUI elements 6.3 Statebar and messagebar 6.3.1 Statebar The statebar provides information about the display area and the work area. It contains up to five items.
7. Error messages 7 Error messages The Hydra is able to detect errors related to video, RGB and audio sources and errors of hard- and software of the HYDRA itself.
7. Error messages 7.1 Source related errors Source related errors can be displayed in the wall alarms list, please see section 5.2.2 Wall alarms area. Detection is activated in the Source properties dialog on the Alarms tab; please refer to section 5.3.7 Setup source. The properties of these errors are listed below. 7.1.1 Audio errors The following errors related to audio sources may occur: Audio Errors Audioloss -60.0 – 20.0 dBu in steps of 0.1 dBu Audiooverlevel -60.0 – 20.0 dBu in steps of 0.
7. Error messages 7.1.3 Video errors The following errors related to analog, SDI or HD-SDI video sources may occur: Video errors Value Videoblack 0 – 255 bit in steps of 1 bit Videowhite 0 – 255 bit in steps of 1 bit Videofreeze 0 – 255 bit in steps of 1 bit Description The video data will be checked during 100 fields. If the luminance pixel data of each pixel of each field is lower than the Videoblack level, the error becomes active. Only pixels of the active area of a video are taken into consideration.
7. Error messages 7.2 Device related errors Device related errors are shown in the module status list; please refer to section 5.3.3 Module status. 7.2.
7. Error messages Corrupt gmZX1 configuration The software did not configure the scaler on the analog or SDI video input card: • Retry . When the error keeps occurring, the board must be replaced; contact the Barco support.
7. Error messages Slot[]: DSP load failed The software was not able to load the DSP on the audio board in the specified slot: • Slot[]: Slot[]: Unknown ª board type No overlay input found No source inputs found No Output found Slot[]: (output) board lost The software detected in the specified slot a board with the specified boardtype, that is not known by the software: • Retry .
7. Error messages Slot[] (overlay): Board lost! The software lost connection to the overlay input card: • Slot[], Channel[]: Board ª lost The software lost the specified channel on the board in the specified slot: • Slot[]: I2c write failure Retry . When the error keeps occurring, the board must be replaced; contact the Barco support. Retry . When the error keeps occurring, the board must be replaced; contact the Barco support.
8. Advanced operation 8 Advanced operation This chapter is finally explaining how to access the data of a HYDRA, how to upgrade to a new release of iSTUDIO and is explaining some advanced configurations.
8. Advanced operation 8.1 Data structure and data access Initially the operating system of HYDRA and all other files are stored on the iSTUDIO – Hydra boot CD R32875211. When switching on the HYDRA for the first time a data structure to store varying files is copied from the CD-ROM to the flash disk. In this structure the configuration, log and system files will be stored and further bitmaps and applications can be added.
8. Advanced operation 8.1.2 Backup / restore procedures The HYDRA operating system and file structure is specially developed to provide a stable system with long lifetime. The CD-ROM is read only and therefore the operating system can not be miss-configured. The varying files are written on a flash disk. The access to the files on the flash disk is explained in the HYDRA user’s manual.
8. Advanced operation 8.2 Upgrading It is strongly recommended to make a backup of the system before upgrading, please refer to section 8.1.2 Backup / restore procedures. In case that an error occurs and restoring the backup fails, please contact the Barco support (10.1 Hotline). To upgrade one or multiple HYDRA modules to the current release of the iSTUDIO software, there are two different procedures. The first procedure is less time consuming. It is explained on this page below.
8. Advanced operation Upgrading one Hydra after the other If you do not want to switch off the whole wall at once, but just one HYDRA after the other, then a more particular procedure is required. In this case temporarily a new wall name has to be introduced for the HYDRA wall. Please follow the steps below: • Connect to one HYDRA • Make sure, that on the Startup tab of the Module properties dialog Show active layout on shutdown is selected, please refer to section 5.3.
8. Advanced operation Additional actions after upgrading When upgrading, the BIOS settings have to be considered. If till then the HYDRA has provided output in XGA resolution, the BIOS settings might have to be changed to SXGA resolution, please refer to section BIOS Setup in the HYDRA user’s manual. Upgrading to release 1.6 or higher might lead to a change or loss of the source settings.
8. Advanced operation 8.3 Redundant operation If operating two or more HYDRAS, special hard- and software configurations can be made to avoid a loss of source control in case that one display fails. Therefore a special hardware configuration is required, which allows to insert the output of each HYDRA to the overlay input card of the other HYDRA, where it can be used as background. Please refer to the HYDRA user’s manual for the explicit hardware configuration.
8. Advanced operation 8.4 Dual mode Usually one HYDRA is connected to one projection module. Under certain circumstances it can also be useful to connect one HYDRA to two projection modules who share the display information. This is called dual mode. It can be used if: • digital projection devices with XGA resolution are used, please refer to section 5.3.
8. Advanced operation Dual mode with Quad-SDI input card, Quad analog input card and Streaming video card When displaying the sources of one Quad-SDI input card, Quad analog input card or Streaming video card in dual mode on different projection modules, some restrictions must be considered. The four sources of the card are internally combined to two couples.
8. Advanced operation 8.5 Server port configuration The iSTUDIO software default configuration uses by default six defined ports. In combination with some firewalls which block these port numbers, it might be necessary to change the port numbers. Changing port numbers The file /etc/services stores the port configuration. The iSTUDIO default configuration uses the port numbers 6666, 6767, 7777, 9000, 8882 and 8883. To edit the file, please refer to section 8.1.1 Data access on Hydra.
9. Technical appendix 9 Technical appendix This chapter provides tabular overview about the order codes of components used with iSTUDIO.
9. Technical appendix 9.
10. Troubleshooting 10 Troubleshooting Check this chapter for information how to contact the technical support of Barco.
10. Troubleshooting 10.1 Hotline Feel free to contact us if you have any further questions! • Barco N.V. Projection Systems Belgium Noordlaan 5, B-8520 Kuurne Phone: +32-56-368-282, Fax: +32-56-368-251 E-mail: support.controlrooms@barco.com, Web: www.barcocontrolrooms.
11. Appendix A - Hydra Open Protocol 11 Appendix A - Hydra Open Protocol The functionality provided by iSTUDIO can mostly also be accessed by means of the HYDRA open protocol or the scripting language. The XML open protocol provides a lot of the functionality of the HYDRA scripting language in a powerful and user-friendly way and will be extended and supported further on. This chapter provides a reference to the open protocol.
11. Appendix A - Hydra Open Protocol 11.1 Formatting 11.1.1 XML All formatting in the HYDRA Open Protocol is based on XML, which stands for Extensible Markup Language. This gives a uniform and readable look to all the data that is transferred to and received from the HYDRA and is also easily extensible. A simple example of an XML structure is the following: The whitespace is not necessary, neither are the newlines (\n).
11. Appendix A - Hydra Open Protocol Some examples: <test> 12345 A&B The content of TAG1 is , of TAG2 is 12345 and of TAG3 is A&B. TAG4 contains the tags A and B.
11. Appendix A - Hydra Open Protocol 11.1.3 Error notification Unknown commands and syntax errors are reported by the XML parser and you will receive a notification. Syntax errors If the parser detects a syntax error it will send an ERROR message instead of the packet containing the COMMANDRESULT.
11. Appendix A - Hydra Open Protocol 11.2 Connections There are two connection types available: one for transactions and one for event handling. 11.2.
11. Appendix A - Hydra Open Protocol 11.3 Transactions 11.3.1 Definition Transaction A transaction contains a number of commands to be executed by the HYDRA. Transactions are always completely executed before another transaction is processed. All the commands in a transaction are executed sequentially. A transaction sits inside a PACKET tag and has the following tag: ... serial is a unique string (e.g.
11. Appendix A - Hydra Open Protocol 11.3.2 Commands – OverView All available commands of the open XML protocol are listed in the table below in alphabetic order together with a short description and link to the section containing the related syntax: Command addstream adjustborder adjuststopwatch Description 11.3.7 Source related commands, define a video stream with its parameters 11.3.9 Object related commands, adjust border color of an object of the active layout 11.3.
11. Appendix A - Hydra Open Protocol haltmodule haltwall initstreams loadfile loadlayoutandupdate loadwalllayoutandupdate rebootmodule rebootwall resetmodule resetwall savefile setalarmconfig setmoduletime setsetupcolors setsetupmodule setsetupsource setsetupusermode setsourcefreeze setsourcename setsourcetally setsourcetallyonobject 11.3.6 Module related commands, 11.3.5 Wall related commands, 11.3.7 Source related commands, 11.3.3 File related commands, 11.3.6 Module related commands, 11.3.
11. Appendix A - Hydra Open Protocol 11.3.3 File related commands This section lists all commands which can be used to manage configuration files of the HYDRA wall, i.e. information about wall layouts, layouts, objects, stream setup and encoder setup. All these files are stored in the save folder, please refer also to section 8.1 Data structure and data access. Information about names and structure of the files can be found in the next section, 11.3.4 File content.
11. Appendix A - Hydra Open Protocol Delete file Delete a stored file on all modules of the HYDRA wall. Note: Renaming a file can be done by loading it, saving it to the new name and deleting the old file.
11. Appendix A - Hydra Open Protocol 11.3.4 File content This section explains structure and content of the layout files, the wall layout files, the stream configuration file and the encoder configuration file. Do not change files of other type than the once mentioned above! By doing so, you might mis-configure the system which might prevent the Hydra from booting. Syntax • File location: The files are stored in /home/hydra/flash/save/.
11. Appendix A - Hydra Open Protocol Layout A layout file contains general information about the setup of the layout and information about the objects, their position and configuration. A layout file contains one General block and an enumeration of different object blocks. Layout – General The first entries define what is displayed on the module; the last entries define the look of the work area of the iSTUDIO GUI. (More information: 5.4.2 Setup layout, 5.
11. Appendix A - Hydra Open Protocol Layout – Object specific properties Each object type has its own parameters. In the following the parameters for the types Object, Video, Audio, Logo, Clock, Timer, Viewer, Application, Text, Stopwatch, Alarm, UMD and Tally are listed. The object type Object has a special meaning. Its parameters are also parameters of the other object types. Anyhow in this document they are only listed in the Object section below. (More information: 5.6.
11. Appendix A - Hydra Open Protocol umdposition Bottom left | bottom center | bottom right | top left | top center | top right placement of the UMD umdinside umdsplitted true | false the UMD is displayed in the video (only with video objects) Splits the two UMD lines: true: first under and second above the video false: both UMD’s under the video umdseparator umdsepcolor umdforecolor umdbackcolor true | false true | false color name from rgb.cfg file color name from rgb.
11. Appendix A - Hydra Open Protocol tton ttvisible ttpage ttusetruetype tttruetypefontname true | false vitcvisible wsson wssindicator wssmode true | false wsscolor wssdefault wssarc afdon afdlines afdindicator afdshowerror etsion etsilines etsiindicator audiodirection color name from rgb.
11. Appendix A - Hydra Open Protocol the timezone to be used, if timezoneenabled is true; specify an expression for a zone from the file timezone /home/hydra/default/config/zones.cfg backcolor forecolor logoclock logo color name from rgb.cfg file color name from rgb.
11. Appendix A - Hydra Open Protocol Text entry line0 useline0 line1 useline1 line2 useline2 line3 useline3 alignment font forecolor backcolor value meaning color name from rgb.cfg file color name from rgb.
11. Appendix A - Hydra Open Protocol UMD entry value meaning lines 1, 2, .., 16 the number of enabled lines The following entries are listed per each active line with the line index (x = 0, 1, ..
11. Appendix A - Hydra Open Protocol Wall layout A wall layout file stores the arrangement of layouts for the whole wall. Please refer also to section 5.2.1 Wall Layout for more detailed information. A wall layout file contains an enumeration of Module blocks. entry value meaning Module name layout – the type of the block module name layout name to load Stream configuration The file streams_config stores the configuration setting of the video streams. Please refer also to section 5.3.
11. Appendix A - Hydra Open Protocol 11.3.5 Wall related commands This section lists all commands which request information of the whole wall or which are applied to the whole wall. To manage the stored bitmap files the following two commands are available: Get list anims Get list with all available animation files. Send Receive ...
11. Appendix A - Hydra Open Protocol The following five lines (between LINE elements) are returned: lines - top to bottom adminpassword userpassword 0 511 1 explanation the administrator password the user password The default language is represented by a number according to the order in the language menu in the iSTUDIO GUI, starting from 0. The user privileges are represented by the decimal representation of a bit flag.
11. Appendix A - Hydra Open Protocol Set setup colors Replace the available colors with this list of RGB color triples (values from 0 to 255) and names. This command replaces the complete existing list with the values you send. Therefore take care that you do not delete the list by accident by sending just the desired changes. Always send a complete list of colors! In case that you need to restore the original list of colors you can use the colors file from the iSTUDIO CD ROM. Please refer to section 8.
11. Appendix A - Hydra Open Protocol Get wall Get the configuration of the HYDRA wall. Send Receive PAGE 17711. Appendix A - Hydra Open Protocol Reset wall Reset all the modules of the HYDRA wall. Send Receive See also haltmodule, haltwall, rebootmodule, resetmodule, resetmodule Reboot wall Reboot all modules of the HYDRA wall.
11. Appendix A - Hydra Open Protocol 11.3.6 Module related commands This section lists all commands which are applied to one or multiple dedicated HYDRA modules or which get information of a single module. The following commands can be used to manage module related information: Get module Get the name of the module where you are connected to.
11. Appendix A - Hydra Open Protocol Clear log file Clear the log file of a HYDRA module. Send For each log file specify: module name Receive See also getlogfile Get module time Get the current time and date of a HYDRA module. This is the internal time the HYDRA was set to. Timezone assignments are not considered.
11. Appendix A - Hydra Open Protocol Get setup module Get the setup of a HYDRA module. Send For each module specify: module name Receive ... ... Between the line tags are the lines of the module setup. See also getsetupsource, setsetupmodule, setsetupsource Set setup module Set the setup of a HYDRA module.
11. Appendix A - Hydra Open Protocol Load layout and update Assign a stored layout to a module and update the module. Send For each layout specify: module name, layout name Receive Software reset module Reset the software of the specified module.
11. Appendix A - Hydra Open Protocol Halt module Halt the specified module. Note: If you want to halt multiple modules and also the module where you are connected to, then put this module on the last place in the command. It is also more efficient to use haltwall if you want to halt all modules.
11. Appendix A - Hydra Open Protocol 11.3.7 Source related commands These commands provide access to source related information and actions. First the commands for administration of source parameters are listed: Get source name Get the names of sources of a module. Send For each source specify: module name and source number (0 - n).
11. Appendix A - Hydra Open Protocol Get source state Get the current state of the sources of a module of the HYDRA wall (this are for instance the detected parameters for video). Send For each module specify: module name Receive ... ... Between the line tags are the lines of the current state of the sources.
11. Appendix A - Hydra Open Protocol Set source freeze Freeze or unfreeze a source of a module of the HYDRA wall. Note: This command is not yet applicable. Further development of this element follows. Send 0 1 0 For each source specify: module name, source number (0 - n), new state.
11. Appendix A - Hydra Open Protocol Set source tally Set tally state of a hardware output tally or a software tally of a source of a module of the HYDRA wall.
11. Appendix A - Hydra Open Protocol Clear source alarm Clear an alarm of a source on a module of the HYDRA wall. Send For each alarm specify: module name, source number (0 - n), alarm name.
11. Appendix A - Hydra Open Protocol Adjust UMD background on source Adjust the background color for UMD lines for the specified sources of the specified modules.
11. Appendix A - Hydra Open Protocol Get alarm config Get the configuration of all alarms of a source.
11. Appendix A - Hydra Open Protocol These commands are used to configure video streams. Add stream Define a video stream with its parameters. Note: This command stores the stream parameters without any notice, even though a stream with this STREAM_ID might already exist. Therefore carefully check in advance not to overwrite information you still need. You must use initstreams afterwards to initialize the streams.
11. Appendix A - Hydra Open Protocol Initstreams After defining streams with the addstream command, the stream_config file has to be reinitialized to enable iSTUDIO to use these streams. This is done with the initstream command. It is sufficient to call initstreams once after adding multiple streams.
11. Appendix A - Hydra Open Protocol 11.3.8 Alarm related commands To administrate alarm related information to following commands are available: Get list alarms Get a list of all alarms that the system supports. Send Receive ...
11. Appendix A - Hydra Open Protocol 11.3.9 Object related commands To change the properties of an object the following commands are available: Adjust border Adjust the border color of an object of the active layout. Send For each object specify: module name, object name, border color.
11. Appendix A - Hydra Open Protocol Adjust UMD Adjust the UMD captions of an object of the active layout. Send For each object specify: module name, object name, line number (0-1), caption.
11. Appendix A - Hydra Open Protocol 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.
11. Appendix A - Hydra Open Protocol 11.3.11 Example Send PAGE 19711. Appendix A - Hydra Open Protocol 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 connection at the same time, and to specify for each connection specific events.
11. Appendix A - Hydra Open Protocol 11.4.3 Available events Alarm changed This event enables the monitoring of all or specific alarms. Please note that only the alarms that are enabled in the source setup of a module are useful. The full list of available source related alarms can be found in the iStudio user interface or can be requested with the getlistalarms command. A few examples of alarms are videoloss, videoblack, videowhite and audioloss.
11. Appendix A - Hydra Open Protocol Incoming event PAGE 20011. Appendix A - Hydra Open Protocol Freeze changed This event reports that a source has been frozen or unfrozen on a module of the wall. Enable / disable PAGE 20111. Appendix A - Hydra Open Protocol Module changed This event reports that the module setup has changed of a module of the wall. Enable / disable Incoming event PAGE 20211. Appendix A - Hydra Open Protocol Tally changed This event reports that the tally state of a source of a module of the wall has changed. Enable / disable Incoming event PAGE 20312. Appendix B – Hydra scripting language definition v1.0 12 Appendix B – Hydra scripting language definition v1.0 Special functionality that is not applicable via the iSTUDIO software can be used by means of the HYDRA scripting language. But the XML open protocol provides the whole functionality of the HYDRA scripting language in a powerful and user-friendly way and will be extended and supported further on.
12. Appendix B – Hydra scripting language definition v1.0 12.1 How to use scripts without the user interface • only one user script can be executed at a time on each module, this means that your script will have to wait until a running script terminates before it will be executed (the script server allows more than 10 pending connections). • create a client TCP socket with the address of the HYDRA module (e.g. 150.158.196.
12. Appendix B – Hydra scripting language definition v1.0 12.1.1 Java script code example /* Java script code example: Returns the names of the first eight sources of the module */ import java.io.*; import java.net.*; public class scriptTest { public static void main(String args[]) { try { /* Connect to script server */ Socket socket=new Socket("150.158.196.151",6767); InputStream istream=socket.getInputStream(); OutputStream ostream=socket.
12. Appendix B – Hydra scripting language definition v1.0 12.2 Definition of script syntax Commenting lines in your script can be done with a semicolon ; . For instance: ; Put the name of module in variable this module this Labels can be defined with a : followed by the name of the label, e.g. :label. Each label can be used only once (unique position in script). Variables do not have to be declared.
12. Appendix B – Hydra scripting language definition v1.0 12.2.
12. Appendix B – Hydra scripting language definition v1.
12. Appendix B – Hydra scripting language definition v1.
12. Appendix B – Hydra scripting language definition v1.0 12.2.
12. Appendix B – Hydra scripting language definition v1.
12. Appendix B – Hydra scripting language definition v1.0 message message string Send script message string (while execution). halt halt module Halt module with name module. reboot reboot module Reboot module with name module. module module name Get the name of the module running this script. wall wall list Get a list (see list command) with all the modules in this wall. load load layout Load stored layout (e.g. brochure) into work layout. empty empty Make work layout empty.
12. Appendix B – Hydra scripting language definition v1.0 type type Get type of currently selected object, the possible types are: General, Object, Video, Audio, Logo, Clock, Timer, Viewer and Application. set set attribute value Set attribute of selected object to value in work layout, see section 12.2.4 Description of object attributes (Layouts). get get attribute value Get attribute of selected object in work layout, see section 12.2.4 Description of object attributes (Layouts).
12. Appendix B – Hydra scripting language definition v1.0 settally settally module source tally state Set tally (0-2) of source (0-29) of module to state (boolean). This is only available for software tallies. state state module Get current state of module (tallies and errors), do this before you use the tally and error commands. tally tally value tally (or gettally) Get tally (0-2) for work source (hardware or software according to configuration of each source).
12. Appendix B – Hydra scripting language definition v1.0 12.2.3 Description of source attributes (sources.cfg) Attribute Description name freeze name of source (e.g. “Video1”) boolean with freeze state (all booleans are a “true” or “false” string, not a value 0 or not 0 !) standard type deinterlace black, bright, contrast, satsinhue, satcoshue, horstart, horwidth, evenstart, oddstart, verwidth source standard (e.g.
12. Appendix B – Hydra scripting language definition v1.0 12.2.4 Description of object attributes (Layouts) General General layout properties: Attribute Description resx resy backcolor bitmap bitmapstyle bitmapname resolution width resolution height background color (e.g.
12. Appendix B – Hydra scripting language definition v1.
12. Appendix B – Hydra scripting language definition v1.0 Clock Clock object specific: Attribute Description digital twelve offseth backcolor forecolor digital (true) or analog clock (false) 12 hours (true) or 24 hours (false) digital clock offset for hours (e.g.
12. Appendix B – Hydra scripting language definition v1.0 12.3 Some example scripts 12.3.
12. Appendix B – Hydra scripting language definition v1.0 12.3.2 Fullscreen script Show first source without error fullscreen module this load "full" :loop state this expr set source 0 :loop2 source source error test expr = test test 0 goto test cont expr + source source 1 expr < test source 30 goto test loop2 :cont select 1 set "source" source set "umdtext" source update this sleep 1 goto 1 loop 12.3.
12. Appendix B – Hydra scripting language definition v1.0 12.3.
12. Appendix B – Hydra scripting language definition v1.
12. Appendix B – Hydra scripting language definition v1.0 12.3.
12. Appendix B – Hydra scripting language definition v1.0 12.3.8 Source script Changing source names ; Set all source names getsetup "Module" expr set count 0 :loop source count expr + count count 1 string set name "Source" string + name name count setsource "name" name expr < test count 30 goto test loop setsetup "Module" 12.3.
13. Index 13 Index 13.1 List of tables Table 3-1 System requirements for the control computer ........................................................................................ 3-2 Table 3-2 Factory set passwords................................................................................................................................. 3-5 Table 3-3 Factory set network settings ......................................................................................................................
13. Index Table 12-13 Viewer object attributes ..................................................................................................................... 12-16 Table 12-14 Application object attributes............................................................................................................... 12-16 13.2 List of figures Figure 2-1 Setup with 3 HYDRAS .................................................................................................................................
13. Index Figure 5-29 Module properties dialog – Boards tab – DVI-DVI output card with scaling (left) and DVI video output card (right) ......................................................................................................................................................... 5-37 Figure 5-30 Module properties dialog – Sources tab................................................................................................
13. Index Figure 5-70 Work area with default setting (left) and with Use vertical enabled (right) .................................... 5-91 Figure 5-71 4 by 3 aspect ratio within XGA resolution (left) and 16 by 9 aspect ratio within XGA resolution (right) ............................................................................................................................................................................ 5-92 Figure 5-72 Language menu ....................................................
