zdoom/fluidsynth
0
0
Fork 0
mirror of https://github.com/ZDoom/fluidsynth.git synced 2024-12-11 21:31:18 +00:00
Code Issues Projects Releases Packages Wiki Activity

add documentation to new fluid_player getters

Browse source
This commit is contained in:
Tom M 2017-08-16 09:37:35 +02:00 committed by GitHub
parent da1b95cb19
commit 27c347a28d
1 changed files with 30 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
fluidsynth/src/midi/fluid_midi.c
View file

@ -1785,33 +1785,55 @@ fluid_player_join(fluid_player_t *player)
return FLUID_OK; return FLUID_OK;
} }
/**
int fluid_player_get_current_tick( fluid_player_t * player ) * Get the number of tempo ticks passed.
* @param player MIDI player instance
* @return The number of tempo ticks passed
* @since 1.1.7
*/
int fluid_player_get_current_tick(fluid_player_t * player)
{ {
return player->cur_ticks; return player->cur_ticks;
} }
int fluid_player_get_total_ticks( fluid_player_t * player ) /**
* Looks through all available MIDI tracks and gets the absolute tick of the very last event to play.
* @param player MIDI player instance
* @return Total tick count of the sequence
* @since 1.1.7
*/
int fluid_player_get_total_ticks(fluid_player_t * player)
{ {
int i; int i;
int maxTicks = 0; int maxTicks = 0;
for (i = 0; i < player->ntracks; i++) { for (i = 0; i < player->ntracks; i++) {
if (player->track[i] != NULL) { if (player->track[i] != NULL) {
int ticks = fluid_track_get_duration( player->track[i] ); int ticks = fluid_track_get_duration(player->track[i]);
if( ticks > maxTicks ) if( ticks > maxTicks )
maxTicks = ticks; maxTicks = ticks;
} }
} }
return maxTicks; return maxTicks;
} }
int fluid_player_get_bpm( fluid_player_t * player ) /**
* Get the tempo of a MIDI player in beats per minute.
* @param player MIDI player instance
* @return MIDI player tempo in BPM
* @since 1.1.7
*/
int fluid_player_get_bpm(fluid_player_t * player)
{ {
return (int)( 60e6 / player->miditempo ); return (int)(60e6 / player->miditempo);
} }
int fluid_player_get_midi_tempo( fluid_player_t * player ) /**
* Get the tempo of a MIDI player.
* @param player MIDI player instance
* @return Tempo of the MIDI player (in microseconds per quarter note, as per MIDI file spec)
* @since 1.1.7
*/
int fluid_player_get_midi_tempo(fluid_player_t * player)
{ {
return player->miditempo; return player->miditempo;
} }