LoadInsTemplate

Loads template for creating instruments.

Synopsis

Item LoadInsTemplate (char *Name, Item AudioDevice)

Description

This function loads an instrument template from the specified file. Note that the function doesn't create an instrument from the instrument template. Call CreateInstrument() to create an Instrument from this Template.

When you finish using the Template, call UnloadInsTemplate() to deallocate the template's resources.

Arguments

Name
Name of the file containing the instrument template (e.g. "directout.dsp").
AudioDevice
Audio device Item for instrument template. 0 indicates the default audio device, the DSP, which is the only valid audio device item at the present time.

Return Value

The function returns a Template item number if successful (a positive value) 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

UnloadInsTemplate(), CreateInsTemplate(), CreateInstrument(), LoadInstrument(), AttachSample(), AttachEnvelope()