fiddle_fluidsynth 0.0.1

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

@@ -0,0 +1,235 @@
+#
+# filename: fiddle-fluidsynth/synth/midi/setup.rb
+#
+
+
+# References
+# - fluidsynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # The functions in this section provide interfaces to change the channel
+  # type and to configure basic channels, legato and portamento setups.
+  # ==== References
+  # - API Reference, Synthesizer/[MIDI Channel Setup](https://www.fluidsynth.org/api/group__channel__setup.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+  # Enumerators.
+  #
+  #
+
+  ### Channel Type
+
+  # The midi channel type used by fluid_synth_set_channel_type().
+  enum(
+    :fluid_midi_channel_type,
+    CHANNEL_TYPE_MELODIC: 0,
+    CHANNEL_TYPE_DRUM:    1,
+  )
+
+  ### Basic Channel Mode.
+
+  # Channel mode bits OR-ed together so that it matches with the midi spec:
+  # poly omnion (0), mono omnion (1), poly omnioff (2), mono omnioff (3).
+  enum(
+    :fluid_channel_mode_flags,
+    FLUID_CHANNEL_POLY_OFF: 0x01,
+    FLUID_CHANNEL_OMNI_OFF: 0x02)
+
+  # Indicates the mode a basic channel is set to.
+  FLUID_CHANNEL_MODE_MASK_EXT=(FLUID_CHANNEL_OMNI_OFF|FLUID_CHANNEL_POLY_OFF)
+  enum(
+    :fluid_basic_channel_modes,
+    FLUID_CHANNEL_MODE_MASK:  FLUID_CHANNEL_MODE_MASK_EXT,
+    FLUID_CHANNEL_MODE_OMNION_POLY:   FLUID_CHANNEL_MODE_MASK_EXT &
+                                        (~FLUID_CHANNEL_OMNI_OFF&
+                                         ~FLUID_CHANNEL_POLY_OFF),
+    FLUID_CHANNEL_MODE_OMNION_MONO:   FLUID_CHANNEL_MODE_MASK_EXT &
+                                        (~FLUID_CHANNEL_OMNI_OFF&
+                                         FLUID_CHANNEL_POLY_OFF),
+    FLUID_CHANNEL_MODE_OMNIOFF_POLY:  FLUID_CHANNEL_MODE_MASK_EXT &
+                                        (FLUID_CHANNEL_OMNI_OFF&
+                                         ~FLUID_CHANNEL_POLY_OFF),
+    FLUID_CHANNEL_MODE_OMNIOFF_MONO:  FLUID_CHANNEL_MODE_MASK_EXT &
+                                        (FLUID_CHANNEL_OMNI_OFF|
+                                         FLUID_CHANNEL_POLY_OFF),
+    FLUID_CHANNEL_MODE_LAST: nil,
+  )
+
+  ### Legato Mode.
+
+  # Indicates the legato mode a channel is set to n1,n2,n3,.
+  enum(
+    :fluid_channel_legato_mode,
+    FLUID_CHANNEL_LEGATO_MODE_RETRIGGER:       nil,
+    FLUID_CHANNEL_LEGATO_MODE_MULTI_RETRIGGER: nil,
+    FLUID_CHANNEL_LEGATO_MODE_LAST:            nil)
+
+  ### Portamento Mode.
+
+  # Indicates the portamento mode a channel is set to.
+  enum(
+    :fluid_channel_portamento_mode,
+    FLUID_CHANNEL_PORTAMENTO_MODE_EACH_NOTE:      nil,
+    FLUID_CHANNEL_PORTAMENTO_MODE_LEGATO_ONLY:    nil,
+    FLUID_CHANNEL_PORTAMENTO_MODE_STACCATO_ONLY:  nil,
+    FLUID_CHANNEL_PORTAMENTO_MODE_LAST:           nil)
+
+  ### Breath Mode.
+
+  # Indicates the breath mode a channel is set to.
+  enum(
+    :fluid_channel_breath_flags,
+    FLUID_CHANNEL_BREATH_POLY: 0x10,
+    FLUID_CHANNEL_BREATH_MONO: 0x20,
+    FLUID_CHANNEL_BREATH_SYNC: 0x40)
+
+
+  #
+  module C
+
+
+    # Functions.
+    #
+    #
+
+    ### Channel Type
+
+    # Set midi channel type.
+    extern 'int fluid_synth_set_channel_type(fluid_synth_t*, int, int)'
+
+
+    ### Basic Channel Mode
+
+    # Disables and unassigns all channels from a basic channel group.
+    extern 'int fluid_synth_reset_basic_channel(fluid_synth_t*, int)'
+
+    # Returns poly mono mode information of any MIDI channel.
+    extern 'int fluid_synth_get_basic_channel' +
+      '(fluid_synth_t*, int, int*, int*, int*)'
+
+    # Sets a new basic channel group only.
+    extern 'int fluid_synth_set_basic_channel(fluid_synth_t*, int, int, int)'
+
+
+    # Legato Mode.
+    #
+    #
+
+    # Sets the legato mode of a channel.
+    extern 'int fluid_synth_set_legato_mode(fluid_synth_t*, int, int)'
+
+    # Gets the legato mode of a channel.
+    extern 'int fluid_synth_get_legato_mode(fluid_synth_t*, int, int*)'
+
+
+    # Portamento Mode.
+    #
+    #
+
+    # Sets the portamento mode of a channel.
+    extern 'int fluid_synth_set_portamento_mode(fluid_synth_t*, int, int)'
+
+    #  Gets the portamento mode of a channel.
+    extern 'int fluid_synth_get_portamento_mode(fluid_synth_t*, int, int*)'
+
+
+    # Breath Mode.
+    #
+    #
+
+
+    # Sets the breath mode of a channel.
+    extern 'int fluid_synth_set_breath_mode(fluid_synth_t*, int, int)'
+
+    # Gets the breath mode of a channel.
+    extern 'int fluid_synth_get_breath_mode(fluid_synth_t*, int, int*)'
+
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  # Channel Type
+  #
+  #
+  def synth_set_channel_type( synth=self.synth, ch: , type: )
+    ret = C.fluid_synth_set_channel_type(synth, ch, type)
+    ret
+  end
+
+  # Basic Channel Mode.
+  #
+  #
+  def synth_reset_basic_channel( synth=self.synth, ch: )
+    ret = C.fluid_synth_reset_basic_channel(synth, ch)
+    ret
+  end
+
+  #
+  # ==== Args
+  #
+  def synth_get_basic_channel( synth=self.synth, ch: ,
+                               basic_ch_out: , mode_out: ,
+                               val_out: )
+    ret = C.fluid_synth_get_basic_channel(
+            synth, ch, basic_ch_out, mode_out, val_out)
+    ret
+  end
+  def synth_set_basic_channel( synth=self.synth, ch: , mode: , val: )
+    ret = C.fluid_synth_set_basic_channel(synth, ch, mode, val)
+    ret
+  end
+
+  # Breath Mode.
+  #
+  #
+  def synth_set_breath_mode( synth=self.synth, ch: , breath_mode: )
+    ret = C.fluid_synth_set_breath_mode(synth, ch, breath_mode)
+    ret
+  end
+  def synth_get_breath_mode( synth=self.synth, ch: , out_mode: )
+    ret = C.fluid_synth_get_breath_mode(synth, ch, out_mode)
+    ret
+  end
+
+  # Legato Mode.
+  #
+  #
+  def synth_set_legato_mode( synth=self.synth, ch: , legato_mode: )
+    ret = C.fluid_synth_set_legato_mode(synth, ch, legato_mode)
+    ret
+  end
+  def synth_get_legato_mode( synth=self.synth, ch: , out_mode: )
+    ret = C.fluid_synth_get_legato_mode(synth, ch, out_mode)
+    ret
+  end
+
+  # Portamento Mode.
+  #
+  #
+  def synth_set_portamento_mode( synth=self.synth, ch: , portamento_mode: )
+    ret = C.fluid_synth_set_portamento_mode(synth, ch, portamento_mode)
+    ret
+  end
+  def synth_get_portamento_mode( synth=self.synth, ch: , out_mode: )
+    ret = C.fluid_synth_get_portamento_mode(synth, ch, out_mode)
+    ret
+  end
+
+
+end
+
+
+#### endof filename: fiddle-fluidsynth/synth/midi/setup.rb

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

