Ivls¶
ivls
Import¶
import "_IVLS/source/ivls.ksp"Overview¶
ivls
LIBRARY
IVLS engine core and product lifecycle orchestration.
- Imports all standard and custom node modules
- Declares the node registry, global constants, and debug infrastructure
- Primary KSP callbacks: init, persistence_changed, listener, note, release, and others
- Coordinates node initialization, reload, and event dispatch via RUN_CB
API¶
Defines¶
| Name | Description |
|---|---|
define ivls.RELEASE_EXTENSION_TICKS |
Number of ticks added to the release wait to extend voice lifetime past the MIDI... |
define IVLS_ALL_NODES |
Complete node list combining base nodes, product-specific nodes, and the post-li... |
define IVLS_BASE_NODES |
Enumeration of the standard IVLS node set included in every product build. |
Macros¶
| Name | Description |
|---|---|
ivls.Assert(#cond#, #m#) |
Asserts a condition and triggers ivls.Fail if it is false. |
ivls.Fail(#m#) |
Halts the current voice path and prints an error message. |
Functions¶
| Name | Description |
|---|---|
debug(str) |
Prints a prefixed debug message when IVLS_DEBUG is active. |
debug.#name#(str) |
Prints a category-tagged debug message when the named category is active. |
debug.#name#.enable() |
Enables debug output for the named category. |
ivls.lcb_timer_us() -> return |
Returns the LCB timer interval in microseconds. |
Defines¶
define ivls.RELEASE_EXTENSION_TICKS¶
Number of ticks added to the release wait to extend voice lifetime past the MIDI note-off boundary.
define IVLS_ALL_NODES¶
Complete node list combining base nodes, product-specific nodes, and the post-lib entry.
define IVLS_BASE_NODES¶
Enumeration of the standard IVLS node set included in every product build.
Macros¶
ivls.Assert(#cond#, #m#)¶
Asserts a condition and triggers ivls.Fail if it is false.
| Parameter | Description |
|---|---|
#cond# |
Boolean expression to evaluate |
#m# |
Failure message passed to ivls.Fail |
ivls.Fail(#m#)¶
Halts the current voice path and prints an error message.
| Parameter | Description |
|---|---|
#m# |
Error message to display |
Functions¶
debug(str)¶
Prints a prefixed debug message when IVLS_DEBUG is active.
| Parameter | Type | Description |
|---|---|---|
str |
string | Message text to display, prepended with debug.current_prefix |
debug.#name#(str)¶
Prints a category-tagged debug message when the named category is active.
| Parameter | Type | Description |
|---|---|---|
str |
string | Message text to display, tagged with the category name |
debug.#name#.enable()¶
Enables debug output for the named category.
ivls.lcb_timer_us() -> return¶
Returns the LCB timer interval in microseconds.
Returns: return — Timer interval in microseconds (1000 us = 1 ms)
Example¶
// TODO: Add usage example