fiddle_fluidsynth 0.0.1

data/lib/fiddle_fluidsynth/synth/effect/reverb.rb

@@ -0,0 +1,207 @@
+#
+# filename: synth/effect/reverb.rb
+#
+
+
+# References
+# - [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # Functions for configuring the built-in reverb effect.
+  # ==== References
+  # - API Reference, Synthesizer/[Effect - Reverb](https://www.fluidsynth.org/api/group__reverb__effect.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+  #
+  module C
+
+    # Lifecycle Functions.
+    #
+    #
+
+
+    # Functions.
+    #
+    #
+
+    # Get reverb damping of all fx groups.
+    extern 'double fluid_synth_get_reverb_damp(fluid_synth_t*)'
+
+    # get reverb damp of one or all groups.
+    extern 'int fluid_synth_get_reverb_group_damp(fluid_synth_t*, int, double*)'
+
+    # get reverb level of one or all groups.
+    extern 'int fluid_synth_get_reverb_group_level(fluid_synth_t*, int, double*)'
+
+    # get reverb roomsize of one or all groups.
+    extern 'int fluid_synth_get_reverb_group_roomsize' +
+      '(fluid_synth_t*, int, double*)'
+
+    # get reverb width of one or all groups
+    extern 'int fluid_synth_get_reverb_group_width' +
+      '(fluid_synth_t*, int, double*)'
+
+    # Get reverb level of all fx groups.
+    extern 'double fluid_synth_get_reverb_level(fluid_synth_t*)'
+
+    # Get reverb room size of all fx groups.
+    extern 'double fluid_synth_get_reverb_roomsize(fluid_synth_t*)'
+
+    # Get reverb width of all fx groups.
+    extern 'double fluid_synth_get_reverb_width(fluid_synth_t*)'
+
+    # Enable or disable reverb on one fx group unit.
+    extern 'int fluid_synth_reverb_on(fluid_synth_t*, int, int)'
+
+    # Set reverb parameters to all groups.
+    extern 'int fluid_synth_set_reverb' +
+      '(fluid_synth_t*, double, double, double, double)'
+
+    # Set reverb damping of all groups.
+    extern 'int fluid_synth_set_reverb_damp(fluid_synth_t*, double)'
+
+    # Set reverb damp to one or all fx groups.
+    extern 'int fluid_synth_set_reverb_group_damp(fluid_synth_t*, int, double)'
+
+    # Set reverb level to one or all fx groups.
+    extern 'int fluid_synth_set_reverb_group_level(fluid_synth_t*, int, double)'
+
+    # Set reverb roomsize to one or all fx groups.
+    extern 'int fluid_synth_set_reverb_group_roomsize' +
+      '(fluid_synth_t*, int, double)'
+
+    # Set reverb width to one or all fx groups.
+    extern 'int fluid_synth_set_reverb_group_width(fluid_synth_t*, int, double)'
+
+    # Set reverb level of all groups.
+    extern 'int fluid_synth_set_reverb_level(fluid_synth_t*, double)'
+
+    # Enable or disable reverb effect.
+    extern 'void fluid_synth_set_reverb_on(fluid_synth_t*, int)'
+
+    # Set reverb roomsize of all groups.
+    extern 'int fluid_synth_set_reverb_roomsize(fluid_synth_t*, double)'
+
+    # Set reverb width of all groups.
+    extern 'int fluid_synth_set_reverb_width(fluid_synth_t*, double)'
+
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def synth_get_reverb_damp( synth=self.synth )
+    deprecated_msg_instead('synth_get_reverb_group_damp()', meth: __method__)
+    ret = C.fluid_synth_get_reverb_damp(synth)
+    ret
+  end
+  def synth_get_reverb_level( synth=self.synth )
+    deprecated_msg_instead('synth_get_reverb_group_level()', meth: __method__)
+    ret = C.fluid_synth_get_reverb_level(synth)
+    ret
+  end
+  def synth_get_reverb_roomsize( synth=self.synth )
+    deprecated_msg_instead('synth_get_reverb_group_roomsize()', meth: __method__)
+    ret = C.fluid_synth_get_reverb_roomsize(synth)
+    ret
+  end
+  def synth_get_reverb_width( synth=self.synth )
+    deprecated_msg_instead('synth_get_reverb_group_width()', meth: __method__)
+    ret = C.fluid_synth_get_reverb_width(synth)
+    ret
+  end
+
+  #
+  def synth_get_reverb_group_damp( synth=self.synth, fx_group: , damping: )
+    ret = C.fluid_synth_get_reverb_group_damp(synth,fx_group,damping)
+    ret
+  end
+  def synth_get_reverb_group_level( synth=self.synth, fx_group: , level: )
+    ret = C.fluid_synth_get_reverb_group_level(synth,fx_group,damping)
+    ret
+  end
+  def synth_get_reverb_group_roomsize( synth=self.synth, fx_group: , roomsize: )
+    ret = C.fluid_synth_get_reverb_group_roomsize(synth,fx_group,damping)
+    ret
+  end
+  def synth_get_reverb_group_width( synth=self.synth, fx_group: , width: )
+    ret = C.fluid_synth_get_reverb_group_width(synth,fx_group,damping)
+    ret
+  end
+
+  #
+  def synth_reverb_on( synth=self.synth, fx_group: , on: )
+    ret = C.fluid_synth_reverb_on(synth,fx_group,on)
+    ret
+  end
+
+  ### setters.
+  def synth_set_reverb( synth=self.synth, roomsize: , damping: , width: , level: )
+    deprecated_msg_instead('the individual setter functions', meth: __method__)
+    ret = C.fluid_synth_set_reverb(synth,roomsize,damping,width,level)
+    ret
+  end
+
+  #
+  def synth_set_reverb_damp( synth=self.synth, damping: )
+    deprecated_msg_instead('synth_set_reverb_group_damp()', meth: __method__)
+    ret = C.fluid_synth_set_reverb_damp(synth,damping)
+    ret
+  end
+  def synth_set_reverb_level( synth=self.synth, level: )
+    deprecated_msg_instead('synth_set_reverb_group_level()', meth: __method__)
+    ret = C.fluid_synth_set_reverb_level(synth,level)
+    ret
+  end
+  def synth_set_reverb_on( synth=self.synth, inton: )
+    deprecated_msg_instead('synth_reverb_on()', meth: __method__)
+    ret = C.fluid_synth_set_reverb_roomsize(synth, inton)
+    ret
+  end
+  def synth_set_reverb_roomsize( synth=self.synth, roomsize: )
+    deprecated_msg_instead('synth_set_reverb_group_roomsize()', meth: __method__)
+    ret = C.fluid_synth_set_reverb_roomsize(synth,roomsize)
+    ret
+  end
+  def synth_set_reverb_width( synth=self.synth, width: )
+    deprecated_msg_instead('synth_set_reverb_group_width()', meth: __method__)
+    ret = C.fluid_synth_set_reverb_width(synth,width)
+    ret
+  end
+
+  ### setters for group.
+  def synth_set_reverb_group_damp( synth=self.synth, fx_group: , damping: )
+    ret = C.fluid_synth_set_reverb_group_damp(synth,fx_group,damping)
+    ret
+  end
+  def synth_set_reverb_group_level( synth=self.synth, fx_group: , level: )
+    ret = C.fluid_synth_set_reverb_group_level(synth,fx_group,level)
+    ret
+  end
+  def synth_set_reverb_group_roomsize( synth=self.synth, fx_group: , roomsize: )
+    ret = C.fluid_synth_set_reverb_group_roomsize(synth,fx_group,roomsize)
+    ret
+  end
+  def synth_set_reverb_group_width( synth=self.synth, fx_group: , width: )
+    ret = C.fluid_synth_set_reverb_group_width(synth,fx_group,width)
+    ret
+  end
+
+
+end
+
+
+#### endof filename: synth/effect/reverb.rb

