Event Trigger¶
Provides the core voice-logic nodes for triggering Kontakt note events from
Import¶
import "_IVLS/std-library/nodes/voice-logics/event-trigger.ksp"Node: Stl.PlayEvent¶
Uses: Init, EventArgs, EventGroups, EventDismiss
Overview¶
Provides the core voice-logic nodes for triggering Kontakt note events from IVLS voice callbacks. Separates the concrete event-firing node (Stl.PlayEvent) from the overridable template (Stl.PlayEvent.Template) so products can inject custom group-filtering and argument setup without replacing the entire trigger mechanism.
Stl.PlayEvent.Template drives the NoteOn/NoteOff lifecycle:
- Fires play_note() with the voice's note, velocity, offset, and duration
- Applies volume/pan/tune from the voice object
- Calls __VIRTUAL__(EventArgs) and __VIRTUAL__(EventGroups) for per-product
customization of event parameters and group-allow-lists
- Registers/deregisters the voice with VMC for sound-voice tracking
- Calls __VIRTUAL__(EventDismiss) on NoteOff before stopping the event
Stl.PlayEvent is the standard concrete implementation that inherits from the
template and initialises the freeze_mod_on_play voice field.
API¶
| Name | Description |
|---|---|
node Stl.PlayEvent from Stl.PlayEvent.Template (Inherits: Stl.PlayEvent.Template) |
Stl.PlayEvent Concrete event-trigger node built on Stl.PlayEvent.Template with f... |
node Stl.PlayEvent.Template |
Stl.PlayEvent.Template Abstract base node implementing the NoteOn/NoteOff Kontak... |
Nodes¶
node Stl.PlayEvent from Stl.PlayEvent.Template¶
Inherits from: Stl.PlayEvent.Template
Callbacks: Init, EventArgs, EventGroups, EventDismiss
Init voice fields:
| Field | Default | Condition |
|---|---|---|
freeze_mod_on_play |
FALSE |
(in_range(freeze_mod_on_play, 0, 1)) |
Stl.PlayEvent Concrete event-trigger node built on Stl.PlayEvent.Template with freeze_mod_on_play support.
node Stl.PlayEvent.Template¶
Callbacks: NoteOn, NoteOff
Stl.PlayEvent.Template Abstract base node implementing the NoteOn/NoteOff Kontakt event-trigger lifecycle.
Example¶
// TODO: Add usage example