This updates the copyright header to all be the same, which is
pretty much an update of where to mail request for a copy of the GPL
and the years of the MPD project. This also puts all committers under
'The Music Player Project' umbrella. These entries should go
individually in the AUTHORS file, for consistancy.

Use config_get_block_string("name") instead of audio_output_get_name().

If an output plugin requires config.h, it should include it directly.

The method control() is too complicated, and overengineered.  Replace
it with two trivial functions: get_volume() and set_volume().

If we move the plugin struct to a separate header, we don't have to
include the big fat output_api.h everywhere.

Now that the output_command enum isn't exposed to output plugins
anymore, we can hide its definition within output_internal.h.

Including "../config.h" breaks on some systems.

Move the "while" loop which checks for commands to the caller
ao_pause().  This simplifies the pause() method, and lets us remove
audio_output_is_pending().

The macro is unused.

The function is only used by the MVP output plugin, and this one call
is wrong.

Those have been superseded by the new legacy configuration code.

All config_get_block_*() functions should accept constant config_param
pointers.

Renamed functions, types, variables.

"LOG_H" is a macro which is also used by ffmpeg/log.h.  This is
ffmpeg's fault, because short macros should be reserved for
applications, but since it's always a good idea to choose prefixed
macro names, even for applications, we are going to do that in MPD.

Don't return 0/-1 on success/error, but true/false.  Instead of int,
use bool for storing flags.

When there are standardized headers, use these instead of the bloated
os_compat.h.

pause() puts the audio output into pause mode: if supported, it may
perform a special action, which keeps the device open, but does not
play anything.  Output plugins like "shout" might want to play silence
during pause, so their clients won't be disconnected.  Plugins which
do not support pausing will simply be closed, and have to be reopened
when unpaused.

This pach includes an implementation for the shout plugin, which
sends silence chunks.

The function audio_output_is_pending() returns whether there is a
pending command.  This is useful for output plugins as a break
condition for longer loops.

We have eliminated direct accesses to the audio_output struct from
the all output plugins.  Make it opaque for them, and move its real
declaration to output_internal.h, similar to decoder_internal.h.

Pass the opaque structure to plugin.init() only, which will return the
plugin's data pointer on success, and NULL on failure.  This data
pointer will be passed to all other methods instead of the
audio_output struct.

The JACK output plugin needs to reset its "opened" flag when the JACK
server fails.  To prevent it from accessing the audio_output struct
directly introduce the API function audio_output_closed().

Reduce direct accesses to the audio_output struct from the plugins:
this time, eliminate all accesses to audio_output.name.  The name is
required by some plugins for log messages.

Pass the globally configured audio_format as a const pointer to
plugin.init().  plugin.open() gets a writable pointer which contains
the audio_format requested by the plugin.  Its initial value is either
the configured audio_format or the input file's audio_format.

To keep I/O nastiness and latencies away from the core, move the audio
output code to a separate thread, one per output.  The thread is
created on demand, and currently runs until mpd exits.

Eliminate sameInAndOutFormats and check with audio_format_equals()
each time it this information is needed.  Another 4 bytes saved.

Instead of checking convertAudioFormat, we can simply check if
reqAudioFormat is defined.  This saves 4 bytes in the struct.

No CamelCase.  Also don't declare typedefs for the methods.

Since the plugin struct is never modified, we should store it in
constant locations.

Instead of copying all that stuff from the audio output plugin to the
audio output structure, store a pointer to the plugin.

Also rename AudioOutputPlugin to struct audio_output_plugin, and use
forward declarations to reduce include dependencies.

Just like decoder_api.h, output_api.h provides the audio output API
which is used by the plugins.

Get rid of CamelCase, and don't use a typedef, so we can
forward-declare it, and unclutter the include dependencies.

Getting rid of CamelCase; not having typedefs also allows us to
forward-declare the structures.

And again, convert arguments to const.

We want to expose the AudioFormat structure to plugins; remove some
clutter by moving its declaration to a separate header file.

git-svn-id: https://svn.musicpd.org/mpd/trunk@7345 09075e82-0dd4-0310-85a5-a0d7c8717e4f

git-svn-id: https://svn.musicpd.org/mpd/trunk@7294 09075e82-0dd4-0310-85a5-a0d7c8717e4f