From 9dcf94ab01269311b4e5d39be23c95560904c626 Mon Sep 17 00:00:00 2001
From: skal <pascal.massimino@gmail.com>
Date: Tue, 27 Jan 2026 23:09:27 +0100
Subject: feat: Implement spectool & specview; refactor coding style; update
 docs

This commit introduces new tools for spectrogram manipulation and visualization, establishes a consistent coding style, and updates project documentation.

Key changes include:

- **Spectrogram Tools:

  - : A command-line utility for analyzing WAV/MP3 files into custom  spectrogram format and playing back these spectrograms via the synth engine.

  - : A command-line tool for visualizing  spectrogram files as ASCII art in the console.

- **Coding Style Enforcement:

  - Added a  configuration file enforcing LLVM-based style with 2-space indentation, no tabs, and an 80-column line limit.

  - Renamed all C++ source files from  to  for project consistency.

  - Applied automatic formatting using
exit across the entire codebase.

- **Documentation & Workflow:

  - Created  to define a commit policy requiring tests to pass before committing.

  - Updated  with instructions for building and using  and , and referenced .

  - Updated  and  to reflect the new tools, audio architecture decisions (real-time additive synthesis, double-buffering for dynamic updates, WAV/MP3 support), coding style, and development workflow.

- **Build System:

  - Modified  to:

    - Include new targets for  and  under the  option.

    - Update source file extensions to .

    - Add a new end-to-end test for  to the  suite.
---
 src/audio/audio.cc | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 src/audio/audio.cc

(limited to 'src/audio/audio.cc')

diff --git a/src/audio/audio.cc b/src/audio/audio.cc
new file mode 100644
index 0000000..0eceed5
--- /dev/null
+++ b/src/audio/audio.cc
@@ -0,0 +1,30 @@
+#define MINIAUDIO_IMPLEMENTATION
+#include "miniaudio.h"
+#include "synth.h"
+#include <math.h>
+
+static ma_device device;
+
+static void audio_callback(ma_device *, void *output, const void *,
+                           ma_uint32 frames) {
+  synth_render((float *)output, frames);
+}
+
+void audio_init() {
+  synth_init();
+  ma_device_config cfg = ma_device_config_init(ma_device_type_playback);
+  cfg.playback.format = ma_format_f32;
+  cfg.playback.channels = 2;
+  cfg.sampleRate = 32000;
+  cfg.dataCallback = audio_callback;
+
+  ma_device_init(nullptr, &cfg, &device);
+  ma_device_start(&device);
+}
+
+void audio_update() {
+}
+void audio_shutdown() {
+  synth_shutdown();
+  ma_device_uninit(&device);
+}
-- 
cgit v1.2.3