// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
// MSVC++ requires this to be set before any other includes to get M_PI.
#define _USE_MATH_DEFINES
#include <cmath>
#include "base/memory/scoped_ptr.h"
#include "base/memory/scoped_vector.h"
#include "base/strings/string_number_conversions.h"
#include "media/base/audio_converter.h"
#include "media/base/fake_audio_render_callback.h"
#include "testing/gmock/include/gmock/gmock.h"
#include "testing/gtest/include/gtest/gtest.h"
namespace media {
// Parameters which control the many input case tests.
static const int kConvertInputs = 8;
static const int kConvertCycles = 3;
// Parameters used for testing.
static const int kBitsPerChannel = 32;
static const ChannelLayout kChannelLayout = CHANNEL_LAYOUT_STEREO;
static const int kHighLatencyBufferSize = 2048;
static const int kLowLatencyBufferSize = 256;
static const int kSampleRate = 48000;
// Number of full sine wave cycles for each Render() call.
static const int kSineCycles = 4;
// Tuple of <input rate, output rate, output channel layout, epsilon>.
typedef std::tr1::tuple<int, int, ChannelLayout, double> AudioConverterTestData;
class AudioConverterTest
: public testing::TestWithParam<AudioConverterTestData> {
public:
AudioConverterTest()
: epsilon_(std::tr1::get<3>(GetParam())) {
// Create input and output parameters based on test parameters.
input_parameters_ = AudioParameters(
AudioParameters::AUDIO_PCM_LINEAR, kChannelLayout,
std::tr1::get<0>(GetParam()), kBitsPerChannel, kHighLatencyBufferSize);
output_parameters_ = AudioParameters(
AudioParameters::AUDIO_PCM_LOW_LATENCY, std::tr1::get<2>(GetParam()),
std::tr1::get<1>(GetParam()), 16, kLowLatencyBufferSize);
converter_.reset(new AudioConverter(
input_parameters_, output_parameters_, false));
audio_bus_ = AudioBus::Create(output_parameters_);
expected_audio_bus_ = AudioBus::Create(output_parameters_);
// Allocate one callback for generating expected results.
double step = kSineCycles / static_cast<double>(
output_parameters_.frames_per_buffer());
expected_callback_.reset(new FakeAudioRenderCallback(step));
}
// Creates |count| input callbacks to be used for conversion testing.
void InitializeInputs(int count) {
// Setup FakeAudioRenderCallback step to compensate for resampling.
double scale_factor = input_parameters_.sample_rate() /
static_cast<double>(output_parameters_.sample_rate());
double step = kSineCycles / (scale_factor *
static_cast<double>(output_parameters_.frames_per_buffer()));
for (int i = 0; i < count; ++i) {
fake_callbacks_.push_back(new FakeAudioRenderCallback(step));
converter_->AddInput(fake_callbacks_[i]);
}
}
// Resets all input callbacks to a pristine state.
void Reset() {
converter_->Reset();
for (size_t i = 0; i < fake_callbacks_.size(); ++i)
fake_callbacks_[i]->reset();
expected_callback_->reset();
}
// Sets the volume on all input callbacks to |volume|.
void SetVolume(float volume) {
for (size_t i = 0; i < fake_callbacks_.size(); ++i)
fake_callbacks_[i]->set_volume(volume);
}
// Validates audio data between |audio_bus_| and |expected_audio_bus_| from
// |index|..|frames| after |scale| is applied to the expected audio data.
bool ValidateAudioData(int index, int frames, float scale) {
for (int i = 0; i < audio_bus_->channels(); ++i) {
for (int j = index; j < frames; ++j) {
double error = fabs(audio_bus_->channel(i)[j] -
expected_audio_bus_->channel(i)[j] * scale);
if (error > epsilon_) {
EXPECT_NEAR(expected_audio_bus_->channel(i)[j] * scale,
audio_bus_->channel(i)[j], epsilon_)
<< " i=" << i << ", j=" << j;
return false;
}
}
}
return true;
}
// Runs a single Convert() stage, fills |expected_audio_bus_| appropriately,
// and validates equality with |audio_bus_| after |scale| is applied.
bool RenderAndValidateAudioData(float scale) {
// Render actual audio data.
converter_->Convert(audio_bus_.get());
// Render expected audio data.
expected_callback_->Render(expected_audio_bus_.get(), 0);
// Zero out unused channels in the expected AudioBus just as AudioConverter
// would during channel mixing.
for (int i = input_parameters_.channels();
i < output_parameters_.channels(); ++i) {
memset(expected_audio_bus_->channel(i), 0,
audio_bus_->frames() * sizeof(*audio_bus_->channel(i)));
}
return ValidateAudioData(0, audio_bus_->frames(), scale);
}
// Fills |audio_bus_| fully with |value|.
void FillAudioData(float value) {
for (int i = 0; i < audio_bus_->channels(); ++i) {
std::fill(audio_bus_->channel(i),
audio_bus_->channel(i) + audio_bus_->frames(), value);
}
}
// Verifies converter output with a |inputs| number of transform inputs.
void RunTest(int inputs) {
InitializeInputs(inputs);
SetVolume(0);
for (int i = 0; i < kConvertCycles; ++i)
ASSERT_TRUE(RenderAndValidateAudioData(0));
Reset();
// Set a different volume for each input and verify the results.
float total_scale = 0;
for (size_t i = 0; i < fake_callbacks_.size(); ++i) {
float volume = static_cast<float>(i) / fake_callbacks_.size();
total_scale += volume;
fake_callbacks_[i]->set_volume(volume);
}
for (int i = 0; i < kConvertCycles; ++i)
ASSERT_TRUE(RenderAndValidateAudioData(total_scale));
Reset();
// Remove every other input.
for (size_t i = 1; i < fake_callbacks_.size(); i += 2)
converter_->RemoveInput(fake_callbacks_[i]);
SetVolume(1);
float scale = inputs > 1 ? inputs / 2.0f : inputs;
for (int i = 0; i < kConvertCycles; ++i)
ASSERT_TRUE(RenderAndValidateAudioData(scale));
}
protected:
virtual ~AudioConverterTest() {}
// Converter under test.
scoped_ptr<AudioConverter> converter_;
// Input and output parameters used for AudioConverter construction.
AudioParameters input_parameters_;
AudioParameters output_parameters_;
// Destination AudioBus for AudioConverter output.
scoped_ptr<AudioBus> audio_bus_;
// AudioBus containing expected results for comparison with |audio_bus_|.
scoped_ptr<AudioBus> expected_audio_bus_;
// Vector of all input callbacks used to drive AudioConverter::Convert().
ScopedVector<FakeAudioRenderCallback> fake_callbacks_;
// Parallel input callback which generates the expected output.
scoped_ptr<FakeAudioRenderCallback> expected_callback_;
// Epsilon value with which to perform comparisons between |audio_bus_| and
// |expected_audio_bus_|.
double epsilon_;
DISALLOW_COPY_AND_ASSIGN(AudioConverterTest);
};
// Ensure the buffer delay provided by AudioConverter is accurate.
TEST(AudioConverterTest, AudioDelay) {
// Choose input and output parameters such that the transform must make
// multiple calls to fill the buffer.
AudioParameters input_parameters = AudioParameters(
AudioParameters::AUDIO_PCM_LINEAR, kChannelLayout, kSampleRate,
kBitsPerChannel, kLowLatencyBufferSize);
AudioParameters output_parameters = AudioParameters(
AudioParameters::AUDIO_PCM_LINEAR, kChannelLayout, kSampleRate * 2,
kBitsPerChannel, kHighLatencyBufferSize);
AudioConverter converter(input_parameters, output_parameters, false);
FakeAudioRenderCallback callback(0.2);
scoped_ptr<AudioBus> audio_bus = AudioBus::Create(output_parameters);
converter.AddInput(&callback);
converter.Convert(audio_bus.get());
// Calculate the expected buffer delay for given AudioParameters.
double input_sample_rate = input_parameters.sample_rate();
int fill_count =
(output_parameters.frames_per_buffer() * input_sample_rate /
output_parameters.sample_rate()) / input_parameters.frames_per_buffer();
base::TimeDelta input_frame_duration = base::TimeDelta::FromMicroseconds(
base::Time::kMicrosecondsPerSecond / input_sample_rate);
int expected_last_delay_milliseconds =
fill_count * input_parameters.frames_per_buffer() *
input_frame_duration.InMillisecondsF();
EXPECT_EQ(expected_last_delay_milliseconds,
callback.last_audio_delay_milliseconds());
}
TEST_P(AudioConverterTest, ArbitraryOutputRequestSize) {
// Resize output bus to be half of |output_parameters_|'s frames_per_buffer().
audio_bus_ = AudioBus::Create(output_parameters_.channels(),
output_parameters_.frames_per_buffer() / 2);
RunTest(1);
}
TEST_P(AudioConverterTest, NoInputs) {
FillAudioData(1.0f);
EXPECT_TRUE(RenderAndValidateAudioData(0.0f));
}
TEST_P(AudioConverterTest, OneInput) {
RunTest(1);
}
TEST_P(AudioConverterTest, ManyInputs) {
RunTest(kConvertInputs);
}
INSTANTIATE_TEST_CASE_P(
AudioConverterTest, AudioConverterTest, testing::Values(
// No resampling. No channel mixing.
std::tr1::make_tuple(44100, 44100, CHANNEL_LAYOUT_STEREO, 0.00000048),
// Upsampling. Channel upmixing.
std::tr1::make_tuple(44100, 48000, CHANNEL_LAYOUT_QUAD, 0.033),
// Downsampling. Channel downmixing.
std::tr1::make_tuple(48000, 41000, CHANNEL_LAYOUT_MONO, 0.042)));
} // namespace media