The Kyma Language for Sound Design, Version 4.5

Booleans
The real-time evaluator can perform all of the standard comparison operators. They return 0 for false and
1 for true.
Message Example Result
ne: (not equal) 3 ne: 2, 3 ne: 3 1, 0
eq: (equal) 3 eq: 2, 3 eq: 3 0, 1
gt: (greater than) 3 gt: 2, 3 gt: 3 1, 0
lt: (less than) 3 lt: 2, 3 lt: 3 0, 0
ge: (greater or equal) 3 ge: 2, 3 ge: 3 1, 1
le: (less or equal) 3 le: 2, 3 le: 3 0, 1
Conditionals
neg:zero:pos: takes on one of three values, depending upon the value of the message receiver. All
expressions are evaluated, but only one of the results is used, depending on whether the first expression
has a negative, zero, or positive value. neg:zero:pos:initially: is the same as neg:zero:pos:
except that you can specify the initial value of the entire expression. In neg:zero:pos:, the initial value
of the entire expression is always 0. The expression takes on the initial value only for as long as the message
receiver does not yet have a value (e.g. if it depends on an event that has not yet occurred).
true:false: or false:true: does conditional evaluation of either the true argument or the false argument
depending upon the value of a test expression. It evaluates only one, not both of the true and
false arguments. For this conditional, true is considered to be any positive number, false is any zero or
negative number.
Message Example Result
neg:zero:pos: -1 neg: 4 zero: 3 pos: 2 4
neg:zero:pos:initially: 1 neg: 4 zero: 3 pos: 2 initially: 8 2
true:false: 0 true: 3 false: 2, 0.5 true: 5 false: 6 2, 5
false:true -2 false: 0 true: 100, 10 false: 40 true: 60 0, 60
Conversions
Kyma considers positive numbers as boolean true values and zero or negative numbers as boolean false
values. asLogicValue maps all true values to 1 and all false values to 0.
You can use db to convert a decibel value into its linear equivalent. 0 db is equal to 1 or full amplitude,
and increases of 6 db double the amplitude, and decreases of 6 db halve the amplitude.
inSOSPitch converts a frequency in hertz or pitch in note numbers to a pitch in the same format and
range as the output of the spectral sources (e.g. SpectrumInRAM, SyntheticSpectrumFromArray, etc.).
These pitches map the range from 0 hz through 22050 hz to a log curve drawn between 0 and 1. Every
doubling of the frequency in hertz corresponds to adding 1/15 to the number in SOS pitch, so at 22050 hz,
the SOS pitch is 1, at 11025 hz it is 1-(1/15), and so on.
Message Example Result
asLogicValue -2 asLogicValue, 0 asLogicValue, 3 asLogicValue 0, 0, 1
db 0 db, 6 db, -6 db, -12 db 1.0, 1.99, 0.5, 0.25
inSOSPitch 22050.0 hz inSOSPitch, 1378.12 hz inSOSPitch 1.0d, 0.73
478