开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 多媒体 > midi > 查看源码
synth.h
资源名称：trunk-r284.zip　[点击查看]
上传用户：tjmskj2
上传日期：2020-08-17
资源大小：577k
文件大小：14k
源码类别：

midi

开发平台：

C/C++

synth.h：源码内容
  1. /* FluidSynth - A Software Synthesizer
  2.  *
  3.  * Copyright (C) 2003  Peter Hanappe and others.
  4.  *
  5.  * This library is free software; you can redistribute it and/or
  6.  * modify it under the terms of the GNU Library General Public License
  7.  * as published by the Free Software Foundation; either version 2 of
  8.  * the License, or (at your option) any later version.
  9.  *
  10.  * This library is distributed in the hope that it will be useful, but
  11.  * WITHOUT ANY WARRANTY; without even the implied warranty of
  12.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13.  * Library General Public License for more details.
  14.  *  
  15.  * You should have received a copy of the GNU Library General Public
  16.  * License along with this library; if not, write to the Free
  17.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  18.  * 02111-1307, USA
  19.  */
  21. #ifndef _FLUIDSYNTH_SYNTH_H
  22. #define _FLUIDSYNTH_SYNTH_H
  25. #ifdef __cplusplus
  26. extern "C" {
  27. #endif
  30. /**
  31.  * @file synth.h
  32.  * @brief Embeddable SoundFont synthesizer
  33.  *  
  34.  * You create a new synthesizer with new_fluid_synth() and you destroy
  35.  * if with delete_fluid_synth(). Use the settings structure to specify
  36.  * the synthesizer characteristics. 
  37.  *
  38.  * You have to load a SoundFont in order to hear any sound. For that
  39.  * you use the fluid_synth_sfload() function.
  40.  *
  41.  * You can use the audio driver functions described below to open
  42.  * the audio device and create a background audio thread.
  43.  *  
  44.  * The API for sending MIDI events is probably what you expect:
  45.  * fluid_synth_noteon(), fluid_synth_noteoff(), ...
  46.  */
  48. #define FLUID_SYNTH_CHANNEL_INFO_NAME_SIZE   32    /**< Length of channel info name field (including zero terminator) */
  50. /**
  51.  * Channel information structure for fluid_synth_get_channel_info().
  52.  * @since 1.1.1
  53.  */
  54. struct _fluid_synth_channel_info_t
  55. {
  56.   int assigned : 1;     /**< TRUE if a preset is assigned, FALSE otherwise */
  57.   /* Reserved flag bits (at the least 31) */
  58.   int sfont_id;         /**< ID of parent SoundFont */
  59.   int bank;             /**< MIDI bank number (0-16383) */
  60.   int program;          /**< MIDI program number (0-127) */
  61.   char name[FLUID_SYNTH_CHANNEL_INFO_NAME_SIZE];     /**< Channel preset name */
  62.   char reserved[32];    /**< Reserved data for future expansion */
  63. };
  65. FLUIDSYNTH_API fluid_synth_t* new_fluid_synth(fluid_settings_t* settings);
  66. FLUIDSYNTH_API int delete_fluid_synth(fluid_synth_t* synth);
  67. FLUIDSYNTH_API fluid_settings_t* fluid_synth_get_settings(fluid_synth_t* synth);
  70. /* MIDI channel messages */
  72. FLUIDSYNTH_API int fluid_synth_noteon(fluid_synth_t* synth, int chan, int key, int vel);
  73. FLUIDSYNTH_API int fluid_synth_noteoff(fluid_synth_t* synth, int chan, int key);
  74. FLUIDSYNTH_API int fluid_synth_cc(fluid_synth_t* synth, int chan, int ctrl, int val);
  75. FLUIDSYNTH_API int fluid_synth_get_cc(fluid_synth_t* synth, int chan, int ctrl, int* pval);
  76. FLUIDSYNTH_API int fluid_synth_sysex(fluid_synth_t *synth, const char *data, int len,
  77.                                      char *response, int *response_len, int *handled, int dryrun);
  78. FLUIDSYNTH_API int fluid_synth_pitch_bend(fluid_synth_t* synth, int chan, int val);
  79. FLUIDSYNTH_API int fluid_synth_get_pitch_bend(fluid_synth_t* synth, int chan, int* ppitch_bend);
  80. FLUIDSYNTH_API int fluid_synth_pitch_wheel_sens(fluid_synth_t* synth, int chan, int val);
  81. FLUIDSYNTH_API int fluid_synth_get_pitch_wheel_sens(fluid_synth_t* synth, int chan, int* pval);
  82. FLUIDSYNTH_API int fluid_synth_program_change(fluid_synth_t* synth, int chan, int program);
  83. FLUIDSYNTH_API int fluid_synth_channel_pressure(fluid_synth_t* synth, int chan, int val);
  84. FLUIDSYNTH_API int fluid_synth_bank_select(fluid_synth_t* synth, int chan, unsigned int bank);
  85. FLUIDSYNTH_API int fluid_synth_sfont_select(fluid_synth_t* synth, int chan, unsigned int sfont_id);
  86. FLUIDSYNTH_API
  87. int fluid_synth_program_select(fluid_synth_t* synth, int chan, unsigned int sfont_id,
  88.                                unsigned int bank_num, unsigned int preset_num);
  89. FLUIDSYNTH_API int
  90. fluid_synth_program_select_by_sfont_name (fluid_synth_t* synth, int chan,
  91.                                           const char *sfont_name, unsigned int bank_num,
  92.                                           unsigned int preset_num);
  93. FLUIDSYNTH_API 
  94. int fluid_synth_get_program(fluid_synth_t* synth, int chan, unsigned int* sfont_id, 
  95.                             unsigned int* bank_num, unsigned int* preset_num);
  96. FLUIDSYNTH_API int fluid_synth_unset_program (fluid_synth_t *synth, int chan);
  97. FLUIDSYNTH_API int fluid_synth_get_channel_info (fluid_synth_t *synth, int chan,
  98.                                                  fluid_synth_channel_info_t *info);
  99. FLUIDSYNTH_API int fluid_synth_program_reset(fluid_synth_t* synth);
  100. FLUIDSYNTH_API int fluid_synth_system_reset(fluid_synth_t* synth);
  103. /* Low level access */
  104. FLUIDSYNTH_API fluid_preset_t* fluid_synth_get_channel_preset(fluid_synth_t* synth, int chan);
  105. FLUIDSYNTH_API int fluid_synth_start(fluid_synth_t* synth, unsigned int id, 
  106.      fluid_preset_t* preset, int audio_chan, 
  107.      int midi_chan, int key, int vel);
  108. FLUIDSYNTH_API int fluid_synth_stop(fluid_synth_t* synth, unsigned int id);
  111. /* SoundFont management */
  113. FLUIDSYNTH_API 
  114. int fluid_synth_sfload(fluid_synth_t* synth, const char* filename, int reset_presets);
  115. FLUIDSYNTH_API int fluid_synth_sfreload(fluid_synth_t* synth, unsigned int id);
  116. FLUIDSYNTH_API int fluid_synth_sfunload(fluid_synth_t* synth, unsigned int id, int reset_presets);
  117. FLUIDSYNTH_API int fluid_synth_add_sfont(fluid_synth_t* synth, fluid_sfont_t* sfont);
  118. FLUIDSYNTH_API void fluid_synth_remove_sfont(fluid_synth_t* synth, fluid_sfont_t* sfont);
  119. FLUIDSYNTH_API int fluid_synth_sfcount(fluid_synth_t* synth);
  120. FLUIDSYNTH_API fluid_sfont_t* fluid_synth_get_sfont(fluid_synth_t* synth, unsigned int num);
  121. FLUIDSYNTH_API fluid_sfont_t* fluid_synth_get_sfont_by_id(fluid_synth_t* synth, unsigned int id);
  122. FLUIDSYNTH_API fluid_sfont_t *fluid_synth_get_sfont_by_name (fluid_synth_t* synth,
  123.                                                              const char *name);
  124. FLUIDSYNTH_API int fluid_synth_set_bank_offset(fluid_synth_t* synth, int sfont_id, int offset);
  125. FLUIDSYNTH_API int fluid_synth_get_bank_offset(fluid_synth_t* synth, int sfont_id);
  128. /* Reverb  */
  130. FLUIDSYNTH_API void fluid_synth_set_reverb(fluid_synth_t* synth, double roomsize, 
  131.    double damping, double width, double level);
  132. FLUIDSYNTH_API void fluid_synth_set_reverb_on(fluid_synth_t* synth, int on);
  133. FLUIDSYNTH_API double fluid_synth_get_reverb_roomsize(fluid_synth_t* synth);
  134. FLUIDSYNTH_API double fluid_synth_get_reverb_damp(fluid_synth_t* synth);
  135. FLUIDSYNTH_API double fluid_synth_get_reverb_level(fluid_synth_t* synth);
  136. FLUIDSYNTH_API double fluid_synth_get_reverb_width(fluid_synth_t* synth);
  138. #define FLUID_REVERB_DEFAULT_ROOMSIZE 0.2f      /**< Default reverb room size */
  139. #define FLUID_REVERB_DEFAULT_DAMP 0.0f          /**< Default reverb damping */
  140. #define FLUID_REVERB_DEFAULT_WIDTH 0.5f         /**< Default reverb width */
  141. #define FLUID_REVERB_DEFAULT_LEVEL 0.9f         /**< Default reverb level */
  144. /* Chorus */
  146. /**
  147.  * Chorus modulation waveform type.
  148.  */
  149. enum fluid_chorus_mod {
  150.   FLUID_CHORUS_MOD_SINE = 0,            /**< Sine wave chorus modulation */
  151.   FLUID_CHORUS_MOD_TRIANGLE = 1         /**< Triangle wave chorus modulation */
  152. };
  154. FLUIDSYNTH_API void fluid_synth_set_chorus(fluid_synth_t* synth, int nr, double level, 
  155.  double speed, double depth_ms, int type);
  156. FLUIDSYNTH_API void fluid_synth_set_chorus_on(fluid_synth_t* synth, int on);
  157. FLUIDSYNTH_API int fluid_synth_get_chorus_nr(fluid_synth_t* synth);
  158. FLUIDSYNTH_API double fluid_synth_get_chorus_level(fluid_synth_t* synth);
  159. FLUIDSYNTH_API double fluid_synth_get_chorus_speed_Hz(fluid_synth_t* synth);
  160. FLUIDSYNTH_API double fluid_synth_get_chorus_depth_ms(fluid_synth_t* synth);
  161. FLUIDSYNTH_API int fluid_synth_get_chorus_type(fluid_synth_t* synth); /* see fluid_chorus_mod */
  163. #define FLUID_CHORUS_DEFAULT_N 3                                /**< Default chorus voice count */
  164. #define FLUID_CHORUS_DEFAULT_LEVEL 2.0f                         /**< Default chorus level */
  165. #define FLUID_CHORUS_DEFAULT_SPEED 0.3f                         /**< Default chorus speed */
  166. #define FLUID_CHORUS_DEFAULT_DEPTH 8.0f                         /**< Default chorus depth */
  167. #define FLUID_CHORUS_DEFAULT_TYPE FLUID_CHORUS_MOD_SINE         /**< Default chorus waveform type */
  170. /* Audio and MIDI channels */
  172. FLUIDSYNTH_API int fluid_synth_count_midi_channels(fluid_synth_t* synth);
  173. FLUIDSYNTH_API int fluid_synth_count_audio_channels(fluid_synth_t* synth);
  174. FLUIDSYNTH_API int fluid_synth_count_audio_groups(fluid_synth_t* synth);
  175. FLUIDSYNTH_API int fluid_synth_count_effects_channels(fluid_synth_t* synth);
  178. /* Synthesis parameters */
  180. FLUIDSYNTH_API void fluid_synth_set_gain(fluid_synth_t* synth, float gain);
  181. FLUIDSYNTH_API float fluid_synth_get_gain(fluid_synth_t* synth);
  182. FLUIDSYNTH_API int fluid_synth_set_polyphony(fluid_synth_t* synth, int polyphony);
  183. FLUIDSYNTH_API int fluid_synth_get_polyphony(fluid_synth_t* synth);
  184. FLUIDSYNTH_API int fluid_synth_get_active_voice_count(fluid_synth_t* synth);
  185. FLUIDSYNTH_API int fluid_synth_get_internal_bufsize(fluid_synth_t* synth);
  187. FLUIDSYNTH_API 
  188. int fluid_synth_set_interp_method(fluid_synth_t* synth, int chan, int interp_method);
  190. /**
  191.  * Synthesis interpolation method.
  192.  */
  193. enum fluid_interp {
  194.   FLUID_INTERP_NONE = 0,        /**< No interpolation: Fastest, but questionable audio quality */
  195.   FLUID_INTERP_LINEAR = 1,      /**< Straight-line interpolation: A bit slower, reasonable audio quality */
  196.   FLUID_INTERP_4THORDER = 4,    /**< Fourth-order interpolation, good quality, the default */
  197.   FLUID_INTERP_7THORDER = 7,    /**< Seventh-order interpolation */
  198. };
  200. #define FLUID_INTERP_DEFAULT    FLUID_INTERP_4THORDER   /**< Default interpolation method from #fluid_interp. */
  201. #define FLUID_INTERP_HIGHEST    FLUID_INTERP_7THORDER   /**< Highest interpolation method from #fluid_interp. */
  204. /* Generator interface */
  206. FLUIDSYNTH_API 
  207. int fluid_synth_set_gen(fluid_synth_t* synth, int chan, int param, float value);
  208. FLUIDSYNTH_API int fluid_synth_set_gen2 (fluid_synth_t* synth, int chan,
  209.                                          int param, float value,
  210.                                          int absolute, int normalized);
  211. FLUIDSYNTH_API float fluid_synth_get_gen(fluid_synth_t* synth, int chan, int param);
  214. /* Tuning */
  216. FLUIDSYNTH_API 
  217. int fluid_synth_create_key_tuning(fluid_synth_t* synth, int bank, int prog,
  218.   const char* name, const double* pitch);
  219. FLUIDSYNTH_API
  220. int fluid_synth_activate_key_tuning(fluid_synth_t* synth, int bank, int prog,
  221.                                     const char* name, const double* pitch, int apply);
  222. FLUIDSYNTH_API 
  223. int fluid_synth_create_octave_tuning(fluid_synth_t* synth, int bank, int prog,
  224.                                      const char* name, const double* pitch);
  225. FLUIDSYNTH_API
  226. int fluid_synth_activate_octave_tuning(fluid_synth_t* synth, int bank, int prog,
  227.                                        const char* name, const double* pitch, int apply);
  228. FLUIDSYNTH_API 
  229. int fluid_synth_tune_notes(fluid_synth_t* synth, int bank, int prog,
  230.    int len, const int *keys, const double* pitch, int apply);
  231. FLUIDSYNTH_API 
  232. int fluid_synth_select_tuning(fluid_synth_t* synth, int chan, int bank, int prog);
  233. FLUIDSYNTH_API
  234. int fluid_synth_activate_tuning(fluid_synth_t* synth, int chan, int bank, int prog,
  235.                                 int apply);
  236. FLUIDSYNTH_API int fluid_synth_reset_tuning(fluid_synth_t* synth, int chan);
  237. FLUIDSYNTH_API
  238. int fluid_synth_deactivate_tuning(fluid_synth_t* synth, int chan, int apply);
  239. FLUIDSYNTH_API void fluid_synth_tuning_iteration_start(fluid_synth_t* synth);
  240. FLUIDSYNTH_API 
  241. int fluid_synth_tuning_iteration_next(fluid_synth_t* synth, int* bank, int* prog);
  242. FLUIDSYNTH_API int fluid_synth_tuning_dump(fluid_synth_t* synth, int bank, int prog, 
  243.    char* name, int len, double* pitch);
  245. /* Misc */
  247. FLUIDSYNTH_API double fluid_synth_get_cpu_load(fluid_synth_t* synth);
  248. FLUIDSYNTH_API char* fluid_synth_error(fluid_synth_t* synth);
  251. /*
  252.  * Synthesizer plugin
  253.  *
  254.  * To create a synthesizer plugin, create the synthesizer as
  255.  * explained above. Once the synthesizer is created you can call
  256.  * any of the functions below to get the audio. 
  257.  */
  259. FLUIDSYNTH_API int fluid_synth_write_s16(fluid_synth_t* synth, int len, 
  260.        void* lout, int loff, int lincr, 
  261.        void* rout, int roff, int rincr);
  262. FLUIDSYNTH_API int fluid_synth_write_float(fluid_synth_t* synth, int len, 
  263.  void* lout, int loff, int lincr, 
  264.  void* rout, int roff, int rincr);
  265. FLUIDSYNTH_API int fluid_synth_nwrite_float(fluid_synth_t* synth, int len, 
  266.   float** left, float** right, 
  267.   float** fx_left, float** fx_right);
  268. FLUIDSYNTH_API int fluid_synth_process(fluid_synth_t* synth, int len,
  269.      int nin, float** in, 
  270.      int nout, float** out);
  272. /**
  273.  * Type definition of the synthesizer's audio callback function.
  274.  * @param synth FluidSynth instance
  275.  * @param len Count of audio frames to synthesize
  276.  * @param out1 Array to store left channel of audio to
  277.  * @param loff Offset index in 'out1' for first sample
  278.  * @param lincr Increment between samples stored to 'out1'
  279.  * @param out2 Array to store right channel of audio to
  280.  * @param roff Offset index in 'out2' for first sample
  281.  * @param rincr Increment between samples stored to 'out2'
  282.  */
  283. typedef int (*fluid_audio_callback_t)(fluid_synth_t* synth, int len, 
  284.      void* out1, int loff, int lincr, 
  285.      void* out2, int roff, int rincr);
  287. /* Synthesizer's interface to handle SoundFont loaders */
  289. FLUIDSYNTH_API void fluid_synth_add_sfloader(fluid_synth_t* synth, fluid_sfloader_t* loader);
  290. FLUIDSYNTH_API fluid_voice_t* fluid_synth_alloc_voice(fluid_synth_t* synth, fluid_sample_t* sample,
  291.                                                       int channum, int key, int vel);
  292. FLUIDSYNTH_API void fluid_synth_start_voice(fluid_synth_t* synth, fluid_voice_t* voice);
  293. FLUIDSYNTH_API void fluid_synth_get_voicelist(fluid_synth_t* synth,
  294.                                               fluid_voice_t* buf[], int bufsize, int ID);
  295. FLUIDSYNTH_API int fluid_synth_handle_midi_event(void* data, fluid_midi_event_t* event);
  296. FLUIDSYNTH_API void fluid_synth_set_midi_router(fluid_synth_t* synth,
  297.                                                 fluid_midi_router_t* router);
  299. #ifdef __cplusplus
  300. }
  301. #endif
  303. #endif /* _FLUIDSYNTH_SYNTH_H */