event.h File Reference

Sequencer event functions and defines. More...


Defines

#define FLUID_SEQ_PITCHWHHELSENS   FLUID_SEQ_PITCHWHEELSENS
 Old deprecated misspelling of FLUID_SEQ_PITCHWHEELSENS.

Enumerations

enum  fluid_seq_event_type {
  FLUID_SEQ_NOTE = 0, FLUID_SEQ_NOTEON, FLUID_SEQ_NOTEOFF, FLUID_SEQ_ALLSOUNDSOFF,
  FLUID_SEQ_ALLNOTESOFF, FLUID_SEQ_BANKSELECT, FLUID_SEQ_PROGRAMCHANGE, FLUID_SEQ_PROGRAMSELECT,
  FLUID_SEQ_PITCHBEND, FLUID_SEQ_PITCHWHEELSENS, FLUID_SEQ_MODULATION, FLUID_SEQ_SUSTAIN,
  FLUID_SEQ_CONTROLCHANGE, FLUID_SEQ_PAN, FLUID_SEQ_VOLUME, FLUID_SEQ_REVERBSEND,
  FLUID_SEQ_CHORUSSEND, FLUID_SEQ_TIMER, FLUID_SEQ_ANYCONTROLCHANGE, FLUID_SEQ_CHANNELPRESSURE,
  FLUID_SEQ_SYSTEMRESET, FLUID_SEQ_UNREGISTERING, FLUID_SEQ_LASTEVENT
}
 Sequencer event type enumeration. More...

Functions

FLUIDSYNTH_API fluid_event_tnew_fluid_event (void)
 Create a new sequencer event structure.
FLUIDSYNTH_API void delete_fluid_event (fluid_event_t *evt)
 Delete a sequencer event structure.
FLUIDSYNTH_API void fluid_event_set_source (fluid_event_t *evt, short src)
 Set source of a sequencer event (DOCME).
FLUIDSYNTH_API void fluid_event_set_dest (fluid_event_t *evt, short dest)
 Set destination of a sequencer event (DOCME).
FLUIDSYNTH_API void fluid_event_timer (fluid_event_t *evt, void *data)
 Set a sequencer event to be a timer event.
FLUIDSYNTH_API void fluid_event_note (fluid_event_t *evt, int channel, short key, short vel, unsigned int duration)
 Set a sequencer event to be a note duration event.
FLUIDSYNTH_API void fluid_event_noteon (fluid_event_t *evt, int channel, short key, short vel)
 Set a sequencer event to be a note on event.
FLUIDSYNTH_API void fluid_event_noteoff (fluid_event_t *evt, int channel, short key)
 Set a sequencer event to be a note off event.
FLUIDSYNTH_API void fluid_event_all_sounds_off (fluid_event_t *evt, int channel)
 Set a sequencer event to be an all sounds off event.
FLUIDSYNTH_API void fluid_event_all_notes_off (fluid_event_t *evt, int channel)
 Set a sequencer event to be a all notes off event.
FLUIDSYNTH_API void fluid_event_bank_select (fluid_event_t *evt, int channel, short bank_num)
 Set a sequencer event to be a bank select event.
FLUIDSYNTH_API void fluid_event_program_change (fluid_event_t *evt, int channel, short preset_num)
 Set a sequencer event to be a program change event.
FLUIDSYNTH_API void fluid_event_program_select (fluid_event_t *evt, int channel, unsigned int sfont_id, short bank_num, short preset_num)
 Set a sequencer event to be a program select event.
FLUIDSYNTH_API void fluid_event_control_change (fluid_event_t *evt, int channel, short control, short val)
 Set a sequencer event to be a MIDI control change event.
FLUIDSYNTH_API void fluid_event_pitch_bend (fluid_event_t *evt, int channel, int val)
 Set a sequencer event to be a pitch bend event.
