2009-03-13 18:43:16 +01:00
|
|
|
/*
|
2017-01-03 20:48:59 +01:00
|
|
|
* Copyright 2003-2017 The Music Player Daemon Project
|
2009-03-13 18:43:16 +01:00
|
|
|
* http://www.musicpd.org
|
2008-09-09 10:02:34 +02:00
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
2009-03-13 18:43:16 +01:00
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License along
|
|
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
2008-09-09 10:02:34 +02:00
|
|
|
*/
|
|
|
|
|
2009-11-12 09:12:38 +01:00
|
|
|
#include "config.h"
|
2014-01-28 11:42:54 +01:00
|
|
|
#include "Internal.hxx"
|
|
|
|
#include "Registry.hxx"
|
|
|
|
#include "Domain.hxx"
|
2013-07-30 08:34:10 +02:00
|
|
|
#include "OutputAPI.hxx"
|
2014-01-24 16:31:52 +01:00
|
|
|
#include "filter/FilterConfig.hxx"
|
2013-01-30 21:47:12 +01:00
|
|
|
#include "AudioParser.hxx"
|
2014-01-24 16:25:21 +01:00
|
|
|
#include "mixer/MixerList.hxx"
|
|
|
|
#include "mixer/MixerType.hxx"
|
|
|
|
#include "mixer/MixerControl.hxx"
|
|
|
|
#include "mixer/plugins/SoftwareMixerPlugin.hxx"
|
2014-01-24 16:31:52 +01:00
|
|
|
#include "filter/FilterPlugin.hxx"
|
|
|
|
#include "filter/FilterRegistry.hxx"
|
|
|
|
#include "filter/plugins/AutoConvertFilterPlugin.hxx"
|
2017-08-07 18:27:00 +02:00
|
|
|
#include "filter/plugins/ConvertFilterPlugin.hxx"
|
2014-01-24 16:31:52 +01:00
|
|
|
#include "filter/plugins/ReplayGainFilterPlugin.hxx"
|
|
|
|
#include "filter/plugins/ChainFilterPlugin.hxx"
|
2017-08-07 18:23:13 +02:00
|
|
|
#include "filter/plugins/VolumeFilterPlugin.hxx"
|
2014-01-24 00:20:01 +01:00
|
|
|
#include "config/ConfigError.hxx"
|
|
|
|
#include "config/ConfigGlobal.hxx"
|
2015-01-21 22:13:44 +01:00
|
|
|
#include "config/Block.hxx"
|
2016-11-09 11:56:01 +01:00
|
|
|
#include "util/RuntimeError.hxx"
|
2013-09-27 22:31:24 +02:00
|
|
|
#include "Log.hxx"
|
2008-11-25 17:47:46 +01:00
|
|
|
|
2016-09-04 20:07:05 +02:00
|
|
|
#include <stdexcept>
|
|
|
|
|
2009-07-06 10:01:47 +02:00
|
|
|
#include <assert.h>
|
2013-07-30 20:11:57 +02:00
|
|
|
#include <string.h>
|
2009-07-06 10:01:47 +02:00
|
|
|
|
2008-09-09 10:02:34 +02:00
|
|
|
#define AUDIO_OUTPUT_TYPE "type"
|
|
|
|
#define AUDIO_OUTPUT_NAME "name"
|
|
|
|
#define AUDIO_OUTPUT_FORMAT "format"
|
2009-12-13 22:49:39 +01:00
|
|
|
#define AUDIO_FILTERS "filters"
|
2008-09-09 10:02:34 +02:00
|
|
|
|
2016-11-09 12:04:54 +01:00
|
|
|
AudioOutput::AudioOutput(const AudioOutputPlugin &_plugin,
|
|
|
|
const ConfigBlock &block)
|
2017-04-28 21:45:47 +02:00
|
|
|
:plugin(_plugin)
|
2014-01-28 12:24:48 +01:00
|
|
|
{
|
2014-01-29 00:53:49 +01:00
|
|
|
assert(plugin.finish != nullptr);
|
|
|
|
assert(plugin.open != nullptr);
|
|
|
|
assert(plugin.close != nullptr);
|
|
|
|
assert(plugin.play != nullptr);
|
2014-01-28 12:24:48 +01:00
|
|
|
|
2016-11-09 12:06:54 +01:00
|
|
|
Configure(block);
|
2016-10-28 22:41:07 +02:00
|
|
|
}
|
|
|
|
|
2014-01-28 11:22:27 +01:00
|
|
|
static const AudioOutputPlugin *
|
2016-11-09 11:56:01 +01:00
|
|
|
audio_output_detect()
|
2009-03-01 13:31:32 +01:00
|
|
|
{
|
2013-11-04 22:20:11 +01:00
|
|
|
LogDefault(output_domain, "Attempt to detect audio output device");
|
2009-03-01 13:31:32 +01:00
|
|
|
|
2012-06-12 20:29:47 +02:00
|
|
|
audio_output_plugins_for_each(plugin) {
|
2013-10-19 18:19:03 +02:00
|
|
|
if (plugin->test_default_device == nullptr)
|
2009-03-01 13:31:32 +01:00
|
|
|
continue;
|
|
|
|
|
2013-11-04 22:20:11 +01:00
|
|
|
FormatDefault(output_domain,
|
|
|
|
"Attempting to detect a %s audio device",
|
|
|
|
plugin->name);
|
2009-03-01 13:31:32 +01:00
|
|
|
if (ao_plugin_test_default_device(plugin))
|
|
|
|
return plugin;
|
|
|
|
}
|
|
|
|
|
2016-11-09 11:56:01 +01:00
|
|
|
throw std::runtime_error("Unable to detect an audio device");
|
2009-03-01 13:31:32 +01:00
|
|
|
}
|
|
|
|
|
2009-07-06 22:00:50 +02:00
|
|
|
/**
|
|
|
|
* Determines the mixer type which should be used for the specified
|
|
|
|
* configuration block.
|
|
|
|
*
|
|
|
|
* This handles the deprecated options mixer_type (global) and
|
|
|
|
* mixer_enabled, if the mixer_type setting is not configured.
|
|
|
|
*/
|
2013-08-04 12:25:08 +02:00
|
|
|
gcc_pure
|
2014-12-02 18:17:55 +01:00
|
|
|
static MixerType
|
2017-05-08 14:44:49 +02:00
|
|
|
audio_output_mixer_type(const ConfigBlock &block) noexcept
|
2009-07-06 22:00:50 +02:00
|
|
|
{
|
|
|
|
/* read the local "mixer_type" setting */
|
2015-01-21 22:13:44 +01:00
|
|
|
const char *p = block.GetBlockValue("mixer_type");
|
2013-10-19 18:19:03 +02:00
|
|
|
if (p != nullptr)
|
2009-07-06 22:00:50 +02:00
|
|
|
return mixer_type_parse(p);
|
|
|
|
|
|
|
|
/* try the local "mixer_enabled" setting next (deprecated) */
|
2015-01-21 22:13:44 +01:00
|
|
|
if (!block.GetBlockValue("mixer_enabled", true))
|
2014-12-02 18:17:47 +01:00
|
|
|
return MixerType::NONE;
|
2009-07-06 22:00:50 +02:00
|
|
|
|
|
|
|
/* fall back to the global "mixer_type" setting (also
|
|
|
|
deprecated) */
|
2015-01-21 22:36:13 +01:00
|
|
|
return mixer_type_parse(config_get_string(ConfigOption::MIXER_TYPE,
|
2013-01-30 17:52:51 +01:00
|
|
|
"hardware"));
|
2009-07-06 22:00:50 +02:00
|
|
|
}
|
|
|
|
|
2013-04-16 21:33:25 +02:00
|
|
|
static Mixer *
|
2014-02-19 21:38:48 +01:00
|
|
|
audio_output_load_mixer(EventLoop &event_loop, AudioOutput &ao,
|
2015-01-21 22:13:44 +01:00
|
|
|
const ConfigBlock &block,
|
2014-02-05 17:22:34 +01:00
|
|
|
const MixerPlugin *plugin,
|
2016-06-22 11:15:49 +02:00
|
|
|
PreparedFilter &filter_chain,
|
2016-09-09 12:52:51 +02:00
|
|
|
MixerListener &listener)
|
2009-07-05 18:44:37 +02:00
|
|
|
{
|
2013-04-16 21:33:25 +02:00
|
|
|
Mixer *mixer;
|
2009-07-05 18:44:37 +02:00
|
|
|
|
2015-01-21 22:13:44 +01:00
|
|
|
switch (audio_output_mixer_type(block)) {
|
2014-12-02 18:17:47 +01:00
|
|
|
case MixerType::NONE:
|
|
|
|
case MixerType::UNKNOWN:
|
2013-10-19 18:19:03 +02:00
|
|
|
return nullptr;
|
2014-12-02 18:16:33 +01:00
|
|
|
|
|
|
|
case MixerType::NULL_:
|
|
|
|
return mixer_new(event_loop, null_mixer_plugin, ao, listener,
|
2016-09-09 12:52:51 +02:00
|
|
|
block);
|
2009-07-05 18:44:37 +02:00
|
|
|
|
2014-12-02 18:17:47 +01:00
|
|
|
case MixerType::HARDWARE:
|
2013-10-19 18:19:03 +02:00
|
|
|
if (plugin == nullptr)
|
|
|
|
return nullptr;
|
2009-07-06 22:00:50 +02:00
|
|
|
|
2014-02-05 23:20:33 +01:00
|
|
|
return mixer_new(event_loop, *plugin, ao, listener,
|
2016-09-09 12:52:51 +02:00
|
|
|
block);
|
2009-07-06 22:00:50 +02:00
|
|
|
|
2014-12-02 18:17:47 +01:00
|
|
|
case MixerType::SOFTWARE:
|
2014-02-19 21:38:48 +01:00
|
|
|
mixer = mixer_new(event_loop, software_mixer_plugin, ao,
|
2014-02-05 23:20:33 +01:00
|
|
|
listener,
|
2016-09-09 12:52:51 +02:00
|
|
|
ConfigBlock());
|
2013-10-19 18:19:03 +02:00
|
|
|
assert(mixer != nullptr);
|
2009-07-06 22:00:50 +02:00
|
|
|
|
2013-02-01 18:40:36 +01:00
|
|
|
filter_chain_append(filter_chain, "software_mixer",
|
2017-08-07 18:23:13 +02:00
|
|
|
ao.volume_filter.Set(volume_filter_prepare()));
|
2009-07-06 22:00:50 +02:00
|
|
|
return mixer;
|
|
|
|
}
|
|
|
|
|
|
|
|
assert(false);
|
2013-08-03 21:34:17 +02:00
|
|
|
gcc_unreachable();
|
2009-07-05 18:44:37 +02:00
|
|
|
}
|
|
|
|
|
2016-11-09 12:06:54 +01:00
|
|
|
void
|
|
|
|
AudioOutput::Configure(const ConfigBlock &block)
|
2008-09-09 10:02:34 +02:00
|
|
|
{
|
2015-01-21 22:13:44 +01:00
|
|
|
if (!block.IsNull()) {
|
|
|
|
name = block.GetBlockValue(AUDIO_OUTPUT_NAME);
|
2016-11-09 12:06:54 +01:00
|
|
|
if (name == nullptr)
|
|
|
|
throw std::runtime_error("Missing \"name\" configuration");
|
2009-03-01 13:32:42 +01:00
|
|
|
|
2015-01-21 22:13:44 +01:00
|
|
|
const char *p = block.GetBlockValue(AUDIO_OUTPUT_FORMAT);
|
2016-10-28 21:46:20 +02:00
|
|
|
if (p != nullptr)
|
|
|
|
config_audio_format = ParseAudioFormat(p, true);
|
|
|
|
else
|
2014-01-28 11:39:12 +01:00
|
|
|
config_audio_format.Clear();
|
2008-09-09 10:02:34 +02:00
|
|
|
} else {
|
2014-01-28 11:39:12 +01:00
|
|
|
name = "default detected output";
|
2009-10-21 22:37:28 +02:00
|
|
|
|
2014-01-28 11:39:12 +01:00
|
|
|
config_audio_format.Clear();
|
2008-09-09 10:02:34 +02:00
|
|
|
}
|
|
|
|
|
2009-07-06 10:01:47 +02:00
|
|
|
/* set up the filter chain */
|
|
|
|
|
2016-06-22 11:15:49 +02:00
|
|
|
prepared_filter = filter_chain_new();
|
|
|
|
assert(prepared_filter != nullptr);
|
2009-12-14 21:36:25 +01:00
|
|
|
|
2010-02-14 17:04:39 +01:00
|
|
|
/* create the normalization filter (if configured) */
|
|
|
|
|
2015-01-21 22:36:13 +01:00
|
|
|
if (config_get_bool(ConfigOption::VOLUME_NORMALIZATION, false)) {
|
2016-06-22 11:15:49 +02:00
|
|
|
auto *normalize_filter =
|
2016-09-04 20:07:05 +02:00
|
|
|
filter_new(&normalize_filter_plugin, ConfigBlock());
|
2013-10-19 18:19:03 +02:00
|
|
|
assert(normalize_filter != nullptr);
|
2009-12-14 21:36:25 +01:00
|
|
|
|
2016-06-22 11:15:49 +02:00
|
|
|
filter_chain_append(*prepared_filter, "normalize",
|
2009-12-14 21:36:25 +01:00
|
|
|
autoconvert_filter_new(normalize_filter));
|
|
|
|
}
|
|
|
|
|
2016-09-04 20:07:05 +02:00
|
|
|
try {
|
|
|
|
filter_chain_parse(*prepared_filter,
|
|
|
|
block.GetBlockValue(AUDIO_FILTERS, ""));
|
|
|
|
} catch (const std::runtime_error &e) {
|
|
|
|
/* It's not really fatal - Part of the filter chain
|
|
|
|
has been set up already and even an empty one will
|
|
|
|
work (if only with unexpected behaviour) */
|
|
|
|
FormatError(e,
|
2013-09-27 22:31:24 +02:00
|
|
|
"Failed to initialize filter chain for '%s'",
|
2014-01-28 11:39:12 +01:00
|
|
|
name);
|
2016-09-04 20:07:05 +02:00
|
|
|
}
|
2011-09-16 23:31:48 +02:00
|
|
|
}
|
|
|
|
|
2016-12-29 22:59:03 +01:00
|
|
|
inline void
|
|
|
|
AudioOutput::Setup(EventLoop &event_loop,
|
2016-11-25 13:54:55 +01:00
|
|
|
const ReplayGainConfig &replay_gain_config,
|
2014-02-05 23:20:33 +01:00
|
|
|
MixerListener &mixer_listener,
|
2016-11-09 12:09:00 +01:00
|
|
|
const ConfigBlock &block)
|
2011-09-16 23:31:48 +02:00
|
|
|
{
|
|
|
|
|
|
|
|
/* create the replay_gain filter */
|
2008-09-09 10:02:34 +02:00
|
|
|
|
2011-09-16 23:31:48 +02:00
|
|
|
const char *replay_gain_handler =
|
2015-01-21 22:13:44 +01:00
|
|
|
block.GetBlockValue("replay_gain_handler", "software");
|
2011-09-16 23:31:48 +02:00
|
|
|
|
|
|
|
if (strcmp(replay_gain_handler, "none") != 0) {
|
2016-12-29 22:59:03 +01:00
|
|
|
prepared_replay_gain_filter =
|
2016-11-25 13:54:55 +01:00
|
|
|
NewReplayGainFilter(replay_gain_config);
|
2016-12-29 22:59:03 +01:00
|
|
|
assert(prepared_replay_gain_filter != nullptr);
|
2011-09-16 23:31:48 +02:00
|
|
|
|
2016-12-29 22:59:03 +01:00
|
|
|
prepared_other_replay_gain_filter =
|
2016-11-25 13:54:55 +01:00
|
|
|
NewReplayGainFilter(replay_gain_config);
|
2016-12-29 22:59:03 +01:00
|
|
|
assert(prepared_other_replay_gain_filter != nullptr);
|
2011-09-16 23:31:48 +02:00
|
|
|
} else {
|
2016-12-29 22:59:03 +01:00
|
|
|
prepared_replay_gain_filter = nullptr;
|
|
|
|
prepared_other_replay_gain_filter = nullptr;
|
2011-09-16 23:31:48 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/* set up the mixer */
|
|
|
|
|
2016-09-09 12:52:51 +02:00
|
|
|
try {
|
2016-12-29 22:59:03 +01:00
|
|
|
mixer = audio_output_load_mixer(event_loop, *this, block,
|
|
|
|
plugin.mixer_plugin,
|
|
|
|
*prepared_filter,
|
|
|
|
mixer_listener);
|
2016-09-09 12:52:51 +02:00
|
|
|
} catch (const std::runtime_error &e) {
|
|
|
|
FormatError(e,
|
2013-09-27 22:31:24 +02:00
|
|
|
"Failed to initialize hardware mixer for '%s'",
|
2016-12-29 22:59:03 +01:00
|
|
|
name);
|
2016-09-09 12:52:51 +02:00
|
|
|
}
|
2009-03-26 18:23:23 +01:00
|
|
|
|
2010-02-16 08:55:37 +01:00
|
|
|
/* use the hardware mixer for replay gain? */
|
|
|
|
|
|
|
|
if (strcmp(replay_gain_handler, "mixer") == 0) {
|
2016-12-29 22:59:03 +01:00
|
|
|
if (mixer != nullptr)
|
|
|
|
replay_gain_filter_set_mixer(*prepared_replay_gain_filter,
|
|
|
|
mixer, 100);
|
2010-02-16 08:55:37 +01:00
|
|
|
else
|
2013-09-27 22:31:24 +02:00
|
|
|
FormatError(output_domain,
|
2016-12-29 22:59:03 +01:00
|
|
|
"No such mixer for output '%s'", name);
|
2010-02-16 08:55:37 +01:00
|
|
|
} else if (strcmp(replay_gain_handler, "software") != 0 &&
|
2016-12-29 22:59:03 +01:00
|
|
|
prepared_replay_gain_filter != nullptr) {
|
2016-11-09 12:09:00 +01:00
|
|
|
throw std::runtime_error("Invalid \"replay_gain_handler\" value");
|
2010-02-16 08:55:37 +01:00
|
|
|
}
|
|
|
|
|
2012-07-10 01:14:43 +02:00
|
|
|
/* the "convert" filter must be the last one in the chain */
|
|
|
|
|
2016-12-29 22:59:03 +01:00
|
|
|
filter_chain_append(*prepared_filter, "convert",
|
2017-08-07 18:27:00 +02:00
|
|
|
convert_filter.Set(convert_filter_prepare()));
|
2011-09-16 23:31:48 +02:00
|
|
|
}
|
2009-07-06 21:50:25 +02:00
|
|
|
|
2014-01-28 11:34:09 +01:00
|
|
|
AudioOutput *
|
2016-11-25 13:54:55 +01:00
|
|
|
audio_output_new(EventLoop &event_loop,
|
|
|
|
const ReplayGainConfig &replay_gain_config,
|
|
|
|
const ConfigBlock &block,
|
2017-05-23 00:31:13 +02:00
|
|
|
MixerListener &mixer_listener)
|
2011-09-16 23:31:48 +02:00
|
|
|
{
|
2014-01-28 11:22:27 +01:00
|
|
|
const AudioOutputPlugin *plugin;
|
2009-07-06 21:50:25 +02:00
|
|
|
|
2015-01-21 22:13:44 +01:00
|
|
|
if (!block.IsNull()) {
|
2011-09-16 23:31:48 +02:00
|
|
|
const char *p;
|
2009-07-06 21:50:25 +02:00
|
|
|
|
2015-01-21 22:13:44 +01:00
|
|
|
p = block.GetBlockValue(AUDIO_OUTPUT_TYPE);
|
2016-11-09 11:56:01 +01:00
|
|
|
if (p == nullptr)
|
|
|
|
throw std::runtime_error("Missing \"type\" configuration");
|
2009-07-06 21:50:25 +02:00
|
|
|
|
2014-01-28 11:22:27 +01:00
|
|
|
plugin = AudioOutputPlugin_get(p);
|
2016-11-09 11:56:01 +01:00
|
|
|
if (plugin == nullptr)
|
|
|
|
throw FormatRuntimeError("No such audio output plugin: %s", p);
|
2011-09-16 23:31:48 +02:00
|
|
|
} else {
|
2013-09-27 22:31:24 +02:00
|
|
|
LogWarning(output_domain,
|
2014-01-28 11:34:09 +01:00
|
|
|
"No 'AudioOutput' defined in config file");
|
2011-09-16 23:31:48 +02:00
|
|
|
|
2016-11-09 11:56:01 +01:00
|
|
|
plugin = audio_output_detect();
|
2011-09-16 23:31:48 +02:00
|
|
|
|
2013-11-04 22:20:11 +01:00
|
|
|
FormatDefault(output_domain,
|
|
|
|
"Successfully detected a %s audio device",
|
|
|
|
plugin->name);
|
2011-09-16 23:31:48 +02:00
|
|
|
}
|
|
|
|
|
2017-01-25 09:47:43 +01:00
|
|
|
AudioOutput *ao = ao_plugin_init(event_loop, *plugin, block);
|
2016-11-09 11:56:01 +01:00
|
|
|
assert(ao != nullptr);
|
2011-09-16 23:31:48 +02:00
|
|
|
|
2016-11-09 12:09:00 +01:00
|
|
|
try {
|
2016-12-29 22:59:03 +01:00
|
|
|
ao->Setup(event_loop, replay_gain_config,
|
|
|
|
mixer_listener, block);
|
2016-11-09 12:09:00 +01:00
|
|
|
} catch (...) {
|
2011-09-16 23:31:48 +02:00
|
|
|
ao_plugin_finish(ao);
|
2016-11-09 12:09:00 +01:00
|
|
|
throw;
|
2011-09-16 23:31:48 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
return ao;
|
2008-09-09 10:02:34 +02:00
|
|
|
}
|