CreateTuning
Creates a tuning item.
Synopsis
Item CreateTuning( ufrac16 *Frequencies, int32 NumNotes,int32 NotesPerOctave, int32 BaseNote )
Description
This function creates a tuning item that can be used to tune an instrument.
NotesPerOctave is set to 12 for a standard western tuning system. For every octave's number of notes up or down, the frequency will be doubled or halved. You can thus specify 12 notes of a 12-tone scale, then extrapolate up or down for the other octaves. You should specify the entire range of pitches if the tuning does not repeat itself every octave. For more information, see the Music Programmer's Guide.
When you are finished with the tuning item, you should call DeleteTuning() to deallocate the resources.
Arguments
- Frequencies
- A pointer to an array of 16.16 frequencies, which lists a tuning pattern.
- NumNotes
- The number of frequencies in the array.
- NotesPerOctave
- The number of notes in an octave (12 in a standard tuning scale).
- BaseNote
- The MIDI pitch (note) value of the first frequency in the array. If your array starts with the frequency of middle C, its MIDI
- pitch value would equal 60.
Return Value
The function returns the item number for the tuning or an error code (a negative value) if an error occurs.
Implementation
Folio call implemented in Audio folio V20.
Associated Files
audio.h
See Also
DeleteTuning(), TuneInsTemplate(), TuneInstrument()