Data & String Processing
Data & String Processing operators parse, convert, transform, and evaluate numbers, strings, and dates flowing through the scene's event pipes.
Arithmetic Operator for Real-Time Math Logic#
1. Functional Overview
The Arithmetic operator performs basic mathematical changes to an incoming float value. When a number is sent to its Input Value @Input, the operator applies the configured mathematical operation (Add, Subtract, Multiply, or Divide) using the specified float operand and broadcasts the resulting math sum through its Output Value @Output.
Arithmetic
ARITHMETICDATA_NUMBERArithmetic Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
operation: "ADD" | "SUBTRACT" | "MULTIPLY" | "DIVIDE" | Operation | ENUMOPTION SELECTOR | "ADD" |
operand: float | Operand | FLOATTEXT INPUT | 0 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
inputValue: (payload: float) => void | Input Value | DATA_FLOAT | AIR_PROPERTY |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Date Convert Operator for Timestamp Parsing#
1. Functional Overview
The Date Convert operator formats temporal parameters. It accepts epoch values or ISO datestrings via Input Date, processes the parameters using custom formatPattern configurations (e.g. YYYY-MM-DD), and outputs formatted text streams through Output Date.
Date Convert
DATE_CONVERTDATA_NUMBERDate Convert Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
inputNumberUnit: "AUTO" | "NOW" | "EPOCH_SECONDS" | "EPOCH_MILLISECONDS" | Numeric Input Unit | ENUMDROPDOWN | "AUTO" |
outputType: "EPOCH_SECONDS" | "EPOCH_MILLISECONDS" | "ISO_STRING" | "CUSTOM_FORMAT" | "RELATIVE_TIME" | Output Type | ENUMDROPDOWN | "ISO_STRING" |
timeZone: "LOCAL" | "UTC" | Time Zone | ENUMDROPDOWN | "LOCAL" |
customFormat: string | Custom Format | STRINGTEXT INPUT | "YYYY-MM-DD HH:mm:ss" |
relativeStyle: "LONG" | "SHORT" | Relative Style | ENUMDROPDOWN | "LONG" |
relativeAllowFuture: boolean | Allow future (e.g., “in 3 hours”) | BOOLTOGGLE | true |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
inputValue: (payload: string) => void | Input Value | DATA_STRING | AIR_PROPERTY |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<string> | Output Value | DATA_STRING | AIR_PROPERTY |
Waveform Generator Operator for Procedural Motion#
1. Functional Overview
The Generator operator creates automated procedural values. Using active clock time, it calculates continuous wave values according to the configured waveType (Sine, Cosine, Square, Triangle, or Perlin Noise), scaling results based on frequency and amplitude parameters to drive smooth periodic animations.
Generator
FUNCTION_GENERATORDATA_NUMBERGenerator Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
functionType: "SINE" | "SQUARE" | "TRIANGLE" | "SAWTOOTH" | "RANDOM" | Function Type | ENUMOPTION SELECTOR | "SINE" |
amplitudeRange: [number, number] | Range | RANGERANGE SLIDER | [-1, 1] |
frequency: float | Frequency | FLOATRANGE SLIDER | 0.25 |
phaseOffset: float | Phase Offset | FLOATRANGE SLIDER | 0 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Loop Operator for Animated Float Iterations#
1. Functional Overview
The Loop operator animates numeric variables continuously. It loops a progress float value from 0 to 1 over the duration specified in loopDuration. The path is smoothed using configurable math easingFunction presets, firing outputs on cycle completion.
Loop
LOOPDATA_NUMBERLoop Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
valueRange: [number, number] | Value Range | RANGERANGE SLIDER | [-1, 1] |
loopSpeed: float | Speed | FLOATRANGE SLIDER | 0.35 |
reverse: boolean | Reverse | BOOLTOGGLE | false |
easingFunction: "LINEAR" | "EASE_IN" | "EASE_OUT" | "EASE_IN_OUT" | Easing Function | ENUMDROPDOWN | "LINEAR" |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
toggleOnoff: () => void | Toggle On/Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
Round Operator for Float Precision & Modulo#
1. Functional Overview
The Round operator processes incoming numeric data to enforce specific mathematical precision formats. It consumes a raw number on its Input Value @Input and outputs the adjusted figure from its Rounded Value @Output. The rounding behavior is configured by the method property (supporting Round, Ceil, Floor, Truncate, or Modulo options) and further adjusted using roundTo, decimalPlaces, or modulo inputs.
Round
ROUNDDATA_NUMBERRound Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
method: "ROUND_NEAREST" | "ROUND_UP" | "ROUND_DOWN" | "TRUNCATE" | "MODULO" | Method | ENUMDROPDOWN | "ROUND_NEAREST" |
roundTo: float | Round To | FLOATTEXT INPUT | 1 |
decimalPlaces: int | Decimal Places | INTTEXT INPUT | undefined |
modulo: float | Modulo | FLOATTEXT INPUT | 2 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
inputValue: (payload: float) => void | Input Value | DATA_FLOAT | AIR_PROPERTY |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
roundedValue: AirEvent<float> | Rounded Value | DATA_FLOAT | AIR_PROPERTY |
Set Float Operator for Direct Numeric Output#
1. Functional Overview
The Set Float operator outputs predefined float constants. When its input trigger fires, it reads the configured float value property and outputs it directly through Output Value, making it useful for initializing math loops or resetting counters.
Set Float
SET_FLOATDATA_NUMBERSet Float Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
alwaysOn: boolean | Always On | BOOLTOGGLE | false |
value: float | value | FLOATTEXT INPUT | 0 |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
setValue: () => void | Set Value | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputValue: AirEvent<float> | Output Value | DATA_FLOAT | AIR_PROPERTY |
String Builder Operator for Dynamic Templates#
1. Functional Overview
The String Builder operator compiles dynamic string outputs. It handles a main template text property containing replacement brackets (e.g. 'Hello {name}'). When input data streams arrive, the operator substitutes local properties into bracket positions and outputs the completed string.
String Builder
STRING_BUILDERDATA_STRINGString Builder Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
templateString: string | Template String | STRINGTEXT INPUT | "" |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
dataInput: (payload: DataBlock[]) => void | Data Input | DATA_BLOCK | DATA_BLOCK |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
dataOutput: AirEvent<DataBlock[]> | Data Output | DATA_BLOCK | DATA_BLOCK |
String Join Operator for Text Array Concatenation#
1. Functional Overview
The String Join operator concatenates text segments. It takes multiple inputs or an array of strings, merges them using the designated delimiter string (e.g. a comma or space), and outputs the unified text via its main trigger.
String Join
STRING_JOINDATA_STRINGString Join Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
joinWith: string | Join With | STRINGTEXT INPUT | ", " |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
dataInput: (payload: DataBlock[]) => void | Data Input | DATA_BLOCK | DATA_BLOCK |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
dataOutput: AirEvent<DataBlock[]> | Data Output | DATA_BLOCK | DATA_BLOCK |
String Switch Operator for Key-Based Routing#
1. Functional Overview
The String Switch operator performs key-value routing. It takes a string key, compares it against a configured list of key-value case pairs, and dispatches the matching value. If no match is found, it falls back to a designated default value.
String Switch
STRING_SWITCHDATA_STRING@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
inputText: (payload: string) => void | Input Text | DATA_STRING | AIR_PROPERTY |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
matchedValue: AirEvent<void> | Matched Value | OPERATOR | OPERATOR |
Translation Operator for Multi-Language Text#
1. Functional Overview
The Translation operator provides real-time text translation. It receives input text, reviews target sourceLanguage and targetLanguage configurations, calls the integrated translation engine, and outputs the translated text.
Translation
TRANSLATIONDATA_STRINGTranslation Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
text: string | Text | STRINGTEXT INPUT | "" |
toLanguage: string | To Language | STRINGDROPDOWN | "SPANISH" |
activationType: string | Activated By | STRINGDROPDOWN | "NEW_TEXT" |
startActive: boolean | Start Active | BOOLTOGGLE | true |
reverseCharacters: boolean | Reverse Characters | BOOLTOGGLE | false |
useFromLanguage: boolean | Specify Origin Language | BOOLTOGGLE | false |
fromLanguage: string | Origin Language | STRINGDROPDOWN | "ENGLISH" |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
translate: (payload: string) => void | Translate | DATA_STRING | AIR_PROPERTY |
toggleOn: () => void | Toggle On | OPERATOR | OPERATOR |
toggleOff: () => void | Toggle Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputText: AirEvent<string> | Output Text | DATA_STRING | AIR_PROPERTY |
Transliteration Operator for Script Conversion#
1. Functional Overview
The Transliteration operator standardizes scripts phonetically. It parses international script strings and uses character map tables to emit latinized equivalent scripts, which is ideal for standardizing naming conventions.
Transliteration
TRANSLITERATIONDATA_STRINGTransliteration Properties Details
| Property & Type | Display Name | System Type | Default |
|---|---|---|---|
useFontReference: boolean | Use Font Reference | BOOLTOGGLE | false |
referenceFont: any | Reference Font | NONEFONT SELECTOR | {fontMediaItemId: 3662a206-5bc6-4de7-b4ac-9cacda5b5f85, variantName: regular} |
startActive: boolean | Start Active | BOOLTOGGLE | true |
reverseCharacters: boolean | Reverse Characters | BOOLTOGGLE | true |
@Input
| @Input & Type | Display Name | @Input Type | Group |
|---|---|---|---|
inputText: (payload: string) => void | Input Text | DATA_STRING | AIR_PROPERTY |
toggleOn: () => void | Toggle On | OPERATOR | OPERATOR |
toggleOff: () => void | Toggle Off | OPERATOR | OPERATOR |
@Output
| @Output & Type | Display Name | @Output Type | Group |
|---|---|---|---|
outputText: AirEvent<string> | Output Text | DATA_STRING | AIR_PROPERTY |