Ksp reference Manual

8.4. change_tune()
change_tune(ber>
,

,
bit>)
Change the tuning of a specific note
event in millicent.

The ID number of the note event to be changed.

The tune amount in millicents. 100000 equals 100 cent, i.e. a half tone.

If the relative bit is set to 
0
, the amount is 
absolute
, i.e. the amount overwrites
any previous set values of that event.
If it is set to 
1
, the amount is 
relative
to the actual value of the event.
The different implications are only relevant with more than one
change_tune()
statement applied to the same event.
Remarks
•
change_tune()
works on a note event level and does not change any tune settings in the
instrument itself. It is also not related to any modulations regarding tuning.
Examples
on init
declare $tune_amount
end on
Event Commands
56
KSP Reference Manual

---

on note
$tune_amount := random(-50000,50000)
change_tune ($EVENT_ID,$tune_amount,1)
end on
Randomly detune each note by ± 50 cent
See Also
change_vol()
change_pan()