fiddle_fluidsynth 0.0.1

data/lib/fiddle_fluidsynth/soundfonts/modulators.rb

@@ -0,0 +1,247 @@
+#
+# filename: fiddle-fluidstynth/soundfonts/modulators.rb
+#
+
+
+# References
+# - fluidstynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # SoundFont modulator functions and constants.
+  # ==== References
+  # - API Reference, SoundFont/[SoundFont Modulators](https://www.fluidsynth.org/api/group__modulators.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+  #
+
+
+  # Enumerations.
+  #
+  #
+
+  # Flags defining the polarity, mapping function and type of a modulator
+  # source.
+  enum(
+    :fluid_mod_flags,
+    FLUID_MOD_POSITIVE: 0,
+    FLUID_MOD_NEGATIVE: 1,
+
+    FLUID_MOD_UNIPOLAR: 0,
+    FLUID_MOD_BIPOLAR:  2,
+
+    FLUID_MOD_LINEAR:    0,
+    FLUID_MOD_CONCAVE:   4,
+    FLUID_MOD_CONVEX:    8,
+    FLUID_MOD_SWITCH:   12,
+
+    FLUID_MOD_GC:        0,
+    FLUID_MOD_CC:       16,
+    FLUID_MOD_CUSTOM: 0x40,
+    FLUID_MOD_SIN:    0x80)
+
+  # General controller (if FLUID_MOD_GC in flags). 
+  enum(
+    :fluid_mod_src,
+    FLUID_MOD_NONE:              0,
+    FLUID_MOD_VELOCITY:          2,
+    FLUID_MOD_KEY:               3,
+    FLUID_MOD_KEYPRESSURE:      10,
+    FLUID_MOD_CHANNELPRESSURE:  13,
+    FLUID_MOD_PITCHWHEEL:       14,
+    FLUID_MOD_PITCHWHEELSENS:   16,
+  )
+
+  # Transform types for the SoundFont2 modulators as defined by
+  # SoundFont 2.04 section 8.3.
+  enum(
+    :fluid_mod_transforms,
+    FLUID_MOD_TRANSFORM_LINEAR: 0,
+    FLUID_MOD_TRANSFORM_ABS:    2)
+
+
+  #
+  #
+  #
+  module C
+
+
+    # Lifecycle Functions (MIDI Sequencer).
+    #
+    #
+
+    # Create a new uninitialized modulator structure.
+    extern 'fluid_mod_t* new_fluid_mod(void)'
+
+    # Free a modulator structure.
+    extern 'void delete_fluid_mod(fluid_mod_t*)'
+
+
+    # Functions.
+    #
+    #
+
+    # Clone the modulators destination, sources, flags and amount.
+    extern 'void fluid_mod_clone(fluid_mod_t*, fluid_mod_t*)'
+
+    # Get the scale amount from a modulator.
+    extern 'double fluid_mod_get_amount(fluid_mod_t*)'
+
+    # Get destination effect from a modulator.
+    extern 'int fluid_mod_get_dest(fluid_mod_t*)'
+
+    # Get primary source flags from a modulator.
+    extern 'int fluid_mod_get_flags1(fluid_mod_t*)'
+
+    # Get secondary source flags from a modulator.
+    extern 'int fluid_mod_get_flags2(fluid_mod_t*)'
+
+    # Get the primary source value from a modulator.
+    extern 'int fluid_mod_get_source1(fluid_mod_t*)'
+
+    # Get the secondary source value from a modulator.
+    extern 'int fluid_mod_get_source2(fluid_mod_t*)'
+
+    # Get the transform type of a modulator.
+    extern 'int fluid_mod_get_transform(fluid_mod_t*)'
+
+    # Check if the modulator has the given destination.
+    extern 'int fluid_mod_has_dest(fluid_mod_t*, int)'
+
+    # Check if the modulator has the given source.
+    extern 'int fluid_mod_has_source(fluid_mod_t*, int, int)'
+
+    # Set the scale amount of a modulator.
+    extern 'void fluid_mod_set_amount(fluid_mod_t*, double)'
+
+    # Set the destination effect of a modulator.
+    extern 'void fluid_mod_set_dest(fluid_mod_t*, int)'
+
+    # Set a modulator's primary source controller and flags.
+    extern 'void fluid_mod_set_source1(fluid_mod_t*, int, int)'
+
+    # Set a modulator's secondary source controller and flags.
+    extern 'void fluid_mod_set_source2(fluid_mod_t*, int, int)'
+
+    # Set the transform type of a modulator.
+    extern 'void fluid_mod_set_transform(fluid_mod_t*, int)'
+
+    # Returns the size of the fluid_mod_t structure.
+    extern 'size_t fluid_mod_sizeof(void)'
+
+    # Checks if two modulators are identical in sources, flags and destination.
+    extern 'int fluid_mod_test_identity(fluid_mod_t*, fluid_mod_t*)'
+
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def mod_new()
+    ret = C.new_fluid_mod()
+    ret
+  end
+
+  def mod_delete( mod )
+    ret = C.delete_fluid_mod(mod)
+    ret
+  end
+
+
+end
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def mod_clone( mod, src: )
+    ret = C.fluid_mod_clone(mod, src)
+    ret
+  end
+
+  def mod_get_amount( mod )
+    ret = C.fluid_mod_get_amount(mod)
+    ret
+  end
+
+  def mod_get_dest( mod )
+    ret = C.fluid_mod_get_dest(mod)
+    ret
+  end
+
+  def mod_get_flags1( mod )
+    ret = C.fluid_mod_get_flags1(mod)
+    ret
+  end
+  def mod_get_flags2( mod )
+    ret = C.fluid_mod_get_flags2(mod)
+    ret
+  end
+  def mod_get_source1( mod )
+    ret = C.fluid_mod_get_source1(mod)
+    ret
+  end
+  def mod_get_source2( mod )
+    ret = C.fluid_mod_get_source2(mod)
+    ret
+  end
+
+  #
+  def mod_get_transform( mod )
+    ret = C.fluid_mod_get_transform(mod)
+    ret
+  end
+
+  #
+  def mod_has_dest( mod, gen: )
+    ret = C.fluid_mod_has_dest(mod,gen)
+    ret
+  end
+  def mod_has_source( mod, cc: , ctrl: )
+    ret = C.fluid_mod_has_source(mod,cc,ctrl)
+    ret
+  end
+
+  #
+  def mod_set_amount( mod, amount: )
+    ret = C.fluid_mod_set_amount(mod, amount)
+    ret
+  end
+  def mod_set_dest( mod, dst: )
+    ret = C.fluid_mod_set_dest(mod, dst)
+    ret
+  end
+  def mod_set_source1( mod, src: , flags: )
+    ret = C.fluid_mod_set_amount(mod, amount)
+    ret
+  end
+  def mod_set_source2( mod, src: , flags: )
+    ret = C.fluid_mod_set_amount(mod, amount)
+    ret
+  end
+  def mod_set_transform( mod, type: )
+    ret = C.fluid_mod_set_amount(mod, amount)
+    ret
+  end
+
+  def mod_sizeof
+    ret = C.fluid_mod_sizeof()
+    ret
+  end
+  def mod_test_identity( mod1: , mod2: )
+    ret = C.fluid_mod_test_identity(mod1, mod2)
+    ret
+  end
+
+
+end
+
+
+#### endof filename: fiddle-fluidstynth/soundfonts/modulators.rb

