| Age | Commit message (Collapse) | Author |
|---|
|
Fixed design flaw where WavDumpBackend was clamping samples to [-1.0, 1.0]
before writing to file. This prevented detection of audio problems.
Changes:
- Removed sample clamping (lines 57-60 in old code)
- WAV dump now records audio "as is" (matches MiniaudioBackend behavior)
- Added clipped_samples_ counter to track diagnostic metric
- Added get_clipped_samples() method for programmatic access
- Report clipping statistics in shutdown():
- "✓ No clipping detected" when clean
- "WARNING: N samples clipped (X% of total)" when clipping occurs
- Suggests reducing volume to fix
Why this matters:
- MiniaudioBackend does NOT clip samples (passes directly to miniaudio)
- WavDumpBackend should match this behavior
- Clipping in WAV files helps identify audio distortion problems
- Developers can compare WAV output to expected values
- Diagnostic metric helps tune audio levels
Testing:
- Added test_clipping_detection() test case
- Verifies clipping counter works correctly (200 clipped / 1000 samples)
- Existing tests show "✓ No clipping detected" for normal audio
- All 27 tests pass
Example output:
WAV file written: test.wav (2.02 seconds, 128986 samples)
✓ No clipping detected
WAV file written: loud.wav (10.5 seconds, 336000 samples)
WARNING: 4521 samples clipped (1.35% of total)
This indicates audio distortion - consider reducing volume
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
|
Fixed design flaw where WavDumpBackend had hardcoded tempo curves
duplicating logic from main.cc. Backend should be passive and just
write audio data, not implement simulation logic.
Changes:
- WavDumpBackend.start() is now non-blocking (was blocking simulation loop)
- Added write_audio() method for passive audio writing
- Removed all tempo scaling logic from backend (lines 62-97)
- Removed tracker_update() and audio_render_ahead() calls from backend
- Removed set_duration() (no longer needed, frontend controls duration)
Frontend (main.cc):
- Added WAV dump mode loop that drives simulation with its own tempo logic
- Reads from ring buffer and calls wav_backend.write_audio()
- Tempo logic stays in one place (no duplication)
- Added ring_buffer.h include for AudioRingBuffer access
Test (test_wav_dump.cc):
- Updated to use frontend-driven approach
- Test manually drives simulation loop
- Calls write_audio() after each frame
- Verifies passive backend behavior
Design:
- Backend: Passive file writer (init/start/write_audio/shutdown)
- Frontend: Active simulation driver (tempo, tracker, rendering)
- Zero duplication of tempo/simulation logic
- Clean separation of concerns
All 27 tests pass.
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
|
Optimized long-running audio tests to significantly improve test suite
performance while maintaining test coverage.
Changes:
- WavDumpBackend: Added set_duration() method with configurable duration
- Default remains 60s for debugging/production use
- Test now uses 2s instead of 60s (140x faster: 60s → 0.43s)
- JitteredAudioBackendTest: Reduced simulation durations
- Test 1: 2.0s → 0.5s (4x faster)
- Test 2: 10.0s → 3.0s (3.3x faster)
- Overall: 14.49s → 4.48s (3.2x faster)
- Updated assertions for shorter durations
- Progress indicators adjusted for shorter tests
Results:
- Total test suite time: 18.31s → 8.29s (55% faster)
- All 20 tests still pass
- Tests still properly validate intended behavior
handoff(Claude): Optimized audio test performance to speed up development
iteration without sacrificing test coverage. WavDumpBackend now has
configurable duration via set_duration() method.
|
|
Implemented WavDumpBackend that renders audio to .wav file instead of
playing on audio device. Useful for debugging audio synthesis, tempo
scaling, and tracker output without needing real-time playback.
New Files:
- src/audio/wav_dump_backend.h: WAV dump backend interface
- src/audio/wav_dump_backend.cc: Implementation with WAV file writing
Features:
- Command line option: --dump_wav [filename]
- Default output: audio_dump.wav
- Format: 16-bit PCM, mono, 32kHz
- Duration: 60 seconds (configurable in code)
- Progress indicator during rendering
- Properly writes WAV header (RIFF format)
Integration (src/main.cc):
- Added --dump_wav command line parsing
- Optional filename parameter
- Sets WavDumpBackend before audio_init()
- Skips main loop in WAV dump mode (just render and exit)
- Zero size impact (all code under !STRIP_ALL)
Usage:
./demo64k --dump_wav # outputs audio_dump.wav
./demo64k --dump_wav my_audio.wav # custom filename
Technical Details:
- Uses AudioBackend interface (from Task #51)
- Calls synth_render() in loop to capture audio
- Converts float samples to int16_t for WAV format
- Updates WAV header with final sample count on shutdown
- Renders 60s worth of audio (1,920,000 samples @ 32kHz)
Test Results:
✓ All 16 tests passing (100%)
✓ Successfully renders 3.7 MB WAV file
✓ File verified as valid RIFF WAVE format
✓ Playback in audio players confirmed
Perfect for:
- Debugging tempo scaling behavior
- Verifying tracker pattern timing
- Analyzing audio output offline
- Creating reference audio for tests
handoff(Claude): WAV dump debugging feature complete
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
