mod.h
上传用户:tjmskj2
上传日期:2020-08-17
资源大小:577k
文件大小:4k
源码类别:

midi

开发平台:

C/C++

  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.  */
  20. #ifndef _FLUIDSYNTH_MOD_H
  21. #define _FLUIDSYNTH_MOD_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /**
  26.  * @file mod.h
  27.  * @brief SoundFont modulator functions and constants.
  28.  */
  29. #define FLUID_NUM_MOD           64      /**< Maximum number of modulators in a voice */
  30. /**
  31.  * Modulator structure.  See SoundFont 2.04 PDF section 8.2.
  32.  */
  33. struct _fluid_mod_t
  34. {
  35.   unsigned char dest;           /**< Destination generator to control */
  36.   unsigned char src1;           /**< Source controller 1 */
  37.   unsigned char flags1;         /**< Source controller 1 flags */
  38.   unsigned char src2;           /**< Source controller 2 */
  39.   unsigned char flags2;         /**< Source controller 2 flags */
  40.   double amount;                /**< Multiplier amount */
  41.   /* The 'next' field allows to link modulators into a list.  It is
  42.    * not used in fluid_voice.c, there each voice allocates memory for a
  43.    * fixed number of modulators.  Since there may be a huge number of
  44.    * different zones, this is more efficient.
  45.    */
  46.   fluid_mod_t * next;
  47. };
  48. /**
  49.  * Flags defining the polarity, mapping function and type of a modulator source.
  50.  * Compare with SoundFont 2.04 PDF section 8.2.
  51.  *
  52.  * Note: Bit values do not correspond to the SoundFont spec!  Also note that
  53.  * #FLUID_MOD_GC and #FLUID_MOD_CC are in the flags field instead of the source field.
  54.  */
  55. enum fluid_mod_flags
  56. {
  57.   FLUID_MOD_POSITIVE = 0,       /**< Mapping function is positive */
  58.   FLUID_MOD_NEGATIVE = 1,       /**< Mapping function is negative */
  59.   FLUID_MOD_UNIPOLAR = 0,       /**< Mapping function is unipolar */
  60.   FLUID_MOD_BIPOLAR = 2,        /**< Mapping function is bipolar */
  61.   FLUID_MOD_LINEAR = 0,         /**< Linear mapping function */
  62.   FLUID_MOD_CONCAVE = 4,        /**< Concave mapping function */
  63.   FLUID_MOD_CONVEX = 8,         /**< Convex mapping function */
  64.   FLUID_MOD_SWITCH = 12,        /**< Switch (on/off) mapping function */
  65.   FLUID_MOD_GC = 0,             /**< General controller source type (#fluid_mod_src) */
  66.   FLUID_MOD_CC = 16             /**< MIDI CC controller (source will be a MIDI CC number) */
  67. };
  68. /**
  69.  * General controller (if #FLUID_MOD_GC in flags).  This
  70.  * corresponds to SoundFont 2.04 PDF section 8.2.1
  71.  */
  72. enum fluid_mod_src
  73. {
  74.   FLUID_MOD_NONE = 0,                   /**< No source controller */
  75.   FLUID_MOD_VELOCITY = 2,               /**< MIDI note-on velocity */
  76.   FLUID_MOD_KEY = 3,                    /**< MIDI note-on note number */
  77.   FLUID_MOD_KEYPRESSURE = 10,           /**< MIDI key pressure */
  78.   FLUID_MOD_CHANNELPRESSURE = 13,       /**< MIDI channel pressure */
  79.   FLUID_MOD_PITCHWHEEL = 14,            /**< Pitch wheel */
  80.   FLUID_MOD_PITCHWHEELSENS = 16         /**< Pitch wheel sensitivity */
  81. };
  82. FLUIDSYNTH_API fluid_mod_t* fluid_mod_new(void);
  83. FLUIDSYNTH_API void fluid_mod_delete(fluid_mod_t * mod);
  84. FLUIDSYNTH_API void fluid_mod_set_source1(fluid_mod_t* mod, int src, int flags); 
  85. FLUIDSYNTH_API void fluid_mod_set_source2(fluid_mod_t* mod, int src, int flags); 
  86. FLUIDSYNTH_API void fluid_mod_set_dest(fluid_mod_t* mod, int dst); 
  87. FLUIDSYNTH_API void fluid_mod_set_amount(fluid_mod_t* mod, double amount); 
  88. FLUIDSYNTH_API int fluid_mod_get_source1(fluid_mod_t* mod);
  89. FLUIDSYNTH_API int fluid_mod_get_flags1(fluid_mod_t* mod);
  90. FLUIDSYNTH_API int fluid_mod_get_source2(fluid_mod_t* mod);
  91. FLUIDSYNTH_API int fluid_mod_get_flags2(fluid_mod_t* mod);
  92. FLUIDSYNTH_API int fluid_mod_get_dest(fluid_mod_t* mod);
  93. FLUIDSYNTH_API double fluid_mod_get_amount(fluid_mod_t* mod);
  94. FLUIDSYNTH_API int fluid_mod_test_identity(fluid_mod_t * mod1, fluid_mod_t * mod2);
  95. #ifdef __cplusplus
  96. }
  97. #endif
  98. #endif /* _FLUIDSYNTH_MOD_H */