Navigation:  Widget Designer > Devices > Christie >


prev main next

Navigation:  Widget Designer > Devices > Christie >


prev main next

Please wait. Due to its content this page might take a while to load...

The Terra Device in the Configuration dialog allows to easily monitor and remote control different functions of a Christie Terra controller. Note that the device is only available in the licensed Widget Designer edition, not the Free version.

Adding a New Terra Device

To add a Terra device, open the Devices menu and select "Christie > Terra > Create Terra". This opens the Configuration dialog. Alternatively, you can add a new device in the Configuration dialog with the "+" button.

On the right side you see several options:

The Name is the unique identifier for this Terra object in WD and the general rules for naming objects apply here as well (only letters, numbers and underscore are allowed, the first symbol must be a letter).
If you like, you can change the default name to a more descriptive one. When scripting, enter the name to access available members as described further down.

The ID is currently used internally only. In upcoming versions it will be possible to use it for addressing the device.

The "Enable" check box is ticked per default. On the left side, you should later see that the icon in front of your Terra device is a filled blue circle. An empty blue circle indicates an enabled device where the IP address is not available. A filled gray circle indicates a disabled device.
In case, you cannot connect to the Terra controller, make sure that the remote option is turned on in the Terra manager. Open the "Global" page and look under "External Control" for the option "JSON API" and enable it.

Now, please enter the IP address of the Terra controller. Click the "Apply" button to save any changes done here. You can also use the shortcut [Ctrl + Enter] to do so.

You can close the dialog now. The newly created device will also be added to the Devices menu > Christie > Terra and can be opened from here or with Devices menu > Configuration.

Using the Device in Regular Scripting

After creating a device, you can access its commands and parameters easily via scripting which allows to perform actions on the device as well as retrieve information from it.

To send commands to the device, first create a CustomScript button or use the Macro editor or anything else with a scripting field. If you enter the device's identifier name into the script field (per default that is "Christie_Terra1"), Script Assist will offer you a list of all members.
Some of them are commands to perform actions on the device, e.g. applying a layout:

You can also retrieve specific values via scripting in the same way as from other widgets (e.g. a Fader value):

vlist = Christie_Terra1.LayoutNames

This member returns all layout names as a list that can be displayed in the Debug Logger or assigned to a variable, DropDown List, etc.


The Terra tutorial shows how to build a small interface to interact with a Terra system and uses the most important commands and Event Listeners.

Using the Device with Event Listeners

Event Listeners can be added to the Configuration dialog and provide a simple way of listening to triggers from connected devices.

Please see the chapter Event Listener for a detailed description of its functionality and Terra Events for an overview (with examples and description) over the events raised by a Terra device.

Using the Device as a Widget

There is also a Terra Display Array widget available which shows the display arrangement of a Terra device.