voicemeeter_api_ruby 4.1.5 → 4.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29df5251a1e4d779dd265a785112c0c8907b89f5f9a30a45a9e50985ed2400e7
-  data.tar.gz: c4a9acbbbe3330aca966d4470373b9ec9f9fe3bcefa0b1f6e60ed665b853c712
+  metadata.gz: d897d4faf2ad7aac9c98689e7dc1b64dac891f610ba1153e46a7c7e97b273815
+  data.tar.gz: 8f275deec8cec53be8fa49a1c8e8605c6cb06153237e99539938fc2511288c8b
 SHA512:
-  metadata.gz: c9e8f17bd773dbbbb9980f5bb91283b0f97be75acff6f2bf0c2315721fdfc9916509ec86a0a28e6db3d548fadbb161c3b40da9cbd8639b4fc98719fe309d1e27
-  data.tar.gz: 12d256fb220ab60c3492d65855ed6cdf714af851f1a7dfcb2d6b3297e2c844a9776162ff600351c9f4baeb71a3a2e99492e19388a588f459301ed1aff4259d7d
+  metadata.gz: 80dc23b32bb5a398e96d249aac772246ac98b3f5b7b759018724fd0b07fc103a181e1e9caa3438dd62022252205ab21bdb0f5c652f7c686a6f9885e5cbd186f6
+  data.tar.gz: 83dab1c59de3a07a3441f50de27e883db07be47a6ff5d3134ad0c6a2f49e00ca813d21c94d05b09d820beecbd29f8ef07e84735ede3b9b8bc122ebd267b61e79

data/lib/voicemeeter/base.rb

