Converts a pitch bend value in semitones and cents into an f16 bend value.
Err Convert12TET_F16( int32 Semitones, int32 Cents,frac16 *FractionPtr )
This function, whose name reads (convert 12-tone equal-tempered to f16,) converts a pitch bend value expressed in semitones and cents to an f16 bend value. The bend value is used with BendInstrumentPitch()
to bend the instrument's pitch up or down: The value multiplies the frequency of the instrument's output to create a resultant pitch bent up or down by the specified amount.
Note that the semitones and cents values need not both be positive or both be negative. One value can be positive while the other value is negative. For example, -5 semitones and +30 cents bends pitch down by 4 semitones and 70 cents.
Convert12TET_F16()
stores the resultant bend value in FractionPtr.
The function returns 0 if successful or an error code (a negative value) if an error occurs.
Folio call implemented in Audio folio V20.
audio.h
BendInstrumentPitch
()