Data & String Processing

Published Updated
Perform mathematical calculations, numerical precision rounding, date conversions, and string transformations.

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#

Operator<DocsSdkOperatorsDataProcessingArithmetic>: Performs a basic math operation (addition, subtraction, multiplication, division) using a configurable operand on an incoming numeric value.

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

DATA_NUMBER.ARITHMETIC
Operator
Operator Type
ARITHMETIC
Operator Group
DATA_NUMBER

Arithmetic Properties Details

Property & TypeDisplay NameSystem TypeDefault
operation: "ADD" | "SUBTRACT" | "MULTIPLY" | "DIVIDE"
Operation
ENUM
OPTION SELECTOR
"ADD"
operand: float
Operand
FLOAT
TEXT INPUT
0

@Input

@Input & TypeDisplay Name@Input TypeGroup
inputValue: (payload: float) => void
Input Value
DATA_FLOATAIR_PROPERTY

@Output

@Output & TypeDisplay Name@Output TypeGroup
outputValue: AirEvent<float>
Output Value
DATA_FLOATAIR_PROPERTY

Date Convert Operator for Timestamp Parsing#

Operator<DocsSdkOperatorsDataProcessingDateConvert>: Parses raw dates or timestamps, outputting formatted time strings or epoch numbers.

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

DATA_NUMBER.DATE_CONVERT
Operator
Operator Type
DATE_CONVERT
Operator Group
DATA_NUMBER

Date Convert Properties Details

Property & TypeDisplay NameSystem TypeDefault
inputNumberUnit: "AUTO" | "NOW" | "EPOCH_SECONDS" | "EPOCH_MILLISECONDS"
Numeric Input Unit
ENUM
DROPDOWN
"AUTO"
outputType: "EPOCH_SECONDS" | "EPOCH_MILLISECONDS" | "ISO_STRING" | "CUSTOM_FORMAT" | "RELATIVE_TIME"
Output Type
ENUM
DROPDOWN
"ISO_STRING"
timeZone: "LOCAL" | "UTC"
Time Zone
ENUM
DROPDOWN
"LOCAL"
customFormat: string
Custom Format
STRING
TEXT INPUT
"YYYY-MM-DD HH:mm:ss"
relativeStyle: "LONG" | "SHORT"
Relative Style
ENUM
DROPDOWN
"LONG"
relativeAllowFuture: boolean
Allow future (e.g., “in 3 hours”)
BOOL
TOGGLE
true

@Input

@Input & TypeDisplay Name@Input TypeGroup
inputValue: (payload: string) => void
Input Value
DATA_STRINGAIR_PROPERTY

@Output

@Output & TypeDisplay Name@Output TypeGroup
outputValue: AirEvent<string>
Output Value
DATA_STRINGAIR_PROPERTY

Waveform Generator Operator for Procedural Motion#

Operator<DocsSdkOperatorsDataProcessingWaveformGenerator>: Generates continuous, procedural waveforms (sine, square, triangle, noise) over time.

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

DATA_NUMBER.FUNCTION_GENERATOR
Operator
Operator Type
FUNCTION_GENERATOR
Operator Group
DATA_NUMBER

Generator Properties Details

Property & TypeDisplay NameSystem TypeDefault
functionType: "SINE" | "SQUARE" | "TRIANGLE" | "SAWTOOTH" | "RANDOM"
Function Type
ENUM
OPTION SELECTOR
"SINE"
amplitudeRange: [number, number]
Range
RANGE
RANGE SLIDER
[-1, 1]
frequency: float
Frequency
FLOAT
RANGE SLIDER
0.25
phaseOffset: float
Phase Offset
FLOAT
RANGE SLIDER
0

@Input

@Input & TypeDisplay Name@Input TypeGroup
toggleOnoff: () => void
Toggle On/Off
OPERATOROPERATOR

@Output

@Output & TypeDisplay Name@Output TypeGroup
outputValue: AirEvent<float>
Output Value
DATA_FLOATAIR_PROPERTY

Loop Operator for Animated Float Iterations#

