joht/speclet

Audio Spectrum Analyzer using Fourier- and Wavelet-Transformation

Speclet

VST Audio Spectrum Analyzer Plugin using Fourier- and Wavelet-Transformation.

• (c)2011 by Johannes Troppacher (Austria)
• For graduation at Hochschule Mittweida - University of Applied Science (Germany)
• Paper (german): Echtzeitspektralanalyse auf Basis der Fourier- und Wavelet-Transformation implementiert als VST-Plugin
• License: GNU GENERAL PUBLIC LICENSE v3
• For prototyping and experimentation without programming visit JoWa Wavelet Library in Native Instruments Reaktor User Library

🖥 User Interface

📖 User Guide

Have a look at the User Guide for further screenshots and to get started using the analyzer.

🏗 Build the Project

Prerequisites

• Installing GIT
• Installing CMake
• Download Ninja
• (Windows only) Install Visual Studio Build Tools with Visual Studio Installer, select Desktop Development for C++ and add all optional "Clang" components
• (Optional) Download Visual Studio Code

Clone

Download the project as zip or clone it using GIT:

git clone https://github.com/JohT/speclet.git

Command Line

See COMMANDS.md if you prefer to use the command line.

Visual Studio Code (MacOS)

• Using Clang in Visual Studio Code
• Install recommended extensions specified in speclet.code-workspace
• Select the kit that fits to your machine (STRG+SHIFT+P, Type "CMAKE kit")

Visual Studio Code (Windows)

• Install Visual Studio Build Tools with Visual Studio Installer, select Desktop Development for C++ and add all optional Clang Features
• Install recommended extensions specified in speclet.code-workspace
• Select the kit that fits your machine (e.g. amd64) (STRG+SHIFT+P, Type "CMAKE kit"). Successfully tested with "Visual Studio Build Tools 2022 Release - amd64".

🩺 Testing

Run Unit Tests within your command line interface (CLI):

ctest --test-dir build/test

Run Unit Tests in Visual Studio Code

Build the project and use extension "matepek.vscode-catch2-test-adapter" to show all the Catch2 CTest cases under "Testing" (left "activity bar", below extensions button).

Build AudioPluginHost for exploratory testing

cmake.exe --build build --config Debug --target AudioPluginHost

🛠 Used Tools

Modernized 2022 using the following tools:

• The LLVM Compiler Infrastructure
• Ninja
• CMake
• Setup-free CMake dependency management
• Plugin Validator

This version is not ready yet. It contains the code from back then, that doesn't compile any more.
It also contains the plugin made with the tutorial Learn Modern C++ by Building an Audio Plugin (w/ JUCE Framework) - Full Course YouTube as a template to start the modernization.

📚 Used Libraries

This plugin was made in 2011 (modernized 2022) using the following frameworks and libraries:

• VST SDK 2.4 rev2 (2011) by Steinberg
  http://www.steinberg.net/en/company/developer.html
  visit the link above for licensing

• VST 3 Audio Plug-Ins SDK (2022) by Steinberg
  http://www.steinberg.net/en/company/developer.html
  visit the link above for licensing

• JUCE
  by Raw Material Software (2011) http://www.rawmaterialsoftware.com/juce (2011) License: https://github.com/juce-framework/JUCE/blob/master/LICENSE.md (2022)

• FFTW
  by MIT (Matteo Frigo and Steven G. Johnson) http://www.fftw.org
  GNU General Public License

• WAVE++
  by Ryerson Computrational Signal Analysis Group
  (c) 1999 by S. E. Ferrando, L. A. Kolasa and N. Kovacevic
  https://math.ryerson.ca/~lkolasa/CppWavelet.html
  " Permission is granted for anyone to copy, use, or modify these programs and documents for purposes of research or education, provided this copyright notice is retained, and note is made of any changes that have been made. Use for commercial applications is only allowed by permission of the copyright holders. "

• Implementation of C++20's std::span for older compilers (c) 2019 by Tristan Brindle https://github.com/tcbrindle/span Boost Software License 1.0

Trademarks

• Steinberg is a registered trademarks of Steinberg Media Technologies GmbH.

🔎 References

Digital Signal Processing

• ⭐ Window Functions and Their Applications in Signal Processing (PDF)
• Understanding FFT Windows (PDF, 2013)
• Comparison of Matching Pursuit Algorithm with Other Signal Processing Techniques for Computation of the Time-Frequency Power Spectrum of Brain Signals
• Fourier uncertainty principle
• JoWa Wavelet Library in Native Instruments Reaktor User Library

Templates and Examples

• ⭐ Pamplejuce
• Cross-platform CI for JUCE audio plugins with Github Actions
• JUCE CMake Repo Prototype
• Example using CPM package manager with JUCE
• CLAP CLever Audio Plugin
• Integration of Catch, CMake and CMake CodeCoverage
• The Stochas Sequencer
• JUCE 6 Preview - Demo Project

Performance Tracing/Logging (Profiling, Instrumentation)

• Google Chrome Browser Trace Log Viewer
• The Cherno - VISUAL BENCHMARKING in C++ (YouTube)
• ⭐ Instrumentor.h (Code Snippet)
• Instrumentor.h David Churchill Mod (Code Snippet)
• Instrumentor.h Mattias Aronsson Mod

Testing

• ⭐ CMake's CTest
• ⭐ Catch2 CMake Integration
• ⭐ Plugin Validator
• Catch2 Data Generators
• Coverage for tests with cmake and catch2
• Findcodecov.cmake

Windows Build

• Visual Studio Build Tools Download

Installation

• VST plug-in locations on Windows
• VST plug-in locations on Mac OS X and macOS
• Where are third-party Audio Units plug-ins installed on Mac?

Other

• ⭐ std::span implementation for C++11 and later
• C++ Singleton
• 10 Cmake Tips & Tricks
• Reference to non-static member function must be called
• Pointer-to-Member Function
• Commit Message Guidelines
• Undefined symbol _kIOMainPortDefault
• CheckTypeSize (FFTW failed for multiple architectures)
• Article CMake Ninja Combo: The Gist

speclet's Issues

Relieve the audio thread

Problem

CPU intense calculations like the Wavelet Transformation, especially with higher resolution and filtering requirements, shouldn't affect the audio thread. Currently, glitches and other artifacts might happen occasionally. The audio thread shouldn't be affected by intense calculations, since they are done to visualize the spectrum, not to change audio.

Expected

• The audio thread should only be connected to a buffer that doesn't lock it
• There shouldn't be any glitches any more

Ideas

• Research buffering and thread synchronization best practices
• Refactor link between audio thread and spectrum calculation and visualization

References

• Using locks in real-time audio processing, safely

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Awaiting Schedule

These updates are awaiting their schedule. Click on a checkbox to get an update now.

• Update dependency juce-framework/JUCE to v7.0.12

Detected dependencies

github-actions

.github/workflows/continuous-integration.yml

• actions/checkout v4
• hendrikmuhs/ccache-action v1
• actions/upload-artifact v4
• actions/download-artifact v4
• softprops/action-gh-release v2

regex

package-lock.cmake

• catchorg/Catch2 3.5.4

package-lock.cmake

• juce-framework/JUCE 7.0.11

package-lock.cmake

• https://github.com/tcbrindle/span.git master@836dc6a0efd9849cb194e88e4aa2387436bb079b

cmake/Environment.cmake

• cpm-cmake/CPM.cmake 0.39.0

.github/workflows/continuous-integration.yml

• Tracktion/pluginval v1.0.3

---

• Check this box to trigger a request for Renovate to run again on this repository

LV2 version?

Hiya. With JUCE 7 now out, how about an LV2 version?