KMidSimpleAPI Class Reference
Simple API covering most of the uses of libkmid. A very simple API around the rest of libkmid. More...
#include <libkmid.h>
Static Public Member Functions | |
int | kMidInit (void) |
Initializes libkmid. | |
int | kMidLoad (const char *filename) |
Loads a song that will be played with the next call to kMidPlay(). | |
int | kMidPlay (int loop=0) |
Plays the song currently loaded with kMidLoad(). | |
int | kMidStop (void) |
Stops playing a song inmediatly. | |
void | kMidDestruct (void) |
Releases the memory allocated by libkmid. | |
int | kMidIsPlaying (void) |
Returns 1 if the library is playing a song, and 0 if it's not. | |
int | kMidDevices (void) |
Returns the number of MIDI devices ( MIDI ports + synthesizers ). | |
const char * | kMidName (int i) |
Returns the name of the i-th device . | |
const char * | kMidType (int i) |
Returns the type of the i-th device . | |
void | kMidSetDevice (int i) |
Sets the MIDI device to use when playing a song. | |
void | kMidSetMidiMapper (const char *mapfilename) |
Sets the Midi Mapper to use. | |
const char * | kMidVersion (void) |
Returns the version number of libkmid, i.e. | |
const char * | kMidCopyright (void) |
Returns the copyright notice that applications using libkmid should print to the user in an about box or somewhere visible. |
Detailed Description
Simple API covering most of the uses of libkmid. A very simple API around the rest of libkmid.You can use the members of this class in pure C applications, just by using the same name as the corresponding function member.
Suppose you're developing a game and you want to play some background music while the user is playing. You only have to call :
When the user decides to quit the game, use
- kMidStop();
- kMidDestruct();
- Version:
- 0.9.5 17/01/2000
- Author:
- Antonio Larrosa Jimenez <larrosa@kde.org>
Definition at line 54 of file libkmid.h.
Member Function Documentation
|
Initializes libkmid. Creates the DeviceManager object, and initializes some variables that will be used later.
Definition at line 42 of file libkmid.cc. |
|
Loads a song that will be played with the next call to kMidPlay().
Definition at line 78 of file libkmid.cc. References kMidDevices(). |
|
Plays the song currently loaded with kMidLoad(). kMidPlay forks in order to play the song in a different process, it exits inmediately, so that the application can follow the normal execution flow while the sone is played. If loop is 0 the song is played once and then the child process finishes. If loop is 1, the song is played repeatedly until kMidStop() is called. You can call kMidStop() anytime you want (also if loop is 0) to stop the song and kill the child process.
Definition at line 84 of file libkmid.cc. References kMidDevices(). |
|
Stops playing a song inmediatly. It doesn't return until the child process that is playing the song is terminated.
Definition at line 123 of file libkmid.cc. References kMidDevices(). |
|
Releases the memory allocated by libkmid. To continue playing, you must first make a(nother) call to kMidInit(). Definition at line 138 of file libkmid.cc. |
|
Returns 1 if the library is playing a song, and 0 if it's not.
Definition at line 149 of file libkmid.cc. |
|
Returns the number of MIDI devices ( MIDI ports + synthesizers ).
Definition at line 154 of file libkmid.cc. Referenced by kMidLoad(), kMidPlay(), kMidSetMidiMapper(), and kMidStop(). |
|
Returns the name of the i-th device . In case libkmid wasn't yet initialized ( see kMidInit() ), the return value is NULL, and in case the parameter has a value out of the valid range ( see kMidDevices() ) it returns an empty string.
Definition at line 159 of file libkmid.cc. |
|
Returns the type of the i-th device . In case libkmid wasn't yet initialized ( see kMidInit() ), the return value is NULL, and in case the parameter has a value out of the valid range ( see kMidDevices() ) it returns an empty string.
Definition at line 164 of file libkmid.cc. |
|
Sets the MIDI device to use when playing a song.
Definition at line 169 of file libkmid.cc. |
|
Sets the Midi Mapper to use. Most of the users won't need a midi mapper, but there're still non-General Midi synthesizers out there, and people with one of those will get much better sound quality by using a MIDI mapper. Please have a look at KMid's documentation for more information about MIDI mappers and how to write a MIDI mapper for your keyboard. Definition at line 174 of file libkmid.cc. References kMidDevices(). |
|
Returns the version number of libkmid, i.e. "0.9.5" or "1.0 Beta" Definition at line 182 of file libkmid.cc. |
|
Returns the copyright notice that applications using libkmid should print to the user in an about box or somewhere visible. I.e. "LibKMid 0.9.5 (C) 1997-2000 Antonio Larrosa Jimenez <larrosa@kde.org>. Spain" Definition at line 187 of file libkmid.cc. |
The documentation for this class was generated from the following files: