|
|
The class represents a Cakewalk .ins file.
It provides a mechanism for listing all instruments provided by a particular .ins file, and for creating an Instrument object from it.
The .ins file format is not documented. However, the documentation that ships with the TSE3 library contains a description of this format.
See also: Instrument
CakewalkInstrumentFile (const std::string &filename)
| CakewalkInstrumentFile |
Create an object for the given file.
Parameters:
filename | The name of the Cakewalk .ins file |
const std::list | instruments |
Returns a set of the instrument titles in the .ins file.
The first time you call this method, the file will be searched. Whilst this is being done you can be informted of progress via the TSE3::Progress interface.
Parameters:
progress | TSE3::Progess callback, or zero for no callback |
Returns: List of instrument titles in the .ins file
Instrument * instrument (const std::string &title,
TSE3::Progress *progress = 0)
| instrument |
Factory method that creates an Instrument object for the given instrument title from this CakewalkInstrumentFile.
You can supply a TSE3::Progess interface to be informed of progress.
Parameters:
title | The title of the instrument to create |
progress | TSE3::Progess callback, or zero for no callback |
Returns: New instrument object - you must delete this object