class OSC_SFManager

This class is a wrapper class for the SoundFont Management System

Public Methods

OSC_SFManager()

virtual ~OSC_SFManager()

OSC_ERR Init()

Initialize the SoundFont Manager. Must be called before any of the other functions.

bool SFManError()

Returns true if the last SFMS API call returned an error.

std::string GetLastSFManErrorText()

Returns a textual description of the last SFMS error

int GetNumDevs()

Returns the number of SoundFont compatible devices installed in the system

OSC_ERR GetListOfDevices(OSC_StringArray &list, bool includeDeviceNumber = false)

Get a list of SoundFont compatible devices

bool IsDeviceFree(int deviceno)

Returns true if the specified device is free (and can be opened)

OSC_ERR Open(int deviceno)

Open the specified device. This must be done before calling any of the functions below.

OSC_ERR Close()

Close the specified device. This should be done when you're done using the device, letting other applications access the device again.

int GetCurrentOpenDevice()

Get the device number for the current open device

bool IsDeviceOpen()

Has a device been opened (is this object an open device)

OSC_ERR LoadBank(int bankno, const std::string &path)

Load a SoundFont (from disk) into a bank (in memory accessible by the SoundFont device)

OSC_ERR ClearLoadedBank(int bankno)

Clear a loaded bank (remove SoundFont from memory)

OSC_ERR ClearAllLoadedBanks(bool alsoBank0 = false)

Clear all loaded banks (frees all the memory) except the synthesizer bank (GM/GS)

int IsMIDIBankUsed(int bankno)

This function is used to check if a particular bank is in use

bool BoolIsMIDIBankUsed(int bankno)

