877083c4d4
There are currently a number of places in the code where we dump audio data in various stages of processing for debug purposes. Currently these all write raw, uncompressed PCM files, which isn't supported by the most common audio players, and requires the user to supply metadata such as sample rate, sample size and endianness, etc. This patch adds a simple class that makes it easy to write WAV files instead. WAV files still contain the same uncompressed PCM data, but they have a small header that contains all the requisite metadata, and are supported by virtually all audio players. Since some of the debug code that will be writing WAV files is written in plain C, a C API is included as well. R=andrew@webrtc.org, bjornv@webrtc.org, henrike@webrtc.org, tommi@webrtc.org Review URL: https://webrtc-codereview.appspot.com/16809004 git-svn-id: http://webrtc.googlecode.com/svn/trunk@6932 4adac7df-926f-26a2-2b94-8c16560cd09d
47 lines
1.6 KiB
C++
47 lines
1.6 KiB
C++
/*
|
|
* Copyright (c) 2014 The WebRTC project authors. All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
#ifndef WEBRTC_COMMON_AUDIO_WAV_HEADER_H_
|
|
#define WEBRTC_COMMON_AUDIO_WAV_HEADER_H_
|
|
|
|
#include <stdint.h>
|
|
|
|
namespace webrtc {
|
|
|
|
static const int kWavHeaderSize = 44;
|
|
|
|
enum WavFormat {
|
|
kWavFormatPcm = 1, // PCM, each sample of size bytes_per_sample
|
|
kWavFormatALaw = 6, // 8-bit ITU-T G.711 A-law
|
|
kWavFormatMuLaw = 7, // 8-bit ITU-T G.711 mu-law
|
|
};
|
|
|
|
// Return true if the given parameters will make a well-formed WAV header.
|
|
bool CheckWavParameters(int num_channels,
|
|
int sample_rate,
|
|
WavFormat format,
|
|
int bytes_per_sample,
|
|
uint32_t num_samples);
|
|
|
|
// Write a kWavHeaderSize bytes long WAV header to buf. The payload that
|
|
// follows the header is supposed to have the specified number of interleaved
|
|
// channels and contain the specified total number of samples of the specified
|
|
// type.
|
|
void WriteWavHeader(uint8_t* buf,
|
|
int num_channels,
|
|
int sample_rate,
|
|
WavFormat format,
|
|
int bytes_per_sample,
|
|
uint32_t num_samples);
|
|
|
|
} // namespace webrtc
|
|
|
|
#endif // WEBRTC_COMMON_AUDIO_WAV_HEADER_H_
|