Skip to main content
Skip table of contents

Add custom logic with the expression editor - EXPERIMENTAL

This feature is still experimental!

The expression editor allows you to build logic inside Pixotope control panel instead of Blueprint by using a drag and drop editor.

Add custom logic

  1. Open the Expression Editor by clicking on the Sum icon

    Screenshot 2025-06-23 at 12.56.05.png

    • The left side shows function options which can be dragged into the fields on the Output side marked as “Input”. For a list of available functions see below

    • The expressions default state shows the Source function in the Input field. This means that the actions Source is send to the Target directly

      image-20250728-083050.png

If the Source function is not present in any of the fields inside the Expression Editor, the value of the actions Source will not be used.

  1. Build your logic by dragging options from the list on the left to the expression editor on the right

  2. To add "variables" to the expression, drag in the Input function

    • an Input parameter is created on the action

      • the value of the input parameter is being sent to the target

  3. Combine the different functions to build more complex logic

Example

A button to increment by a custom step value

image-20250728-090531.png

The logic is executed/The target is updated when

  • the source changes

  • the widget is executed

Updating an input does NOT execute the logic.

Available functions

Function

Input options

Description

Source

Takes the source value

Input

Creates an input parameter and takes its value

Decimal

  • Value

  • Digits

Allows to set the amount of digits for a number

Abs

  • Input

Returns the absolute value

Inc

  • Input

Returns the value + 1

To build an increment/decrement logic, feed the output back into the input.

Screenshot 2025-08-05 at 12.50.19.png
Screenshot 2025-08-05 at 12.50.42.png

Dec

  • Input

Returns the value -1

Add

  • Input

  • Input

Adds input values

Sub

  • Input

  • Input

Subtracts input values

Mul

  • Input

  • Input

Multiplies input values

Div

  • Input

  • Input

Divides input values

Min

  • Input

  • Input

Returns the smaller number

Max

  • Input

  • Input

Returns the larger number

Concat

  • Input

  • Input

Combines the inputs into a single text

image-20250728-091442.png

Advanced example

In the example above we combined two “concat“ nodes. However, it will always output plural for the word “apple“. As we want it to be singular when the number is 1, we need to use an If function.

image-20250728-092856.png

If

  • Condition

  • Then

  • Else

Returns the Then value if the condition is true otherwise it returns the Else value

Conditions:

truthy: true, non-zero number

false: false, 0

Key

  • Json

  • Path

Engine

Select specific engines to be controlled

Can not be combined with other functions!

By default all actions are sent to the engines specified in the "Send to" engine list. To only send the action to specific machines

  1. Drag the engine function over

    • This creates an Engine input parameter

  2. Double click the field next to the Engine input parameter

  3. Enter 1 or more machine names separated by a comma

image-20250728-093511.png

This is for example useful in an AR+XR setup.

JavaScript errors detected

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

If this problem persists, please contact our support.