Ksp reference Manual

General Commands
53
KSP Reference Manual

---

8. EVENT COMMANDS
8.1. by_marks()
by_marks()
A user defined group of events (or event IDs)
Remarks
by_marks()
is a user defined group of events which can be set with 
set_event_mark()
. It can
be used with all commands which utilize event IDs like 
note_off()
, 
change_tune()
etc.
Examples
on note
if ($EVENT_NOTE mod 12 = 0) {if played note is a c}
set_event_mark($EVENT_ID,$MARK_1)
change_tune(by_marks($MARK_1),%CC[1]*1000,0)
end if
end on
on controller
if($CC_NUM = 1)
change_tune(by_marks($MARK_1),%CC[1]*1000,0)
end if
end on
Moving the mod wheel changes the tuning of all c's (C-2, C-1…C8)
See Also 
set_event_mark()
$EVENT_ID
$ALL_EVENTS
$MARK_1 … $MARK_28
8.2. change_note()
change_note(
,
)
Change the note number of a specific note event
Remarks
•
Change_note()
is only allowed in the note callback and only works before the first 
wait()
statement. If the voice is already running, only the value of the variable changes.
Event Commands
54
KSP Reference Manual

---

• Once the note number of a particular note event is changed, it becomes the new
$EVENT_NOTE
• It is not possible to address events via event groups like 
$ALL_EVENTS
Examples
on init
declare %black_keys[5] := (1,3,6,8,10)
end on
on note
if (search(%black_keys,$EVENT_NOTE mod 12) # -1)
change_note($EVENT_ID,$EVENT_NOTE-1)
end if
end on
Constrain all notes to white keys, i.e. C major
See Also 
$EVENT_NOTE
change_velo()