93 lines
4.0 KiB
C
93 lines
4.0 KiB
C
/* FluidSynth - A Software Synthesizer
|
|
*
|
|
* Copyright (C) 2003 Peter Hanappe and others.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public License
|
|
* as published by the Free Software Foundation; either version 2.1 of
|
|
* the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free
|
|
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
* 02110-1301, USA
|
|
*/
|
|
|
|
#ifndef _FLUIDSYNTH_SEQ_H
|
|
#define _FLUIDSYNTH_SEQ_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @defgroup sequencer MIDI Sequencer
|
|
*
|
|
* MIDI event sequencer.
|
|
*
|
|
* The MIDI sequencer can be used to play MIDI events in a more flexible way than
|
|
* using the MIDI file player, which expects the events to be stored as
|
|
* Standard MIDI Files. Using the sequencer, you can provide the events one by
|
|
* one, with an optional timestamp for scheduling.
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Event callback prototype for destination clients.
|
|
*
|
|
* @param time Current sequencer tick value (see fluid_sequencer_get_tick()).
|
|
* @param event The event being received
|
|
* @param seq The sequencer instance
|
|
* @param data User defined data registered with the client
|
|
*
|
|
* @note @p time may not be of the same tick value as the scheduled event! In fact, depending on
|
|
* the sequencer's scale and the synth's sample-rate, @p time may a few ticks too late. Although this
|
|
* itself is inaudible, it is important to consider,
|
|
* when you use this callback for enqueuing additional events over and over again with
|
|
* fluid_sequencer_send_at(): If you enqueue new events with a relative tick value you might introduce
|
|
* a timing error, which causes your sequence to sound e.g. slower than it's supposed to be. If this is
|
|
* your use-case, make sure to enqueue events with an absolute tick value.
|
|
*/
|
|
typedef void (*fluid_event_callback_t)(unsigned int time, fluid_event_t *event,
|
|
fluid_sequencer_t *seq, void *data);
|
|
|
|
|
|
/** @startlifecycle{MIDI Sequencer} */
|
|
FLUID_DEPRECATED FLUIDSYNTH_API fluid_sequencer_t *new_fluid_sequencer(void);
|
|
FLUIDSYNTH_API fluid_sequencer_t *new_fluid_sequencer2(int use_system_timer);
|
|
FLUIDSYNTH_API void delete_fluid_sequencer(fluid_sequencer_t *seq);
|
|
/** @endlifecycle */
|
|
|
|
FLUIDSYNTH_API int fluid_sequencer_get_use_system_timer(fluid_sequencer_t *seq);
|
|
FLUIDSYNTH_API
|
|
fluid_seq_id_t fluid_sequencer_register_client(fluid_sequencer_t *seq, const char *name,
|
|
fluid_event_callback_t callback, void *data);
|
|
FLUIDSYNTH_API void fluid_sequencer_unregister_client(fluid_sequencer_t *seq, fluid_seq_id_t id);
|
|
FLUIDSYNTH_API int fluid_sequencer_count_clients(fluid_sequencer_t *seq);
|
|
FLUIDSYNTH_API fluid_seq_id_t fluid_sequencer_get_client_id(fluid_sequencer_t *seq, int index);
|
|
FLUIDSYNTH_API char *fluid_sequencer_get_client_name(fluid_sequencer_t *seq, fluid_seq_id_t id);
|
|
FLUIDSYNTH_API int fluid_sequencer_client_is_dest(fluid_sequencer_t *seq, fluid_seq_id_t id);
|
|
FLUIDSYNTH_API void fluid_sequencer_process(fluid_sequencer_t *seq, unsigned int msec);
|
|
FLUIDSYNTH_API void fluid_sequencer_send_now(fluid_sequencer_t *seq, fluid_event_t *evt);
|
|
FLUIDSYNTH_API
|
|
int fluid_sequencer_send_at(fluid_sequencer_t *seq, fluid_event_t *evt,
|
|
unsigned int time, int absolute);
|
|
FLUIDSYNTH_API
|
|
void fluid_sequencer_remove_events(fluid_sequencer_t *seq, fluid_seq_id_t source, fluid_seq_id_t dest, int type);
|
|
FLUIDSYNTH_API unsigned int fluid_sequencer_get_tick(fluid_sequencer_t *seq);
|
|
FLUIDSYNTH_API void fluid_sequencer_set_time_scale(fluid_sequencer_t *seq, double scale);
|
|
FLUIDSYNTH_API double fluid_sequencer_get_time_scale(fluid_sequencer_t *seq);
|
|
/* @} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _FLUIDSYNTH_SEQ_H */
|