@@ -0,0 +1,223 @@
+require "observer"
+
+require "voicemeeter/runvm"
+require "voicemeeter/configs"
+require "voicemeeter/errors"
+
+module Voicemeeter
+  class Base
+    "
+    Base class responsible for wrapping the C Remote API
+
+    Mixin required modules
+    "
+    include Observable
+    include Configs
+    include RunVM
+
+    attr_accessor :strip, :bus, :button, :vban, :command, :recorder, :device
+    attr_accessor :strip_mode
+
+    attr_reader :kind, :p_in, :v_in, :p_out, :v_out, :retval, :cache
+    attr_reader :running, :_strip_comp, :_bus_comp, :delay
+
+    DELAY = 0.001
+    SYNC = false
+    RATELIMIT = 0.033
+    SIZE = 1
+
+    def initialize(kind, **kwargs)
+      @kind = kind
+      @p_in, @v_in = kind.layout[:strip].values
+      @p_out, @v_out = kind.layout[:bus].values
+      @cache = Hash.new
+      @sync = kwargs[:sync] || SYNC
+      @ratelimit = kwargs[:ratelimit] || RATELIMIT
+      @running = false
+      @strip_mode = 0
+      @delay = DELAY
+    end
+
+    def init_thread
+      @running = true
+      @cache["strip_level"], @cache["bus_level"] = _get_levels
+      Thread.new do
+        loop do
+          Thread.stop if !@running
+          if pdirty?
+            changed
+            notify_observers("pdirty")
+          end
+          if mdirty?
+            changed
+            notify_observers("mdirty")
+          end
+          if ldirty?
+            changed
+            @_strip_comp =
+              @cache["strip_level"].map.with_index do |x, i|
+                !(x == @strip_buf[i])
+              end
+            @_bus_comp =
+              @cache["bus_level"].map.with_index { |x, i| !(x == @bus_buf[i]) }
+            @cache["strip_level"] = @strip_buf
+            @cache["bus_level"] = @bus_buf
+            notify_observers("ldirty")
+          end
+          sleep(@ratelimit)
+        end
+      end
+    end
+
+    def end_thread
+      @running = false
+    end
+
+    def login
+      @@cdll.call(:login)
+      clear_polling
+    rescue CAPIErrors => error
+      case
+      when error.value == 1
+        self.start(@kind.name)
+        clear_polling
+      when error.value < 0
+        raise
+      end
+    end
+
+    def logout
+      clear_polling
+      sleep(0.1)
+      @@cdll.call(:logout)
+    end
+
+    def type
+      c_type = FFI::MemoryPointer.new(:long, SIZE)
+      @@cdll.call(:vmtype, c_type)
+      types = { 1 => "basic", 2 => "banana", 3 => "potato" }
+      types[c_type.read_long]
+    end
+
+    def version
+      c_ver = FFI::MemoryPointer.new(:long, SIZE)
+      @@cdll.call(:vmversion, c_ver)
+      v1 = (c_ver.read_long & 0xFF000000) >> 24
+      v2 = (c_ver.read_long & 0x00FF0000) >> 16
+      v3 = (c_ver.read_long & 0x0000FF00) >> 8
+      v4 = c_ver.read_long & 0x000000FF
+      "#{v1}.#{v2}.#{v3}.#{v4}"
+    end
+
+    def get_parameter(name, is_string = false)
+      self.polling("get_parameter", name: name) do
+        if is_string
+          c_get = FFI::MemoryPointer.new(:string, 512, true)
+          @@cdll.call(:get_parameter_string, name, c_get)
+          c_get.read_string
+        else
+          c_get = FFI::MemoryPointer.new(:float, SIZE)
+          @@cdll.call(:get_parameter_float, name, c_get)
+          c_get.read_float.round(1)
+        end
+      end
+    end
+
+    def set_parameter(name, value)
+      if value.is_a? String
+        @@cdll.call(:set_parameter_string, name, value)
+      else
+        @@cdll.call(:set_parameter_float, name, value.to_f)
+      end
+      @cache.store(name, value)
+    end
+
+    def get_buttonstatus(id, mode)
+      self.polling("get_buttonstatus", id: id, mode: mode) do
+        c_get = FFI::MemoryPointer.new(:float, SIZE)
+        @@cdll.call(:get_buttonstatus, id, c_get, mode)
+        c_get.read_float.to_i
+      end
+    end
+
+    def set_buttonstatus(id, state, mode)
+      @@cdll.call(:set_buttonstatus, id, state, mode)
+      @cache.store("mb_#{id}_#{mode}", state)
+    end
+
+    def set_parameter_multi(param_hash)
+      param_hash.each do |(key, val)|
+        prop, m2, m3, *rem = key.to_s.split("_")
+        if m2.to_i.to_s == m2
+          m2 = m2.to_i
+        elsif m3.to_i.to_s == m3
+          m3 = m3.to_i
+        end
+
+        case prop
+        when "strip"
+          self.strip[m2].set_multi(val)
+        when "bus"
+          self.bus[m2].set_multi(val)
+        when "button", "mb"
+          self.button[m2].set_multi(val)
+        when "vban"
+          if %w[instream in].include? m2
+            self.vban.instream[m3].set_multi(val)
+          elsif %w[outstream out].include? m2
+            self.vban.outstream[m3].set_multi(val)
+          end
+        end
+        sleep(DELAY)
+      end
+    end
+
+    def get_level(type, index)
+      c_get = FFI::MemoryPointer.new(:float, SIZE)
+      @@cdll.call(:get_level, type, index, c_get)
+      c_get.read_float
+    end
+
+    def _get_levels
+      [
+        (0...(2 * @p_in + 8 * @v_in)).map { |i| get_level(@strip_mode, i) },
+        (0...(8 * (@p_out + @v_out))).map { |i| get_level(3, i) }
+      ]
+    end
+
+    def get_num_devices(direction)
+      unless %w[in out].include? direction
+        raise VMRemoteErrors.new("expected in or out")
+      end
+      if direction == "in"
+        val = @@cdll.call(:get_num_indevices)
+      else
+        val = @@cdll.call(:get_num_outdevices)
+      end
+      val[0]
+    end
+
+    def get_device_description(index, direction)
+      unless %w[in out].include? direction
+        raise VMRemoteErrors.new("expected in or out")
+      end
+      c_type = FFI::MemoryPointer.new(:long, SIZE)
+      c_name = FFI::MemoryPointer.new(:string, 256, true)
+      c_hwid = FFI::MemoryPointer.new(:string, 256, true)
+      if direction == "in"
+        @@cdll.call(:get_desc_indevices, index, c_type, c_name, c_hwid)
+      else
+        @@cdll.call(:get_desc_outdevices, index, c_type, c_name, c_hwid)
+      end
+      [c_name.read_string, c_type.read_long, c_hwid.read_string]
+    end
+
+    alias_method "set_multi", :set_parameter_multi
+    alias_method "apply", :set_parameter_multi
+    alias_method "get", :get_parameter
+    alias_method "set", :set_parameter
+    alias_method "pdirty", :pdirty?
+    alias_method "mdirty", :mdirty?
+    alias_method "ldirty", :ldirty?
+  end
+end

data/lib/voicemeeter/bus.rb

