Complete WAV file reader and writer in pure C++20. More...
#include <WavFile.h>
Public Member Functions | |
| ~WavFile () override | |
| bool | openRead (const std::filesystem::path &path) override |
| Opens a WAV file for reading. | |
| bool | openWrite (const std::filesystem::path &path, const AudioFileInfo &info) override |
| Opens a WAV file for writing, overwriting if it exists. | |
| AudioFileInfo | getInfo () const override |
| Retrieves metadata of the currently opened file. | |
| bool | readSamples (AudioBufferView< float > dest) override |
| Reads samples from the start of the file into the destination view. | |
| bool | readSamples (AudioBufferView< float > dest, int64_t startFrame, int64_t numFrames) override |
| Reads a specific range of sample frames. Useful for chunked streaming. | |
| bool | writeSamples (AudioBufferView< const float > src) override |
| Writes samples from the view to the file. | |
| void | close () override |
| Finalizes file headers and releases system handles. | |
| bool | isOpen () const noexcept override |
| Checks if a valid file handle is currently open. | |
 Public Member Functions inherited from dspark::AudioFile | |
| virtual | ~AudioFile ()=default |
Detailed Description
Complete WAV file reader and writer in pure C++20.
Inherits from AudioFile to provide a uniform interface. Handles both standard PCM and IEEE float formats, mono through multi-channel (up to 64 channels).
- Note
- Files with more than 2 channels or more than 16 bits per sample are written as WAVE_FORMAT_EXTENSIBLE, per the Microsoft specification. Plain PCM/float headers are used otherwise for maximum compatibility.
Constructor & Destructor Documentation
◆ ~WavFile()
Member Function Documentation
◆ close()
|
inlineoverridevirtual |
Finalizes file headers and releases system handles.
Safe to call multiple times. Implementations invoke this from their destructor, so an open file is always finalized; call it explicitly when you need the write error-checked (a destructor cannot report failure) or the file released before the object dies.
Implements dspark::AudioFile.
◆ getInfo()
|
inlineoverridevirtual |
Retrieves metadata of the currently opened file.
- Returns
- AudioFileInfo struct. Returns default values if no file is open.
Implements dspark::AudioFile.
◆ isOpen()
|
inlineoverridevirtualnoexcept |
Checks if a valid file handle is currently open.
Implements dspark::AudioFile.
◆ openRead()
|
inlineoverridevirtual |
Opens a WAV file for reading.
- Parameters
-
path Platform-independent path to the WAV file.
- Returns
- True if the file was found and contains a valid RIFF/WAVE header.
Implements dspark::AudioFile.
◆ openWrite()
|
inlineoverridevirtual |
Opens a WAV file for writing, overwriting if it exists.
The requested format is validated BEFORE the destination is touched: an unsupported format returns false without creating or truncating anything on disk.
- Parameters
-
path Platform-independent output path. info Configuration for sample rate, bit depth, and channels.
- Returns
- True if the file was created and the preliminary header written.
Implements dspark::AudioFile.
◆ readSamples() [1/2]
|
inlineoverridevirtual |
Reads samples from the start of the file into the destination view.
Reads up to min(view length, file length) frames into up to min(view channels, file channels) channels. Excess buffer space and channels beyond those present in the file are left untouched.
- Parameters
-
dest Buffer view to receive the audio data.
- Returns
- True if read successfully. False if an I/O error occurred or no file is open for reading.
Implements dspark::AudioFile.
◆ readSamples() [2/2]
|
inlineoverridevirtual |
Reads a specific range of sample frames. Useful for chunked streaming.
The requested range must lie entirely within the file (startFrame >= 0, numFrames > 0, startFrame + numFrames <= numSamples); out-of-range requests return false without reading. As with the full-file overload, the transfer is clamped to the view's capacity.
- Parameters
-
dest Buffer view to receive the audio data. startFrame The absolute frame index in the file to start reading from. numFrames The number of frames to read.
- Returns
- True if the range was read successfully.
Implements dspark::AudioFile.
◆ writeSamples()
|
inlineoverridevirtual |
Writes samples from the view to the file.
Converts float [-1.0, 1.0] back to the native bit-depth defined in openWrite(). May be called repeatedly to append blocks (streaming writes).
- Parameters
-
src Buffer view containing the data to write.
- Returns
- True on success, False if disk is full or an I/O error occurred.
Implements dspark::AudioFile.
The documentation for this class was generated from the following file:
- IO/WavFile.h
