# 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()`