@@ -0,0 +1,107 @@
+require "voicemeeter/iremote"
+
+module Voicemeeter
+  class Bus < IRemote
+    "
+    Concrete Bus class
+    "
+    include Channel_Meta_Functions
+
+    attr_accessor :mode, :levels
+
+    def self.make(remote, layout_bus)
+      "
+      Factory function for Bus classes.
+      "
+      p_out, v_out = layout_bus.values
+      (0...(p_out + v_out)).map do |i|
+        i < p_out ? PhysicalBus.new(remote, i) : VirtualBus.new(remote, i)
+      end
+    end
+
+    def initialize(remote, i)
+      super
+      self.make_accessor_bool :mute, :mono, :eq, :sel
+      self.make_accessor_float :gain
+      self.make_accessor_string :label
+
+      @mode = BusModes.new(remote, i)
+      @levels = BusLevels.new(remote, i)
+    end
+
+    def identifier
+      "bus[#{@index}]"
+    end
+
+    def fadeto(target, time)
+      self.setter("FadeTo", "(#{target}, #{time})")
+      sleep(@remote.delay)
+    end
+
+    def fadeby(change, time)
+      self.setter("FadeBy", "(#{change}, #{time})")
+      sleep(@remote.delay)
+    end
+  end
+
+  class PhysicalBus < Bus
+    def initialize(remote, i)
+      super
+      self.make_reader_only :device, :sr
+    end
+  end
+
+  class VirtualBus < Bus
+  end
+
+  class BusModes < IRemote
+    include Channel_Meta_Functions
+
+    def initialize(remote, i)
+      super
+      self.make_bus_modes :normal,
+                          :amix,
+                          :bmix,
+                          :repeat,
+                          :composite,
+                          :tvmix,
+                          :upmix21,
+                          :upmix41,
+                          :upmix61,
+                          :centeronly,
+                          :lfeonly,
+                          :rearonly
+    end
+
+    def identifier
+      "bus[#{@index}].mode"
+    end
+  end
+
+  class BusLevels < IRemote
+    def initialize(remote, i)
+      super
+      @init = i * 8
+      @offset = 8
+    end
+
+    def identifier
+      "bus[#{@index}]"
+    end
+
+    def getter(mode)
+      if @remote.running
+        vals = @remote.cache["bus_level"][@init, @offset]
+      else
+        vals = (@init...@offset).map { |i| @remote.get_level(mode, i) }
+      end
+      vals.map { |x| x > 0 ? (20 * Math.log(x, 10)).round(1) : -200.0 }
+    end
+
+    def all
+      getter(3)
+    end
+
+    def isdirty? = @remote._bus_comp[@init, @offset].any?
+  end
+end

data/lib/voicemeeter/button.rb

@@ -0,0 +1,25 @@
+require "voicemeeter/iremote"
+require "voicemeeter/meta"
+
+module Voicemeeter
+  class MacroButton < IRemote
+    include MacroButton_Meta_Functions
+
+    def self.make(remote, num_buttons)
+      (0...num_buttons).map { |i| MacroButton.new(remote, i) }
+    end
+
+    def initialize(remote, i)
+      super
+      self.make_accessor_macrobutton :state, :stateonly, :trigger
+    end
+
+    def getter(mode)
+      @remote.get_buttonstatus(@index, mode)
+    end
+
+    def setter(set, mode)
+      @remote.set_buttonstatus(@index, set, mode)
+    end
+  end
+end

data/lib/voicemeeter/cbindings.rb

