2017-12-18 02:26:06 +00:00
|
|
|
//
|
|
|
|
// FilteringSpeaker.h
|
|
|
|
// Clock Signal
|
|
|
|
//
|
|
|
|
// Created by Thomas Harte on 15/12/2017.
|
2018-05-13 19:19:52 +00:00
|
|
|
// Copyright 2017 Thomas Harte. All rights reserved.
|
2017-12-18 02:26:06 +00:00
|
|
|
//
|
|
|
|
|
|
|
|
#ifndef FilteringSpeaker_h
|
|
|
|
#define FilteringSpeaker_h
|
|
|
|
|
|
|
|
#include "../Speaker.hpp"
|
|
|
|
#include "../../../SignalProcessing/Stepper.hpp"
|
|
|
|
#include "../../../SignalProcessing/FIRFilter.hpp"
|
|
|
|
#include "../../../ClockReceiver/ClockReceiver.hpp"
|
|
|
|
#include "../../../Concurrency/AsyncTaskQueue.hpp"
|
|
|
|
|
2018-03-22 13:23:01 +00:00
|
|
|
#include <mutex>
|
2017-12-19 02:39:23 +00:00
|
|
|
#include <cstring>
|
2019-07-08 22:14:03 +00:00
|
|
|
#include <cmath>
|
2017-12-19 02:39:23 +00:00
|
|
|
|
2017-12-18 02:26:06 +00:00
|
|
|
namespace Outputs {
|
|
|
|
namespace Speaker {
|
|
|
|
|
|
|
|
/*!
|
2017-12-19 02:39:23 +00:00
|
|
|
The low-pass speaker expects an Outputs::Speaker::SampleSource-derived
|
|
|
|
template class, and uses the instance supplied to its constructor as the
|
|
|
|
source of a high-frequency stream of audio which it filters down to a
|
|
|
|
lower-frequency output.
|
2017-12-18 02:26:06 +00:00
|
|
|
*/
|
2020-02-16 23:28:03 +00:00
|
|
|
template <typename SampleSource> class LowpassSpeaker: public Speaker {
|
2017-12-18 02:26:06 +00:00
|
|
|
public:
|
2020-02-15 23:03:12 +00:00
|
|
|
LowpassSpeaker(SampleSource &sample_source) : sample_source_(sample_source) {
|
2020-03-22 02:00:47 +00:00
|
|
|
// Propagate an initial volume level.
|
2018-03-09 18:23:18 +00:00
|
|
|
sample_source.set_sample_volume_range(32767);
|
|
|
|
}
|
2017-12-18 02:26:06 +00:00
|
|
|
|
2020-03-22 02:00:47 +00:00
|
|
|
void set_output_volume(float volume) final {
|
|
|
|
// Clamp to the acceptable range, and set.
|
|
|
|
volume = std::min(std::max(0.0f, volume), 1.0f);
|
|
|
|
sample_source_.set_sample_volume_range(int16_t(32767.0f * volume));
|
|
|
|
}
|
|
|
|
|
2017-12-18 02:26:06 +00:00
|
|
|
// Implemented as per Speaker.
|
2020-01-26 18:25:23 +00:00
|
|
|
float get_ideal_clock_rate_in_range(float minimum, float maximum) final {
|
2018-03-22 23:01:20 +00:00
|
|
|
std::lock_guard<std::mutex> lock_guard(filter_parameters_mutex_);
|
2018-03-22 13:23:01 +00:00
|
|
|
|
2017-12-18 02:26:06 +00:00
|
|
|
// return twice the cut off, if applicable
|
|
|
|
if( filter_parameters_.high_frequency_cutoff > 0.0f &&
|
|
|
|
filter_parameters_.input_cycles_per_second >= filter_parameters_.high_frequency_cutoff * 3.0f &&
|
|
|
|
filter_parameters_.input_cycles_per_second <= filter_parameters_.high_frequency_cutoff * 3.0f)
|
|
|
|
return filter_parameters_.high_frequency_cutoff * 3.0f;
|
|
|
|
|
|
|
|
// return exactly the input rate if possible
|
|
|
|
if( filter_parameters_.input_cycles_per_second >= minimum &&
|
|
|
|
filter_parameters_.input_cycles_per_second <= maximum)
|
|
|
|
return filter_parameters_.input_cycles_per_second;
|
|
|
|
|
|
|
|
// if the input rate is lower, return the minimum
|
|
|
|
if(filter_parameters_.input_cycles_per_second < minimum)
|
|
|
|
return minimum;
|
|
|
|
|
|
|
|
// otherwise, return the maximum
|
|
|
|
return maximum;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Implemented as per Speaker.
|
2020-02-15 18:40:19 +00:00
|
|
|
void set_computed_output_rate(float cycles_per_second, int buffer_size, bool stereo) final {
|
2018-03-22 23:01:20 +00:00
|
|
|
std::lock_guard<std::mutex> lock_guard(filter_parameters_mutex_);
|
2020-02-09 21:32:32 +00:00
|
|
|
if(filter_parameters_.output_cycles_per_second == cycles_per_second && size_t(buffer_size) == output_buffer_.size()) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2017-12-18 02:26:06 +00:00
|
|
|
filter_parameters_.output_cycles_per_second = cycles_per_second;
|
|
|
|
filter_parameters_.parameters_are_dirty = true;
|
2020-02-16 23:28:03 +00:00
|
|
|
output_buffer_.resize(std::size_t(buffer_size) * (SampleSource::get_is_stereo() ? 2 : 1));
|
2017-12-18 02:26:06 +00:00
|
|
|
}
|
|
|
|
|
2020-02-15 18:40:19 +00:00
|
|
|
bool get_is_stereo() final {
|
2020-02-16 23:28:03 +00:00
|
|
|
return SampleSource::get_is_stereo();
|
2020-02-15 18:40:19 +00:00
|
|
|
}
|
|
|
|
|
2017-12-18 02:26:06 +00:00
|
|
|
/*!
|
|
|
|
Sets the clock rate of the input audio.
|
|
|
|
*/
|
|
|
|
void set_input_rate(float cycles_per_second) {
|
2018-03-22 23:01:20 +00:00
|
|
|
std::lock_guard<std::mutex> lock_guard(filter_parameters_mutex_);
|
2020-02-09 21:32:32 +00:00
|
|
|
if(filter_parameters_.input_cycles_per_second == cycles_per_second) {
|
|
|
|
return;
|
|
|
|
}
|
2017-12-18 02:26:06 +00:00
|
|
|
filter_parameters_.input_cycles_per_second = cycles_per_second;
|
|
|
|
filter_parameters_.parameters_are_dirty = true;
|
2018-03-22 13:23:01 +00:00
|
|
|
filter_parameters_.input_rate_changed = true;
|
2017-12-18 02:26:06 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
/*!
|
|
|
|
Allows a cut-off frequency to be specified for audio. Ordinarily this low-pass speaker
|
|
|
|
will determine a cut-off based on the output audio rate. A caller can manually select
|
|
|
|
an alternative cut-off. This allows machines with a low-pass filter on their audio output
|
|
|
|
path to be explicit about its effect, and get that simulation for free.
|
|
|
|
*/
|
|
|
|
void set_high_frequency_cutoff(float high_frequency) {
|
2018-03-22 23:01:20 +00:00
|
|
|
std::lock_guard<std::mutex> lock_guard(filter_parameters_mutex_);
|
2020-02-09 21:32:32 +00:00
|
|
|
if(filter_parameters_.high_frequency_cutoff == high_frequency) {
|
|
|
|
return;
|
|
|
|
}
|
2017-12-18 02:26:06 +00:00
|
|
|
filter_parameters_.high_frequency_cutoff = high_frequency;
|
|
|
|
filter_parameters_.parameters_are_dirty = true;
|
|
|
|
}
|
|
|
|
|
2018-04-21 22:01:18 +00:00
|
|
|
/*!
|
|
|
|
Schedules an advancement by the number of cycles specified on the provided queue.
|
|
|
|
The speaker will advance by obtaining data from the sample source supplied
|
|
|
|
at construction, filtering it and passing it on to the speaker's delegate if there is one.
|
|
|
|
*/
|
|
|
|
void run_for(Concurrency::DeferringAsyncTaskQueue &queue, const Cycles cycles) {
|
|
|
|
queue.defer([this, cycles] {
|
|
|
|
run_for(cycles);
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
2020-02-10 00:14:25 +00:00
|
|
|
enum class Conversion {
|
|
|
|
ResampleSmaller,
|
|
|
|
Copy,
|
|
|
|
ResampleLarger
|
|
|
|
} conversion_ = Conversion::Copy;
|
|
|
|
|
2017-12-18 02:26:06 +00:00
|
|
|
/*!
|
|
|
|
Advances by the number of cycles specified, obtaining data from the sample source supplied
|
|
|
|
at construction, filtering it and passing it on to the speaker's delegate if there is one.
|
|
|
|
*/
|
|
|
|
void run_for(const Cycles cycles) {
|
2020-02-19 01:33:31 +00:00
|
|
|
const auto delegate = delegate_.load();
|
|
|
|
if(!delegate) return;
|
2018-01-31 03:23:06 +00:00
|
|
|
|
2020-05-09 21:57:21 +00:00
|
|
|
const int scale = get_scale();
|
|
|
|
|
2019-10-30 02:36:29 +00:00
|
|
|
std::size_t cycles_remaining = size_t(cycles.as_integral());
|
2017-12-18 02:26:06 +00:00
|
|
|
if(!cycles_remaining) return;
|
2018-03-22 13:23:01 +00:00
|
|
|
|
2018-03-22 23:01:20 +00:00
|
|
|
FilterParameters filter_parameters;
|
|
|
|
{
|
|
|
|
std::lock_guard<std::mutex> lock_guard(filter_parameters_mutex_);
|
|
|
|
filter_parameters = filter_parameters_;
|
|
|
|
filter_parameters_.parameters_are_dirty = false;
|
2018-03-22 13:23:01 +00:00
|
|
|
filter_parameters_.input_rate_changed = false;
|
|
|
|
}
|
2018-03-22 23:01:20 +00:00
|
|
|
if(filter_parameters.parameters_are_dirty) update_filter_coefficients(filter_parameters);
|
|
|
|
if(filter_parameters.input_rate_changed) {
|
2020-02-19 01:33:31 +00:00
|
|
|
delegate->speaker_did_change_input_clock(this);
|
2018-03-22 23:01:20 +00:00
|
|
|
}
|
2017-12-18 02:26:06 +00:00
|
|
|
|
2020-02-10 00:14:25 +00:00
|
|
|
switch(conversion_) {
|
|
|
|
case Conversion::Copy:
|
|
|
|
while(cycles_remaining) {
|
2020-02-16 23:28:03 +00:00
|
|
|
const auto cycles_to_read = std::min((output_buffer_.size() - output_buffer_pointer_) / (SampleSource::get_is_stereo() ? 2 : 1), cycles_remaining);
|
2020-02-15 23:55:19 +00:00
|
|
|
sample_source_.get_samples(cycles_to_read, &output_buffer_[output_buffer_pointer_ ]);
|
2020-02-16 23:28:03 +00:00
|
|
|
output_buffer_pointer_ += cycles_to_read * (SampleSource::get_is_stereo() ? 2 : 1);
|
2017-12-18 02:26:06 +00:00
|
|
|
|
2020-05-09 21:57:21 +00:00
|
|
|
// TODO: apply scale.
|
|
|
|
|
2020-02-15 23:55:19 +00:00
|
|
|
// Announce to delegate if full.
|
2017-12-18 02:26:06 +00:00
|
|
|
if(output_buffer_pointer_ == output_buffer_.size()) {
|
|
|
|
output_buffer_pointer_ = 0;
|
2020-02-16 23:28:03 +00:00
|
|
|
did_complete_samples(this, output_buffer_, SampleSource::get_is_stereo());
|
2017-12-18 02:26:06 +00:00
|
|
|
}
|
|
|
|
|
2020-02-10 00:14:25 +00:00
|
|
|
cycles_remaining -= cycles_to_read;
|
|
|
|
}
|
|
|
|
break;
|
|
|
|
|
|
|
|
case Conversion::ResampleSmaller:
|
|
|
|
while(cycles_remaining) {
|
2020-02-16 23:28:03 +00:00
|
|
|
const auto cycles_to_read = std::min((input_buffer_.size() - input_buffer_depth_) / (SampleSource::get_is_stereo() ? 2 : 1), cycles_remaining);
|
2020-02-15 23:55:19 +00:00
|
|
|
|
2020-02-10 00:14:25 +00:00
|
|
|
sample_source_.get_samples(cycles_to_read, &input_buffer_[input_buffer_depth_]);
|
2020-02-16 23:28:03 +00:00
|
|
|
input_buffer_depth_ += cycles_to_read * (SampleSource::get_is_stereo() ? 2 : 1);
|
2020-02-10 00:14:25 +00:00
|
|
|
|
|
|
|
if(input_buffer_depth_ == input_buffer_.size()) {
|
2020-05-09 21:57:21 +00:00
|
|
|
resample_input_buffer(scale);
|
2017-12-18 02:26:06 +00:00
|
|
|
}
|
2020-02-15 23:55:19 +00:00
|
|
|
|
|
|
|
cycles_remaining -= cycles_to_read;
|
2017-12-18 02:26:06 +00:00
|
|
|
}
|
2020-02-10 00:14:25 +00:00
|
|
|
break;
|
2017-12-18 02:26:06 +00:00
|
|
|
|
2020-02-10 00:14:25 +00:00
|
|
|
case Conversion::ResampleLarger:
|
|
|
|
// TODO: input rate is less than output rate.
|
|
|
|
break;
|
2017-12-18 02:26:06 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-02-15 23:03:12 +00:00
|
|
|
SampleSource &sample_source_;
|
2017-12-18 02:26:06 +00:00
|
|
|
|
|
|
|
std::size_t output_buffer_pointer_ = 0;
|
|
|
|
std::size_t input_buffer_depth_ = 0;
|
|
|
|
std::vector<int16_t> input_buffer_;
|
|
|
|
std::vector<int16_t> output_buffer_;
|
|
|
|
|
|
|
|
std::unique_ptr<SignalProcessing::Stepper> stepper_;
|
|
|
|
std::unique_ptr<SignalProcessing::FIRFilter> filter_;
|
|
|
|
|
2018-03-22 23:01:20 +00:00
|
|
|
std::mutex filter_parameters_mutex_;
|
2017-12-18 02:26:06 +00:00
|
|
|
struct FilterParameters {
|
|
|
|
float input_cycles_per_second = 0.0f;
|
|
|
|
float output_cycles_per_second = 0.0f;
|
|
|
|
float high_frequency_cutoff = -1.0;
|
|
|
|
|
|
|
|
bool parameters_are_dirty = true;
|
2018-03-22 13:23:01 +00:00
|
|
|
bool input_rate_changed = false;
|
2017-12-18 02:26:06 +00:00
|
|
|
} filter_parameters_;
|
|
|
|
|
2018-03-22 23:01:20 +00:00
|
|
|
void update_filter_coefficients(const FilterParameters &filter_parameters) {
|
2018-04-05 22:40:07 +00:00
|
|
|
float high_pass_frequency = filter_parameters.output_cycles_per_second / 2.0f;
|
|
|
|
if(filter_parameters.high_frequency_cutoff > 0.0) {
|
|
|
|
high_pass_frequency = std::min(filter_parameters.high_frequency_cutoff, high_pass_frequency);
|
|
|
|
}
|
|
|
|
|
2017-12-18 02:26:06 +00:00
|
|
|
// Make a guess at a good number of taps.
|
2019-07-17 02:13:47 +00:00
|
|
|
std::size_t number_of_taps = std::size_t(
|
2018-04-05 22:40:07 +00:00
|
|
|
ceilf((filter_parameters.input_cycles_per_second + high_pass_frequency) / high_pass_frequency)
|
2017-12-18 02:26:06 +00:00
|
|
|
);
|
|
|
|
number_of_taps = (number_of_taps * 2) | 1;
|
|
|
|
|
2019-12-24 02:31:46 +00:00
|
|
|
stepper_ = std::make_unique<SignalProcessing::Stepper>(
|
2019-07-17 02:13:47 +00:00
|
|
|
uint64_t(filter_parameters.input_cycles_per_second),
|
2019-12-24 02:31:46 +00:00
|
|
|
uint64_t(filter_parameters.output_cycles_per_second));
|
2017-12-18 02:26:06 +00:00
|
|
|
|
2019-12-24 02:31:46 +00:00
|
|
|
filter_ = std::make_unique<SignalProcessing::FIRFilter>(
|
2017-12-18 02:26:06 +00:00
|
|
|
static_cast<unsigned int>(number_of_taps),
|
2018-03-22 23:01:20 +00:00
|
|
|
filter_parameters.input_cycles_per_second,
|
2017-12-18 02:26:06 +00:00
|
|
|
0.0,
|
|
|
|
high_pass_frequency,
|
2019-12-24 02:31:46 +00:00
|
|
|
SignalProcessing::FIRFilter::DefaultAttenuation);
|
2017-12-18 02:26:06 +00:00
|
|
|
|
2020-02-10 00:14:25 +00:00
|
|
|
|
|
|
|
// Pick the new conversion function.
|
|
|
|
if( filter_parameters.input_cycles_per_second == filter_parameters.output_cycles_per_second &&
|
|
|
|
filter_parameters.high_frequency_cutoff < 0.0) {
|
|
|
|
// If input and output rates exactly match, and no additional cut-off has been specified,
|
|
|
|
// just accumulate results and pass on.
|
|
|
|
conversion_ = Conversion::Copy;
|
|
|
|
} else if( filter_parameters.input_cycles_per_second > filter_parameters.output_cycles_per_second ||
|
|
|
|
(filter_parameters.input_cycles_per_second == filter_parameters.output_cycles_per_second && filter_parameters.high_frequency_cutoff >= 0.0)) {
|
|
|
|
// If the output rate is less than the input rate, or an additional cut-off has been specified, use the filter.
|
|
|
|
conversion_ = Conversion::ResampleSmaller;
|
|
|
|
} else {
|
|
|
|
conversion_ = Conversion::ResampleLarger;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Do something sensible with any dangling input, if necessary.
|
2020-05-09 21:57:21 +00:00
|
|
|
const int scale = get_scale();
|
2020-02-10 00:14:25 +00:00
|
|
|
switch(conversion_) {
|
|
|
|
// Neither direct copying nor resampling larger currently use any temporary input.
|
|
|
|
// Although in the latter case that's just because it's unimplemented. But, regardless,
|
|
|
|
// that means nothing to do.
|
|
|
|
default: break;
|
|
|
|
|
2020-02-15 23:55:19 +00:00
|
|
|
case Conversion::ResampleSmaller: {
|
2020-02-10 00:14:25 +00:00
|
|
|
// Reize the input buffer only if absolutely necessary; if sizing downward
|
|
|
|
// such that a sample would otherwise be lost then output it now. Keep anything
|
|
|
|
// currently in the input buffer that hasn't yet been processed.
|
2020-02-16 23:28:03 +00:00
|
|
|
const size_t required_buffer_size = size_t(number_of_taps) * (SampleSource::get_is_stereo() ? 2 : 1);
|
2020-02-15 23:55:19 +00:00
|
|
|
if(input_buffer_.size() != required_buffer_size) {
|
|
|
|
if(input_buffer_depth_ >= required_buffer_size) {
|
2020-05-09 21:57:21 +00:00
|
|
|
resample_input_buffer(scale);
|
2020-02-15 23:55:19 +00:00
|
|
|
input_buffer_depth_ %= required_buffer_size;
|
2020-02-10 00:14:25 +00:00
|
|
|
}
|
2020-02-15 23:55:19 +00:00
|
|
|
input_buffer_.resize(required_buffer_size);
|
2020-02-10 00:14:25 +00:00
|
|
|
}
|
2020-02-15 23:55:19 +00:00
|
|
|
} break;
|
2020-02-10 00:14:25 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-05-09 21:57:21 +00:00
|
|
|
inline void resample_input_buffer(int scale) {
|
2020-02-16 23:28:03 +00:00
|
|
|
if constexpr (SampleSource::get_is_stereo()) {
|
2020-02-15 23:55:19 +00:00
|
|
|
output_buffer_[output_buffer_pointer_ + 0] = filter_->apply(input_buffer_.data(), 2);
|
|
|
|
output_buffer_[output_buffer_pointer_ + 1] = filter_->apply(input_buffer_.data() + 1, 2);
|
|
|
|
output_buffer_pointer_+= 2;
|
|
|
|
} else {
|
|
|
|
output_buffer_[output_buffer_pointer_] = filter_->apply(input_buffer_.data());
|
|
|
|
output_buffer_pointer_++;
|
|
|
|
}
|
2020-02-10 00:14:25 +00:00
|
|
|
|
2020-05-09 21:57:21 +00:00
|
|
|
// Apply scale, if supplied, clamping appropriately.
|
|
|
|
if(scale != 65536) {
|
|
|
|
#define SCALE(x) x = int16_t(std::max(std::min((int(x) * scale) >> 16, 32767), -32768))
|
|
|
|
if constexpr (SampleSource::get_is_stereo()) {
|
|
|
|
SCALE(output_buffer_[output_buffer_pointer_ - 2]);
|
|
|
|
SCALE(output_buffer_[output_buffer_pointer_ - 1]);
|
|
|
|
} else {
|
|
|
|
SCALE(output_buffer_[output_buffer_pointer_ - 1]);
|
|
|
|
}
|
|
|
|
#undef SCALE
|
|
|
|
}
|
|
|
|
|
2020-02-10 00:14:25 +00:00
|
|
|
// Announce to delegate if full.
|
|
|
|
if(output_buffer_pointer_ == output_buffer_.size()) {
|
|
|
|
output_buffer_pointer_ = 0;
|
2020-02-16 23:28:03 +00:00
|
|
|
did_complete_samples(this, output_buffer_, SampleSource::get_is_stereo());
|
2020-02-10 00:14:25 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// If the next loop around is going to reuse some of the samples just collected, use a memmove to
|
|
|
|
// preserve them in the correct locations (TODO: use a longer buffer to fix that?) and don't skip
|
|
|
|
// anything. Otherwise skip as required to get to the next sample batch and don't expect to reuse.
|
2020-02-16 23:28:03 +00:00
|
|
|
const auto steps = stepper_->step() * (SampleSource::get_is_stereo() ? 2 : 1);
|
2020-02-10 00:14:25 +00:00
|
|
|
if(steps < input_buffer_.size()) {
|
|
|
|
auto *const input_buffer = input_buffer_.data();
|
|
|
|
std::memmove( input_buffer,
|
|
|
|
&input_buffer[steps],
|
|
|
|
sizeof(int16_t) * (input_buffer_.size() - steps));
|
|
|
|
input_buffer_depth_ -= steps;
|
|
|
|
} else {
|
2020-02-15 23:55:19 +00:00
|
|
|
if(steps > input_buffer_.size()) {
|
2020-02-16 23:28:03 +00:00
|
|
|
sample_source_.skip_samples((steps - input_buffer_.size()) / (SampleSource::get_is_stereo() ? 2 : 1));
|
2020-02-15 23:55:19 +00:00
|
|
|
}
|
2020-02-10 00:14:25 +00:00
|
|
|
input_buffer_depth_ = 0;
|
|
|
|
}
|
2017-12-18 02:26:06 +00:00
|
|
|
}
|
2020-05-09 21:57:21 +00:00
|
|
|
|
|
|
|
int get_scale() {
|
|
|
|
return int(65536.0 / sample_source_.get_average_output_peak());
|
|
|
|
};
|
2017-12-18 02:26:06 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif /* FilteringSpeaker_h */
|