A simplified version of IsMIDIBank used(

OSC_ERR LoadPreset(int sourceBankno, int sourcePreset, int destBankno, int destPreset, const std::string &path)

Load a preset in a SoundFont on disk into a preset in a bank

OSC_ERR ClearLoadedPreset(int bankno, int preset)

Clear a loaded preset

OSC_ERR LoadWaveform(int destBankno, int destPreset, const std::string &path)

Load a waveform on disk into a preset in a bank

OSC_ERR ClearLoadedWaveform(int bankno, int preset)

Clear a loaded waveform

OSC_ERR GetLoadedBankDescriptor(int bankno, std::string &desc)

Get the name of the SoundFont in specified bank (as specified inside the SoundFont file by the author)

OSC_ERR GetLoadedBankPathname(int bankno, std::string &path)

Get the path to the SoundFont in the specified bank

OSC_ERR GetLoadedPresetDescriptor(int bankno, int presetno, std::string &desc)

Get the name of the specified preset of the SoundFont in the specified bank

OSC_ERR GetDevCaps(int deviceno, PSFCAPSOBJECT pCaps)

Get the capabilities of the specified device (you don't have to open the device first)

OSC_ERR GetDevCaps(PSFCAPSOBJECT pCaps)

Get the capabilities of the current open device (see SFMS sdk doc for details)

OSC_ERR GetDevName(int deviceno, std:: string &name)

Get the name of the speified device (you don't have to open the device first)

OSC_ERR GetDevName(std::string &name)

Get the name of the current open device

OSC_ERR GetDevNo(const std::string &name, int &deviceno)

Get the device number of the specified device (name)

OSC_ERR QueryStaticSampleMemorySize(int &maxmem, int & availmem)

Get the maximum amount of memory and the available memory for the current open device

OSC_ERR GetAllSynthEmulations(OSC_StringArray &list)

Get a list of supported synthesizer emulations

OSC_ERR GetSynthEmulation(int &index, std::string &name)

Get the name and index of the current synthesizer emulation

OSC_ERR SelectSynthEmulation(int index)

Select the new current synthesizer emulation

int GetNumSynthEmulations()

OSC_ERR GetSynthEmulationDescription(int index, std::string &name)

OSC_SFManager()

virtual ~OSC_SFManager()

OSC_ERR Init()

Initialize the SoundFont Manager. Must be called before any of the other functions.

bool SFManError()

Returns true if the last SFMS API call returned an error.

std::string GetLastSFManErrorText()

Returns a textual description of the last SFMS error

int GetNumDevs()

Returns the number of SoundFont compatible devices installed in the system

OSC_ERR GetListOfDevices(OSC_StringArray &list, bool includeDeviceNumber = false)

Get a list of SoundFont compatible devices

bool IsDeviceFree(int deviceno)

Returns true if the specified device is free (and can be opened)

OSC_ERR Open(int deviceno)

Open the specified device. This must be done before calling any of the functions below.

OSC_ERR Close()

Close the specified device. This should be done when you're done using the device, letting other applications access the device again.

int GetCurrentOpenDevice()

Get the device number for the current open device

bool IsDeviceOpen()

Has a device been opened (is this object an open device)

OSC_ERR LoadBank(int bankno, const std::string &path)

Load a SoundFont (from disk) into a bank (in memory accessible by the SoundFont device)

OSC_ERR ClearLoadedBank(int bankno)

Clear a loaded bank (remove SoundFont from memory)

OSC_ERR ClearAllLoadedBanks(bool alsoBank0 = false)

Clear all loaded banks (frees all the memory) except the synthesizer bank (GM/GS)

int IsMIDIBankUsed(int bankno)

This function is used to check if a particular bank is in use. If the bank is in use, the function will return the number of the bank that owns the specified bank. If the bank is not in use, the function will return -1.

bool BoolIsMIDIBankUsed(int bankno)

A simplified version of IsMIDIBank used(...) that returns true if the specified bank is in use and it is 'owned' by itself. In other words, if a SoundFont has been loaded specifically into this bank, and the bank is not owned by another bank.

OSC_ERR LoadPreset(int sourceBankno, int sourcePreset, int destBankno, int destPreset, const std::string &path)

Load a preset in a SoundFont on disk into a preset in a bank

OSC_ERR ClearLoadedPreset(int bankno, int preset)

Clear a loaded preset

OSC_ERR LoadWaveform(int destBankno, int destPreset, const std::string &path)

Load a waveform on disk into a preset in a bank

OSC_ERR ClearLoadedWaveform(int bankno, int preset)

Clear a loaded waveform

OSC_ERR GetLoadedBankDescriptor(int bankno, std::string &desc)

Get the name of the SoundFont in specified bank (as specified inside the SoundFont file by the author)

OSC_ERR GetLoadedBankPathname(int bankno, std::string &path)

Get the path to the SoundFont in the specified bank

OSC_ERR GetLoadedPresetDescriptor(int bankno, int presetno, std::string &desc)

Get the name of the specified preset of the SoundFont in the specified bank

OSC_ERR GetDevCaps(int deviceno, PSFCAPSOBJECT pCaps)

Get the capabilities of the specified device (you don't have to open the device first)

OSC_ERR GetDevCaps(PSFCAPSOBJECT pCaps)

Get the capabilities of the current open device (see SFMS sdk doc for details)

OSC_ERR GetDevName(int deviceno, std:: string &name)

Get the name of the speified device (you don't have to open the device first)

OSC_ERR GetDevName(std::string &name)

Get the name of the current open device

OSC_ERR GetDevNo(const std::string &name, int &deviceno)

Get the device number of the specified device (name)

OSC_ERR QueryStaticSampleMemorySize(int &maxmem, int & availmem)

Get the maximum amount of memory and the available memory for the current open device

OSC_ERR GetAllSynthEmulations(OSC_StringArray &list)

Get a list of supported synthesizer emulations

OSC_ERR GetSynthEmulation(int &index, std::string &name)

Get the name and index of the current synthesizer emulation

OSC_ERR SelectSynthEmulation(int index)

Select the new current synthesizer emulation

int GetNumSynthEmulations()

OSC_ERR GetSynthEmulationDescription(int index, std::string &name)

alphabetic index hierarchy of classes

generated by doc++