Action-Level Conditions

Action-level conditions allow you to control whether or not an action triggers the actions that are connected to it.

This is one of multiple ways of doing this.

Setting a Condition

The condition is entered via "Set Condition" in the context menu of the action. The dialog that appears has a field in which you can enter the condition. After it is initially entered, the condition appears in a text field in the action's slot and can be edited there. Additionally, the action's icon changes from an arrow to a question mark.

Condition Evaluation

When the action is executed, the condition is checked by comparing it to the parameters passed into the action:

• If the condition is not met, processing of the action stops.
• If it is met, processing continues as normal, executing the action and passing parameter values to connected actions.

This allows you to create a system where only those connections are followed where conditions have been met.
This will create the code inside the action, in this example as set condition 10, it will look like this.

--conditionBegin
if not (val == 10) then
	pixc.suppressCallRefs()
	return
end
--conditionEnd

Condition Syntax

Simple Comparisons

The simplest condition consists of a single numeric value or string. The system will compare the first parameter of the action to that value.

Example:

23  -- Condition is met if val equals 23

If multiple values are entered, they are checked sequentially:

23, 87  -- Condition is met if val2 equals 23 and val2 equals 87

Using Comparison Operators

You can use operators such as >, <, <=, >=:

> 23  -- Condition is met if val1 is greater than 23

Using Lua Expressions

Conditions can contain any valid Lua code. This allows complex conditions:

val1 > 23 or val2 == 90

Referencing Other Actions

You can use other actions in conditions. For example:

TimeInfo.getSeconds() > 30

This condition checks if the function getSeconds() in the TimeInfo module returns a value greater than 30.

Else and ElseIf Conditions

Else Actions

To react when a condition is not met, set an else-action:

1. Create an action below an action with a condition.
2. Right-click the action and choose "Use as Else For [Action Name]".
3. The action will now trigger only if the preceding condition was not met.

ElseIf Actions

To create an elseif condition:

1. First, create an else-action as described above.
2. Right-click the else-action and add a new condition.
3. The action will now act as an elseif, only triggering if the first condition was not met but its own condition is met.

Examples

Basic Condition

ConditionTest.getSeconds() < 30

This checks if the action getSeconds() in ConditionTest returns a value below 30.

Example Code for getSeconds()

return Pixera.Timelines.getTimelineAtIndex(0).getCurrentTime() / 60

This retrieves the current timeline time and converts it to minutes.

Project file with the examples from above

https://static.helpjuice.com/helpjuice_production/uploads/upload/image/9741/direct/1742218524285/conditions.avp

PIXERA 25.1 INTER 30 | 17. March 2025 | J.B.