SonoraFX - Expressions Guide

1. Trigger Event Readers

These expressions read parameters from the current active trigger event. Use them inside your Command Bridge event rules!

• TriggeredChannel("SonoraFX"): Returns the channel ID (1..48) that fired the current trigger.
• GetPlaySoundName$("SonoraFX", Channel): Returns the sound file name or sample string requested for the channel.
• TriggeredVolume("SonoraFX"): Returns the target volume (0..100) computed by LFOs or envelopes.
• TriggeredFrequency("SonoraFX"): Returns the computed frequency/pitch Hz (including sweeps and LFOs).
• TriggeredPan("SonoraFX"): Returns the computed stereo pan (-100..100).
• TriggeredPosition("SonoraFX"): Returns the playback position in milliseconds.
• TriggeredLoops("SonoraFX"): Returns the loop count parameter.

2. Channel State Inspectors

• GetPlayState("SonoraFX", Channel): Returns channel status: 1 = Playing, 2 = Paused, 3 = Stopped.
• GetFreqOrigin("SonoraFX", Channel): Returns the original baseline sampling rate (e.g., 44100 Hz) stored for the channel.
• GetTriggeredFreqOrigin("SonoraFX"): Returns the original frequency of the channel that fired the active trigger.
• GetFreqOriginPct("SonoraFX", Channel, Percentage): Calculates a safe target pitch frequency as a percentage of the original sample rate (e.g., 400% = 4x pitch up, guarding against 0 Hz reset crashes).
• GetCustomTimer("SonoraFX"): Returns the high-precision internal C++ runtime timer in seconds.