/* * Copyright 2003-2016 The Music Player Daemon Project * http://www.musicpd.org * * 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. * * 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. */ #include "config.h" #include "Internal.hxx" #include "Registry.hxx" #include "Domain.hxx" #include "OutputAPI.hxx" #include "filter/FilterConfig.hxx" #include "AudioParser.hxx" #include "mixer/MixerList.hxx" #include "mixer/MixerType.hxx" #include "mixer/MixerControl.hxx" #include "mixer/plugins/SoftwareMixerPlugin.hxx" #include "filter/FilterPlugin.hxx" #include "filter/FilterRegistry.hxx" #include "filter/plugins/AutoConvertFilterPlugin.hxx" #include "filter/plugins/ReplayGainFilterPlugin.hxx" #include "filter/plugins/ChainFilterPlugin.hxx" #include "config/ConfigError.hxx" #include "config/ConfigGlobal.hxx" #include "config/Block.hxx" #include "util/Error.hxx" #include "Log.hxx" #include #include #include #define AUDIO_OUTPUT_TYPE "type" #define AUDIO_OUTPUT_NAME "name" #define AUDIO_OUTPUT_FORMAT "format" #define AUDIO_FILTERS "filters" AudioOutput::AudioOutput(const AudioOutputPlugin &_plugin) :plugin(_plugin) { assert(plugin.finish != nullptr); assert(plugin.open != nullptr); assert(plugin.close != nullptr); assert(plugin.play != nullptr); } static const AudioOutputPlugin * audio_output_detect(Error &error) { LogDefault(output_domain, "Attempt to detect audio output device"); audio_output_plugins_for_each(plugin) { if (plugin->test_default_device == nullptr) continue; FormatDefault(output_domain, "Attempting to detect a %s audio device", plugin->name); if (ao_plugin_test_default_device(plugin)) return plugin; } error.Set(output_domain, "Unable to detect an audio device"); return nullptr; } /** * 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. */ gcc_pure static MixerType audio_output_mixer_type(const ConfigBlock &block) { /* read the local "mixer_type" setting */ const char *p = block.GetBlockValue("mixer_type"); if (p != nullptr) return mixer_type_parse(p); /* try the local "mixer_enabled" setting next (deprecated) */ if (!block.GetBlockValue("mixer_enabled", true)) return MixerType::NONE; /* fall back to the global "mixer_type" setting (also deprecated) */ return mixer_type_parse(config_get_string(ConfigOption::MIXER_TYPE, "hardware")); } static PreparedFilter * CreateVolumeFilter() { return filter_new(&volume_filter_plugin, ConfigBlock()); } static Mixer * audio_output_load_mixer(EventLoop &event_loop, AudioOutput &ao, const ConfigBlock &block, const MixerPlugin *plugin, PreparedFilter &filter_chain, MixerListener &listener) { Mixer *mixer; switch (audio_output_mixer_type(block)) { case MixerType::NONE: case MixerType::UNKNOWN: return nullptr; case MixerType::NULL_: return mixer_new(event_loop, null_mixer_plugin, ao, listener, block); case MixerType::HARDWARE: if (plugin == nullptr) return nullptr; return mixer_new(event_loop, *plugin, ao, listener, block); case MixerType::SOFTWARE: mixer = mixer_new(event_loop, software_mixer_plugin, ao, listener, ConfigBlock()); assert(mixer != nullptr); filter_chain_append(filter_chain, "software_mixer", ao.volume_filter.Set(CreateVolumeFilter())); return mixer; } assert(false); gcc_unreachable(); } bool AudioOutput::Configure(const ConfigBlock &block, Error &error) { if (!block.IsNull()) { name = block.GetBlockValue(AUDIO_OUTPUT_NAME); if (name == nullptr) { error.Set(config_domain, "Missing \"name\" configuration"); return false; } const char *p = block.GetBlockValue(AUDIO_OUTPUT_FORMAT); if (p != nullptr) { bool success = audio_format_parse(config_audio_format, p, true, error); if (!success) return false; } else config_audio_format.Clear(); } else { name = "default detected output"; config_audio_format.Clear(); } tags = block.GetBlockValue("tags", true); always_on = block.GetBlockValue("always_on", false); enabled = block.GetBlockValue("enabled", true); /* set up the filter chain */ prepared_filter = filter_chain_new(); assert(prepared_filter != nullptr); /* create the normalization filter (if configured) */ if (config_get_bool(ConfigOption::VOLUME_NORMALIZATION, false)) { auto *normalize_filter = filter_new(&normalize_filter_plugin, ConfigBlock()); assert(normalize_filter != nullptr); filter_chain_append(*prepared_filter, "normalize", autoconvert_filter_new(normalize_filter)); } 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, "Failed to initialize filter chain for '%s'", name); } /* done */ return true; } static bool audio_output_setup(EventLoop &event_loop, AudioOutput &ao, MixerListener &mixer_listener, const ConfigBlock &block, Error &error) { /* create the replay_gain filter */ const char *replay_gain_handler = block.GetBlockValue("replay_gain_handler", "software"); if (strcmp(replay_gain_handler, "none") != 0) { ao.prepared_replay_gain_filter = filter_new(&replay_gain_filter_plugin, block); assert(ao.prepared_replay_gain_filter != nullptr); ao.replay_gain_serial = 0; ao.prepared_other_replay_gain_filter = filter_new(&replay_gain_filter_plugin, block); assert(ao.prepared_other_replay_gain_filter != nullptr); ao.other_replay_gain_serial = 0; } else { ao.prepared_replay_gain_filter = nullptr; ao.prepared_other_replay_gain_filter = nullptr; } /* set up the mixer */ try { ao.mixer = audio_output_load_mixer(event_loop, ao, block, ao.plugin.mixer_plugin, *ao.prepared_filter, mixer_listener); } catch (const std::runtime_error &e) { FormatError(e, "Failed to initialize hardware mixer for '%s'", ao.name); } /* use the hardware mixer for replay gain? */ if (strcmp(replay_gain_handler, "mixer") == 0) { if (ao.mixer != nullptr) replay_gain_filter_set_mixer(ao.prepared_replay_gain_filter, ao.mixer, 100); else FormatError(output_domain, "No such mixer for output '%s'", ao.name); } else if (strcmp(replay_gain_handler, "software") != 0 && ao.prepared_replay_gain_filter != nullptr) { error.Set(config_domain, "Invalid \"replay_gain_handler\" value"); return false; } /* the "convert" filter must be the last one in the chain */ auto *f = filter_new(&convert_filter_plugin, ConfigBlock()); assert(f != nullptr); filter_chain_append(*ao.prepared_filter, "convert", ao.convert_filter.Set(f)); return true; } AudioOutput * audio_output_new(EventLoop &event_loop, const ConfigBlock &block, MixerListener &mixer_listener, PlayerControl &pc, Error &error) { const AudioOutputPlugin *plugin; if (!block.IsNull()) { const char *p; p = block.GetBlockValue(AUDIO_OUTPUT_TYPE); if (p == nullptr) { error.Set(config_domain, "Missing \"type\" configuration"); return nullptr; } plugin = AudioOutputPlugin_get(p); if (plugin == nullptr) { error.Format(config_domain, "No such audio output plugin: %s", p); return nullptr; } } else { LogWarning(output_domain, "No 'AudioOutput' defined in config file"); plugin = audio_output_detect(error); if (plugin == nullptr) return nullptr; FormatDefault(output_domain, "Successfully detected a %s audio device", plugin->name); } AudioOutput *ao = ao_plugin_init(plugin, block, error); if (ao == nullptr) return nullptr; if (!audio_output_setup(event_loop, *ao, mixer_listener, block, error)) { ao_plugin_finish(ao); return nullptr; } ao->player_control = &pc; return ao; }