@@ -0,0 +1,128 @@
+#
+# filename: fiddle-fluidstynth/synth/midi/tuning.rb
+#
+
+
+# References
+# - fluidsynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # The functions in this section implement the MIDI Tuning Standard
+  # interface.
+  # ==== References
+  # - API Reference, Synthesizer/[MIDI Tuning](https://www.fluidsynth.org/api/group__tuning.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+  #
+  module C
+
+    # Lifecycle Functions.
+    #
+    #
+
+
+    # Functions.
+    #
+    #
+
+    # Set the tuning of the entire MIDI note scale.
+    extern 'int fluid_synth_activate_key_tuning' +
+      '(fluid_synth_t*, int, int, char*, double*, int)'
+
+    # Activate an octave tuning on every octave in the MIDI note scale.
+    extern 'int fluid_synth_activate_octave_tuning' +
+      '(fluid_synth_t*, int, int, char*, double*, int)'
+
+    # Activate a tuning scale on a MIDI channel.
+    extern 'int fluid_synth_activate_tuning(fluid_synth_t*, int, int, int, int)'
+
+    # Clear tuning scale on a MIDI channel (use default equal tempered scale).
+    extern 'int fluid_synth_deactivate_tuning(fluid_synth_t*, int, int)'
+
+    # Set tuning values for one or more MIDI notes for an existing tuning.
+    extern 'int fluid_synth_tune_notes' +
+      '(fluid_synth_t*, int, int, int, int*, double*, int)'
+
+    # Get the entire note tuning for a given MIDI bank and program.
+    extern 'int fluid_synth_tuning_dump' +
+      '(fluid_synth_t*, int, int, char*, int, double*)'
+
+    # Advance to next tuning.
+    extern 'int fluid_synth_tuning_iteration_next(fluid_synth_t*, int*, int*)'
+
+    # Start tuning iteration.
+    extern 'void fluid_synth_tuning_iteration_start(fluid_synth_t*)'
+
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def synth_activate_key_tuning( synth=self.synth,
+                                 bknum: , pgnum: , name: , pitch: , apply: )
+    ret = C.fluid_synth_activate_key_tuning(
+            synth, bknum, pgnum, name, pitch, apply)
+    ret
+  end
+
+  def synth_activate_octave_tuning( synth=self.synth,
+                                    bknum: , pgnum: , name: , pitch: , apply: )
+    ret = C.fluid_synth_activate_octave_tuning(
+            synth, bknum, pgnum, name, pitch, apply)
+    ret
+  end
+
+  def synth_activate_tuning( synth=self.synth, ch: , bknum: , pgnum: , apply: )
+    ret = C.fluid_synth_activate_tuning(synth, ch, bknum, pgnum, apply)
+    ret
+  end
+
+  #
+  # ==== Args
+  # apply:: TRUE to apply tuning change to active notes, FALSE otherwise
+  #
+  def synth_deactivate_tuning( synth=self.synth, ch: , apply: )
+    ret = C.fluid_synth_deactivate_tuning(synth, ch, apply)
+    ret
+  end
+
+  def synth_tune_notes( synth=self.synth,
+                        bknum: , pgnum: , len: , key: , pitch: , apply: )
+    ret = C.fluid_synth_tune_notes(synth, bknum, pgnum, len, key, pitch, apply)
+    ret
+  end
+
+  def synth_tuning_dump( synth=self.synth,
+                         bknum: , pgnum: , name: , len: , pitch: )
+    ret = C.fluid_synth_tuning_dump(synth, bknum, pgnum, name, len, pitch)
+    ret
+  end
+
+  def synth_tuning_iteration_next( synth=self.synth, bknum: ,  pgnum: )
+    ret = C.fluid_synth_tuning_iteration_next(synth, bknum, pgnum)
+    ret
+  end
+
+  def synth_tuning_iteration_start( synth=self.synth )
+    ret = C.fluid_synth_tuning_iteration_start(synth)
+    ret
+  end
+
+
+end
+
+
+#### endof filename: fiddle-fluidstynth/synth/midi/tuning.rb

