Skip to main content
Skip table of contents

Creating a control panel - PRODUCTION

The Pixotope Director allows you to create custom remote-control panels, which run:

  • in a web browser on your Pixotope network

You can control:

  • all properties and functions of Pixotope Engine objects

  • all aspects of Pixotope Director which are controlled via the Pixotope API

Learn more about the supported widget and property types

Want to give feedback?

This is another step on the journey where we would welcome your input and thoughts. If you are interested in giving feedback, sharing your use cases or contributing in general, we would love to invite you to our Control Panel slack channel! Just send an email to design@pixotope.com


Academy Tutorial - User configurable control panel

  • Introduction to our new control panel


Create a control panel

  1. Go to PRODUCTION > Show > Launch

  2. Click "Create new control panel"

  3. Give it a descriptive name

  4. The control panel is opened in your default browser

Learn more about the Control Panel - Interface and its Keyboard shortcuts

Open a control panel

  1. Go to PRODUCTION > Show > Launch

  2. Hover over the control panel you want to open and click "Launch panel (Editor)"

  3. The control panel is opened in your default browser

Duplicate, Rename, Delete a panel

Use the overflow menu to duplicate, rename or delete a control panel.

Every control panel is stored in its own folder together with potential image assets.

Find the property to control

Any property with a red/orange circle to the left of the property can be controlled.

For functions use FN

  1. Go to the "Properties and States" drawer to find the Target property you want to control

  2. If necessary use the search field to search for objects/actors or properties (use the exposed filter )

Exposed tab

shows all exposed properties

Control panel tab

shows all widgets and their properties

Engine tab

shows all objects/actors in a level and all their properties and functions

For advanced users

Store tab

shows all properties of the current show file

API Log tab

shows all Pixotope API messages

Sub properties

Some properties can be further broken down into sub properties which can be controlled.

  1. Click on the down arrow next to the property name

Transform

Color

Vector

Expose property to show up in Exposed tab - (optional)

Properties can be exposed in two ways

  • Per object/widget

    • Exposes the property of one specific object

  • Per class (only for objects/actors)

    • Exposes the property for all objects based on this class

  1. Go to any property with a star and/or C icon

  2. Click the

    • Star icon to expose the property per object

    • C icon to expose the property per class

  • Functions, transforms and visibility can currently not be exposed

  • World settings are only exposable per class

Of course you can always Expose properties from within the Editor

Add widgets with actions

You can create widgets with actions

  1. In the "Properties and States" drawer find the Target property you want to control

    • To link the same property of multiple objects at the same time, select multiple objects in the Engine tab. This shows their common properties.

  2. Click and drag the red circle of a Target property onto the canvas
    (for functions drag FN)

    • Holding down Ctrl while dragging will insert the last selected widget, skipping the toolbox

  3. The widget toolbox is opened

  4. Double click the widget which should control this property
    OR select it and click "Confirm"

    • The widget is added to the canvas

    • An action is added to the widget

      • Setting the default value of the widget as the Source

      • Setting the dragged property as the Target

  • An action is attached to a specific widget which triggers it

  • When triggered, it sends the Source value or property to the Target property

  • Actions can use properties from running levels, as well as from other widgets on the canvas

Edit widgets

  1. Right click one or more widgets

    • OR select them on the canvas or the "Control panel" tab in the "Properties and States" drawer

  2. Change any of the properties in the properties section by clicking into its value field

Editing properties of multiple widgets at once can only be done if they are of the same type

Populate Options for Tab and Select widget

  1. Select the Tab or Select widget, add values and labels respectively

  2. Double click List of a Enum or Array property in the "Engine" tab of the "Properties and States" drawer

Organize widgets

To organize your widgets you have many options

Every widget has a main color allowing to create visual relationships
Every widget has an internal label allowing to add descriptions
Group background widgets allow to group widgets together

Double click the header of the group widget to select and move all widgets within the group

Label widgets allow to add descriptions with more formatting options

Arrange widgets

  1. To group select widgets, go into Select mode by pressing V

  2. Move, resize, cut, copy and paste the widgets

  3. Align the widgets by opening the align dialog via the shortcuts tray

  4. Return to Draw mode by pressing V again

Edit actions

  1. For the widget to read the target property when switching to Live mode, click on the arrow between source and target and set the direction of the action to "Bidirectional"

    • not available for Button (Trigger)

  2. Optional: for the Source

    • Override the default Source property by dragging another property onto the source drop zone

    • OR set a constant value by double clicking into the source drop zone

Additional options

  • To automatically trigger an action when switching to Live mode, enable the "STARTUP" toggle

  • To remove a value or property, click the x to the right of the Source or Target field

  • To remove the action, click the x all the way to the right of the action row

Custom options based on widget and property type

Some widgets and property types offer additional options.

Button (Toggle) and Tab widget

These widgets have more than one action event which actions can be added to.

Learn more about supported action events

Transform type

Transforms can be dragged into the action list

When dragged in as a whole, the transform type breaks down into its individual sub property fields.

  • Drag any source property into the individual fields

  • OR set a constant value by double clicking into the field

At the trigger time, the individual values will be combined and set as the new transform

Function type

If function have arguments, the arguments are listed.

  • Drag any source property into the individual fields

  • OR set a constant value by double clicking into the field

API Call type

Add widgets and actions separately

Add a widget

  1. Press T to open the toolbox

  2. Double click the widget
    OR select it and click "Confirm"

  3. Click and drag on the canvas to place/draw the widget

    • If necessary Press V to switch between Draw and Select mode

Add an action to a widget

  1. Select one or more objects

  2. Drag an action either

    • directly onto a widget

    • OR onto the actions list

This will automatically set the default value of the widget as the source

Drag action onto widget

  1. In the "Properties and States" drawer find the Target property you want to control

  2. Click and drag the red circle of a Target property onto a widget

Drag action onto actions list

  1. Double click the widget on the canvas to focus its action list

  2. Click and drag the red circle of the Target property onto the target drop zone

For functions drag FN instead of the red circle

Go live

Save a control panel

  1. Click on the save icon in the shortcuts bar on the left
    OR press Ctrl+S

To avoid losing data

  • we store all saved versions in a Version history, which is accessible via the history icon in the header

  • we warn you before you close or reload the tab

  • we try to recover the last unsaved version in case Director, which serves the page, crashes

Preview Live mode

  1. Press R or the "Play" button in the header

    • The yellow border is removed

    • The canvas is centered

    • You cannot add or move widgets

This mode allows you to continue editing the widgets properties and actions.

  1. Click on the Settings icon in the header to open the Control panel editor settings

  2. Enable "Show Drawers on Run mode"

  3. Click "Apply"

Exit Preview Live mode

  1. Press R or the "Stop" button in the header

Live mode

This mode removes any ability to edit the control panel including switching between Edit and Preview Live mode

  1. Click on "Launch panel" from the Launch panel in Director

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.