fiddle_fluidsynth 0.0.1

data/lib/fiddle_fluidsynth/logging/logging.rb

@@ -0,0 +1,82 @@
+#
+# filename: fiddle-fluidstynth/logging/logging.rb
+#
+
+
+# References
+# - [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # Logging interface.
+  # ==== References
+  # - API References, [Logging](https://www.fluidsynth.org/api/group__logging.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+  # Enumerations
+  #
+  #
+
+  ### FluidSynth log levels.
+  enum(
+    :fluid_log_level,
+    FLUID_PANIC:    nil,   # The synth can't function correctly any more.
+    FLUID_ERR:      nil,   # Serious error occurred.
+    FLUID_WARN:     nil,   # Warning.
+    FLUID_INFO:     nil,   # Verbose informational messages.
+    FLUID_DBG:      nil,   # Debugging messages.
+    LAST_LOG_LEVEL: nil)
+
+  #
+  module C
+
+    # Typedefs
+    #
+    #
+
+    # Log function handler callback type used by fluid_set_log_function().
+    typealias 'fluid_log_function_t', 'void*'
+
+    # Functions.
+    #
+    #
+
+    # Default log function which prints to the stderr.
+    extern 'void fluid_default_log_function(int, char*, void*)'
+
+    # Print a message to the log.
+    extern 'int fluid_log(int, char*, ...)'
+
+    # Installs a new log function for a specified log level.
+    extern 'fluid_log_function_t fluid_set_log_function' +
+      '(int, fluid_log_function_t, void*)'
+
+  end
+end
+
+
+#
+#
+#
+class FiddleFluidSynth
+
+  def self.default_log_function( level: , message: , data: )
+    ret = C.fluid_default_log_function(level, message, data)
+    ret
+  end
+
+  def self.log( level: , fmt: , **args )
+    ret = C.fluid_log(level, fmt, args)
+    ret
+  end
+
+  def self.set_log_function( level: , func: , data: )
+    ret = C.fluid_set_log_function(level, func, data)
+    ret
+  end
+
+end
+
+
+#### endof filename: fiddle-fluidstynth/logging/logging.rb

data/lib/fiddle_fluidsynth/logging.rb

@@ -0,0 +1,6 @@
+#
+# filename: fiddle-fluidsynth/logging.rb
+#
+require_relative "./logging/logging"
+
+####

data/lib/fiddle_fluidsynth/midi_input/driver.rb

@@ -0,0 +1,77 @@
+#
+# filename: fiddle-fluidstynth/midi_input/driver.rb
+#
+
+
+# References
+# - fluidsynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # Functions for managing MIDI drivers.
+  # ==== References
+  # - MIDI Input/[MIDI Driver](https://www.fluidsynth.org/api/group__midi__driver.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+  #
+  module C
+
+
+    # Lifecycle Functions.
+    #
+    #
+
+    # Create a new MIDI driver instance.
+    # [MIDI driver settings](https://www.fluidsynth.org/api/settings_midi.html)
+    # [Settings Reference](https://www.fluidsynth.org/api/fluidsettings.html)
+    #
+    extern 'fluid_midi_driver_t* new_fluid_midi_driver' +
+      '(fluid_settings_t*, handle_midi_event_func_t*, void*)'
+
+    # Delete a MIDI driver instance.
+    extern 'void delete_fluid_midi_driver(fluid_midi_driver_t*)'    #
+
+
+    # Functions.
+    #
+    #
+
+
+  end
+end
+
+
+#
+#
+#
+class FiddleFluidSynth
+
+  #
+  #
+  # ==== See Also
+  # - util/callback.rb
+  #
+  def self.midi_driver_new( settings: ,
+                            handler: Midi_event_func_default, handler_data: nil )
+    ret = C.new_fluid_midi_driver(settings, handler, handler_data)
+    ret
+  end
+  def midi_driver_new( settings = self.settings,
+                       handler: Midi_event_func_default, handler_data: nil )
+    self.class.midi_driver_new(
+      settings: settings, handler: handler, handler_data: handler_data)
+  end
+
+  def self.midi_driver_delete( driver )
+    ret = C.delete_fluid_midi_driver(driver)
+    ret
+  end
+  def midi_driver_delete( driver )
+    self.class.midi_driver_delete(driver)
+  end
+
+end
+
+
+#### endof filename: fiddle-fluidstynth/midi_input/driver.rb

data/lib/fiddle_fluidsynth/midi_input/events.rb

