Skip to main content

GettingStartedControls Part 5

Data-bound clock

In this step we will add a new Control that represents a clock. This clock works via data-binding. The Player that comes with CGI Studio provides one sample data-source that represents the current UTC time. This value will be bound to the clock Control. Scene Composer offers an analog and a digital clock control. In this example digital clock will be used. Note that the following steps work similar for the analog clock.

Application specification

Because the data-source is defined in the Player, a connection between the Player and the Scene Composer Solution has to be defined. The following approach needs to be followed if data-binding should be used. Go to "File -> Define application specification". A window will pop up that requires two paths:

  • File: This is the path to the XHCDL file where the binding sources are stored.
  • Include Path: This is root path to the source of CGI Studio Courier.

After entering the paths the pop-up window should look similar to the following:

drawing-4-1736840679.png

Press "OK" to save the specification. In the "Output"-panel a message will be shown if the specification is valid or not.

Clock Control

Drag the Control called "Digital Clock" into the home scene. The Control has some properties for customization. For instance the clock can be configured to show full 24 hours or just 12 hours with an "a.m." and "p.m." label. The text of those labels can be changed as well. The properties of the control look similar to this:

drawing-5-1734681136.png

Add Data-binding

To add data-binding go to the Clock Control properties click on the chain icon on the right of the property "Time" to open the "Define Data Binding" dialog. For the property "Time" the datatype "Variant" is preselected, now the Binding Source can be chosen. Choose the Time binding source and click "OK". To find the binding source more easily, the dialog offers a search field. Define Data Binding dialog looks like this:

drawing-5-1734681249.png

You can now generate a new asset library and try it out in the Player.

Conclusion

This concludes the Getting Started Controls tutorial. However, by providing your own custom images and further modifying the layout of the controls, you can create even more visually stunning solutions. The GettingStartedControls sample provided in CGI Studio is just one example of what can be achieved using this tutorial as a basis.

drawing-7-1676541303.png