Skip to content

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

See Also