data/lib/fiddle_fluidsynth/synth/midi.rb

@@ -0,0 +1,9 @@
+#
+#
+#
+require_relative "./midi/messages"
+require_relative "./midi/setup"
+require_relative "./midi/tuning"
+
+
+####

data/lib/fiddle_fluidsynth/synth/params/params.rb

@@ -0,0 +1,200 @@
+#
+# filename: fiddle-fluidsynth/synth/params/params.rb
+#
+
+
+# References
+# - fluidsynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # Functions to control and query synthesis parameters like gain and
+  # polyphony count.
+  # ==== References
+  # - API Reference, Synthesizer/[Parameters](https://www.fluidsynth.org/api/group__synthesis__params.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+
+  # Enumerations.
+  #
+  #
+
+  FLUID_INTERP_4THORDER_EXT = 4
+  FLUID_INTERP_7THORDER_EXT = 7
+  enum(
+    :fluid_interp,
+    FLUID_INTERP_NONE:      0,
+    FLUID_INTERP_LINEAR:    1,
+    FLUID_INTERP_4THORDER:  FLUID_INTERP_4THORDER_EXT,
+    FLUID_INTERP_7THORDER:  FLUID_INTERP_7THORDER_EXT,
+    FLUID_INTERP_DEFAULT:   FLUID_INTERP_4THORDER_EXT,
+    FLUID_INTERP_HIGHEST:   FLUID_INTERP_7THORDER_EXT,
+  )
+
+  enum(
+    :fluid_synth_add_mod,
+    FLUID_SYNTH_OVERWRITE: nil,
+    FLUID_SYNTH_ADD:       nil)
+
+  #
+  module C
+
+
+    # Lifecycle Functions.
+    #
+    #
+
+
+    # Functions.
+    #
+    #
+
+    # Adds the specified modulator mod as default modulator to the synth.
+    extern 'int fluid_synth_add_default_mod(fluid_synth_t*, fluid_mod_t*, int)'
+
+    # Get the total count of audio channels.
+    extern 'int fluid_synth_count_audio_channels(fluid_synth_t*)'
+
+    # Get the total number of allocated audio channels.
+    extern 'int fluid_synth_count_audio_groups(fluid_synth_t*)'
+
+    # Get the total number of allocated effects channels.
+    extern 'int fluid_synth_count_effects_channels(fluid_synth_t*)'
+
+    # Get the total number of allocated effects units.
+    extern 'int fluid_synth_count_effects_groups(fluid_synth_t*)'
+
+    # Get the total count of MIDI channels.
+    extern 'int fluid_synth_count_midi_channels(fluid_synth_t*)'
+
+    # Get current number of active voices.
+    extern 'int fluid_synth_get_active_voice_count(fluid_synth_t*)'
+
+    # Get synth output gain value.
+    extern 'float fluid_synth_get_gain(fluid_synth_t*)'
+
+    # Get the internal synthesis buffer size value.
+    extern 'int fluid_synth_get_internal_bufsize(fluid_synth_t*)'
+
+    # Get current synthesizer polyphony (max number of voices).
+    extern 'int fluid_synth_get_polyphony(fluid_synth_t*)'
+
+    # Removes the specified modulator mod from the synth's default modulator
+    # list.
+    extern 'int fluid_synth_remove_default_mod(fluid_synth_t*, fluid_mod_t*)'
+
+    # Set synth output gain value.
+    extern 'void fluid_synth_set_gain(fluid_synth_t*, float)'
+
+    # Set synthesis interpolation method on one or all MIDI channels.
+    extern 'int fluid_synth_set_interp_method(fluid_synth_t*, int, int)'
+
+    # Set synthesizer polyphony (max number of voices).
+    extern 'int fluid_synth_set_polyphony(fluid_synth_t*, int)'
+
+    # Set up an event to change the sample-rate of the synth during the next
+    # rendering call.
+    extern 'void fluid_synth_set_sample_rate(fluid_synth_t*, float)'
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def synth_add_default_mod( synth=self.synth, mod: , mode: )
+    ret = C.fluid_synth_add_default_mod(synth,mod,mode)
+    ret
+  end
+
+  #
+  def synth_count_audio_channels( synth=self.synth )
+    ret = C.fluid_synth_count_audio_channels(synth)
+    ret
+  end
+
+  def synth_count_audio_groups( synth=self.synth )
+    ret = C.fluid_synth_count_audio_groups(synth)
+    ret
+  end
+
+  def synth_count_effects_channels( synth=self.synth )
+    ret = C.fluid_synth_count_effects_channels(synth)
+    ret
+  end
+
+  def synth_count_effects_groups( synth=self.synth )
+    ret = C.fluid_synth_count_effects_groups(synth)
+    ret
+  end
+
+  def synth_count_midi_channels( synth=self.synth )
+    ret = C.fluid_synth_count_midi_channels(synth)
+    ret
+  end
+
+  #
+  def synth_get_active_voice_count( synth=self.synth )
+    ret = C.fluid_synth_get_active_voice_count(synth)
+    ret
+  end
+
+  def synth_get_gain( synth=self.synth )
+    ret = C.fluid_synth_get_gain(synth)
+    ret
+  end
+
+  def synth_get_internal_bufsize( synth=self.synth )
+    ret = C.fluid_synth_get_internal_bufsize(synth)
+    ret
+  end
+
+  def synth_get_polyphony( synth=self.synth )
+    ret = C.fluid_synth_get_polyphony(synth)
+    ret
+  end
+
+  #
+  def synth_remove_default_mod( synth=self.synth, mod: )
+    ret = C.fluid_synth_remove_default_mod(synth, mod)
+    ret
+  end
+
+  def synth_set_gain( synth=self.synth, gain: )
+    ret = C.fluid_synth_set_gain(synth, gain)
+    ret
+  end
+
+  def synth_set_interp_method( synth=self.synth, ch: , interp_method: )
+    ret = C.fluid_synth_set_interp_method(synth, ch, interp_method)
+    ret
+  end
+
+  def synth_set_polyphony( synth=self.synth, polyphony: )
+    ret = C.fluid_synth_set_polyphony(synth, polyphony)
+    ret
+  end
+
+  #
+  # - [fluid_synth_set_sample_rate()](https://www.fluidsynth.org/api/group__synthesis__params.html#ga58a436738d2a21b160b0732024bb4dbe)
+  #
+  def synth_set_sample_rate( synth=self.synth, sample_rate: )
+    deprecated_msg(__method__)
+    ret = C.fluid_synth_set_sample_rate(synth, sample_rate)
+    ret
+  end
+
+end
+
+
+#### endof filename: fiddle-fluidsynth/synth/params/params.rb

data/lib/fiddle_fluidsynth/synth/params.rb

@@ -0,0 +1,8 @@
+#
+# filename: fiddle-fluidsynth/synth/params.rb
+#
+
+require_relative "./params/params"
+
+
+####