TuneInstrument

Applies the specified tuning to an instrument.

Synopsis

Err TuneInstrument( Item Instrument, Item Tuning )

Description

This function applies the specified tuning (created using CreateTuning()) to an instrument so that notes played on the instrument use that tuning. If no tuning is specified, the default 12-tone equal-tempered tuning is used.

Arguments

Instrument
The item number of the instrument.
Tuning
The item number of the tuning.

Return Value

The function returns 0 if successful or an error code (a negative value) if an error occurs.

Implementation

SWI implemented in Audio folio V20.

Associated Files

audio.h

See Also

CreateTuning(), TuneInsTemplate(), DeleteTuning()