Ksp reference Manual

Advanced Concepts
195
KSP Reference Manual

---

USE_CODE_IF_NOT()
...
END_USE_CODE

refers to a symbolic name which consists of alphanumeric symbols, preceded by a
letter. You could write for example:
on note
{do something general}
$var := 5
{do some conditional code}
USE_CODE_IF_NOT(dont_do_sequencer)
while ($count > 0)
play_note()
end while
END_USE_CODE
end on
What's happening here?
Only if the symbol 
dont_do_sequencer
is not defined, the code between 
USE_
and 
END_USE
will be processed. If the symbol were to be found, the code would not be passed on to the parser;
it is as if the code was never written. Therefore it does not utilize any CPU power.
You can define symbols with
SET_CONDITION()
and delete the definition with
RESET_CONDITION()
All commands will be interpreted 
before
the script is running, i.e., by using 
USE_CODE_
, the code
might get stalled before it is passed to the script engine. This means, 
SET_CONDITION
and 
RE-
SET_CONDITION
are not actually true commands: they cannot be utilized in 
if()...end if
statements; also a 
wait()
statement before those commands is useless. Each 
SET_CONDITION
and 
RESET_CONDITION
will be executed before something else happens.
All defined symbols are passed on to following scripts, i.e. if script 3 contains conditional code, you
can turn it on or off in script 1 or 2.
You can use conditional code to bypass system scripts. There are two built-in symbols:
NO_SYS_SCRIPT_PEDAL
NO_SYS_SCRIPT_RLS_TRIG
If you define one of those symbols with 
SET_CONDITION()
, the corresponding part of the system
scripts will be bypassed. For clarity reasons, those definitions should always take place in the 
in-
it
callback.
on init
{we want to do our own release triggering}
SET_CONDITION(NO_SYS_SCRIPT_RLS_TRIG)
end on