Operator<DocsSdkOperatorsDataProcessingLoop>: Loops execution states between float values over set durations using custom easing behaviors.

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

DATA_NUMBER.LOOP
Operator
Operator Type
LOOP
Operator Group
DATA_NUMBER

Loop Properties Details

Property & TypeDisplay NameSystem TypeDefault
valueRange: [number, number]
Value Range
RANGE
RANGE SLIDER
[-1, 1]
loopSpeed: float
Speed
FLOAT
RANGE SLIDER
0.35
reverse: boolean
Reverse
BOOL
TOGGLE
false
easingFunction: "LINEAR" | "EASE_IN" | "EASE_OUT" | "EASE_IN_OUT"
Easing Function
ENUM
DROPDOWN
"LINEAR"

@Input

@Input & TypeDisplay Name@Input TypeGroup
toggleOnoff: () => void
Toggle On/Off
OPERATOROPERATOR

@Output

@Output & TypeDisplay Name@Output TypeGroup
outputValue: AirEvent<float>
Output Value
DATA_FLOATAIR_PROPERTY

Round Operator for Float Precision & Modulo#

Operator<DocsSdkOperatorsDataProcessingRound>: Rounds an incoming floating-point number based on configurable methods, precision bounds, or modulo loops.

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

DATA_NUMBER.ROUND
Operator
Operator Type
ROUND
Operator Group
DATA_NUMBER

Round Properties Details

Property & TypeDisplay NameSystem TypeDefault
method: "ROUND_NEAREST" | "ROUND_UP" | "ROUND_DOWN" | "TRUNCATE" | "MODULO"
Method
ENUM
DROPDOWN
"ROUND_NEAREST"
roundTo: float
Round To
FLOAT
TEXT INPUT
1
decimalPlaces: int
Decimal Places
INT
TEXT INPUT
undefined
modulo: float
Modulo
FLOAT
TEXT INPUT
2

@Input

@Input & TypeDisplay Name@Input TypeGroup
inputValue: (payload: float) => void
Input Value
DATA_FLOATAIR_PROPERTY

@Output

@Output & TypeDisplay Name@Output TypeGroup
roundedValue: AirEvent<float>
Rounded Value
DATA_FLOATAIR_PROPERTY

Set Float Operator for Direct Numeric Output#

Operator<DocsSdkOperatorsDataProcessingSetFloat>: Hardcodes and forces a float variable output upon receiving an execution trigger.

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

DATA_NUMBER.SET_FLOAT
Operator
Operator Type
SET_FLOAT
Operator Group
DATA_NUMBER

Set Float Properties Details

Property & TypeDisplay NameSystem TypeDefault
alwaysOn: boolean
Always On
BOOL
TOGGLE
false
value: float
value
FLOAT
TEXT INPUT
0

@Input

@Input & TypeDisplay Name@Input TypeGroup
setValue: () => void
Set Value
OPERATOROPERATOR

@Output

@Output & TypeDisplay Name@Output TypeGroup
outputValue: AirEvent<float>
Output Value
DATA_FLOATAIR_PROPERTY

String Builder Operator for Dynamic Templates#

Operator<DocsSdkOperatorsDataProcessingStringBuilder>: Compiles template string blocks by substituting custom variables into bracket tags.

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

DATA_STRING.STRING_BUILDER
Operator
Operator Type
STRING_BUILDER
Operator Group
DATA_STRING

String Builder Properties Details

Property & TypeDisplay NameSystem TypeDefault
templateString: string
Template String
STRING
TEXT INPUT
""

@Input

@Input & TypeDisplay Name@Input TypeGroup
dataInput: (payload: DataBlock[]) => void
Data Input
DATA_BLOCKDATA_BLOCK

@Output

@Output & TypeDisplay Name@Output TypeGroup
dataOutput: AirEvent<DataBlock[]>
Data Output
DATA_BLOCKDATA_BLOCK

String Join Operator for Text Array Concatenation#

Operator<DocsSdkOperatorsDataProcessingStringJoin>: Joins an array of text values into a single string using a designated separator character.

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

