From 9e39479f55828c9effe4ad82a51962f369f83c7c Mon Sep 17 00:00:00 2001 From: derselbst Date: Fri, 29 Dec 2017 21:57:54 +0100 Subject: [PATCH] update API doc of fluid_synth_[bank|sfont]_select() --- src/synth/fluid_synth.c | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/synth/fluid_synth.c b/src/synth/fluid_synth.c index 7b4f73be..91fb2480 100644 --- a/src/synth/fluid_synth.c +++ b/src/synth/fluid_synth.c @@ -2185,6 +2185,11 @@ fluid_synth_program_change(fluid_synth_t* synth, int chan, int prognum) * @param chan MIDI channel number (0 to MIDI channel count - 1) * @param bank MIDI bank number * @return FLUID_OK on success, FLUID_FAILED otherwise + * @note This function does not change the instrument currently assigned to \c chan, + * as it is usually called prior to fluid_synth_program_change(). If you still want + * instrument changes to take effect immediately, call fluid_synth_program_reset() + * after having set up the bank configuration. + * */ int fluid_synth_bank_select(fluid_synth_t* synth, int chan, unsigned int bank) @@ -2202,6 +2207,10 @@ fluid_synth_bank_select(fluid_synth_t* synth, int chan, unsigned int bank) * @param chan MIDI channel number (0 to MIDI channel count - 1) * @param sfont_id ID of a loaded SoundFont * @return FLUID_OK on success, FLUID_FAILED otherwise + * @note This function does not change the instrument currently assigned to \c chan, + * as it is usually called prior to fluid_synth_bank_select() or fluid_synth_program_change(). + * If you still want instrument changes to take effect immediately, call fluid_synth_program_reset() + * after having selected the soundfont. */ int fluid_synth_sfont_select(fluid_synth_t* synth, int chan, unsigned int sfont_id)