data/lib/fiddle_fluidsynth/soundfonts/soundfonts.rb

@@ -0,0 +1,64 @@
+#
+# filename: soundfonts/soundfonts.rb
+#
+
+
+# References
+# - fluidsynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  #
+  module C
+
+    # SoundFont related functions.
+    # ==== References
+    # - API Reference, [SoundFonts](https://www.fluidsynth.org/api/group__soundfonts.html)
+    # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+    #
+
+
+    # Lifecycle Functions.
+    #
+    #
+
+
+    # Functions.
+    #
+    #
+
+    # Pins all samples of the given preset.
+    extern 'int fluid_synth_pin_preset(fluid_synth_t*, int, int, int)'
+
+    # Unpin all samples of the given preset.
+    extern 'int fluid_synth_unpin_preset(fluid_synth_t*, int, int, int)'
+
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def synth_pin_preset( synth=self.synth, sfid: , bknum: , prenum: )
+    ret = C.fluid_synth_pin_preset(synth, sfid, bknum, prenum)
+    ret
+  end
+  def synth_unpin_preset( synth=self.synth, sfid: , bknum: , prenum: )
+    ret = C.fluid_synth_unpin_preset(synth, sfid, bknum, prenum)
+    ret
+  end
+
+end
+
+
+#### endof filename: soundfonts/soundfonts.rb

data/lib/fiddle_fluidsynth/soundfonts/voices.rb

