voicemeeter_api_ruby 4.1.3 → 4.2.0

Sign up to get free protection for your applications and to get access to all the features.
data/lib/base.rb DELETED
@@ -1,219 +0,0 @@
1
- require "observer"
2
-
3
- require_relative "runvm"
4
- require_relative "configs"
5
- require_relative "errors"
6
-
7
- class Base
8
- "
9
- Base class responsible for wrapping the C Remote API
10
-
11
- Mixin required modules
12
- "
13
- include Observable
14
- include Configs
15
- include RunVM
16
-
17
- attr_accessor :strip, :bus, :button, :vban, :command, :recorder, :device
18
- attr_accessor :strip_mode
19
-
20
- attr_reader :kind, :p_in, :v_in, :p_out, :v_out, :retval, :cache
21
- attr_reader :running, :_strip_comp, :_bus_comp
22
-
23
- DELAY = 0.001
24
- SYNC = false
25
- RATELIMIT = 0.033
26
- SIZE = 1
27
-
28
- def initialize(kind, **kwargs)
29
- @kind = kind
30
- @p_in, @v_in = kind.layout[:strip].values
31
- @p_out, @v_out = kind.layout[:bus].values
32
- @cache = Hash.new
33
- @sync = kwargs[:sync] || SYNC
34
- @ratelimit = kwargs[:ratelimit] || RATELIMIT
35
- @running = false
36
- @strip_mode = 0
37
- @delay = DELAY
38
- end
39
-
40
- def init_thread
41
- @running = true
42
- @cache["strip_level"], @cache["bus_level"] = _get_levels
43
- Thread.new do
44
- loop do
45
- Thread.stop if !@running
46
- if pdirty?
47
- changed
48
- notify_observers("pdirty")
49
- end
50
- if mdirty?
51
- changed
52
- notify_observers("mdirty")
53
- end
54
- if ldirty?
55
- changed
56
- @_strip_comp =
57
- @cache["strip_level"].map.with_index do |x, i|
58
- !(x == @strip_buf[i])
59
- end
60
- @_bus_comp =
61
- @cache["bus_level"].map.with_index { |x, i| !(x == @bus_buf[i]) }
62
- @cache["strip_level"] = @strip_buf
63
- @cache["bus_level"] = @bus_buf
64
- notify_observers("ldirty")
65
- end
66
- sleep(@ratelimit)
67
- end
68
- end
69
- end
70
-
71
- def end_thread
72
- @running = false
73
- end
74
-
75
- def login
76
- @@cdll.call(:login)
77
- clear_polling
78
- rescue CAPIErrors => error
79
- case
80
- when error.value == 1
81
- self.start(@kind.name)
82
- clear_polling
83
- when error.value < 0
84
- raise
85
- end
86
- end
87
-
88
- def logout
89
- clear_polling
90
- sleep(0.1)
91
- @@cdll.call(:logout)
92
- end
93
-
94
- def type
95
- c_type = FFI::MemoryPointer.new(:long, SIZE)
96
- @@cdll.call(:vmtype, c_type)
97
- types = { 1 => "basic", 2 => "banana", 3 => "potato" }
98
- types[c_type.read_long]
99
- end
100
-
101
- def version
102
- c_ver = FFI::MemoryPointer.new(:long, SIZE)
103
- @@cdll.call(:vmversion, c_ver)
104
- v1 = (c_ver.read_long & 0xFF000000) >> 24
105
- v2 = (c_ver.read_long & 0x00FF0000) >> 16
106
- v3 = (c_ver.read_long & 0x0000FF00) >> 8
107
- v4 = c_ver.read_long & 0x000000FF
108
- "#{v1}.#{v2}.#{v3}.#{v4}"
109
- end
110
-
111
- def get_parameter(name, is_string = false)
112
- self.polling("get_parameter", name: name) do
113
- if is_string
114
- c_get = FFI::MemoryPointer.new(:string, 512, true)
115
- @@cdll.call(:get_parameter_string, name, c_get)
116
- c_get.read_string
117
- else
118
- c_get = FFI::MemoryPointer.new(:float, SIZE)
119
- @@cdll.call(:get_parameter_float, name, c_get)
120
- c_get.read_float.round(1)
121
- end
122
- end
123
- end
124
-
125
- def set_parameter(name, value)
126
- if value.is_a? String
127
- @@cdll.call(:set_parameter_string, name, value)
128
- else
129
- @@cdll.call(:set_parameter_float, name, value.to_f)
130
- end
131
- @cache.store(name, value)
132
- end
133
-
134
- def get_buttonstatus(id, mode)
135
- self.polling("get_buttonstatus", id: id, mode: mode) do
136
- c_get = FFI::MemoryPointer.new(:float, SIZE)
137
- @@cdll.call(:get_buttonstatus, id, c_get, mode)
138
- c_get.read_float.to_i
139
- end
140
- end
141
-
142
- def set_buttonstatus(id, state, mode)
143
- @@cdll.call(:set_buttonstatus, id, state, mode)
144
- @cache.store("mb_#{id}_#{mode}", state)
145
- end
146
-
147
- def set_parameter_multi(param_hash)
148
- param_hash.each do |(key, val)|
149
- prop, m2, m3, *rem = key.to_s.split("_")
150
- if m2.to_i.to_s == m2
151
- m2 = m2.to_i
152
- elsif m3.to_i.to_s == m3
153
- m3 = m3.to_i
154
- end
155
-
156
- case prop
157
- when "strip"
158
- self.strip[m2].set_multi(val)
159
- when "bus"
160
- self.bus[m2].set_multi(val)
161
- when "button", "mb"
162
- self.button[m2].set_multi(val)
163
- when "vban"
164
- if %w[instream in].include? m2
165
- self.vban.instream[m3].set_multi(val)
166
- elsif %w[outstream out].include? m2
167
- self.vban.outstream[m3].set_multi(val)
168
- end
169
- end
170
- sleep(DELAY)
171
- end
172
- end
173
-
174
- def get_level(type, index)
175
- c_get = FFI::MemoryPointer.new(:float, SIZE)
176
- @@cdll.call(:get_level, type, index, c_get)
177
- c_get.read_float
178
- end
179
-
180
- def _get_levels
181
- s = (0...(2 * @p_in + 8 * @v_in)).map { |i| get_level(@strip_mode, i) }
182
- b = (0...(8 * (@p_out + @v_out))).map { |i| get_level(3, i) }
183
- [s, b]
184
- end
185
-
186
- def get_num_devices(direction)
187
- unless %w[in out].include? direction
188
- raise VMRemoteErrors.new("expected in or out")
189
- end
190
- if direction == "in"
191
- val = @@cdll.call(:get_num_indevices)
192
- else
193
- val = @@cdll.call(:get_num_outdevices)
194
- end
195
- val[0]
196
- end
197
-
198
- def get_device_description(index, direction)
199
- unless %w[in out].include? direction
200
- raise VMRemoteErrors.new("expected in or out")
201
- end
202
- c_type = FFI::MemoryPointer.new(:long, SIZE)
203
- c_name = FFI::MemoryPointer.new(:string, 256, true)
204
- c_hwid = FFI::MemoryPointer.new(:string, 256, true)
205
- if direction == "in"
206
- @@cdll.call(:get_desc_indevices, index, c_type, c_name, c_hwid)
207
- else
208
- @@cdll.call(:get_desc_outdevices, index, c_type, c_name, c_hwid)
209
- end
210
- [c_name.read_string, c_type.read_long, c_hwid.read_string]
211
- end
212
-
213
- alias_method "set_multi", :set_parameter_multi
214
- alias_method "get", :get_parameter
215
- alias_method "set", :set_parameter
216
- alias_method "pdirty", :pdirty?
217
- alias_method "mdirty", :mdirty?
218
- alias_method "ldirty", :ldirty?
219
- end
data/lib/bus.rb DELETED
@@ -1,97 +0,0 @@
1
- require_relative "iremote"
2
- require_relative "mixin"
3
-
4
- class Bus < IRemote
5
- "
6
- Concrete Bus class
7
- "
8
- include Channel_Meta_Functions
9
- include Fades
10
-
11
- attr_accessor :mode, :levels
12
-
13
- def self.make(remote, layout_bus)
14
- "
15
- Factory function for Bus classes.
16
- "
17
- p_out, v_out = layout_bus.values
18
- (0...(p_out + v_out)).map do |i|
19
- i < p_out ? PhysicalBus.new(remote, i) : VirtualBus.new(remote, i)
20
- end
21
- end
22
-
23
- def initialize(remote, i)
24
- super
25
- self.make_accessor_bool :mute, :mono, :eq, :sel
26
- self.make_accessor_float :gain
27
- self.make_accessor_string :label
28
-
29
- @mode = BusModes.new(remote, i)
30
- @levels = BusLevels.new(remote, i)
31
- end
32
-
33
- def identifier
34
- "bus[#{@index}]"
35
- end
36
- end
37
-
38
- class PhysicalBus < Bus
39
- def initialize(remote, i)
40
- super
41
- self.make_reader_only :device, :sr
42
- end
43
- end
44
-
45
- class VirtualBus < Bus
46
- end
47
-
48
- class BusModes < IRemote
49
- include Channel_Meta_Functions
50
-
51
- def initialize(remote, i)
52
- super
53
- self.make_bus_modes :normal,
54
- :amix,
55
- :bmix,
56
- :repeat,
57
- :composite,
58
- :tvmix,
59
- :upmix21,
60
- :upmix41,
61
- :upmix61,
62
- :centeronly,
63
- :lfeonly,
64
- :rearonly
65
- end
66
-
67
- def identifier
68
- "bus[#{@index}].mode"
69
- end
70
- end
71
-
72
- class BusLevels < IRemote
73
- def initialize(remote, i)
74
- super
75
- @init = i * 8
76
- @offset = 8
77
- end
78
-
79
- def identifier
80
- "bus[#{@index}]"
81
- end
82
-
83
- def getter(mode)
84
- if @remote.running
85
- vals = @remote.cache["bus_level"][@init, @offset]
86
- else
87
- vals = (@init...@offset).map { |i| @remote.get_level(mode, i) }
88
- end
89
- vals.map { |x| x > 0 ? (20 * Math.log(x, 10)).round(1) : -200.0 }
90
- end
91
-
92
- def all
93
- getter(3)
94
- end
95
-
96
- def isdirty? = @remote._bus_comp[@init, @offset].any?
97
- end
data/lib/button.rb DELETED
@@ -1,23 +0,0 @@
1
- require_relative "iremote"
2
- require_relative "meta"
3
-
4
- class MacroButton < IRemote
5
- include MacroButton_Meta_Functions
6
-
7
- def self.make(remote, num_buttons)
8
- (0...num_buttons).map { |i| MacroButton.new(remote, i) }
9
- end
10
-
11
- def initialize(remote, i)
12
- super
13
- self.make_accessor_macrobutton :state, :stateonly, :trigger
14
- end
15
-
16
- def getter(mode)
17
- @remote.get_buttonstatus(@index, mode)
18
- end
19
-
20
- def setter(set, mode)
21
- @remote.set_buttonstatus(@index, set, mode)
22
- end
23
- end
data/lib/cbindings.rb DELETED
@@ -1,125 +0,0 @@
1
- require "ffi"
2
- require_relative "inst"
3
-
4
- include InstallationFunctions
5
-
6
- module CBindings
7
- "
8
- Creates Ruby bindings to the C DLL
9
-
10
- Performs other low level tasks
11
- "
12
- extend FFI::Library
13
-
14
- private
15
-
16
- begin
17
- OS_BITS = FFI::Platform::CPU.downcase == "x64" ? 64 : 32
18
- VM_PATH = get_vmpath(OS_BITS)
19
- DLL_NAME = "VoicemeeterRemote#{OS_BITS == 64 ? "64" : ""}.dll"
20
-
21
- self.vm_dll = VM_PATH.join(DLL_NAME)
22
- rescue InstallErrors => error
23
- puts "ERROR: #{error.message}"
24
- raise
25
- end
26
-
27
- ffi_lib @vm_dll
28
- ffi_convention :stdcall
29
-
30
- attach_function :vm_login, :VBVMR_Login, [], :long
31
- attach_function :vm_logout, :VBVMR_Logout, [], :long
32
- attach_function :vm_runvm, :VBVMR_RunVoicemeeter, [:long], :long
33
- attach_function :vm_vmtype, :VBVMR_GetVoicemeeterType, [:pointer], :long
34
- attach_function :vm_vmversion, :VBVMR_GetVoicemeeterVersion, [:pointer], :long
35
-
36
- attach_function :vm_mdirty, :VBVMR_MacroButton_IsDirty, [], :long
37
- attach_function :vm_get_buttonstatus,
38
- :VBVMR_MacroButton_GetStatus,
39
- %i[long pointer long],
40
- :long
41
- attach_function :vm_set_buttonstatus,
42
- :VBVMR_MacroButton_SetStatus,
43
- %i[long float long],
44
- :long
45
-
46
- attach_function :vm_pdirty, :VBVMR_IsParametersDirty, [], :long
47
- attach_function :vm_get_parameter_float,
48
- :VBVMR_GetParameterFloat,
49
- %i[string pointer],
50
- :long
51
- attach_function :vm_set_parameter_float,
52
- :VBVMR_SetParameterFloat,
53
- %i[string float],
54
- :long
55
-
56
- attach_function :vm_get_parameter_string,
57
- :VBVMR_GetParameterStringA,
58
- %i[string pointer],
59
- :long
60
- attach_function :vm_set_parameter_string,
61
- :VBVMR_SetParameterStringA,
62
- %i[string string],
63
- :long
64
-
65
- attach_function :vm_set_parameter_multi,
66
- :VBVMR_SetParameters,
67
- [:string],
68
- :long
69
-
70
- attach_function :vm_get_level, :VBVMR_GetLevel, %i[long long pointer], :long
71
-
72
- attach_function :vm_get_num_indevices, :VBVMR_Input_GetDeviceNumber, [], :long
73
- attach_function :vm_get_desc_indevices,
74
- :VBVMR_Input_GetDeviceDescA,
75
- %i[long pointer pointer pointer],
76
- :long
77
-
78
- attach_function :vm_get_num_outdevices,
79
- :VBVMR_Output_GetDeviceNumber,
80
- [],
81
- :long
82
- attach_function :vm_get_desc_outdevices,
83
- :VBVMR_Output_GetDeviceDescA,
84
- %i[long pointer pointer pointer],
85
- :long
86
-
87
- @@cdll =
88
- lambda { |func, *args| self.retval = [send("vm_#{func}", *args), func] }
89
-
90
- def clear_polling = while pdirty? || mdirty?; end
91
-
92
- def polling(func, **kwargs)
93
- params = {
94
- "get_parameter" => kwargs[:name],
95
- "get_buttonstatus" => "mb_#{kwargs[:id]}_#{kwargs[:mode]}"
96
- }
97
- return @cache.delete(params[func]) if @cache.key? params[func]
98
-
99
- clear_polling if @sync
100
-
101
- yield
102
- end
103
-
104
- def retval=(values)
105
- " Writer validation for CAPI calls "
106
- retval, func = *values
107
- unless %i[get_num_indevices get_num_outdevices].include? func
108
- raise CAPIErrors.new(retval, func) if retval&.nonzero?
109
- end
110
- @retval = retval
111
- end
112
-
113
- public
114
-
115
- def pdirty? = vm_pdirty&.nonzero?
116
-
117
- def mdirty? = vm_mdirty&.nonzero?
118
-
119
- def ldirty?
120
- @strip_buf, @bus_buf = _get_levels
121
- return(
122
- !(@cache["strip_level"] == @strip_buf && @cache["bus_level"] == @bus_buf)
123
- )
124
- end
125
- end
data/lib/command.rb DELETED
@@ -1,36 +0,0 @@
1
- require_relative "iremote"
2
- require_relative "meta"
3
-
4
- class Command < IRemote
5
- include Commands_Meta_Functions
6
-
7
- def initialize(remote)
8
- super
9
- self.make_action_prop :show, :restart, :shutdown
10
- self.make_writer_bool :showvbanchat, :lock
11
- end
12
-
13
- def identifier
14
- :command
15
- end
16
-
17
- def hide
18
- self.setter("show", 0)
19
- end
20
-
21
- def load(value)
22
- raise VMRemoteErrors.new("Expected a string") unless value.is_a? String
23
- self.setter("load", value)
24
- sleep(0.2)
25
- end
26
-
27
- def save(value)
28
- raise VMRemoteErrors.new("Expected a string") unless value.is_a? String
29
- self.setter("save", value)
30
- sleep(0.2)
31
- end
32
-
33
- def reset
34
- @remote.set_config("reset")
35
- end
36
- end
data/lib/configs.rb DELETED
@@ -1,80 +0,0 @@
1
- require "kinds"
2
- require "toml"
3
-
4
- module Configs
5
- private
6
-
7
- @@configs = Hash.new
8
-
9
- class TOMLStrBuilder
10
- def initialize(kind)
11
- @p_in, @v_in = kind[:layout][:strip].values
12
- @p_out, @v_out = kind[:layout][:bus].values
13
- @vs_params =
14
- ["mute = false", "mono = false", "solo = false", "gain = 0.0"] +
15
- (1..@p_out).map { |i| "A#{i} = false" } +
16
- (1..@v_out).map { |i| "B#{i} = false" }
17
-
18
- @ps_params = @vs_params + ["comp = 0.0", "gate = 0.0"]
19
- @bus_params = ["mono = false", "eq = false", "mute = false"]
20
- end
21
-
22
- def build
23
- "
24
- Builds a TOML script for the parser
25
- "
26
- @ps = (0...@p_in).map { |i| ["[strip_#{i}]"] + @ps_params }
27
- @ps.map! { |a| a.map { |s| s.gsub("B1 = false", "B1 = true") } }
28
- @vs = (@p_in...(@p_in + @v_in)).map { |i| ["[strip_#{i}]"] + @vs_params }
29
- @vs.map! { |a| a.map { |s| s.gsub("A1 = false", "A1 = true") } }
30
-
31
- @b = (0...(@p_out + @v_out)).map { |i| ["[bus_#{i}]"] + @bus_params }
32
-
33
- [@ps + @vs + @b].join("\n")
34
- end
35
- end
36
-
37
- def parser(data)
38
- TOML::Parser.new(data).parsed
39
- end
40
-
41
- def get_configs(kind_id)
42
- file_path = File.join(Dir.pwd, "configs", "#{kind_id}")
43
-
44
- if Dir.exist?(file_path)
45
- Dir
46
- .glob(File.join(file_path, "*.toml"))
47
- .to_h do |toml_file|
48
- filename = File.basename(toml_file, ".toml")
49
- puts "loading config #{kind_id}/#{filename} into memory"
50
- [filename, parser(File.read(toml_file))]
51
- end
52
- end
53
- end
54
-
55
- def loader
56
- if @@configs.empty?
57
- builder = TOMLStrBuilder.new(@kind)
58
- puts "loading config reset into memory"
59
- @@configs["reset"] = parser(builder.build)
60
- configs = get_configs(@kind.name.to_s)
61
-
62
- @@configs.merge!(configs) unless configs.nil?
63
- end
64
- end
65
-
66
- public
67
-
68
- def set_config(value)
69
- loader
70
- unless @@configs.key? value
71
- raise VMRemoteErrors.new("No profile with name #{value} was loaded")
72
- end
73
-
74
- self.send("set_multi", @@configs[value])
75
- puts "config #{@kind.name}/#{value} applied!"
76
- sleep(@delay)
77
- end
78
-
79
- alias_method "apply_config", :set_config
80
- end
data/lib/device.rb DELETED
@@ -1,24 +0,0 @@
1
- require_relative "iremote"
2
- require_relative "meta"
3
-
4
- class Device
5
- def initialize(remote)
6
- @remote = remote
7
- end
8
-
9
- def getter(**kwargs)
10
- return @remote.get_num_devices(kwargs[:direction]) if kwargs[:index].nil?
11
-
12
- vals = @remote.get_device_description(kwargs[:index], kwargs[:direction])
13
- types = { 1 => "mme", 3 => "wdm", 4 => "ks", 5 => "asio" }
14
- { name: vals[0], type: types[vals[1]], id: vals[2] }
15
- end
16
-
17
- def ins = getter(direction: "in")
18
-
19
- def outs = getter(direction: "out")
20
-
21
- def input(i) = getter(index: i, direction: "in")
22
-
23
- def output(i) = getter(index: i, direction: "out")
24
- end
data/lib/errors.rb DELETED
@@ -1,41 +0,0 @@
1
- module Errors
2
- class VMRemoteErrors < StandardError
3
- end
4
-
5
- class InstallErrors < VMRemoteErrors
6
- end
7
-
8
- class CAPIErrors < VMRemoteErrors
9
- attr_accessor :value, :func
10
-
11
- def initialize(value, func)
12
- self.value = value
13
- self.func = func
14
- end
15
-
16
- def message
17
- "
18
- When attempting to run function #{@func} the
19
- C API returned value #{@value}. See documentation for further info
20
- "
21
- end
22
- end
23
-
24
- class OutOfBoundsErrors < VMRemoteErrors
25
- attr_accessor :range
26
-
27
- def initialize(range)
28
- self.range = range
29
- end
30
-
31
- def message
32
- if @range.kind_of?(Range)
33
- "Value error, expected value in range (#{range.first}..#{range.last})"
34
- elsif @range.kind_of?(Array)
35
- "Value error, expected one of: #{@range}"
36
- else
37
- "Value error, expected #{@range}"
38
- end
39
- end
40
- end
41
- end
data/lib/inst.rb DELETED
@@ -1,27 +0,0 @@
1
- require "win32/registry"
2
- require "pathname"
3
- require_relative "errors"
4
-
5
- include Errors
6
-
7
- module InstallationFunctions
8
- private
9
-
10
- def get_vmpath(os_bits)
11
- vm_key = "VB:Voicemeeter {17359A74-1236-5467}"
12
- reg_key =
13
- "Software#{os_bits == 64 ? "\\WOW6432Node" : ""}\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\"
14
- Win32::Registry::HKEY_LOCAL_MACHINE.open(reg_key + vm_key) do |reg|
15
- value = reg["UninstallString"]
16
-
17
- pn = Pathname.new(value)
18
- return pn.dirname
19
- end
20
- raise InstallErrors.new("Could not get the Voicemeeter path")
21
- end
22
-
23
- def vm_dll=(value)
24
- raise InstallErrors.new("Could not fetch the dll file") unless value.file?
25
- @vm_dll = value
26
- end
27
- end
data/lib/iremote.rb DELETED
@@ -1,30 +0,0 @@
1
- require_relative "meta"
2
- require_relative "errors"
3
-
4
- class IRemote
5
- "
6
- Common interface between base class and higher classes.
7
- "
8
- include Meta_Functions
9
-
10
- def initialize(remote, i = nil)
11
- @remote = remote
12
- @index = i
13
- end
14
-
15
- def getter(param, is_string = false)
16
- @remote.get_parameter("#{self.identifier}.#{param}", is_string)
17
- end
18
-
19
- def setter(param, value)
20
- @remote.set_parameter("#{self.identifier}.#{param}", value)
21
- end
22
-
23
- def identifier
24
- raise "Called abstract method: identifier"
25
- end
26
-
27
- def set_multi(param_hash)
28
- param_hash.each { |(key, val)| self.send("#{key}=", val) }
29
- end
30
- end