@@ -0,0 +1,255 @@
+#
+# filename: fiddle-fluidstynth/midi_input/events.rb
+#
+
+
+# References
+# - fluidsynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # Functions to create, modify, query and delete MIDI events.
+  # ==== References
+  # - API Reference, MIDI Input/[MIDI Events](https://www.fluidsynth.org/api/group__midi__events.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  # ==== See Also
+  # - sequencer/events.rb
+
+  #
+  module C
+
+    # Lifecycle Functions.
+    #
+    #
+
+    # Create a MIDI event structure.
+    extern 'fluid_midi_event_t* new_fluid_midi_event(void)'
+
+    # Delete MIDI event structure.
+    extern 'void delete_fluid_midi_event(fluid_midi_event_t*)'
+
+
+    # Functions.
+    #
+    #
+
+    # Get the channel field of a MIDI event structure.
+    extern 'int fluid_midi_event_get_channel(fluid_midi_event_t*)'
+
+    # Get the control number of a MIDI event structure.
+    extern 'int fluid_midi_event_get_control(fluid_midi_event_t*)'
+
+    # Get the key field of a MIDI event structure.
+    extern 'int fluid_midi_event_get_key(fluid_midi_event_t*)'
+
+    # Get the lyric of a MIDI event structure.
+    #  FIXME. void**
+    # extern 'int fluid_midi_event_get_lyrics(void*, void**, void*)'
+    extern 'int fluid_midi_event_get_lyrics(fluid_midi_event_t*, void*, void*)'
+
+    # Get the pitch field of a MIDI event structure.
+    extern 'int fluid_midi_event_get_pitch(fluid_midi_event_t*)'
+
+    #  Get the program field of a MIDI event structure.
+    extern 'int fluid_midi_event_get_program(fluid_midi_event_t*)'
+
+    # Get the text of a MIDI event structure.
+    #  FIXME. void**
+    # extern 'int fluid_midi_event_get_text(void*, void**, void*)'
+    extern 'int fluid_midi_event_get_text(fluid_midi_event_t*, void*, void*)'
+
+    # Get the event type field of a MIDI event structure.
+    extern 'int fluid_midi_event_get_type(fluid_midi_event_t*)'
+
+    # Get the value field from a MIDI event structure.
+    extern 'int fluid_midi_event_get_value(fluid_midi_event_t*)'
+
+    # Get the velocity field of a MIDI event structure.
+    extern 'int fluid_midi_event_get_velocity(fluid_midi_event_t*)'
+
+    ###
+
+    # Set the channel field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_channel(fluid_midi_event_t*, int)'
+
+    # Set the control field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_control(fluid_midi_event_t*, int)'
+
+    # Set the key field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_key(fluid_midi_event_t*, int)'
+
+    # Assign lyric data to a MIDI event structure.
+    extern 'int fluid_midi_event_set_lyrics' +
+      '(fluid_midi_event_t*, void*, int, int)'
+
+    # Set the pitch field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_pitch(fluid_midi_event_t*, int)'
+
+    # Set the program field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_program(fluid_midi_event_t*, int)'
+
+    # Assign sysex data to a MIDI event structure.
+    extern 'int fluid_midi_event_set_sysex(fluid_midi_event_t*, void*, int, int)'
+
+    # Assign text data to a MIDI event structure.
+    extern 'int fluid_midi_event_set_text(fluid_midi_event_t*, void*, int, int)'
+
+    #  Set the event type field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_type(fluid_midi_event_t*, int)'
+
+    #  Set the value field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_value(fluid_midi_event_t*, int)'
+
+    #  Set the velocity field of a MIDI event structure.
+    extern 'int fluid_midi_event_set_velocity(fluid_midi_event_t*, int)'
+
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+class FiddleFluidSynth
+
+  def self.midi_event_new()
+    ret = C.new_fluid_midi_event()
+    ret
+  end
+  def midi_event_new()
+    self.class.midi_event_new()
+  end
+
+  def self.midi_event_delete( ev )
+    ret = C.delete_fluid_midi_event(ev)
+    ret
+  end
+  def midi_event_delete( ev )
+    self.class.midi_event_delete(ev)
+  end
+
+end
+
+
+# Functions.
+#
+#
+
+### getter-related midi event.
+class FiddleFluidSynth
+
+  def midi_event_get_channel( ev )
+    ret = C.fluid_midi_event_get_channel(ev)
+    ret
+  end
+
+  def midi_event_get_control( ev )
+    ret = C.fluid_midi_event_get_control(ev)
+    ret
+  end
+
+  def midi_event_get_key( ev )
+    ret = C.fluid_midi_event_get_key(ev)
+    ret
+  end
+
+  def midi_event_get_lyrics( ev, data, size )
+    ret = C.fluid_midi_event_get_lyrics(ev, data, size)
+    ret
+  end
+
+  def midi_event_get_pitch( ev )
+    ret = C.fluid_midi_event_get_pitch(ev)
+    ret
+  end
+
+  def midi_event_get_program( ev )
+    ret = C.fluid_midi_event_get_program(ev)
+    ret
+  end
+
+  def midi_event_get_text( ev, data: , size: )
+    ret = C.fluid_midi_event_get_text(ev, data, size)
+    ret
+  end
+
+  def midi_event_get_type( ev )
+    ret = C.fluid_midi_event_get_type(ev)
+    ret
+  end
+
+  def midi_event_get_value( ev )
+    ret = C.fluid_midi_event_get_value(ev)
+    ret
+  end
+
+  def midi_event_get_velocity( ev )
+    ret = C.fluid_midi_event_get_velocity(ev)
+    ret
+  end
+
+end
+
+### setter-related midi events.
+class FiddleFluidSynth
+
+  def midi_event_set_channel( ev, ch: )
+    ret = C.fluid_midi_event_set_channel(ev, ch)
+    ret
+  end
+
+  def midi_event_set_control( ev, ctrl: )
+    ret = C.fluid_midi_event_set_control(ev, ctrl)
+    ret
+  end
+
+  def midi_event_set_key( ev, key: )
+    ret = C.fluid_midi_event_set_key(ev, key)
+    ret
+  end
+
+  def midi_event_set_lyrics( ev, data: , size: , dynamic: )
+    ret = C.fluid_midi_event_set_lyrics(ev, data, size, dynamic)
+    ret
+  end
+
+  def midi_event_set_pitch( ev, val: )
+    ret = C.fluid_midi_event_set_pitch(ev, val)
+    ret
+  end
+
+  def midi_event_set_program( ev, val: )
+    ret = C.fluid_midi_event_set_program(ev, val)
+    ret
+  end
+
+  def midi_event_set_sysex( ev, data: , size: , dynamic: )
+    ret = C.fluid_midi_event_set_sysex(ev, data, size, dynamic)
+    ret
+  end
+
+  def midi_event_set_text( ev, data: , size: , dynamic: )
+    ret = C.fluid_midi_event_set_text(ev, data, size, dynamic)
+    ret
+  end
+
+  def midi_event_set_type( ev, type: )
+    ret = C.fluid_midi_event_set_type(ev, type)
+    ret
+  end
+
+  def midi_event_set_value( ev, val: )
+    ret = C.fluid_midi_event_set_value(ev, val)
+    ret
+  end
+
+  def midi_event_set_velocity( ev, val: )
+    ret = C.fluid_midi_event_set_velocity(ev, val)
+    ret
+  end
+
+end
+
+
+#### endof filename: fiddle-fluidstynth/midi_input/events.rb