@@ -0,0 +1,178 @@
+#
+# filename: fiddle-fluidstynth/soundfonts/voices.rb
+#
+
+
+# References
+# - fluidstynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  # Synthesis voice manipulation functions.
+  # ==== References
+  # - API Reference, SoundFonts/[Voice Manipulation](https://www.fluidsynth.org/api/group__voices.html)
+  # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+
+  # Enumerations.
+  #
+  #
+
+  # Enum used with fluid_voice_add_mod() to specify how to handle duplicate
+  # modulators.
+  enum(
+    :fluid_voice_add_mod,
+    FLUID_VOICE_OVERWRITE:  nil,
+    FLUID_VOICE_ADD:        nil,
+    FLUID_VOICE_DEFAULT:    nil,
+  )
+
+  #
+  module C
+
+
+    # Lifecycle Functions (MIDI Sequencer).
+    #
+    #
+
+
+    # Functions.
+    #
+    #
+
+    # Adds a modulator to the voice if the modulator has valid sources.
+    extern 'void fluid_voice_add_mod(fluid_voice_t*, fluid_mod_t*, int)'
+
+    # Get the value of a generator.
+    extern 'float fluid_voice_gen_get(fluid_voice_t*, int)'
+
+    # Offset the value of a generator.
+    extern 'void fluid_voice_gen_incr(fluid_voice_t*, int, float)'
+
+    # Set the value of a generator.
+    extern 'void fluid_voice_gen_set(fluid_voice_t*, int, float)'
+
+    # Return the effective MIDI key of the playing voice.
+    extern 'int fluid_voice_get_actual_key(fluid_voice_t*)'
+
+    # Return the effective MIDI velocity of the playing voice.
+    extern 'int fluid_voice_get_actual_velocity(fluid_voice_t*)'
+
+    # Return the MIDI channel the voice is playing on.
+    extern 'int fluid_voice_get_channel(fluid_voice_t*)'
+
+    #  Get the unique ID of the noteon-event.
+    extern 'unsigned int fluid_voice_get_id(fluid_voice_t*)'
+
+    # Return the MIDI key from the starting noteon event.
+    extern 'int fluid_voice_get_key(fluid_voice_t*)'
+
+    # Return the MIDI velocity from the starting noteon event.
+    extern 'int fluid_voice_get_velocity(fluid_voice_t*)'
+
+    # Check if a voice is ON.
+    extern 'int fluid_voice_is_on(fluid_voice_t*)'
+
+    # Check if a voice is producing sound.
+    extern 'int fluid_voice_is_playing(fluid_voice_t*)'
+
+    # Check if a voice keeps playing after it has received a noteoff due to
+    # being held by sostenuto.
+    extern 'int fluid_voice_is_sostenuto(fluid_voice_t*)'
+
+    # Check if a voice keeps playing after it has received a noteoff due to
+    # being held by sustain.
+    extern 'int fluid_voice_is_sustained(fluid_voice_t*)'
+
+    # Calculate the peak volume of a sample for voice off optimization.
+    extern 'int fluid_voice_optimize_sample(fluid_sample_t*)'
+
+    # Update all the synthesis parameters which depend on generator gen.
+    extern 'void fluid_voice_update_param(fluid_voice_t*, int)'
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  def voice_add_mod( voice, mod: , mode: )
+    ret = C.fluid_voice_add_mod(voice,mod,mode)
+    ret
+  end
+
+  def voice_gen_get( voice, gen: )
+    ret = C.fluid_voice_gen_get(voice,gen)
+    ret
+  end
+  def voice_gen_incr( voice, i: , val: )
+    ret = C.fluid_voice_gen_get(voice, i, val)
+    ret
+  end
+  def voice_gen_set( voice, i: , val: )
+    ret = C.fluid_voice_gen_get(voice,i,val)
+    ret
+  end
+
+  def voice_get_actual_key( voice )
+    ret = C.fluid_voice_get_actual_key(voice)
+    ret
+  end
+  def voice_get_actual_velocity( voice )
+    ret = C.fluid_voice_get_actual_velocity(voice)
+    ret
+  end
+  def voice_get_channel( voice )
+    ret = C.fluid_voice_get_channel(voice)
+    ret
+  end
+  def voice_get_id( voice )
+    ret = C.fluid_voice_get_id(voice)
+    ret
+  end
+  def voice_get_key( voice )
+    ret = C.fluid_voice_get_key(voice)
+    ret
+  end
+  def voice_get_velocity( voice )
+    ret = C.fluid_voice_get_velocity(voice)
+    ret
+  end
+
+  #
+  def voice_is_on( voice )
+    ret = C.fluid_voice_is_on(voice)
+    ret
+  end
+  def voice_is_playing( voice )
+    ret = C.fluid_voice_is_playing(voice)
+    ret
+  end
+  def voice_is_sostenuto( voice )
+    ret = C.fluid_voice_is_sostenuto(voice)
+    ret
+  end
+  def voice_is_sustained( voice )
+    ret = C.fluid_voice_is_sustained(voice)
+    ret
+  end
+  def voice_optimize_sample( voice )
+    ret = C.fluid_voice_optimize_sample(voice)
+    ret
+  end
+  def voice_update_param( voice, gen: )
+    ret = C.fluid_voice_update_param(voice, gen)
+    ret
+  end
+
+end
+
+
+#### endof filename: fiddle-fluidstynth/soundfonts/voices.rb

