voicemeeter/CHANGELOG.md

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

Before any major/minor/patch bump all unit tests will be run to verify they pass.

## [Unreleased]

- [x]

## [2.1.0] - 2024-07-01

### Added

- Added a configurable login timeout in seconds (defaults to 2).
- Option function added for overriding the type of Voicemeeter GUI runVoicemeeter() will launch.
- Explanation of Option functions added to README.

### Changed

- runVoicemeeter() now launches x64 GUIs for all kinds if on a 64 bit system.
  - this can be overridden to force 32 bit GUI using voicemeeter.WithBits(32) Option function

## [2.0.0] - 2022-10-25

V2 introduces some breaking changes.

### Changed

- Removed Get prefix from getters in Bus, Strip, Vban, Button and Output types.
- Pooler now communicates event updates over a channel.
- strip.comp now references comp struct type. (see readme for changes in setting comp parameters)
- strip.gate now references gate struct type. (see readme for changes in setting gate parameters)
- strip.eq, bus.eq now reference eQ struct type. (see readme for changes in setting eq parameters)
- All examples and tests have been updated to reflect the changes.

### Added

- denoiser type to strip types.
- XY parameters added to strip type
- extra logging added to getters/setters in iRemote type.
- InitPooler to Remote type in case the Pooler needs reinitiating. (perhaps the GUI closed unexpectedly)

### Fixed

- Functions that wrap CAPI calls in base.go now return correct error values.

## [1.11.0] - 2022-10-10

### Fixed

- type error in getLevel

## [1.8.0] - 2022-09-17

### Added

- vm-cli example added + example README
- Fade, App methods added to project README

## [1.7.0] - 2022-09-14

### Added

- voicemeeter.NewRemote now accepts a delay int argument (milliseconds).
- vm.Sync() can now be used to force the dirty parameters to clear.

### Changed

- higher level methods/functions now accept/return float64
- tests updated to reflect changes.

## [1.5.0] - 2022-09-07

### Changed

- changes to error handling.
  - functions that wrap capi calls now return error types.
  - higher level functions print error messages

## [1.4.0] - 2022-08-22

### Added

- midi type, supports midi devices
- midi updates added to the pooler
- event type, supports toggling event updates through EventAdd() and EventRemove() methods.
- Forwarder methods for get/set float/string parameters added to Remote type
- Midi, Events sections added to README.

### Changed

- macrobutton updates moved into its own goroutine
- observer example updated to include midi updates
- level updates are now disabled by default, should be enabled explicitly

## [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