DATA_STRING.STRING_JOIN
Operator
Operator Type
STRING_JOIN
Operator Group
DATA_STRING

String Join Properties Details

Property & TypeDisplay NameSystem TypeDefault
joinWith: string
Join With
STRING
TEXT INPUT
", "

@Input

@Input & TypeDisplay Name@Input TypeGroup
dataInput: (payload: DataBlock[]) => void
Data Input
DATA_BLOCKDATA_BLOCK

@Output

@Output & TypeDisplay Name@Output TypeGroup
dataOutput: AirEvent<DataBlock[]>
Data Output
DATA_BLOCKDATA_BLOCK

String Switch Operator for Key-Based Routing#

Operator<DocsSdkOperatorsDataProcessingStringSwitch>: Evaluates an incoming text key, routing the flow to different string output results based on case mappings.

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

DATA_STRING.STRING_SWITCH
Operator
Operator Type
STRING_SWITCH
Operator Group
DATA_STRING
No configurable properties.

@Input

@Input & TypeDisplay Name@Input TypeGroup
inputText: (payload: string) => void
Input Text
DATA_STRINGAIR_PROPERTY

@Output

@Output & TypeDisplay Name@Output TypeGroup
matchedValue: AirEvent<void>
Matched Value
OPERATOROPERATOR

Translation Operator for Multi-Language Text#

Operator<DocsSdkOperatorsDataProcessingTranslation>: Translates incoming text variables between languages using active translation plugins.

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

DATA_STRING.TRANSLATION
Operator
Operator Type
TRANSLATION
Operator Group
DATA_STRING

Translation Properties Details

Property & TypeDisplay NameSystem TypeDefault
text: string
Text
STRING
TEXT INPUT
""
toLanguage: string
To Language
STRING
DROPDOWN
"SPANISH"
activationType: string
Activated By
STRING
DROPDOWN
"NEW_TEXT"
startActive: boolean
Start Active
BOOL
TOGGLE
true
reverseCharacters: boolean
Reverse Characters
BOOL
TOGGLE
false
useFromLanguage: boolean
Specify Origin Language
BOOL
TOGGLE
false
fromLanguage: string
Origin Language
STRING
DROPDOWN
"ENGLISH"

@Input

@Input & TypeDisplay Name@Input TypeGroup
translate: (payload: string) => void
Translate
DATA_STRINGAIR_PROPERTY
toggleOn: () => void
Toggle On
OPERATOROPERATOR
toggleOff: () => void
Toggle Off
OPERATOROPERATOR

@Output

@Output & TypeDisplay Name@Output TypeGroup
outputText: AirEvent<string>
Output Text
DATA_STRINGAIR_PROPERTY

Transliteration Operator for Script Conversion#

Operator<DocsSdkOperatorsDataProcessingTransliteration>: Converts text from one script system to another (e.g. Cyrillic or Hanzi to Latin alphabets) phonetically.

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

DATA_STRING.TRANSLITERATION
Operator
Operator Type
TRANSLITERATION
Operator Group
DATA_STRING

Transliteration Properties Details

Property & TypeDisplay NameSystem TypeDefault
useFontReference: boolean
Use Font Reference
BOOL
TOGGLE
false
referenceFont: any
Reference Font
NONE
FONT SELECTOR
{fontMediaItemId: 3662a206-5bc6-4de7-b4ac-9cacda5b5f85, variantName: regular}
startActive: boolean
Start Active
BOOL
TOGGLE
true
reverseCharacters: boolean
Reverse Characters
BOOL
TOGGLE
true

@Input

@Input & TypeDisplay Name@Input TypeGroup
inputText: (payload: string) => void
Input Text
DATA_STRINGAIR_PROPERTY
toggleOn: () => void
Toggle On
OPERATOROPERATOR
toggleOff: () => void
Toggle Off
OPERATOROPERATOR

@Output

@Output & TypeDisplay Name@Output TypeGroup
outputText: AirEvent<string>
Output Text
DATA_STRINGAIR_PROPERTY