Remote Kind field now exported.

Kind fields/methods now exported

vmRem renamed vm in examples/tests. prefer short variable name.

minor version bump

.gitignore

@@ -1,5 +1,5 @@
 # quick tests
-quick.go
+quick
 
 # Binaries for programs and plugins
 *.exe

CHANGELOG.md

@@ -10,3 +10,84 @@ Before any major/minor/patch bump all unit tests will be run to verify they pass
 ## [Unreleased]
 
 -   [x]
+
+## [1.2.0] - 2022-07-10
+
+### Added
+
+-   docstrings added to types, methods and functions
+-   version retractions added to go.mod
+
+### Changed
+
+-   Entry method renamed from GetRemote to NewRemote
+-   Readme updated to reflect latest changes
+
+## [1.1.0] - 2022-06-30
+
+### Added
+
+-   Level updates implemented in Pooler struct. Runs in its own goroutine.
+
+### Fixed
+
+-   Fixed bug with identifier in outputs struct.
+
+### Changed
+
+-   Package files moved into root of repository.
+-   Remote struct now exported type
+
+## [1.0.0] - 2022-06-30
+
+### Added
+
+-   recorder, device structs implemented
+-   gainlayers field in strip struct implemented
+-   levels field in strip, bus structs implemented
+-   pooler ratelimit set at 33ms
+
+## [0.0.3] - 2022-06-25
+
+### Added
+
+-   pre-commit.ps1 added for use with git hook
+-   unit tests for factory functions added
+-   vban parameter methods added
+-   support for observers added. publisher/observer structs defined
+-   Pooler struct added, pdirty, mdirty now updated continously in a goroutine
+
+### Changed
+
+-   NewRemote factory method now uses director, builder types to create Remote types.
+-   cdll renamed to path
+-   test suite now using testify/assert
+
+## [0.0.2] - 2022-06-23
+
+### Added
+
+-   physicalStrip, virtualStrip, physicalBus and virtualBus types defined.
+-   factory methods for strip, bus now cast return values to interface types.
+-   parameter methods added to strip, bus types.
+-   command struct implemented
+-   bus, vban unit tests added
+
+### Changed
+
+-   strip, bus slices in remote type defined as interface slice types.
+-   bindings in base now prepended with vm.
+-   vban fields added to kind structs
+
+## [0.0.1] - 2022-06-22
+
+### Added
+
+-   interface entry point defined in remote
+-   some base functions are exported through forwarding methods in Remote type (Login, Logout etc)
+-   wrapper around the CAPI defined in base
+-   path helper functions defined in cdll
+-   kind structs defined in kinds. These describe the layout for each version.
+-   channel, strip, bus structs getter/setter procedures defined.
+-   button struct fully implemented.
+-   initial test commit

README.md

@@ -23,11 +23,13 @@ For an outline of past/future changes refer to: [CHANGELOG](CHANGELOG.md)
 
 Add to your `go.mod` file:
 
-`require github.com/onyx-and-iris/voicemeeter-api-go v1.0.2`
+`require github.com/onyx-and-iris/voicemeeter-api-go vX.X.X`
+
+where `vX.X.X` is the version you require.
 
 #### GO GET
 
-Install voicemeeter-api-go package from your console
+Install voicemeeter-api-go package from your console to download the latest version.
 
 `go get github.com/onyx-and-iris/voicemeeter-api-go`
 
