vst3utils

A C++ header-only library providing little helper classes for developing vst3 plug-ins.

Requirements

• c++17 compatible compiler
• vst3 sdk

Usage

You can either add a header include directory pointing to the 'include' repository path or, if you use CMake, simply add this directory to CMake with add_subdirectory and add a target dependency to your own target.

add_subdirectory("path/to/vst3utils" ${PROJECT_BINARY_DIR}/vst3utils)

add_target_dependency(myTarget
  PRIVATE
    vst3utils
)

History

• Version 1.2.0 [03/22/2025]
  • added unit tests
  • added transport_state_observer
  • added event dispatcher helper
  • added observable template
  • added RAII memory buffer object
  • added byte_order_stream.h
  • added dB to gain functions
• Version 1.1.0 [08/03/2023]
  • added messages.h and parameter_changes_iterator.h
  • a few additions else where, see git commit history
• Version 1.0.0 [07/16/2023]
  • initial release

Headers

#include "vst3utils/buffer.h

• vst3utils::buffer
  • RAII memory buffer object with support for aligned memory

#include "vst3utils/byte_order_stream.h

• vst3utils::byte_order_ibstream
  • an adapter to read/write byte ordered data to an IBStream

#include "vst3utils/enum_array.h

• vst3utils::enum_array
  • a std::array using an enum for accessing its elements

#include "vst3utils/event_iterator.h"

• vst3utils::event_iterator
  • a c++ compatible forward iterator for Steinberg::Vst::Event

#include "vst3utils/events.h"

• vst3utils::dispatch_event
  • function to dispatch a Steinberg::Vst::Event

#include "vst3utils/message.h"

• vst3utils::message
  • an adapter for Steinberg::Vst::IMessage
• vst3utils::attribute_list
  • an adapter for Steinberg::Vst::IAttributeList

#include "vst3utils/norm_plain_conversion.h

contains functions to convert from normalized to plain and back

• vst3utils::normalized_to_plain
• vst3utils::normalized_to_steps
• vst3utils::normalized_to_exp
• vst3utils::plain_to_normalized
• vst3utils::steps_to_normalized
• vst3utils::exp_to_normalized
• vst3utils::db_to_gain
• vst3utils::gain_to_db

#include "vst3utils/observable.h"

• vst3utils::observable
  • template to observe an object by multiple listeners without direct dependency

#include "vst3utils/parameter_changes_iterator.h

• vst3utils::parameter_changes_iterator
  • a c++ compatible forward iterator for Steinberg::Vst::IParameterChanges
• vst3utils::parameter_value_queue_iterator
  • a c++ compatible forward iterator for Steinberg::Vst::IParamValueQueue

#include "vst3utils/parameter_description.h

contains structs and functions to declare parameters at compile time

example:

static constexpr std::array<description, 4> param_desc = {{
  {range_description (u"volume", -12, linear_functions<-60, 0> (), 1, u"dB")},
  {range_description (u"cutoff", 2000, exponent_functions<80, 22050> (), 0, u"Hz")},
  {range_description (u"resonance", 50, linear_functions<0, 100> (), 0, u"%")},
  {list_description  (u"filter type", 0, strings_filter_types)},
}};

#include "vst3utils/parameter_updater.h

• vst3utils::throttled_parameter_updater
  • a throttling realtime parameter updater

#include "vst3utils/parameter.h

• vst3utils::parameter
  • extension to the parameter class of the vst3 sdk which uses a parameter description

#include "vst3utils/smooth_value.h

• vst3utils::smooth_value
  • a value object that smoothly changes from one value to another

#include "vst3utils/string_conversion.h

• vst3utils::copy_utf16_to_ascii
• vst3utils::create_utf16_from_ascii
• vst3utils::copy_ascii_to_utf16

#include "vst3utils/transport_state_observer.h

• vst3utils::transport_state_observer
  • helper for handling transport state changes

License

//------------------------------------------------------------------------
/* This source code is free software. It comes without any warranty, to
 * the extent permitted by applicable law. You can redistribute it
 * and/or modify it under the terms of the Do What The Fuck You Want
 * To Public License, Version 2, as published by Sam Hocevar. See
 * http://sam.zoy.org/wtfpl/COPYING for more details. */
//------------------------------------------------------------------------