data/lib/fiddle_fluidsynth/midi_input/midi_input.rb

@@ -0,0 +1,70 @@
+#
+# filename: fiddle-fluidstynth/midi_input/midi_input.rb
+#
+
+
+# References
+# - fluidsynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # MIDI Input Subsystem.
+  # ==== References
+  # - MIDI Input/[MIDI Driver](https://www.fluidsynth.org/api/group__midi__driver.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+  #
+  module C
+
+    # Typedefs.
+    #
+    #
+
+    # Generic callback function for MIDI event handler.
+    # typedef int(*handle_midi_event_func_t) (void *data, fluid_midi_event_t *event)
+    typealias 'handle_midi_event_func_t', 'void*'
+
+    # Generic callback function fired once by MIDI tick change.
+    # typedef int(*handle_midi_tick_func_t) (void *data, int tick)
+    typealias 'handle_midi_tick_func_t',  'void*'
+
+
+    # Lifecycle Functions.
+    #
+    #
+
+
+    # Functions.
+    #
+    #
+
+    # Handle MIDI event from MIDI router, used as a callback function.
+    extern 'int fluid_synth_handle_midi_event(void*, fluid_midi_event_t*)'
+
+  end
+end
+
+
+#
+#
+#
+class FiddleFluidSynth
+
+  #
+  # ==== See ALso
+  # - midi_input/router.rb
+  # - util/callback.rb:define_tick_callback().
+  #
+  def self.synth_handle_midi_event( data, event )
+    ret = C.fluid_synth_handle_midi_event(data, event)
+    ret
+  end
+  def synth_handle_midi_event( data, event )
+    self.class.synth_handle_midi_event(data, event)
+  end
+
+end
+
+
+#### endof filename: fiddle-fluidstynth/midi_input/midi_input.rb