data/lib/fiddle_fluidsynth/synth/effect.rb

@@ -0,0 +1,10 @@
+#
+#
+#
+require_relative "./effect/chorus"
+require_relative "./effect/iir_filter"
+require_relative "./effect/ladspa"
+require_relative "./effect/reverb"
+
+
+####

data/lib/fiddle_fluidsynth/synth/midi/messages.rb

@@ -0,0 +1,292 @@
+#
+# filename: synth/midi/messages.rb
+#
+
+
+# References
+# - [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # The MIDI channel message functions are mostly directly named after
+  # their counterpart MIDI messages.
+  # ==== References
+  # - API Reference, Synthesizer/[MIDI Channel Messages](https://www.fluidsynth.org/api/group__midi__messages.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+  #
+  module C
+
+    # Lifecycle Functions.
+    #
+    #
+
+    # Functions.
+    #
+    #
+
+    # Turn off all voices that are playing on the given MIDI channel, by
+    # putting them into release phase.
+    extern 'int fluid_synth_all_notes_off(fluid_synth_t*, int)'
+
+    # Immediately stop all voices on the given MIDI channel (skips release
+    # phase).
+    extern 'int fluid_synth_all_sounds_off(fluid_synth_t*, int)'
+
+    # Set instrument bank number on a MIDI channel.
+    extern 'int fluid_synth_bank_select(fluid_synth_t*, int, int)'
+
+    # Send a MIDI controller event on a MIDI channel.
+    extern 'int fluid_synth_cc(fluid_synth_t*, int, int, int)'
+
+    # Set the MIDI channel pressure controller value.
+    extern 'int fluid_synth_channel_pressure(fluid_synth_t*, int, int)'
+
+    # Get current MIDI controller value on a MIDI channel.
+    extern 'int fluid_synth_get_cc(fluid_synth_t*, int, int, int*)'
+
+    # Retrieve the generator NRPN offset assigned to a MIDI channel.
+    extern 'float fluid_synth_get_gen(fluid_synth_t*, int, int)'
+
+    # Get the MIDI pitch bend controller value on a MIDI channel.
+    extern 'int fluid_synth_get_pitch_bend(fluid_synth_t*, int, int*)'
+
+    # Get MIDI pitch wheel sensitivity on a MIDI channel.
+    extern 'int fluid_synth_get_pitch_wheel_sens(fluid_synth_t*, int, int*)'
+
+    # Get current SoundFont ID, bank number and program number for a MIDI
+    # channel.
+    extern 'int fluid_synth_get_program' +
+      '(fluid_synth_t*, int, int*, int*, int*)'
+
+    # Set the MIDI polyphonic key pressure controller value.
+    extern 'int fluid_synth_key_pressure(fluid_synth_t*, int, int, int)'
+
+    # Sends a note-off event to a FluidSynth object.
+    extern 'int fluid_synth_noteoff(fluid_synth_t*, int, int)'
+
+    # Send a note-on event to a FluidSynth object.
+    extern 'int fluid_synth_noteon(fluid_synth_t*, int, int, int)'
+
+    # Set the MIDI pitch bend controller value on a MIDI channel.
+    extern 'int fluid_synth_pitch_bend(fluid_synth_t*, int, int)'
+
+    # Set MIDI pitch wheel sensitivity on a MIDI channel.
+    extern 'int fluid_synth_pitch_wheel_sens(fluid_synth_t*, int, int)'
+
+    # Send a program change event on a MIDI channel.
+    extern 'int fluid_synth_program_change(fluid_synth_t*, int, int)'
+
+    # Resend a bank select and a program change for every channel and assign
+    # corresponding instruments.
+    extern 'int fluid_synth_program_reset(fluid_synth_t*)'
+
+    # Select an instrument on a MIDI channel by SoundFont ID, bank and 
+    # program numbers.
+    extern 'int fluid_synth_program_select(fluid_synth_t*, int, int, int, int)'
+
+    # Select an instrument on a MIDI channel by SoundFont name, bank and
+    # program numbers.
+    extern 'int fluid_synth_program_select_by_sfont_name' +
+      '(fluid_synth_t*, int, char*, int, int )'
+
+    # Apply an offset to a SoundFont generator on a MIDI channel.
+    extern 'int fluid_synth_set_gen(fluid_synth_t*, int, int, float)'
+
+    # Set SoundFont ID on a MIDI channel.
+    extern 'int fluid_synth_sfont_select(fluid_synth_t*, int, int)'
+
+    # Process a MIDI SYSEX (system exclusive) message.
+    extern 'int fluid_synth_sysex' +
+      '(fluid_synth_t*, char*, int, char*, int*, int*, int)'
+
+    # Send MIDI system reset command (big red 'panic' button), turns off
+    # notes, resets controllers and restores initial basic channel
+    # configuration.
+    extern 'int fluid_synth_system_reset(fluid_synth_t*)'
+
+    # Set the preset of a MIDI channel to an unassigned state.
+    extern 'int fluid_synth_unset_program(fluid_synth_t*, int)'
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def synth_all_notes_off( synth=self.synth, ch: )
+    ret = C.fluid_synth_all_notes_off(synth, ch)
+    ret
+  end
+  def synth_all_sounds_off( synth=self.synth, ch: )
+    ret = C.fluid_synth_all_sounds_off(synth, ch)
+    ret
+  end
+
+  # def synth_bank_select( synth: , ch: , bank: )
+  def synth_bank_select( synth=self.synth, ch: , bknum: )
+    ret = C.fluid_synth_bank_select(synth, ch, bknum)
+    ret
+  end
+
+  # def synth_cc( synth: , ch: , num: , val: )
+  def synth_cc( synth=self.synth, ch: , num: , val: )
+    ret = nil
+    if (num < 0 || num > 127) || ch < 0 || (val < 0 || val > 127)
+      ret = FLUID_FAILED
+    else
+      ret = C.fluid_synth_cc(synth, ch, num, val)
+    end
+    ret
+  end
+
+  #
+  def synth_channel_pressure( synth=self.synth , ch: , val: )
+    ret = C.fluid_synth_channel_pressure(synth, ch, val)
+    ret
+  end
+
+  # getters.
+  def synth_get_cc( synth=self.synth, ch: , num: , pval: )
+    ret = C.fluid_synth_get_cc(synth, ch, num, pval)
+    ret
+  end
+
+  def synth_get_gen( synth=self.synth, ch: , param: )
+    ret = C.fluid_synth_get_gen(synth, ch, param)
+    ret
+  end
+
+  def synth_get_pitch_bend( synth=self.synth, ch: , ppitch_bend: )
+    ret = C.fluid_synth_get_pitch_bend(synth, ch, ppitch_bend)
+    ret
+  end
+
+  def synth_get_pitch_wheel_sens( synth=self.synth, ch: , pval: )
+    ret = C.fluid_synth_get_pitch_wheel_sens(synth, ch, pval)
+    ret
+  end
+
+  def synth_get_program( synth=self.synth, ch: , sfid: , bknum: , prenum: )
+    ret = C.fluid_synth_get_program(synth, ch, sfid, bknum, prenum)
+    ret
+  end
+
+  #
+  def synth_key_pressure( synth=self.synth, ch: , key: , val: )
+    ret = C.fluid_synth_key_pressure(synth, ch, key, val)
+    ret
+  end
+
+  # def synth_noteoff( synth: , ch: , key: )
+  def synth_noteoff( synth=self.synth, ch: , key: )
+    ret = nil
+    if (key < 0 || key > 127) || (ch < 0)
+      ret = FLUID_FAILED
+    else
+      ret = C.fluid_synth_noteoff(synth, ch, key)
+    end
+    ret
+  end
+
+  # def synth_noteon( synth: , ch: , key: , vel: )
+  def synth_noteon( synth=self.synth, ch: , key: , vel: )
+    ret = nil
+    if (key < 0 || key > 127) || ch < 0 || (vel < 0 || vel > 127)
+      ret = FLUID_FAILED
+    else
+      ret = C.fluid_synth_noteon(synth, ch, key, vel)
+    end
+    ret
+  end
+
+  #
+  # ==== Args
+  # val:: 8192 is the middle value (see the ref[1]).
+  def synth_pitch_bend( synth=self.synth, ch: , val: )
+    _val = val + 8192
+
+    ret = C.fluid_synth_pitch_bend(synth, ch, _val)
+    ret
+  end
+
+  # def synth_pitch_wheel_sens( synth: , ch: , val: )
+  def synth_pitch_wheel_sens( synth=self.synth, ch: , val: )
+    ret = C.fluid_synth_pitch_wheel_sens(synth, ch, val)
+    ret
+  end
+
+
+  ### program.
+
+  # def synth_program_change( synth: , ch: , prog_num: )
+  def synth_program_change( synth=self.synth, ch: , pgnum: )
+    ret = C.fluid_synth_program_change(synth, ch, pgnum)
+    ret
+  end
+
+  def synth_program_reset( synth = self.synth )
+    ret = C.fluid_synth_program_reset(synth)
+    ret
+  end
+  # def synth_program_select( synth: , ch: , sfid: , bknum: , prenum: )
+  def synth_program_select( synth=self.synth, ch: , sfid: , bknum: , prenum: )
+    ret = C.fluid_synth_program_select(
+            synth, ch, sfid, bknum, prenum)
+    ret
+  end
+
+  def synth_program_select_by_sfont_name( synth=self.synth, ch: ,
+                                          sfont_name: , bknum: , prenum: )
+    ret = C.fluid_synth_program_select_by_sfont_name(
+            synth, ch, sfont_name, bknum, prenum)
+    ret
+  end
+
+  #
+  # def synth_set_gen( synth: , ch: , param: , val: )
+  def synth_set_gen( synth=self.synth, ch: , param: , val: )
+    ret = C.fluid_synth_set_gen(synth, ch, param, val)
+    ret
+  end
+
+  # def synth_sfont_select( synth: , ch: , sfid: )
+  def synth_sfont_select( synth=self.synth, ch: , sfid: )
+    ret = C.fluid_synth_sfont_select(synth, ch, sfid)
+    ret
+  end
+
+  def synth_sysex( synth=self.synth,
+                   data: , len: ,
+                   response: , response_len: , handled: , dryrun: )
+    ret = C.fluid_synth_sysex(synth, data,len,
+                              response,response_len,
+                              handled, dryrun)
+    ret
+  end
+
+  def synth_system_reset( synth = self.synth )
+    ret = C.fluid_synth_system_reset(synth)
+    ret
+  end
+
+  def synth_unset_program( synth=self.synth, ch: )
+    ret = C.fluid_synth_unset_program(synth, ch)
+    ret
+  end
+
+
+end
+
+
+#### endof filename: synth/midi/messages.rb