# 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 similarly for the analog clock.

##### Application specification

The data-source is defined in the Player. Therefore 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.

1. In the menu bar go to \[File\] &gt;\[Define application specification\]. 
    - The "Courier Editor Parameters" dialog will pop up. See image below
    - This dialog requires two paths. <table border="1" class="align-center" id="bkmrk-connect-to-fusion-no-2" style="border-collapse: collapse; width: 601px; border-width: 1px; height: 134.667px;"><tbody><tr style="height: 29.4667px;"><td style="background-color: rgb(53, 152, 219); width: 135.167px;"><span style="color: rgb(255, 255, 255);">**File** </span></td><td style="width: 465.167px;">This is the path to the XHCDL file where the binding sources are stored</td></tr><tr><td style="background-color: rgb(53, 152, 219); width: 135.167px;"><span style="color: rgb(255, 255, 255);">**Include Path** </span></td><td style="width: 465.167px;">This is root path to the source of CGI Studio [Courier](http://dev.doc.cgistudio.at/APILINK/namespace_courier.html).
        
        </td></tr></tbody></table>
        
        <div drawio-diagram="8479"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-07/drawing-5-1751633050.png" alt=""/></div>
2. Enter the paths as given in the table below and press \[OK\]. 
    - The specification is saved.
    - The Output panel will show whether the validation is valid (Validation finished!) or not (Validation failed!).  
        <table border="1" class="align-center" id="bkmrk-file-..%2F..%2F..%2F..%2Fcgi" style="border-collapse: collapse; width: 601px; border-width: 1px; height: 134.667px;"><tbody><tr style="height: 29.4667px;"><td style="background-color: rgb(53, 152, 219); width: 135.167px;"><span style="color: rgb(255, 255, 255);">**File** </span></td><td class="align-left" style="width: 465.167px;">\\cgi\_studio\_player\\src\\Player\\xhcdl\\PlayerDataBinding.xhcdl</td></tr><tr><td style="background-color: rgb(53, 152, 219); width: 135.167px;"><span style="color: rgb(255, 255, 255);">**Include Path** </span></td><td class="align-left" style="width: 465.167px;">\\cgi\_studio\_courier\\src</td></tr></tbody></table>

<div class="contents" id="bkmrk--2"><div class="contents"><div class="textblock">  
</div></div></div>##### Add Data-Binding to the DigitalClock Control

1. In the Solutions Explorer **double-click SceneHome**, which can be found under path given in the table below. 
    - Scene Tree panel displays the scene tree of SceneHome. There is a DigitalClock control under the root node (SceneHome &gt; DigitalClock).
    - Scene Editor displays the editable scene. There is a DigitalClock control in the top center above the gauge.  
        <table border="1" class="align-center" id="bkmrk-import-resources-pat" style="border-collapse: collapse; width: 600px; border-width: 1px; height: 59.6px;"><tbody><tr style="height: 29.8px;"><td style="background-color: rgb(53, 152, 219); width: 137.5px; height: 29.8px;"><span style="color: rgb(255, 255, 255);">**Open Scene** </span></td><td style="background-color: rgb(53, 152, 219); width: 461.5px; height: 29.8px;"><span style="color: rgb(255, 255, 255);">**Solution Explorer Path** </span></td></tr><tr style="height: 29.8px;"><td style="width: 137.5px; height: 29.8px;">SceneHome  
        </td><td style="width: 461.5px; height: 29.8px;">Solution &gt; Scenes &gt; SceneHome  
        </td></tr></tbody></table>
2. Either in Scene Editor or in Scene Tree panel **select** the **DigitalClock** control and view the configurable properties in the **Properties panel**.  
    
    - In the Properties panel under \[Control\] there is a **Time** property.
    - The Time property has a button with a chain icon on its right side. Its tooltip says "Bind property to a data source item". <div drawio-diagram="8481"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-07/drawing-5-1751634634.png" alt=""/></div>
3. Click on this button. 
    - The **Define Data Binding** dialog will be opened.
    - In the top of this dialog you can see that for the property "**Time**" the datatype "**Variant**" is preselected.
4. From the list of Data items **choose** the **Time binding source** and click **\[OK\]**. 
    - The Data Binding has been configured successfully. <p class="callout info">To find the binding source more easily, the dialog offers a search field.</p>
        
        <div drawio-diagram="8482"><img src="https://doc316en.candera.eu/uploads/images/drawio/2025-07/drawing-5-1751634970.png" alt=""/></div>
5. You can now generate a new asset library and try it out in the Player.

<div class="contents" id="bkmrk--0"><div class="contents"><div class="textblock">  
</div></div></div>#### 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.

<div class="contents" id="bkmrk--8"><div class="contents"><div class="textblock"><div class="image"><div drawio-diagram="1624"><img src="https://doc316en.candera.eu/uploads/images/drawio/2023-02/drawing-7-1676541303.png" alt=""/></div>

---

</div></div></div></div>