data/lib/fiddle_fluidsynth/soundfonts.rb

@@ -0,0 +1,11 @@
+#
+# filename: fiddle-fluidsynth/soundfonts.rb
+#
+require_relative "./soundfonts/soundfonts"
+
+require_relative "./soundfonts/generators"
+require_relative "./soundfonts/loader"
+require_relative "./soundfonts/modulators"
+require_relative "./soundfonts/voices"
+
+####

data/lib/fiddle_fluidsynth/synth/audio_rendering.rb

@@ -0,0 +1,100 @@
+#
+# filename: synth/audio_rendering.rb
+#
+
+
+# References
+# - fluidstynth.org, [API Reference](https://www.fluidsynth.org/api/modules.html)
+#
+class FiddleFluidSynth
+
+  #
+  module C
+
+    # The functions in this section can be used to render audio directly
+    # to memory buffers.
+    # ==== References
+    # - API Reference, Synthesizer/[Audio Rendering](https://www.fluidsynth.org/api/group__audio__rendering.html)
+    # - [library fiddle](https://docs.ruby-lang.org/ja/latest/library/fiddle.html)
+    #
+
+    # Lifecycle Functions.
+    #
+    #
+
+
+    # Functions.
+    #
+    #
+
+    # Synthesize a block of floating point audio to separate audio buffers
+    # (multi-channel rendering).
+    # FIXME. float**
+    extern 'int fluid_synth_nwrite_float' +
+      '(fluid_synth_t*, int, void*, void*, void*, void*)'
+
+    # Synthesize floating point audio to stereo audio channels (implements
+    # the default interface fluid_audio_func_t).
+    extern 'int fluid_synth_process' +
+      '(fluid_synth_t*, int, int, void*, int, void*)'
+
+    # Synthesize a block of floating point audio samples to audio buffers.
+    extern 'int fluid_synth_write_float' +
+      '(fluid_synth_t*, int, void*, int, int, void*, int, int)'
+
+    # Synthesize a block of 16 bit audio samples to audio buffers.
+    extern 'int fluid_synth_write_s16' +
+      '(fluid_synth_t*, int, void*, int, int, void*, int, int)'
+
+  end
+end
+
+
+# Lifecycle Functions.
+#
+#
+
+
+# Functions.
+#
+#
+class FiddleFluidSynth
+
+  #
+  def synth_nwrite_float( synth=self.synth,
+                          len: , left: , right: , fx_left: , fx_right: )
+    deprecated_msg_instead('fluid_synth_process()', meth: __method__)
+
+    ret = C.fluid_synth_nwrite_float(
+            synth, len, left,right, fx_left,fx_right)
+    ret
+  end
+
+  def synth_process( synth=self.synth,
+                     len: , nfx: , fx: , nout: , outbuf: )
+    ret = C.fluid_synth_process(
+            synth, len, nfx,fx, nout,outbuf)
+    ret
+  end
+
+  def synth_write_float( synth=self.synth,
+                         len: , lout: , loff: , lincr: ,
+                                rout: , roff: , rincr: )
+    ret = C.fluid_synth_write_float(
+            synth, len, lout,loff,lincr, rout,roff,rincr )
+    ret
+  end
+
+  def synth_write_s16( synth=self.synth,
+                       len: , lout: , loff: , lincr: ,
+                              rout: , roff: , rincr: )
+    ret = C.fluid_synth_write_s16(
+            synth, len, lout,loff,lincr, rout,roff,rincr)
+    ret
+  end
+
+
+end
+
+
+#### endof filename: synth/rendering.rb