FLUIDSYNTH_API void fluid_event_pitch_wheelsens (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a pitch wheel sensitivity event.
FLUIDSYNTH_API void fluid_event_modulation (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a modulation event.
FLUIDSYNTH_API void fluid_event_sustain (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a MIDI sustain event.
FLUIDSYNTH_API void fluid_event_pan (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a stereo pan event.
FLUIDSYNTH_API void fluid_event_volume (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a volume event.
FLUIDSYNTH_API void fluid_event_reverb_send (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a reverb send event.
FLUIDSYNTH_API void fluid_event_chorus_send (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a chorus send event.
FLUIDSYNTH_API void fluid_event_channel_pressure (fluid_event_t *evt, int channel, short val)
 Set a sequencer event to be a channel-wide aftertouch event.
FLUIDSYNTH_API void fluid_event_system_reset (fluid_event_t *evt)
 Set a sequencer event to be a midi system reset event.
FLUIDSYNTH_API void fluid_event_any_control_change (fluid_event_t *evt, int channel)
 Set a sequencer event to be an any control change event.
FLUIDSYNTH_API void fluid_event_unregistering (fluid_event_t *evt)
 Set a sequencer event to be an unregistering event.
FLUIDSYNTH_API int fluid_event_get_type (fluid_event_t *evt)
 Get the event type (fluid_seq_event_type) field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_source (fluid_event_t *evt)
 Get the source field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_dest (fluid_event_t *evt)
 Get the dest field from a sequencer event structure.
FLUIDSYNTH_API int fluid_event_get_channel (fluid_event_t *evt)
 Get the MIDI channel field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_key (fluid_event_t *evt)
 Get the MIDI note field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_velocity (fluid_event_t *evt)
 Get the MIDI velocity field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_control (fluid_event_t *evt)
 Get the MIDI control number field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_value (fluid_event_t *evt)
 Get the value field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_program (fluid_event_t *evt)
 Get the MIDI program field from a sequencer event structure.
FLUIDSYNTH_API void * fluid_event_get_data (fluid_event_t *evt)
 Get the data field from a sequencer event structure.
FLUIDSYNTH_API unsigned int fluid_event_get_duration (fluid_event_t *evt)
 Get the duration field from a sequencer event structure.
FLUIDSYNTH_API short fluid_event_get_bank (fluid_event_t *evt)
 Get the MIDI bank field from a sequencer event structure.
FLUIDSYNTH_API int fluid_event_get_pitch (fluid_event_t *evt)
 Get the pitch field from a sequencer event structure.
FLUIDSYNTH_API unsigned int fluid_event_get_sfont_id (fluid_event_t *evt)
 Get the SoundFont ID field from a sequencer event structure.


Detailed Description

Sequencer event functions and defines.

Functions and constants for creating/processing sequencer events.


Enumeration Type Documentation

Sequencer event type enumeration.

Enumerator:
FLUID_SEQ_NOTE  Note event with duration.
FLUID_SEQ_NOTEON  Note on event.
FLUID_SEQ_NOTEOFF  Note off event.
FLUID_SEQ_ALLSOUNDSOFF  All sounds off event.
FLUID_SEQ_ALLNOTESOFF  All notes off event.
FLUID_SEQ_BANKSELECT  Bank select message.
FLUID_SEQ_PROGRAMCHANGE  Program change message.
FLUID_SEQ_PROGRAMSELECT  Program select message (DOCME).
FLUID_SEQ_PITCHBEND  Pitch bend message.
FLUID_SEQ_PITCHWHEELSENS  Pitch wheel sensitivity set message.

Since:
1.1.0 was mispelled previously
FLUID_SEQ_MODULATION  Modulation controller event.
FLUID_SEQ_SUSTAIN  Sustain controller event.
FLUID_SEQ_CONTROLCHANGE  MIDI control change event.
FLUID_SEQ_PAN  Stereo pan set event.
FLUID_SEQ_VOLUME  Volume set event.
FLUID_SEQ_REVERBSEND  Reverb send set event.
FLUID_SEQ_CHORUSSEND  Chorus send set event.
FLUID_SEQ_TIMER  Timer event (DOCME).
FLUID_SEQ_ANYCONTROLCHANGE  DOCME (used for remove_events only).
FLUID_SEQ_CHANNELPRESSURE  Channel aftertouch event.

Since:
1.1.0
FLUID_SEQ_SYSTEMRESET  System reset event.

Since:
1.1.0
FLUID_SEQ_UNREGISTERING  Called when a sequencer client is being unregistered.

Since:
1.1.0
FLUID_SEQ_LASTEVENT  Defines the count of event enums.


Function Documentation

FLUIDSYNTH_API fluid_event_t* new_fluid_event ( void   ) 

Create a new sequencer event structure.

Returns:
New sequencer event structure or NULL if out of memory
Examples:
fluidsynth_arpeggio.c, and fluidsynth_metronome.c.

FLUIDSYNTH_API void delete_fluid_event ( fluid_event_t evt  ) 

Delete a sequencer event structure.

Parameters:
evt Sequencer event structure created by new_fluid_event().
Examples:
fluidsynth_arpeggio.c, and fluidsynth_metronome.c.

FLUIDSYNTH_API void fluid_event_set_source ( fluid_event_t evt,
short  src 
)

Set source of a sequencer event (DOCME).

Parameters:
evt Sequencer event structure
src DOCME
Examples:
fluidsynth_arpeggio.c, and fluidsynth_metronome.c.

FLUIDSYNTH_API void fluid_event_set_dest ( fluid_event_t evt,
short  dest 
)

Set destination of a sequencer event (DOCME).

Parameters:
evt Sequencer event structure
dest DOCME
Examples:
fluidsynth_arpeggio.c, and fluidsynth_metronome.c.

FLUIDSYNTH_API void fluid_event_timer ( fluid_event_t evt,
void *  data 
)

Set a sequencer event to be a timer event.

Parameters:
evt Sequencer event structure
data DOCME
Examples:
fluidsynth_arpeggio.c, and fluidsynth_metronome.c.

FLUIDSYNTH_API void fluid_event_note ( fluid_event_t evt,
int  channel,
short  key,
short  vel,
unsigned int  duration 
)

Set a sequencer event to be a note duration event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
key MIDI note number (0-127)
vel MIDI velocity value (0-127)
duration Duration of note (DOCME units?)

FLUIDSYNTH_API void fluid_event_noteon ( fluid_event_t evt,
int  channel,
short  key,
short  vel 
)

Set a sequencer event to be a note on event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
key MIDI note number (0-127)
vel MIDI velocity value (0-127)
Examples:
fluidsynth_arpeggio.c, and fluidsynth_metronome.c.

FLUIDSYNTH_API void fluid_event_noteoff ( fluid_event_t evt,
int  channel,
short  key 
)

Set a sequencer event to be a note off event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
key MIDI note number (0-127)
Examples:
fluidsynth_arpeggio.c.

FLUIDSYNTH_API void fluid_event_all_sounds_off ( fluid_event_t evt,
int  channel 
)

Set a sequencer event to be an all sounds off event.

Parameters:
evt Sequencer event structure
channel MIDI channel number

FLUIDSYNTH_API void fluid_event_all_notes_off ( fluid_event_t evt,
int  channel 
)

Set a sequencer event to be a all notes off event.

Parameters:
evt Sequencer event structure
channel MIDI channel number

FLUIDSYNTH_API void fluid_event_bank_select ( fluid_event_t evt,
int  channel,
short  bank_num 
)

Set a sequencer event to be a bank select event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
bank_num MIDI bank number (0-16383)

FLUIDSYNTH_API void fluid_event_program_change ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a program change event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val MIDI program number (0-127)

FLUIDSYNTH_API void fluid_event_program_select ( fluid_event_t evt,
int  channel,
unsigned int  sfont_id,
short  bank_num,
short  preset_num 
)

Set a sequencer event to be a program select event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
sfont_id SoundFont ID number
bank_num MIDI bank number (0-16383)
preset_num MIDI preset number (0-127)

FLUIDSYNTH_API void fluid_event_control_change ( fluid_event_t evt,
int  channel,
short  control,
short  val 
)

Set a sequencer event to be a MIDI control change event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
control MIDI control number (0-127)
val MIDI control value (0-16383 DOCME is that true?)

FLUIDSYNTH_API void fluid_event_pitch_bend ( fluid_event_t evt,
int  channel,
int  pitch 
)

Set a sequencer event to be a pitch bend event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
pitch MIDI pitch bend value (0-16383, 8192 = no bend)

FLUIDSYNTH_API void fluid_event_pitch_wheelsens ( fluid_event_t evt,
int  channel,
short  value 
)

Set a sequencer event to be a pitch wheel sensitivity event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
value MIDI pitch wheel sensitivity value (DOCME units?)

FLUIDSYNTH_API void fluid_event_modulation ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a modulation event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val MIDI modulation value (0-127)

FLUIDSYNTH_API void fluid_event_sustain ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a MIDI sustain event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val MIDI sustain value (0-127)

FLUIDSYNTH_API void fluid_event_pan ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a stereo pan event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val MIDI panning value (0-127, 0=left, 64 = middle, 127 = right)

FLUIDSYNTH_API void fluid_event_volume ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a volume event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val Volume value (0-127)

FLUIDSYNTH_API void fluid_event_reverb_send ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a reverb send event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val Reverb amount (0-127)

FLUIDSYNTH_API void fluid_event_chorus_send ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a chorus send event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val Chorus amount (0-127)

FLUIDSYNTH_API void fluid_event_channel_pressure ( fluid_event_t evt,
int  channel,
short  val 
)

Set a sequencer event to be a channel-wide aftertouch event.

Parameters:
evt Sequencer event structure
channel MIDI channel number
val Aftertouch amount (0-127)
Since:
1.1.0

FLUIDSYNTH_API void fluid_event_system_reset ( fluid_event_t evt  ) 

Set a sequencer event to be a midi system reset event.

Parameters:
evt Sequencer event structure
Since:
1.1.0

FLUIDSYNTH_API void fluid_event_any_control_change ( fluid_event_t evt,
int  channel 
)

Set a sequencer event to be an any control change event.

Parameters:
evt Sequencer event structure
channel MIDI channel number DOCME

FLUIDSYNTH_API void fluid_event_unregistering ( fluid_event_t evt  ) 

Set a sequencer event to be an unregistering event.

Parameters:
evt Sequencer event structure
Since:
1.1.0

FLUIDSYNTH_API int fluid_event_get_type ( fluid_event_t evt  ) 

Get the event type (fluid_seq_event_type) field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
Event type (fluid_seq_event_type).

FLUIDSYNTH_API short fluid_event_get_source ( fluid_event_t evt  ) 

Get the source field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
DOCME

FLUIDSYNTH_API short fluid_event_get_dest ( fluid_event_t evt  ) 

Get the dest field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
DOCME

FLUIDSYNTH_API int fluid_event_get_channel ( fluid_event_t evt  ) 

Get the MIDI channel field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
MIDI channel number (DOCME 0-15 or more?)

FLUIDSYNTH_API short fluid_event_get_key ( fluid_event_t evt  ) 

Get the MIDI note field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
MIDI note number (0-127)

FLUIDSYNTH_API short fluid_event_get_velocity ( fluid_event_t evt  ) 

Get the MIDI velocity field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
MIDI velocity value (0-127)

FLUIDSYNTH_API short fluid_event_get_control ( fluid_event_t evt  ) 

Get the MIDI control number field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
MIDI control number (0-127)

FLUIDSYNTH_API short fluid_event_get_value ( fluid_event_t evt  ) 

Get the value field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
Value field of event.
The Value field is used by the following event types: FLUID_SEQ_PROGRAMCHANGE, FLUID_SEQ_PROGRAMSELECT (preset_num), FLUID_SEQ_PITCHWHHELSENS, FLUID_SEQ_MODULATION, FLUID_SEQ_SUSTAIN, FLUID_SEQ_CONTROLCHANGE, FLUID_SEQ_PAN, FLUID_SEQ_VOLUME, FLUID_SEQ_REVERBSEND, FLUID_SEQ_CHORUSSEND.

FLUIDSYNTH_API short fluid_event_get_program ( fluid_event_t evt  ) 

Get the MIDI program field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
MIDI program number (0-127)
Used by the FLUID_SEQ_PROGRAMCHANGE and FLUID_SEQ_PROGRAMSELECT event types.

FLUIDSYNTH_API void* fluid_event_get_data ( fluid_event_t evt  ) 

Get the data field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
Data field of event.
Used by the FLUID_SEQ_TIMER event type.

FLUIDSYNTH_API unsigned int fluid_event_get_duration ( fluid_event_t evt  ) 

Get the duration field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
Note duration value (DOCME units?)
Used by the FLUID_SEQ_NOTE event type.

FLUIDSYNTH_API short fluid_event_get_bank ( fluid_event_t evt  ) 

Get the MIDI bank field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
MIDI bank number (0-16383)
Used by the FLUID_SEQ_BANKSELECT and FLUID_SEQ_PROGRAMSELECT event types.

FLUIDSYNTH_API int fluid_event_get_pitch ( fluid_event_t evt  ) 

Get the pitch field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
MIDI pitch bend pitch value (0-16383, 8192 = no bend)
Used by the FLUID_SEQ_PITCHBEND event type.

FLUIDSYNTH_API unsigned int fluid_event_get_sfont_id ( fluid_event_t evt  ) 

Get the SoundFont ID field from a sequencer event structure.

Parameters:
evt Sequencer event structure
Returns:
SoundFont identifier value.
Used by the FLUID_SEQ_PROGRAMSELECT event type.


Generated on Fri Jan 8 02:37:43 2016 for libfluidsynth by  doxygen 1.5.6