@@ -0,0 +1,126 @@
+require "ffi"
+require "voicemeeter/inst"
+
+module Voicemeeter
+  module CBindings
+    "
+    Creates Ruby bindings to the C DLL
+
+    Performs other low level tasks
+    "
+    extend Voicemeeter::InstallationFunctions
+    extend FFI::Library
+
+    private
+
+    begin
+      OS_BITS = FFI::Platform::CPU.downcase == "x64" ? 64 : 32
+      VM_PATH = get_vmpath(OS_BITS)
+      DLL_NAME = "VoicemeeterRemote#{OS_BITS == 64 ? "64" : ""}.dll"
+
+      self.vm_dll = VM_PATH.join(DLL_NAME)
+    rescue InstallErrors => error
+      puts "ERROR: #{error.message}"
+      raise
+    end
+
+    ffi_lib @vm_dll
+    ffi_convention :stdcall
+
+    attach_function :vm_login, :VBVMR_Login, [], :long
+    attach_function :vm_logout, :VBVMR_Logout, [], :long
+    attach_function :vm_runvm, :VBVMR_RunVoicemeeter, [:long], :long
+    attach_function :vm_vmtype, :VBVMR_GetVoicemeeterType, [:pointer], :long
+    attach_function :vm_vmversion, :VBVMR_GetVoicemeeterVersion, [:pointer], :long
+
+    attach_function :vm_mdirty, :VBVMR_MacroButton_IsDirty, [], :long
+    attach_function :vm_get_buttonstatus,
+                    :VBVMR_MacroButton_GetStatus,
+                    %i[long pointer long],
+                    :long
+    attach_function :vm_set_buttonstatus,
+                    :VBVMR_MacroButton_SetStatus,
+                    %i[long float long],
+                    :long
+
+    attach_function :vm_pdirty, :VBVMR_IsParametersDirty, [], :long
+    attach_function :vm_get_parameter_float,
+                    :VBVMR_GetParameterFloat,
+                    %i[string pointer],
+                    :long
+    attach_function :vm_set_parameter_float,
+                    :VBVMR_SetParameterFloat,
+                    %i[string float],
+                    :long
+
+    attach_function :vm_get_parameter_string,
+                    :VBVMR_GetParameterStringA,
+                    %i[string pointer],
+                    :long
+    attach_function :vm_set_parameter_string,
+                    :VBVMR_SetParameterStringA,
+                    %i[string string],
+                    :long
+
+    attach_function :vm_set_parameter_multi,
+                    :VBVMR_SetParameters,
+                    [:string],
+                    :long
+
+    attach_function :vm_get_level, :VBVMR_GetLevel, %i[long long pointer], :long
+
+    attach_function :vm_get_num_indevices, :VBVMR_Input_GetDeviceNumber, [], :long
+    attach_function :vm_get_desc_indevices,
+                    :VBVMR_Input_GetDeviceDescA,
+                    %i[long pointer pointer pointer],
+                    :long
+
+    attach_function :vm_get_num_outdevices,
+                    :VBVMR_Output_GetDeviceNumber,
+                    [],
+                    :long
+    attach_function :vm_get_desc_outdevices,
+                    :VBVMR_Output_GetDeviceDescA,
+                    %i[long pointer pointer pointer],
+                    :long
+
+    @@cdll =
+      lambda { |func, *args| self.retval = [send("vm_#{func}", *args), func] }
+
+    def clear_polling = while pdirty? || mdirty?; end
+
+    def polling(func, **kwargs)
+      params = {
+        "get_parameter" => kwargs[:name],
+        "get_buttonstatus" => "mb_#{kwargs[:id]}_#{kwargs[:mode]}"
+      }
+      return @cache.delete(params[func]) if @cache.key? params[func]
+
+      clear_polling if @sync
+
+      yield
+    end
+
+    def retval=(values)
+      " Writer validation for CAPI calls "
+      retval, func = *values
+      unless %i[get_num_indevices get_num_outdevices].include? func
+        raise CAPIErrors.new(retval, func) if retval&.nonzero?
+      end
+      @retval = retval
+    end
+
+    public
+
+    def pdirty? = vm_pdirty&.nonzero?
+
+    def mdirty? = vm_mdirty&.nonzero?
+
+    def ldirty?
+      @strip_buf, @bus_buf = _get_levels
+      return(
+        !(@cache["strip_level"] == @strip_buf && @cache["bus_level"] == @bus_buf)
+      )
+    end
+  end
+end

data/lib/voicemeeter/command.rb

@@ -0,0 +1,38 @@
+require "voicemeeter/iremote"
+require "voicemeeter/meta"
+
+module Voicemeeter
+  class Command < IRemote
+    include Commands_Meta_Functions
+
+    def initialize(remote)
+      super
+      self.make_action_prop :show, :restart, :shutdown
+      self.make_writer_bool :showvbanchat, :lock
+    end
+
+    def identifier
+      :command
+    end
+
+    def hide
+      self.setter("show", 0)
+    end
+
+    def load(value)
+      raise VMRemoteErrors.new("Expected a string") unless value.is_a? String
+      self.setter("load", value)
+      sleep(0.2)
+    end
+
+    def save(value)
+      raise VMRemoteErrors.new("Expected a string") unless value.is_a? String
+      self.setter("save", value)
+      sleep(0.2)
+    end
+
+    def reset
+      @remote.set_config("reset")
+    end
+  end
+end

data/lib/voicemeeter/configs.rb