@@ -46,15 +48,15 @@ import (
 
 func main() {
 	kindId := "banana"
-	vmRem := voicemeeter.GetRemote(kindId)
+	vm := voicemeeter.NewRemote(kindId)
 
-	vmRem.Login()
+	vm.Login()
 
-	vmRem.Strip[0].SetLabel("rode podmic")
-	vmRem.Strip[0].SetMute(true)
-	fmt.Printf("Strip 0 (%s) mute was set to %v\n", vmRem.Strip[0].GetLabel(), vmRem.Strip[0].GetMute())
+	vm.Strip[0].SetLabel("rode podmic")
+	vm.Strip[0].SetMute(true)
+	fmt.Printf("Strip 0 (%s) mute was set to %v\n", vm.Strip[0].GetLabel(), vm.Strip[0].GetMute())
 
-	vmRem.Logout()
+	vm.Logout()
 }
 ```
 
@@ -68,59 +70,59 @@ Pass the kind of Voicemeeter as an argument. kindId may be:
 
 ## `Remote Type`
 
-#### `vmRem.Strip`
+#### `vm.Strip`
 
 []t_strip slice containing both physicalStrip and virtualStrip types
 
-#### `vmRem.Bus`
+#### `vm.Bus`
 
 []t_bus slice containing both physicalBus and virtualBus types
 
-#### `vmRem.Button`
+#### `vm.Button`
 
 []button slice containing button types, one for each macrobutton
 
-#### `vmRem.Command`
+#### `vm.Command`
 
 pointer to command type, represents action type functions
 
-#### `vmRem.Vban`
+#### `vm.Vban`
 
 pointer to vban type, containing both vbanInStream and vbanOutStream slices
 
-#### `vmRem.Device`
+#### `vm.Device`
 
 pointer to device type, represents physical input/output hardware devices
 
-#### `vmRem.Recorder`
+#### `vm.Recorder`
 
 pointer to recorder type, represents the recorder
 
-#### `vmRem.Type()`
+#### `vm.Type()`
 
 returns the type of Voicemeeter as a string
 
-#### `vmRem.Version()`
+#### `vm.Version()`
 
 returns the version of Voicemeeter as a string
 
-#### `vmRem.SendText(<script>)`
+#### `vm.SendText(<script>)`
 
 sets many parameters in script format eg. ("Strip[0].Mute=1;Bus[3].Gain=3.6")
 
-#### `vmRem.Register(o observer)`
+#### `vm.Register(o observer)`
 
 register an object as an observer
 
-#### `vmRem.Deregister(o observer)`
+#### `vm.Deregister(o observer)`
 
 deregister an object as an observer
 
-#### `vmRem.Pdirty()`
+#### `vm.Pdirty()`
 
 returns True iff a GUI parameter has changed
 
-#### `vmRem.Mdirty()`
+#### `vm.Mdirty()`
 
 returns True iff a macrobutton paramter has changed
 
@@ -128,7 +130,7 @@ returns True iff a macrobutton paramter has changed
 
 ### Strip
 
-The following functions are available
+The following methods are available
 
 -   `GetMute() bool`
 -   `SetMute(val bool)`
@@ -156,16 +158,16 @@ The following functions are available
 example:
 
 ```go
-vmRem.Strip[3].SetGain(3.7)
-fmt.Println(vmRem.Strip[0].GetLabel())
-vmRem.Strip[4].SetA1(true)
+vm.Strip[3].SetGain(3.7)
+fmt.Println(vm.Strip[0].GetLabel())
+vm.Strip[4].SetA1(true)
 ```
 
 ##### Gainlayers
 
--   `vmRem.Strip[i].GainLayer()[j]`
+-   `vm.Strip[i].GainLayer()[j]`
 
-The following functions are available
+The following methods are available
 
 -   `Get() float64`
 -   `Set(val float32)`
@@ -173,14 +175,14 @@ The following functions are available
 example:
 
 ```go
-vmRem.Strip[6].GainLayer()[3].Set(-13.6)
+vm.Strip[6].GainLayer()[3].Set(-13.6)
 ```
 
 ##### Levels
 
--   `vmRem.Strip[i].Levels()`
+-   `vm.Strip[i].Levels()`
 
-The following functions are available
+The following methods are available
 
 -   `PreFader() []float32`
 -   `PostFader() []float32`
@@ -189,12 +191,12 @@ The following functions are available
 example:
 
 ```go
-fmt.Println(vmRem.Strip[5].Levels().PreFader())
+fmt.Println(vm.Strip[5].Levels().PreFader())
 ```
 
 ### Bus
 
-The following functions are available
+The following methods are available
 
 -   `String() string`
 -   `GetMute() bool`
@@ -209,15 +211,15 @@ The following functions are available
 -   `SetGain(val float32)` from -60.0 to 12.0
 
 ```go
-vmRem.Bus[3].SetEq(true)
-fmt.Println(vmRem.Bus[0].GetLabel())
+vm.Bus[3].SetEq(true)
+fmt.Println(vm.Bus[0].GetLabel())
 ```
 
 ##### Modes
 
--   `vmRem.Bus[i].Mode()`
+-   `vm.Bus[i].Mode()`
 
-The following functions are available
+The following methods are available
 
 -   `SetNormal(val bool)`
 -   `GetNormal() bool`
@@ -247,27 +249,27 @@ The following functions are available
 example:
 
 ```go
-vmRem.Bus[3].Mode().SetAmix(true)
-vmRem.Bus[4].Mode().SetCenterOnly(true)
+vm.Bus[3].Mode().SetAmix(true)
+vm.Bus[4].Mode().SetCenterOnly(true)
 ```
 
 ##### Levels
 
--   `vmRem.Bus[i].Levels()`
+-   `vm.Bus[i].Levels()`
 
-The following functions are available
+The following methods are available
 
 -   `All() []float32`
 
 example:
 
 ```go
-fmt.Println(vmRem.Bus[1].Levels().All())
+fmt.Println(vm.Bus[1].Levels().All())
 ```
 
 ### Button
 
-The following functions are available
+The following methods are available
 
 -   `GetState() bool`
 -   `SetState(val bool)`
@@ -279,13 +281,13 @@ The following functions are available
 example:
 
 ```go
-vmRem.Button[37].SetState(true)
-fmt.Println(vmRem.Button[64].GetStateOnly())
+vm.Button[37].SetState(true)
+fmt.Println(vm.Button[64].GetStateOnly())
 ```
 
 ### Command
 
-The following functions are available
+The following methods are available
 
 -   `Show()` Show Voicemeeter GUI if it's hidden
 -   `Hide()` Hide Voicemeeter GUI if it's shown
@@ -296,19 +298,19 @@ The following functions are available
 example:
 
 ```go
-vmRem.Command.Restart()
-vmRem.Command.Show()
+vm.Command.Restart()
+vm.Command.Show()
 ```
 
 ### VBAN
 
--   `vmRem.Vban.Enable()` `vmRem.Vban.Disable()` Turn VBAN on or off
+-   `vm.Vban.Enable()` `vm.Vban.Disable()` Turn VBAN on or off
 
 ##### Instream | Outstream
 
--   `vmRem.Vban.InStream` `vmRem.Vban.OutStream`
+-   `vm.Vban.InStream` `vm.Vban.OutStream`
 
-The following functions are available
+The following methods are available
 
 -   `GetOn() bool`
 -   `SetOn(val bool)`
@@ -333,18 +335,18 @@ example:
 
 ```go
 # turn VBAN on
-vmRem.Vban.Enable()
+vm.Vban.Enable()
 
 // turn on vban instream 0
-vmRem.Vban.InStream[0].SetOn(true)
+vm.Vban.InStream[0].SetOn(true)
 
 // set bit property for outstream 3 to 24
-vmRem.Vban.OutStream[3].SetBit(24)
+vm.Vban.OutStream[3].SetBit(24)
 ```
 
 ### Device
 
-The following functions are available
+The following methods are available
 
 -   `Ins`
 -   `Outs`
@@ -354,14 +356,14 @@ The following functions are available
 example:
 
 ```go
-for i := 0; i < int(vmRem.Device.Ins()); i++ {
-	fmt.Println(vmRem.Device.Input(i))
+for i := 0; i < int(vm.Device.Ins()); i++ {
+	fmt.Println(vm.Device.Input(i))
 }
 ```
 
 ### Recorder
 
-The following functions are available
+The following methods are available
 
 -   `Play()`
 -   `Stop()`
@@ -374,14 +376,14 @@ The following functions are available
 example:
 
 ```go
-vmRem.Recorder.Play()
-vmRem.Recorder.Stop()
+vm.Recorder.Play()
+vm.Recorder.Stop()
 
 # Enable loop play
-vmRem.Recorder.Loop(true)
+vm.Recorder.Loop(true)
 
 # Disable recorder out channel B2
-vmRem.Recorder.SetB2(false)
+vm.Recorder.SetB2(false)
 ```
 
 ### Run tests

base.go

@@ -40,7 +40,8 @@ var (
 )
 
 // login logs into the API,
-// then attempts to launch Voicemeeter if it's not running.
+// attempts to launch Voicemeeter if it's not running,
+// initializes dirty parameters.
 func login(kindId string) {
 	res, _, _ := vmLogin.Call()
 	if res == 1 {
@@ -112,19 +113,20 @@ func mdirty() bool {
 	return int(res) == 1
 }
 
+// ldirty returns true iff a level value has changed
 func ldirty(k *kind) bool {
-	_levelCache.stripLevelsBuff = make([]float32, (2*k.physIn)+(8*k.virtIn))
-	_levelCache.busLevelsBuff = make([]float32, 8*k.numBus())
+	_levelCache.stripLevelsBuff = make([]float32, (2*k.PhysIn)+(8*k.VirtIn))
+	_levelCache.busLevelsBuff = make([]float32, 8*k.NumBus())
 
-	for i := 0; i < (2*k.physIn)+(8*k.virtIn); i++ {
+	for i := 0; i < (2*k.PhysIn)+(8*k.VirtIn); i++ {
 		_levelCache.stripLevelsBuff[i] = float32(getLevel(_levelCache.stripMode, i))
 		_levelCache.stripComp[i] = _levelCache.stripLevelsBuff[i] == _levelCache.stripLevels[i]
 	}
-	for i := 0; i < 8*k.numBus(); i++ {
+	for i := 0; i < 8*k.NumBus(); i++ {
 		_levelCache.busLevelsBuff[i] = float32(getLevel(3, i))
 		_levelCache.busComp[i] = _levelCache.busLevelsBuff[i] == _levelCache.busLevels[i]
 	}
-	return !(allTrue(_levelCache.stripComp, (2*k.physIn)+(8*k.virtIn)) && allTrue(_levelCache.busComp, 8*k.numBus()))
+	return !(allTrue(_levelCache.stripComp, (2*k.PhysIn)+(8*k.VirtIn)) && allTrue(_levelCache.busComp, 8*k.NumBus()))
 }
 
 // getVMType returns the type of Voicemeeter, as a string
@@ -252,7 +254,8 @@ func setMacroStatus(id, state, mode int) {
 	}
 }
 
-func get_num_devices(dir string) uint64 {
+// getNumDevices returns the number of hardware input/output devices
+func getNumDevices(dir string) uint64 {
 	if strings.Compare(dir, "in") == 0 {
 		res, _, _ := vmGetDevNumIn.Call()
 		return uint64(res)
@@ -262,7 +265,8 @@ func get_num_devices(dir string) uint64 {
 	}
 }
 
-func get_device_description(i int, dir string) (string, uint64, string) {
+// getDeviceDescription returns name, driver type and hwid for a given device
+func getDeviceDescription(i int, dir string) (string, uint64, string) {
 	var t_ uint64
 	var b1 [512]byte
 	var b2 [512]byte

bus.go

@@ -2,9 +2,11 @@ package voicemeeter
 
 import (
 	"fmt"
+	"time"
 )
 
-type t_bus interface {
+// iBus defines the interface bus types must satisfy
+type iBus interface {
 	String() string
 	GetMute() bool
 	SetMute(val bool)
@@ -16,8 +18,10 @@ type t_bus interface {
 	SetLabel(val string)
 	GetGain() float64
 	SetGain(val float32)
-	Mode() t_busMode
+	Mode() iBusMode
 	Levels() *levels
+	FadeTo(target float32, time_ int)
+	FadeBy(change float32, time_ int)
 }
 
 // bus represents a bus channel
@@ -78,25 +82,39 @@ func (b *bus) SetGain(val float32) {
 }
 
 // Mode returns address of a busMode struct
-func (b *bus) Mode() t_busMode {
+func (b *bus) Mode() iBusMode {
 	return &b.mode
 }
 
-// Levels returns the gainlayer field
+// Levels returns the levels field
 func (b *bus) Levels() *levels {
 	return &b.levels
 }
 
+// FadeTo sets the value of gain to target over at time interval of time_
+func (b *bus) FadeTo(target float32, time_ int) {
+	b.setter_string("FadeTo", fmt.Sprintf("(\"%f\", %d)", target, time_))
+	time.Sleep(time.Millisecond)
+}
+
+// FadeBy adjusts the value of gain by change over a time interval of time_
+func (b *bus) FadeBy(change float32, time_ int) {
+	b.setter_string("FadeBy", fmt.Sprintf("(\"%f\", %d)", change, time_))
+	time.Sleep(time.Millisecond)
+}
+
+//physicalBus represents a single physical bus
 type physicalBus struct {
 	bus
 }
 
-func newPhysicalBus(i int, k *kind) t_bus {
+// newPhysicalBus returns a physicalBus type cast to an iBus
+func newPhysicalBus(i int, k *kind) iBus {
 	b := newBusMode(i)
 	l := newBusLevels(i, k)
 	pb := physicalBus{bus{iRemote{fmt.Sprintf("bus[%d]", i), i}, b, l}}
 
-	return t_bus(&pb)
+	return iBus(&pb)
 }
 
 // String implements the fmt.stringer interface
@@ -104,15 +122,17 @@ func (p *physicalBus) String() string {
 	return fmt.Sprintf("PhysicalBus%d", p.index)
 }
 
+//virtualBus represents a single virtual bus
 type virtualBus struct {
 	bus
 }
 
-func newVirtualBus(i int, k *kind) t_bus {
+// newVirtualBus returns a virtualBus type cast to an iBus
+func newVirtualBus(i int, k *kind) iBus {
 	b := newBusMode(i)
 	l := newBusLevels(i, k)
 	vb := virtualBus{bus{iRemote{fmt.Sprintf("bus[%d]", i), i}, b, l}}
-	return t_bus(&vb)
+	return iBus(&vb)
 }
 
 // String implements the fmt.stringer interface
@@ -120,7 +140,8 @@ func (v *virtualBus) String() string {
 	return fmt.Sprintf("VirtualBus%d", v.index)
 }
 
-type t_busMode interface {
+// iBusMode defines the interface busMode type must satisfy
+type iBusMode interface {
 	SetNormal(val bool)
 	GetNormal() bool
 	SetAmix(val bool)
@@ -147,119 +168,147 @@ type t_busMode interface {
 	GetRearOnly() bool
 }
 
+// busMode offers methods for getting/setting bus mode states
 type busMode struct {
 	iRemote
 }
 
+// newBusMode returns a busMode struct
 func newBusMode(i int) busMode {
 	return busMode{iRemote{fmt.Sprintf("bus[%d].mode", i), i}}
 }
 
-func (bm *busMode) SetNormal(val bool) {
-	bm.setter_bool("Normal", val)
-}
-
+// GetNormal gets the value of the Mode.Normal parameter
 func (bm *busMode) GetNormal() bool {
 	return bm.getter_bool("Normal")
 }
 
-func (bm *busMode) SetAmix(val bool) {
-	bm.setter_bool("Amix", val)
+// SetNormal sets the value of the Mode.Normal parameter
+func (bm *busMode) SetNormal(val bool) {
+	bm.setter_bool("Normal", val)
 }
 
+// GetAmix gets the value of the Mode.Amix parameter
 func (bm *busMode) GetAmix() bool {
 	return bm.getter_bool("Amix")
 }
 
-func (bm *busMode) SetBmix(val bool) {
-	bm.setter_bool("Bmix", val)
+// SetAmix sets the value of the Mode.Amix parameter
+func (bm *busMode) SetAmix(val bool) {
+	bm.setter_bool("Amix", val)
 }
 
+// GetBmix gets the value of the Mode.Bmix parameter
 func (bm *busMode) GetBmix() bool {
 	return bm.getter_bool("Bmix")
 }
 
-func (bm *busMode) SetRepeat(val bool) {
-	bm.setter_bool("Repeat", val)
+// SetBmix sets the value of the Mode.Bmix parameter
+func (bm *busMode) SetBmix(val bool) {
+	bm.setter_bool("Bmix", val)
 }
 
+// GetRepeat gets the value of the Mode.Repeat parameter
 func (bm *busMode) GetRepeat() bool {
 	return bm.getter_bool("Repeat")
 }
 
-func (bm *busMode) SetComposite(val bool) {
-	bm.setter_bool("Composite", val)
+// SetRepeat sets the value of the Mode.Repeat parameter
+func (bm *busMode) SetRepeat(val bool) {
+	bm.setter_bool("Repeat", val)
 }
 
+// GetComposite gets the value of the Mode.Composite parameter
 func (bm *busMode) GetComposite() bool {
 	return bm.getter_bool("Composite")
 }
 
-func (bm *busMode) SetTvMix(val bool) {
-	bm.setter_bool("TvMix", val)
+// SetComposite sets the value of the Mode.Composite parameter
+func (bm *busMode) SetComposite(val bool) {
+	bm.setter_bool("Composite", val)
 }
 
+// GetTvMix gets the value of the Mode.TvMix parameter
 func (bm *busMode) GetTvMix() bool {
 	return bm.getter_bool("TvMix")
 }
 
-func (bm *busMode) SetUpMix21(val bool) {
-	bm.setter_bool("UpMix21", val)
+// SetTvMix sets the value of the Mode.TvMix parameter
+func (bm *busMode) SetTvMix(val bool) {
+	bm.setter_bool("TvMix", val)
 }
 
+// GetUpMix21 gets the value of the Mode.UpMix21 parameter
 func (bm *busMode) GetUpMix21() bool {
 	return bm.getter_bool("UpMix21")
 }
 
-func (bm *busMode) SetUpMix41(val bool) {
-	bm.setter_bool("UpMix41", val)
+// SetUpMix21 sets the value of the Mode.UpMix21 parameter
+func (bm *busMode) SetUpMix21(val bool) {
+	bm.setter_bool("UpMix21", val)
 }
 
+// GetUpMix41 gets the value of the Mode.UpMix41 parameter
 func (bm *busMode) GetUpMix41() bool {
 	return bm.getter_bool("UpMix41")
 }
 
-func (bm *busMode) SetUpMix61(val bool) {
-	bm.setter_bool("UpMix61", val)
+// SetUpMix41 sets the value of the Mode.UpMix41 parameter
+func (bm *busMode) SetUpMix41(val bool) {
+	bm.setter_bool("UpMix41", val)
 }
 
+// GetUpMix61 gets the value of the Mode.UpMix61 parameter
 func (bm *busMode) GetUpMix61() bool {
 	return bm.getter_bool("UpMix61")
 }
 
-func (bm *busMode) SetCenterOnly(val bool) {
-	bm.setter_bool("CenterOnly", val)
+// SetUpMix61 sets the value of the Mode.UpMix61 parameter
+func (bm *busMode) SetUpMix61(val bool) {
+	bm.setter_bool("UpMix61", val)
 }
 
+// GetCenterOnly gets the value of the Mode.CenterOnly parameter
 func (bm *busMode) GetCenterOnly() bool {
 	return bm.getter_bool("CenterOnly")
 }
 
-func (bm *busMode) SetLfeOnly(val bool) {
-	bm.setter_bool("LfeOnly", val)
+// SetCenterOnly sets the value of the Mode.CenterOnly parameter
+func (bm *busMode) SetCenterOnly(val bool) {
+	bm.setter_bool("CenterOnly", val)
 }
 
+// GetLfeOnly gets the value of the Mode.LFE parameter
 func (bm *busMode) GetLfeOnly() bool {
 	return bm.getter_bool("LfeOnly")
 }
 
-func (bm *busMode) SetRearOnly(val bool) {
-	bm.setter_bool("RearOnly", val)
+// SetLfeOnly sets the value of the Mode.LFE parameter
+func (bm *busMode) SetLfeOnly(val bool) {
+	bm.setter_bool("LfeOnly", val)
 }
 
+// GetRearOnly gets the value of the Mode.RearOnly parameter
 func (bm *busMode) GetRearOnly() bool {
 	return bm.getter_bool("RearOnly")
 }
 
+// SetRearOnly sets the value of the Mode.RearOnly parameter
+func (bm *busMode) SetRearOnly(val bool) {
+	bm.setter_bool("RearOnly", val)
+}
+
+// newBusLevels represents the levels field for a channel
 func newBusLevels(i int, k *kind) levels {
 	init := i * 8
 	return levels{iRemote{fmt.Sprintf("bus[%d]", i), i}, k, init, 8, "bus"}
 }
 
+// All returns the level values for a bus
 func (l *levels) All() []float32 {
 	var levels []float32
 	for i := l.init; i < l.init+l.offset; i++ {
-		levels = append(levels, l.convertLevel(_levelCache.busLevels[i]))
+		levels = append(levels, convertLevel(_levelCache.busLevels[i]))
 	}
 	return levels
 }

button.go

@@ -2,7 +2,7 @@ package voicemeeter
 
 import "fmt"
 
-// custom strip type, struct forwarding channel
+// button represents a single macrobuttton
 type button struct {
 	index int
 }

command.go

@@ -1,9 +1,11 @@
 package voicemeeter
 
+//command represents command (action) type parameters
 type command struct {
 	iRemote
 }
 
+// newCommand returns a pointer to a command type
 func newCommand() *command {
 	return &command{iRemote{"command", 0}}
 }
@@ -29,7 +31,6 @@ func (c *command) Restart() {
 }
 
 // Lock locks or unlocks the Voiceemeter GUI
-// it accepts a boolean value
 func (c *command) Lock(val bool) {
 	var value float32
 	if val {

device.go

@@ -13,16 +13,16 @@ func newDevice() *device {
 
 // Ins returns the total number of physical input devices
 func (d *device) Ins() int {
-	return int(get_num_devices("in"))
+	return int(getNumDevices("in"))
 }
 
 // Ins returns the total number of physical input devices
 func (d *device) Outs() int {
-	return int(get_num_devices("out"))
+	return int(getNumDevices("out"))
 }
 
 func (d *device) Input(i int) devDesc {
-	n, t_, id := get_device_description(i, "in")
+	n, t_, id := getDeviceDescription(i, "in")
 	vals := map[uint64]string{
 		1: "mme",
 		3: "wdm",
@@ -33,7 +33,7 @@ func (d *device) Input(i int) devDesc {
 }
 
 func (d *device) Output(i int) devDesc {
-	n, t_, id := get_device_description(i, "out")
+	n, t_, id := getDeviceDescription(i, "out")
 	vals := map[uint64]string{
 		1: "mme",
 		3: "wdm",

examples/observer/observer.go

@@ -34,13 +34,13 @@ func (o observer) OnUpdate(subject string) {
 }
 
 func main() {
-	vmRem := voicemeeter.GetRemote("potato")
-	vmRem.Login()
+	vm := voicemeeter.NewRemote("potato")
+	vm.Login()
 
-	o := observer{vmRem}
-	vmRem.Register(o)
+	o := observer{vm}
+	vm.Register(o)
 	time.Sleep(30 * time.Second)
-	vmRem.Deregister(o)
+	vm.Deregister(o)
 
-	vmRem.Logout()
+	vm.Logout()
 }

go.mod

@@ -2,6 +2,11 @@ module github.com/onyx-and-iris/voicemeeter-api-go
 
 go 1.18
 
+retract (
+	// package files moved into root of repository
+	[v1.0.0, v1.1.0]
+)
+
 require (
 	github.com/stretchr/testify v1.8.0
 	golang.org/x/sys v0.0.0-20220708085239-5a0f0661e09d

iremote.go

@@ -4,12 +4,14 @@ import (
 	"fmt"
 )
 
-// iRemote provides a set of common forwarding methods
+// iRemote provides an interface between higher methods and lower functions
+// expected to be embedded
 type iRemote struct {
 	_identifier string
 	index       int
 }
 
+// identifier returns a string identifier
 func (ir *iRemote) identifier() string {
 	return ir._identifier
 }

kinds.go

@@ -9,25 +9,25 @@ var basic, banana, potato *kind
 
 // A kind represents a Voicemeeter kinds layout
 type kind struct {
-	name                                              string
-	physIn, virtIn, physOut, virtOut, vbanIn, vbanOut int
+	Name                                              string
+	PhysIn, VirtIn, PhysOut, VirtOut, VbanIn, VbanOut int
 }
 
 // numStrip returns the total number of strips for a kind
-func (k *kind) numStrip() int {
-	n := k.physIn + k.virtIn
+func (k *kind) NumStrip() int {
+	n := k.PhysIn + k.VirtIn
 	return n
 }
 
 // numBus returns the total number of buses for a kind
-func (k *kind) numBus() int {
-	n := k.physOut + k.virtOut
+func (k *kind) NumBus() int {
+	n := k.PhysOut + k.VirtOut
 	return n
 }
 
 // String implements the fmt.stringer interface
 func (k *kind) String() string {
-	return fmt.Sprintf("%s%s", strings.ToUpper(k.name[:1]), k.name[1:])
+	return fmt.Sprintf("%s%s", strings.ToUpper(k.Name[:1]), k.Name[1:])
 }
 
 // newBasicKind returns a basic kind struct address

levels.go

@@ -1,8 +1,6 @@
 package voicemeeter
 
-import "math"
-
-// levels
+// levels represents the levels field for a channel
 type levels struct {
 	iRemote
 	k      *kind
@@ -11,12 +9,15 @@ type levels struct {
 	id     string
 }
 
-func (l *levels) convertLevel(i float32) float32 {
-	if i > 0 {
-		val := 20 * math.Log10(float64(i))
-		return float32(roundFloat(float64(val), 1))
+// returns true if any levels value for a strip/bus have been updated
+func (l *levels) IsDirty() bool {
+	var vals []bool
+	if l.id == "strip" {
+		vals = _levelCache.stripComp[l.init : l.init+l.offset]
+	} else if l.id == "bus" {
+		vals = _levelCache.busComp[l.init : l.init+l.offset]
 	}
-	return -200.0
+	return !allTrue(vals, l.offset)
 }
 
 var _levelCache *levelCache
@@ -34,10 +35,10 @@ type levelCache struct {
 
 // newLevelCache returns a levelCache struct address
 func newLevelCache(k *kind) *levelCache {
-	stripLevels := make([]float32, (2*k.physIn)+(8*k.virtIn))
-	busLevels := make([]float32, 8*k.numBus())
-	stripComp := make([]bool, (2*k.physIn)+(8*k.virtIn))
-	busComp := make([]bool, 8*k.numBus())
+	stripLevels := make([]float32, (2*k.PhysIn)+(8*k.VirtIn))
+	busLevels := make([]float32, 8*k.NumBus())
+	stripComp := make([]bool, (2*k.PhysIn)+(8*k.VirtIn))
+	busComp := make([]bool, 8*k.NumBus())
 	if _levelCache == nil {
 		_levelCache = &levelCache{stripMode: 0, stripLevels: stripLevels, busLevels: busLevels, stripComp: stripComp, busComp: busComp}
 	}

outputs.go

@@ -1,6 +1,7 @@
 package voicemeeter
 
-type t_outputs interface {
+// iOutputs defines the interface outputs type must satisfy
+type iOutputs interface {
 	GetA1() bool
 	SetA1(val bool)
 	GetA2() bool
@@ -19,10 +20,13 @@ type t_outputs interface {
 	SetB3(val bool)
 }
 
+// outputs represents the outputs field (A1 - A5, B1 - B3)
+// expected to be embedded
 type outputs struct {
 	iRemote
 }
 
+// newOutputs returns an outputs type
 func newOutputs(id string, i int) outputs {
 	o := outputs{iRemote{id, i}}
 	return o

publisher.go

@@ -75,8 +75,8 @@ func (p *pooler) levels() {
 
 	for p.run {
 		if ldirty(p.k) {
-			update(_levelCache.stripLevels, _levelCache.stripLevelsBuff, (2*p.k.physIn)+(8*p.k.virtIn))
-			update(_levelCache.busLevels, _levelCache.busLevelsBuff, 8*p.k.numBus())
+			update(_levelCache.stripLevels, _levelCache.stripLevelsBuff, (2*p.k.PhysIn)+(8*p.k.VirtIn))
+			update(_levelCache.busLevels, _levelCache.busLevelsBuff, 8*p.k.NumBus())
 			p.notify("ldirty")
 		}
 		time.Sleep(33 * time.Millisecond)

recorder.go

@@ -1,10 +1,12 @@
 package voicemeeter
 
+// recorder represents the recorder
 type recorder struct {
 	iRemote
 	outputs
 }
 
+// newRecorder returns an address to a recorder struct
 func newRecorder() *recorder {
 	o := newOutputs("recorder", 0)
 	return &recorder{iRemote{"recorder", 0}, o}

remote.go

@@ -7,9 +7,9 @@ import (
 
 // A Remote type represents the API for a kind
 type Remote struct {
-	kind     *kind
-	Strip    []t_strip
-	Bus      []t_bus
+	Kind     *kind
+	Strip    []iStrip
+	Bus      []iBus
 	Button   []button
 	Command  *command
 	Vban     *vban
@@ -21,14 +21,14 @@ type Remote struct {
 
 // String implements the fmt.stringer interface
 func (r *Remote) String() string {
-	return fmt.Sprintf("Voicemeeter %s", r.kind)
+	return fmt.Sprintf("Voicemeeter %s", r.Kind)
 }
 
 // Login logs into the API
 // then it intializes the pooler
 func (r *Remote) Login() {
-	login(r.kind.name)
-	r.pooler = newPooler(r.kind)
+	login(r.Kind.Name)
+	r.pooler = newPooler(r.Kind)
 }
 
 // Logout logs out of the API
@@ -38,10 +38,12 @@ func (r *Remote) Logout() {
 	logout()
 }
 
+// Type returns the type of Voicemeeter (basic, banana, potato)
 func (r *Remote) Type() string {
 	return getVMType()
 }
 
+// Version returns the version of Voicemeeter as a string
 func (r *Remote) Version() string {
 	return getVersion()
 }
@@ -56,6 +58,7 @@ func (r *Remote) Mdirty() bool {
 	return mdirty()
 }
 
+// SendText sets multiple parameters by script
 func (r *Remote) SendText(script string) {
 	setParametersMulti(script)
 }
@@ -65,11 +68,12 @@ func (r *Remote) Register(o observer) {
 	r.pooler.Register(o)
 }
 
-// Register forwards the deregister method to Pooler
+// Deregister forwards the deregister method to Pooler
 func (r *Remote) Deregister(o observer) {
 	r.pooler.Deregister(o)
 }
 
+// remoteBuilder defines the interface builder types must satisfy
 type remoteBuilder interface {
 	setKind() remoteBuilder
 	makeStrip() remoteBuilder
@@ -103,23 +107,25 @@ func (d *director) Get() *Remote {
 	return d.builder.Get()
 }
 
+// genericBuilder represents a generic builder type
 type genericBuilder struct {
 	k *kind
 	r Remote
 }
 
+// setKind sets the kind for a builder of a kind
 func (b *genericBuilder) setKind() remoteBuilder {
-	b.r.kind = b.k
+	b.r.Kind = b.k
 	return b
 }
 
 // makeStrip makes a strip slice and assigns it to remote.Strip
-// []t_strip comprises of both physical and virtual strip types
+// []iStrip comprises of both physical and virtual strip types
 func (b *genericBuilder) makeStrip() remoteBuilder {
 	fmt.Println("building strip")
-	_strip := make([]t_strip, b.k.numStrip())
-	for i := 0; i < b.k.numStrip(); i++ {
-		if i < b.k.physIn {
+	_strip := make([]iStrip, b.k.NumStrip())
+	for i := 0; i < b.k.NumStrip(); i++ {
+		if i < b.k.PhysIn {
 			_strip[i] = newPhysicalStrip(i, b.k)
 		} else {
 			_strip[i] = newVirtualStrip(i, b.k)
@@ -133,9 +139,9 @@ func (b *genericBuilder) makeStrip() remoteBuilder {
 // []t_bus comprises of both physical and virtual bus types
 func (b *genericBuilder) makeBus() remoteBuilder {
 	fmt.Println("building bus")
-	_bus := make([]t_bus, b.k.numBus())
-	for i := 0; i < b.k.numBus(); i++ {
-		if i < b.k.physOut {
+	_bus := make([]iBus, b.k.NumBus())
+	for i := 0; i < b.k.NumBus(); i++ {
+		if i < b.k.PhysOut {
 			_bus[i] = newPhysicalBus(i, b.k)
 		} else {
 			_bus[i] = newVirtualBus(i, b.k)
@@ -189,6 +195,7 @@ func (b *genericBuilder) Get() *Remote {
 	return &b.r
 }
 
+// basicBuilder represents a builder specific to basic type
 type basicBuilder struct {
 	genericBuilder
 }
@@ -198,6 +205,7 @@ func (basb *genericBuilder) Build() remoteBuilder {
 	return basb.setKind().makeStrip().makeBus().makeButton().makeCommand().makeVban().makeDevice()
 }
 
+// bananaBuilder represents a builder specific to banana type
 type bananaBuilder struct {
 	genericBuilder
 }
@@ -207,6 +215,7 @@ func (banb *bananaBuilder) Build() remoteBuilder {
 	return banb.setKind().makeStrip().makeBus().makeButton().makeCommand().makeVban().makeDevice().makeRecorder()
 }
 
+// potatoBuilder represents a builder specific to potato type
 type potatoBuilder struct {
 	genericBuilder
 }
@@ -216,9 +225,9 @@ func (potb *potatoBuilder) Build() remoteBuilder {
 	return potb.setKind().makeStrip().makeBus().makeButton().makeCommand().makeVban().makeDevice().makeRecorder()
 }
 
-// GetRemote returns a Remote type for a kind
+// NewRemote returns a Remote type for a kind
 // this is the interface entry point
-func GetRemote(kindId string) *Remote {
+func NewRemote(kindId string) *Remote {
 	_kind, ok := kindMap[kindId]
 	if !ok {
 		err := fmt.Errorf("unknown Voicemeeter kind '%s'", kindId)
@@ -227,7 +236,7 @@ func GetRemote(kindId string) *Remote {
 	}
 
 	director := director{}
-	switch _kind.name {
+	switch _kind.Name {
 	case "basic":
 		director.SetBuilder(&basicBuilder{genericBuilder{_kind, Remote{}}})
 	case "banana":

remote_test.go

@@ -8,7 +8,7 @@ import (
 
 func TestGetBasicRemote(t *testing.T) {
 	//t.Skip("skipping test")
-	__rem := GetRemote("basic")
+	__rem := NewRemote("basic")
 	t.Run("Should return a remote basic type", func(t *testing.T) {
 		assert.NotNil(t, __rem)
 	})
@@ -34,7 +34,7 @@ func TestGetBasicRemote(t *testing.T) {
 
 func TestGetBananaRemote(t *testing.T) {
 	//t.Skip("skipping test")
-	__rem := GetRemote("banana")
+	__rem := NewRemote("banana")
 	t.Run("Should return a remote banana type", func(t *testing.T) {
 		assert.NotNil(t, __rem)
 	})
@@ -60,7 +60,7 @@ func TestGetBananaRemote(t *testing.T) {
 
 func TestGetPotatoRemote(t *testing.T) {
 	//t.Skip("skipping test")
-	__rem := GetRemote("potato")
+	__rem := NewRemote("potato")
 	t.Run("Should return a remote basic type", func(t *testing.T) {
 		assert.NotNil(t, __rem)
 	})

strip.go

@@ -2,9 +2,11 @@ package voicemeeter
 
 import (
 	"fmt"
+	"time"
 )
 
-type t_strip interface {
+// iStrip defines the interface bus types must satisfy
+type iStrip interface {
 	String() string
 	GetMute() bool
 	SetMute(val bool)
@@ -28,7 +30,11 @@ type t_strip interface {
 	SetAudibility(val float32)
 	GainLayer() []gainLayer
 	Levels() *levels
-	t_outputs
+	FadeTo(target float32, time_ int)
+	FadeBy(change float32, time_ int)
+	AppGain(name string, gain float32)
+	AppMute(name string, val bool)
+	iOutputs
 }
 
 // strip represents a strip channel
@@ -104,16 +110,30 @@ func (s *strip) GainLayer() []gainLayer {
 	return s.gainLayer
 }
 
-// Levels returns the gainlayer field
+// Levels returns the levels field
 func (s *strip) Levels() *levels {
 	return &s.levels
 }
 
+// FadeTo sets the value of gain to target over at time interval of time_
+func (s *strip) FadeTo(target float32, time_ int) {
+	s.setter_string("FadeTo", fmt.Sprintf("(\"%f\", %d)", target, time_))
+	time.Sleep(time.Millisecond)
+}
+
+// FadeBy adjusts the value of gain by change over a time interval of time_
+func (s *strip) FadeBy(change float32, time_ int) {
+	s.setter_string("FadeBy", fmt.Sprintf("(\"%f\", %d)", change, time_))
+	time.Sleep(time.Millisecond)
+}
+
+//physicalStrip represents a single physical strip
 type physicalStrip struct {
 	strip
 }
 
-func newPhysicalStrip(i int, k *kind) t_strip {
+// newPhysicalStrip returns a physicalStrip type cast to an iStrip
+func newPhysicalStrip(i int, k *kind) iStrip {
 	o := newOutputs(fmt.Sprintf("strip[%d]", i), i)
 	gl := make([]gainLayer, 8)
 	for j := 0; j < 8; j++ {
@@ -121,10 +141,10 @@ func newPhysicalStrip(i int, k *kind) t_strip {
 	}
 	l := newStripLevels(i, k)
 	ps := physicalStrip{strip{iRemote{fmt.Sprintf("strip[%d]", i), i}, o, gl, l}}
-	return t_strip(&ps)
+	return iStrip(&ps)
 }
 
-// implement fmt.stringer interface in fmt
+// String implements fmt.stringer interface
 func (p *physicalStrip) String() string {
 	return fmt.Sprintf("PhysicalStrip%d", p.index)
 }
@@ -169,11 +189,13 @@ func (p *physicalStrip) SetMc(val bool) {
 	panic("invalid parameter MC for physicalStrip")
 }
 
+//virtualStrip represents a single virtual strip
 type virtualStrip struct {
 	strip
 }
 
-func newVirtualStrip(i int, k *kind) t_strip {
+// newVirtualStrip returns a virtualStrip type cast to an iStrip
+func newVirtualStrip(i int, k *kind) iStrip {
 	o := newOutputs(fmt.Sprintf("strip[%d]", i), i)
 	gl := make([]gainLayer, 8)
 	for j := 0; j < 8; j++ {
@@ -181,10 +203,10 @@ func newVirtualStrip(i int, k *kind) t_strip {
 	}
 	l := newStripLevels(i, k)
 	vs := virtualStrip{strip{iRemote{fmt.Sprintf("strip[%d]", i), i}, o, gl, l}}
-	return t_strip(&vs)
+	return iStrip(&vs)
 }
 
-// implement fmt.stringer interface in fmt
+// String implements fmt.stringer interface
 func (v *virtualStrip) String() string {
 	return fmt.Sprintf("VirtualStrip%d", v.index)
 }
@@ -229,69 +251,83 @@ func (v *virtualStrip) SetAudibility(val float32) {
 	panic("invalid parameter Audibility for virtualStrip")
 }
 
+// AppGain sets the gain in db by val for the app matching name.
+func (v *strip) AppGain(name string, val float32) {
+	v.setter_string("AppGain", fmt.Sprintf("(\"%s\", %f)", name, val))
+}
+
+// AppMute sets mute state as val for the app matching name.
+func (v *strip) AppMute(name string, val bool) {
+	var value int
+	if val {
+		value = 1
+	} else {
+		value = 0
+	}
+	v.setter_string("AppMute", fmt.Sprintf("(\"%s\", %f)", name, float32(value)))
+}
+
+// gainLayer represents the 8 gainlayers for a single strip
 type gainLayer struct {
 	iRemote
 	index int
 }
 
+// newGainLayer returns a gainlayer struct
 func newGainLayer(i, j int) gainLayer {
 	return gainLayer{iRemote{fmt.Sprintf("strip[%d]", i), i}, j}
 }
 
+// Get gets the gain value for a single gainlayer
 func (gl *gainLayer) Get() float64 {
 	return gl.getter_float(fmt.Sprintf("gainlayer[%d]", gl.index))
 }
 
+// Set sets the gain value for a single gainlayer
 func (gl *gainLayer) Set(val float32) {
 	gl.setter_float(fmt.Sprintf("gainlayer[%d]", gl.index), val)
 }
 
+// newStripLevels returns a levels struct
 func newStripLevels(i int, k *kind) levels {
 	var init int
 	var os int
-	if i < k.physIn {
+	if i < k.PhysIn {
 		init = i * 2
 		os = 2
 	} else {
-		init = (k.physIn * 2) + ((i - k.physIn) * 8)
+		init = (k.PhysIn * 2) + ((i - k.PhysIn) * 8)
 		os = 8
 	}
 	return levels{iRemote{fmt.Sprintf("strip[%d]", i), i}, k, init, os, "strip"}
 }
 
+// PreFader returns the level values for this strip, PREFADER mode
 func (l *levels) PreFader() []float32 {
 	_levelCache.stripMode = 0
 	var levels []float32
 	for i := l.init; i < l.init+l.offset; i++ {
-		levels = append(levels, l.convertLevel(_levelCache.stripLevels[i]))
+		levels = append(levels, convertLevel(_levelCache.stripLevels[i]))
 	}
 	return levels
 }
 
+// PostFader returns the level values for this strip, POSTFADER mode
 func (l *levels) PostFader() []float32 {
 	_levelCache.stripMode = 1
 	var levels []float32
 	for i := l.init; i < l.init+l.offset; i++ {
-		levels = append(levels, l.convertLevel(_levelCache.stripLevels[i]))
+		levels = append(levels, convertLevel(_levelCache.stripLevels[i]))
 	}
 	return levels
 }
 
+// PostMute returns the level values for this strip, POSTMUTE mode
 func (l *levels) PostMute() []float32 {
 	_levelCache.stripMode = 2
 	var levels []float32
 	for i := l.init; i < l.init+l.offset; i++ {
-		levels = append(levels, l.convertLevel(_levelCache.stripLevels[i]))
+		levels = append(levels, convertLevel(_levelCache.stripLevels[i]))
 	}
 	return levels
 }
-
-func (l *levels) IsDirty() bool {
-	var vals []bool
-	if l.id == "strip" {
-		vals = _levelCache.stripComp[l.init : l.init+l.offset]
-	} else if l.id == "bus" {
-		vals = _levelCache.busComp[l.init : l.init+l.offset]
-	}
-	return !allTrue(vals, l.offset)
-}

tests/helper_test.go

@@ -9,18 +9,18 @@ import (
 )
 
 var (
-	vmRem = voicemeeter.GetRemote("potato")
+	vm = voicemeeter.NewRemote("potato")
 )
 
 func TestMain(m *testing.M) {
-	vmRem.Login()
+	vm.Login()
 	code := m.Run()
-	vmRem.Logout()
+	vm.Logout()
 	os.Exit(code)
 }
 
 func sync() {
 	time.Sleep(30 * time.Millisecond)
-	for vmRem.Pdirty() || vmRem.Mdirty() {
+	for vm.Pdirty() || vm.Mdirty() {
 	}
 }

tests/higher_test.go

@@ -8,206 +8,206 @@ import (
 
 func TestStrip0Mute(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[0].SetMute(true)
+	vm.Strip[0].SetMute(true)
 	sync()
 	t.Run("Should return true when SetMute(true)", func(t *testing.T) {
-		assert.True(t, vmRem.Strip[0].GetMute())
+		assert.True(t, vm.Strip[0].GetMute())
 	})
 
-	vmRem.Strip[0].SetMute(false)
+	vm.Strip[0].SetMute(false)
 	sync()
 	t.Run("Should return false when SetMute(false)", func(t *testing.T) {
-		assert.False(t, vmRem.Strip[0].GetMute())
+		assert.False(t, vm.Strip[0].GetMute())
 	})
 }
 
 func TestStrip3A1(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[3].SetA1(true)
+	vm.Strip[3].SetA1(true)
 	sync()
 	t.Run("Should return true when SetA1(true)", func(t *testing.T) {
-		assert.True(t, vmRem.Strip[3].GetA1())
+		assert.True(t, vm.Strip[3].GetA1())
 	})
 
-	vmRem.Strip[3].SetA1(false)
+	vm.Strip[3].SetA1(false)
 	sync()
 	t.Run("Should return false when SetA1(false)", func(t *testing.T) {
-		assert.False(t, vmRem.Strip[3].GetA1())
+		assert.False(t, vm.Strip[3].GetA1())
 	})
 }
 
 func TestStrip2Limit(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[2].SetLimit(-8)
+	vm.Strip[2].SetLimit(-8)
 	sync()
 	t.Run("Should return -8 when SetLimit(-8)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[2].GetLimit(), -8)
+		assert.Equal(t, vm.Strip[2].GetLimit(), -8)
 	})
 
-	vmRem.Strip[2].SetLimit(-32)
+	vm.Strip[2].SetLimit(-32)
 	sync()
 	t.Run("Should return -32 when SetLimit(-8)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[2].GetLimit(), -32)
+		assert.Equal(t, vm.Strip[2].GetLimit(), -32)
 	})
 
 }
 
 func TestStrip4Label(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[4].SetLabel("test0")
+	vm.Strip[4].SetLabel("test0")
 	sync()
 	t.Run("Should return test0 when SetLimit('test0')", func(t *testing.T) {
-		assert.Equal(t, "test0", vmRem.Strip[4].GetLabel())
+		assert.Equal(t, "test0", vm.Strip[4].GetLabel())
 	})
 
-	vmRem.Strip[4].SetLabel("test1")
+	vm.Strip[4].SetLabel("test1")
 	sync()
 	t.Run("Should return test1 when SetLimit('test1')", func(t *testing.T) {
-		assert.Equal(t, "test1", vmRem.Strip[4].GetLabel())
+		assert.Equal(t, "test1", vm.Strip[4].GetLabel())
 	})
 }
 
 func TestStrip5Gain(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[4].SetGain(-20.8)
+	vm.Strip[4].SetGain(-20.8)
 	sync()
 	t.Run("Should return -20.8 when SetGain(-20.8)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[4].GetGain(), -20.8)
+		assert.Equal(t, vm.Strip[4].GetGain(), -20.8)
 	})
 
-	vmRem.Strip[4].SetGain(-3.6)
+	vm.Strip[4].SetGain(-3.6)
 	sync()
 	t.Run("Should return -3.6 when SetGain(-3.6)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[4].GetGain(), -3.6)
+		assert.Equal(t, vm.Strip[4].GetGain(), -3.6)
 	})
 }
 
 func TestStrip3Comp(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[4].SetComp(8.1)
+	vm.Strip[4].SetComp(8.1)
 	sync()
 	t.Run("Should return 8.1 when SetGain(8.1)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[4].GetComp(), 8.1)
+		assert.Equal(t, vm.Strip[4].GetComp(), 8.1)
 	})
 
-	vmRem.Strip[4].SetComp(1.6)
+	vm.Strip[4].SetComp(1.6)
 	sync()
 	t.Run("Should return 1.6 when SetGain(1.6)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[4].GetComp(), 1.6)
+		assert.Equal(t, vm.Strip[4].GetComp(), 1.6)
 	})
 }
 
 func TestStrip5Mc(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[5].SetMc(true)
+	vm.Strip[5].SetMc(true)
 	sync()
 	t.Run("Should return true when SetMc(true)", func(t *testing.T) {
-		assert.True(t, vmRem.Strip[5].GetMc())
+		assert.True(t, vm.Strip[5].GetMc())
 	})
 
-	vmRem.Strip[5].SetMc(false)
+	vm.Strip[5].SetMc(false)
 	sync()
 	t.Run("Should return false when SetMc(false)", func(t *testing.T) {
-		assert.False(t, vmRem.Strip[5].GetMc())
+		assert.False(t, vm.Strip[5].GetMc())
 	})
 }
 
 func TestStrip2GainLayer3(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Strip[2].GainLayer()[3].Set(-18.3)
+	vm.Strip[2].GainLayer()[3].Set(-18.3)
 	sync()
 	t.Run("Should return -18.3 when SetMc(true)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[2].GainLayer()[3].Get(), -18.3)
+		assert.Equal(t, vm.Strip[2].GainLayer()[3].Get(), -18.3)
 	})
 
-	vmRem.Strip[2].GainLayer()[3].Set(-25.6)
+	vm.Strip[2].GainLayer()[3].Set(-25.6)
 	sync()
 	t.Run("Should return -25.6 when SetMc(true)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Strip[2].GainLayer()[3].Get(), -25.6)
+		assert.Equal(t, vm.Strip[2].GainLayer()[3].Get(), -25.6)
 	})
 }
 
 func TestBus3Eq(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Bus[3].SetEq(true)
+	vm.Bus[3].SetEq(true)
 	sync()
 	t.Run("Should return true when SetEq(true)", func(t *testing.T) {
-		assert.True(t, vmRem.Bus[3].GetEq())
+		assert.True(t, vm.Bus[3].GetEq())
 	})
 
-	vmRem.Bus[3].SetEq(false)
+	vm.Bus[3].SetEq(false)
 	sync()
 	t.Run("Should return false when SetEq(false)", func(t *testing.T) {
-		assert.False(t, vmRem.Bus[3].GetEq())
+		assert.False(t, vm.Bus[3].GetEq())
 	})
 }
 
 func TestBus4Label(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Bus[4].SetLabel("test0")
+	vm.Bus[4].SetLabel("test0")
 	sync()
 	t.Run("Should return test0 when SetEq('test0')", func(t *testing.T) {
-		assert.Equal(t, "test0", vmRem.Bus[4].GetLabel())
+		assert.Equal(t, "test0", vm.Bus[4].GetLabel())
 	})
 
-	vmRem.Bus[4].SetLabel("test1")
+	vm.Bus[4].SetLabel("test1")
 	sync()
 	t.Run("Should return test1 when SetEq('test1')", func(t *testing.T) {
-		assert.Equal(t, "test1", vmRem.Bus[4].GetLabel())
+		assert.Equal(t, "test1", vm.Bus[4].GetLabel())
 	})
 }
 
 func TestBus3ModeAmix(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Bus[3].Mode().SetAmix(true)
+	vm.Bus[3].Mode().SetAmix(true)
 	sync()
 	t.Run("Should return true when Mode().SetAmix(true)", func(t *testing.T) {
-		assert.True(t, vmRem.Bus[3].Mode().GetAmix())
+		assert.True(t, vm.Bus[3].Mode().GetAmix())
 	})
 }
 
 func TestVbanInStream0On(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Vban.InStream[0].SetOn(true)
+	vm.Vban.InStream[0].SetOn(true)
 	sync()
 	t.Run("Should return true when SetOn(true)", func(t *testing.T) {
-		assert.True(t, vmRem.Vban.InStream[0].GetOn())
+		assert.True(t, vm.Vban.InStream[0].GetOn())
 	})
 
-	vmRem.Vban.InStream[0].SetOn(false)
+	vm.Vban.InStream[0].SetOn(false)
 	sync()
 	t.Run("Should return false when SetOn(false)", func(t *testing.T) {
-		assert.False(t, vmRem.Vban.InStream[0].GetOn())
+		assert.False(t, vm.Vban.InStream[0].GetOn())
 	})
 }
 
 func TestVbanOutStream6On(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Vban.OutStream[6].SetOn(true)
+	vm.Vban.OutStream[6].SetOn(true)
 	sync()
 	t.Run("Should return true when SetOn(true)", func(t *testing.T) {
-		assert.True(t, vmRem.Vban.OutStream[6].GetOn())
+		assert.True(t, vm.Vban.OutStream[6].GetOn())
 	})
 
-	vmRem.Vban.OutStream[6].SetOn(false)
+	vm.Vban.OutStream[6].SetOn(false)
 	sync()
 	t.Run("Should return false when SetOn(false)", func(t *testing.T) {
-		assert.False(t, vmRem.Vban.OutStream[6].GetOn())
+		assert.False(t, vm.Vban.OutStream[6].GetOn())
 	})
 }
 
 func TestVbanOutStream3Name(t *testing.T) {
 	t.Skip("skipping test")
-	vmRem.Vban.OutStream[3].SetName("test0")
+	vm.Vban.OutStream[3].SetName("test0")
 	sync()
 	t.Run("Should return test0 when SetName('test0')", func(t *testing.T) {
-		assert.Equal(t, "test0", vmRem.Vban.OutStream[3].GetName())
+		assert.Equal(t, "test0", vm.Vban.OutStream[3].GetName())
 	})
 
-	vmRem.Vban.OutStream[3].SetName("test1")
+	vm.Vban.OutStream[3].SetName("test1")
 	sync()
 	t.Run("Should return test1 when SetName('test1')", func(t *testing.T) {
-		assert.Equal(t, "test1", vmRem.Vban.OutStream[3].GetName())
+		assert.Equal(t, "test1", vm.Vban.OutStream[3].GetName())
 	})
 }
 
@@ -219,21 +219,21 @@ func TestVbanInStream4Bit(t *testing.T) {
 				t.Error("expected panic")
 			}
 		}()
-		vmRem.Vban.InStream[4].SetBit(16)
+		vm.Vban.InStream[4].SetBit(16)
 	})
 }
 
 func TestVbanOutStream4Bit(t *testing.T) {
 	//t.Skip("skipping test")
-	vmRem.Vban.OutStream[4].SetBit(16)
+	vm.Vban.OutStream[4].SetBit(16)
 	sync()
 	t.Run("Should return 16 when SetBit(16)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Vban.OutStream[4].GetBit(), 16)
+		assert.Equal(t, vm.Vban.OutStream[4].GetBit(), 16)
 	})
 
-	vmRem.Vban.OutStream[4].SetBit(24)
+	vm.Vban.OutStream[4].SetBit(24)
 	sync()
 	t.Run("Should return 24 when SetBit(24)", func(t *testing.T) {
-		assert.Equal(t, vmRem.Vban.OutStream[4].GetBit(), 24)
+		assert.Equal(t, vm.Vban.OutStream[4].GetBit(), 24)
 	})
 }

tests/pre-commit.ps1

@@ -1,6 +1,6 @@
 Function RunTests {
+	$run_int_tests = "go clean -testcache; go test -v ."
 	$run_ext_tests = "go clean -testcache; go test -v .\tests\"
-	$run_int_tests = "go clean -testcache; go test -v .\voicemeeter\"
 
 	Invoke-Expression $run_ext_tests
 	Invoke-Expression $run_int_tests

util.go

@@ -12,13 +12,24 @@ func allTrue(s []bool, sz int) bool {
 	return true
 }
 
+// update copies the contents of one float slice into another
 func update(s1 []float32, s2 []float32, sz int) {
 	for i := 0; i < sz; i++ {
 		s1[i] = s2[i]
 	}
 }
 
+// roundFloat rounds a float value to a given precision
 func roundFloat(val float64, precision uint) float64 {
 	ratio := math.Pow(10, float64(precision))
 	return math.Round(val*ratio) / ratio
 }
+
+// convertLevel performs the necessary math for a channel level
+func convertLevel(i float32) float32 {
+	if i > 0 {
+		val := 20 * math.Log10(float64(i))
+		return float32(roundFloat(float64(val), 1))
+	}
+	return -200.0
+}

util_test.go

@@ -0,0 +1,41 @@
+package voicemeeter
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestAllTrue(t *testing.T) {
+	//t.Skip("skipping test")
+	s := []bool{true, true, true, true, true, true}
+	t.Run("Should return true", func(t *testing.T) {
+		assert.True(t, allTrue(s, len(s)))
+	})
+	s = []bool{true, true, true, true, false, true}
+	t.Run("Should return false", func(t *testing.T) {
+		assert.False(t, allTrue(s, len(s)))
+	})
+}
+
+func TestUpdate(t *testing.T) {
+	//t.Skip("skipping test")
+	s1 := []float32{3.6, 8.7, 1.8, 18.2}
+	s2 := make([]float32, len(s1))
+	update(s2, s1, len(s1))
+	t.Run("Should return true", func(t *testing.T) {
+		assert.Equal(t, s1, s2)
+	})
+}
+
+func TestConvertLevel(t *testing.T) {
+	//t.Skip("skipping test")
+	res := convertLevel(0.02)
+	t.Run("Should be equal", func(t *testing.T) {
+		assert.Equal(t, float32(-34), res)
+	})
+	res = convertLevel(-0.02)
+	t.Run("Should be equal", func(t *testing.T) {
+		assert.Equal(t, float32(-200), res)
+	})
+}

vban.go

@@ -2,7 +2,8 @@ package voicemeeter
 
 import "fmt"
 
-type t_vban interface {
+// iVban defines the interface vban types must satisfy
+type iVban interface {
 	GetOn() bool
 	SetOn(val bool)
 	GetName() string
@@ -133,9 +134,9 @@ type vbanInStream struct {
 	vbanStream
 }
 
-func newVbanInStream(i int) t_vban {
+func newVbanInStream(i int) iVban {
 	vbi := vbanInStream{vbanStream{iRemote{fmt.Sprintf("vban.instream[%d]", i), i}}}
-	return t_vban(&vbi)
+	return iVban(&vbi)
 }
 
 // SetSr panics reason read only
@@ -157,23 +158,23 @@ type vbanOutStream struct {
 	vbanStream
 }
 
-func newVbanOutStream(i int) t_vban {
+func newVbanOutStream(i int) iVban {
 	vbo := vbanOutStream{vbanStream{iRemote{fmt.Sprintf("vban.outstream[%d]", i), i}}}
-	return t_vban(&vbo)
+	return iVban(&vbo)
 }
 
 type vban struct {
-	InStream  []t_vban
-	OutStream []t_vban
+	InStream  []iVban
+	OutStream []iVban
 }
 
 func newVban(k *kind) *vban {
-	_vbanIn := make([]t_vban, k.vbanIn)
-	for i := 0; i < k.vbanIn; i++ {
+	_vbanIn := make([]iVban, k.VbanIn)
+	for i := 0; i < k.VbanIn; i++ {
 		_vbanIn[i] = newVbanInStream(i)
 	}
-	_vbanOut := make([]t_vban, k.vbanOut)
-	for i := 0; i < k.vbanOut; i++ {
+	_vbanOut := make([]iVban, k.VbanOut)
+	for i := 0; i < k.VbanOut; i++ {
 		_vbanOut[i] = newVbanOutStream(i)
 	}
 	return &vban{