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

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_EVENT_H
  21. #define _FLUIDSYNTH_EVENT_H
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /**
  26.  * @file event.h
  27.  * @brief Sequencer event functions and defines.
  28.  *
  29.  * Functions and constants for creating/processing sequencer events.
  30.  */
  31. /**
  32.  * Sequencer event type enumeration.
  33.  */
  34. enum fluid_seq_event_type {
  35.   FLUID_SEQ_NOTE = 0, /**< Note event with duration */
  36.   FLUID_SEQ_NOTEON, /**< Note on event */
  37.   FLUID_SEQ_NOTEOFF, /**< Note off event */
  38.   FLUID_SEQ_ALLSOUNDSOFF, /**< All sounds off event */
  39.   FLUID_SEQ_ALLNOTESOFF, /**< All notes off event */
  40.   FLUID_SEQ_BANKSELECT, /**< Bank select message */
  41.   FLUID_SEQ_PROGRAMCHANGE, /**< Program change message */
  42.   FLUID_SEQ_PROGRAMSELECT, /**< Program select message (DOCME) */
  43.   FLUID_SEQ_PITCHBEND, /**< Pitch bend message */
  44.   FLUID_SEQ_PITCHWHEELSENS, /**< Pitch wheel sensitivity set message @since 1.1.0 was mispelled previously */
  45.   FLUID_SEQ_MODULATION, /**< Modulation controller event */
  46.   FLUID_SEQ_SUSTAIN, /**< Sustain controller event */
  47.   FLUID_SEQ_CONTROLCHANGE, /**< MIDI control change event */
  48.   FLUID_SEQ_PAN, /**< Stereo pan set event */
  49.   FLUID_SEQ_VOLUME, /**< Volume set event */
  50.   FLUID_SEQ_REVERBSEND, /**< Reverb send set event */
  51.   FLUID_SEQ_CHORUSSEND, /**< Chorus send set event */
  52.   FLUID_SEQ_TIMER, /**< Timer event (DOCME) */
  53.   FLUID_SEQ_ANYCONTROLCHANGE, /**< DOCME (used for remove_events only) */
  54.   FLUID_SEQ_CHANNELPRESSURE,    /**< Channel aftertouch event @since 1.1.0 */
  55.   FLUID_SEQ_SYSTEMRESET,        /**< System reset event @since 1.1.0 */
  56.   FLUID_SEQ_UNREGISTERING,      /**< Called when a sequencer client is being unregistered. @since 1.1.0 */
  57.   FLUID_SEQ_LASTEVENT /**< Defines the count of event enums */
  58. };
  59. #define FLUID_SEQ_PITCHWHHELSENS        FLUID_SEQ_PITCHWHEELSENS        /**< Old deprecated misspelling of #FLUID_SEQ_PITCHWHEELSENS */
  60. /* Event alloc/free */
  61. FLUIDSYNTH_API fluid_event_t* new_fluid_event(void);
  62. FLUIDSYNTH_API void delete_fluid_event(fluid_event_t* evt);
  63. /* Initializing events */
  64. FLUIDSYNTH_API void fluid_event_set_source(fluid_event_t* evt, short src);
  65. FLUIDSYNTH_API void fluid_event_set_dest(fluid_event_t* evt, short dest);
  66. /* Timer events */
  67. FLUIDSYNTH_API void fluid_event_timer(fluid_event_t* evt, void* data);
  68. /* Note events */
  69. FLUIDSYNTH_API void fluid_event_note(fluid_event_t* evt, int channel, 
  70.    short key, short vel, 
  71.    unsigned int duration);
  72. FLUIDSYNTH_API void fluid_event_noteon(fluid_event_t* evt, int channel, short key, short vel);
  73. FLUIDSYNTH_API void fluid_event_noteoff(fluid_event_t* evt, int channel, short key);
  74. FLUIDSYNTH_API void fluid_event_all_sounds_off(fluid_event_t* evt, int channel);
  75. FLUIDSYNTH_API void fluid_event_all_notes_off(fluid_event_t* evt, int channel);
  76. /* Instrument selection */
  77. FLUIDSYNTH_API void fluid_event_bank_select(fluid_event_t* evt, int channel, short bank_num);
  78. FLUIDSYNTH_API void fluid_event_program_change(fluid_event_t* evt, int channel, short preset_num);
  79. FLUIDSYNTH_API void fluid_event_program_select(fluid_event_t* evt, int channel, unsigned int sfont_id, short bank_num, short preset_num);
  80. /* Real-time generic instrument controllers */
  81. FLUIDSYNTH_API 
  82. void fluid_event_control_change(fluid_event_t* evt, int channel, short control, short val);
  83. /* Real-time instrument controllers shortcuts */
  84. FLUIDSYNTH_API void fluid_event_pitch_bend(fluid_event_t* evt, int channel, int val);
  85. FLUIDSYNTH_API void fluid_event_pitch_wheelsens(fluid_event_t* evt, int channel, short val);
  86. FLUIDSYNTH_API void fluid_event_modulation(fluid_event_t* evt, int channel, short val);
  87. FLUIDSYNTH_API void fluid_event_sustain(fluid_event_t* evt, int channel, short val);
  88. FLUIDSYNTH_API void fluid_event_pan(fluid_event_t* evt, int channel, short val);
  89. FLUIDSYNTH_API void fluid_event_volume(fluid_event_t* evt, int channel, short val);
  90. FLUIDSYNTH_API void fluid_event_reverb_send(fluid_event_t* evt, int channel, short val);
  91. FLUIDSYNTH_API void fluid_event_chorus_send(fluid_event_t* evt, int channel, short val);
  92. FLUIDSYNTH_API void fluid_event_channel_pressure(fluid_event_t* evt, int channel, short val);
  93. FLUIDSYNTH_API void fluid_event_system_reset(fluid_event_t* evt);
  94. /* Only for removing events */
  95. FLUIDSYNTH_API void fluid_event_any_control_change(fluid_event_t* evt, int channel);
  96. /* Only when unregistering clients */
  97. FLUIDSYNTH_API void fluid_event_unregistering(fluid_event_t* evt);
  98. /* Accessing event data */
  99. FLUIDSYNTH_API int fluid_event_get_type(fluid_event_t* evt);
  100. FLUIDSYNTH_API short fluid_event_get_source(fluid_event_t* evt);
  101. FLUIDSYNTH_API short fluid_event_get_dest(fluid_event_t* evt);
  102. FLUIDSYNTH_API int fluid_event_get_channel(fluid_event_t* evt);
  103. FLUIDSYNTH_API short fluid_event_get_key(fluid_event_t* evt);
  104. FLUIDSYNTH_API short fluid_event_get_velocity(fluid_event_t* evt);
  105. FLUIDSYNTH_API short fluid_event_get_control(fluid_event_t* evt);
  106. FLUIDSYNTH_API short fluid_event_get_value(fluid_event_t* evt);
  107. FLUIDSYNTH_API short fluid_event_get_program(fluid_event_t* evt);
  108. FLUIDSYNTH_API void* fluid_event_get_data(fluid_event_t* evt);
  109. FLUIDSYNTH_API unsigned int fluid_event_get_duration(fluid_event_t* evt);
  110. FLUIDSYNTH_API short fluid_event_get_bank(fluid_event_t* evt);
  111. FLUIDSYNTH_API int fluid_event_get_pitch(fluid_event_t* evt);
  112. FLUIDSYNTH_API unsigned int fluid_event_get_sfont_id(fluid_event_t* evt);
  113. #ifdef __cplusplus
  114. }
  115. #endif
  116. #endif /* _FLUIDSYNTH_EVENT_H */