https://github.com/kleydon/wavutils
Utilities for reading and writing wav files; all at once or incrementally.
https://github.com/kleydon/wavutils
16-bit 32-bit 64-bit 8-bit android audio convert floating-point frame ios lpcm osx pcm read reading wav wave windows write writing
Last synced: 17 days ago
JSON representation
Utilities for reading and writing wav files; all at once or incrementally.
- Host: GitHub
- URL: https://github.com/kleydon/wavutils
- Owner: kleydon
- License: mit
- Created: 2020-05-16T21:36:59.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-05-24T01:46:07.000Z (almost 5 years ago)
- Last Synced: 2025-04-09T16:09:10.694Z (17 days ago)
- Topics: 16-bit, 32-bit, 64-bit, 8-bit, android, audio, convert, floating-point, frame, ios, lpcm, osx, pcm, read, reading, wav, wave, windows, write, writing
- Language: C++
- Size: 136 KB
- Stars: 14
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WavUtils
Classes for reading and writing Wav files in C++.
- Read or write incrementally (frame by frame), or all at once
- Support for 8/16/24/32-bit int samples, or 32/64-bit float samples
- Conversion to/from 16-bit int format, while reading or writing
- In-Memory conversion to/from 16-bit int format
- Little-Endian; supports iOS, Android NDK, Windows, and OSX (post-PowerPC)
## Usage
### Read:
```C++
#include "WavReader.hpp"
...
WavReader* wr = new WavReader();
wr->initialize(inputWavFilePath);
wr->prepareToRead(); // Metadata available after this
wr->readData(sampleData, wr->getSampleDataSize());
wr->finishReading();
```
### Write:
```C++
#include "WavWriter.hpp"
...
WavWriter* ww = new WavWriter();
ww->initialize(outputWavFilePath,
sampleRate,
numChannels, // 1 || 2
samplesAreInts, // false for 32/64-bit float vals
byteDepth); // 1, 2, 3, 4 for int samples; 4 or 8 for float samples
ww->startWriting(); //Writes header
ww->writeData(sampleData, sampleDataSize);
ww->finishReading();
```
### Incrementally Read & Write:
```C++
...
wr->readData(bufferA, bufferASize);
wr->readData(bufferB, bufferBSize);
...
ww->writeData(bufferA, bufferASize);
ww->writeData(bufferB, bufferBSize);
...
```
### Conversion to/from Int16 Samples, during Read & Write
```C++
...
wr->readDataToInt16s(int16Samples,
numInt16Samples);
ww->writeDataFromInt16s(int16Samples,
numInt16Samples);
...
```
### In-Memory Conversion to/from Int16 Samples
```C++
...
wr->readInt16SampleFromArray(sampleData, // Wav-format "source" sample data array
sampleDataSize,
sampleIndex, //Index of sample to be read
int16SampleCh1, // Sample's channel-1 value, as int16
int16SampleCh2); // Sample's channel-2 value (if available), as int16
...
ww->writeInt16SampleToArray(int16SampleCh1, // Sample's channel-1 value, as int16
int16SampleCh2, // Sample's channel-2 value (if available), as int16
sampleIndex, //Index of sample to be written
sampleData, // Wav-format "target" sample data array
sampleDataSize);
...
```