Miles Sound System SDK 7.2a

AIL_set_GTL_filename_prefix

The function AIL_set_GTL_filename_prefix informs MSS of the prefix portion of all Global Timbre Library filenames which are associated with a particular application.

void AIL_set_GTL_filename_prefix(
  char const * prefix
);

In Parameters

prefix: points to a valid DOS filename prefix.

Discussion

Global Timbre Library files contain instruments for MSS 2.X-generation synthesizer drivers such as those for the Yamaha OPL2- and OPL3- based boards, and the Roland MT-32.

By default, the AIL_install_MDI_driver_file and AIL_install_MDI_driver_image functions will assume that all Global Timbre Library filenames begin with the DOS prefix "FATMAN". This prefix is combined with the driver-specific GTL suffix, such as ".AD" for the 2-operator Ad Lib OPL2-type drivers, to yield the complete filename under which the driver expects to find a GTL file containing instrument definitions for the application. This function must be called before installing the .MDI driver or drivers, to declare a different GTL filename prefix.

One use for this feature might be for programs which use custom Yamaha and/or MT-32 GTL files. For example, if you're custom patches were called "CUSTOM.AD" and "CUSTOM.OPL", then simply add a call such as AIL_set_GTL_filename_prefix("CUSTOM") before calling AIL_install_MDI_driver_file or AIL_install_MDI_driver_image.

MSS 2.X-compatible Global Timbre Library files are loaded by the driver from the current working directory at the time AIL_init_sequence or AIL_install_timbre is called. If this is undesirable, the AIL_set_redist_directory function may be used to specify a DOS directory path to be used as part of the timbre filename prefix string.

Drivers for later devices such as the Gravis UltraSound card use proprietary instrument libraries rather than GTL files. Other drivers, such as the MPU401 General MIDI driver MPU401.MDI, do not make any provisions for instrument loading at all. AIL_set_GTL_filename_prefix will have no effect when either of these driver types are installed.

The current version of the Windows and MacOS system does not support custom MIDI instruments. The default MIDI instrument set used by the selected midiOut driver will be used instead.

Group: XMIDI Services
Related Functions: AIL_init_sequence, AIL_install_MDI_driver_file, AIL_install_MDI_driver_image, AIL_install_timbre, AIL_set_GTL_filename_prefix, AIL_set_redist_directory
Related Basic Types: char const *, void