@@ -0,0 +1,83 @@
+require "voicemeeter/kinds"
+require "toml"
+
+module Voicemeeter
+  module Configs
+    private
+
+    @@configs = Hash.new
+
+    class TOMLStrBuilder
+      def initialize(kind)
+        @p_in, @v_in = kind[:layout][:strip].values
+        @p_out, @v_out = kind[:layout][:bus].values
+        @vs_params =
+          ["mute = false", "mono = false", "solo = false", "gain = 0.0"] +
+            (1..@p_out).map { |i| "A#{i} = false" } +
+            (1..@v_out).map { |i| "B#{i} = false" }
+
+        @ps_params = @vs_params + ["comp = 0.0", "gate = 0.0"]
+        @bus_params = ["mono = false", "eq = false", "mute = false"]
+      end
+
+      def build
+        "
+        Builds a TOML script for the parser
+        "
+        @ps = (0...@p_in).map { |i| ["[strip_#{i}]"] + @ps_params }
+        @ps.map! { |a| a.map { |s| s.gsub("B1 = false", "B1 = true") } }
+        @vs =
+          (@p_in...(@p_in + @v_in)).map { |i| ["[strip_#{i}]"] + @vs_params }
+        @vs.map! { |a| a.map { |s| s.gsub("A1 = false", "A1 = true") } }
+
+        @b = (0...(@p_out + @v_out)).map { |i| ["[bus_#{i}]"] + @bus_params }
+
+        [@ps + @vs + @b].join("\n")
+      end
+    end
+
+    def parser(data)
+      TOML::Parser.new(data).parsed
+    end
+
+    def get_configs(kind_id)
+      file_path = File.join(Dir.pwd, "configs", "#{kind_id}")
+
+      if Dir.exist?(file_path)
+        Dir
+          .glob(File.join(file_path, "*.toml"))
+          .to_h do |toml_file|
+            filename = File.basename(toml_file, ".toml")
+            puts "loading config #{kind_id}/#{filename} into memory"
+            [filename, parser(File.read(toml_file))]
+          end
+      end
+    end
+
+    def loader
+      if @@configs.empty?
+        builder = TOMLStrBuilder.new(@kind)
+        puts "loading config reset into memory"
+        @@configs["reset"] = parser(builder.build)
+        configs = get_configs(@kind.name.to_s)
+
+        @@configs.merge!(configs) unless configs.nil?
+      end
+    end
+
+    public
+
+    def set_config(value)
+      loader
+      unless @@configs.key? value
+        raise VMRemoteErrors.new("No profile with name #{value} was loaded")
+      end
+
+      self.send("set_multi", @@configs[value])
+      puts "config #{@kind.name}/#{value} applied!"
+      sleep(@delay)
+    end
+
+    alias_method "apply_config", :set_config
+  end
+end

data/lib/voicemeeter/device.rb

@@ -0,0 +1,26 @@
+require "voicemeeter/iremote"
+require "voicemeeter/meta"
+
+module Voicemeeter
+  class Device
+    def initialize(remote)
+      @remote = remote
+    end
+
+    def getter(**kwargs)
+      return @remote.get_num_devices(kwargs[:direction]) if kwargs[:index].nil?
+
+      vals = @remote.get_device_description(kwargs[:index], kwargs[:direction])
+      types = { 1 => "mme", 3 => "wdm", 4 => "ks", 5 => "asio" }
+      { name: vals[0], type: types[vals[1]], id: vals[2] }
+    end
+
+    def ins = getter(direction: "in")
+
+    def outs = getter(direction: "out")
+
+    def input(i) = getter(index: i, direction: "in")
+
+    def output(i) = getter(index: i, direction: "out")
+  end
+end

data/lib/voicemeeter/errors.rb

@@ -0,0 +1,43 @@
+module Voicemeeter
+  module Errors
+    class VMRemoteErrors < StandardError
+    end
+
+    class InstallErrors < VMRemoteErrors
+    end
+
+    class CAPIErrors < VMRemoteErrors
+      attr_accessor :value, :func
+
+      def initialize(value, func)
+        self.value = value
+        self.func = func
+      end
+
+      def message
+        "
+        When attempting to run function #{@func} the
+        C API returned value #{@value}. See documentation for further info
+        "
+      end
+    end
+
+    class OutOfBoundsErrors < VMRemoteErrors
+      attr_accessor :range
+
+      def initialize(range)
+        self.range = range
+      end
+
+      def message
+        if @range.kind_of?(Range)
+          "Value error, expected value in range (#{range.first}..#{range.last})"
+        elsif @range.kind_of?(Array)
+          "Value error, expected one of: #{@range}"
+        else
+          "Value error, expected #{@range}"
+        end
+      end
+    end
+  end
+end