mpv/DOCS/man/en
wm4 e60b8f181d audio/filter: split af_format into separate filters, rename af_force
af_format is the old audio conversion filter. It could do all possible
conversions supported by the audio chain. However, ever since the
addition of af_lavrresample, most conversions are done by
libav/swresample, and af_format is used as fallback.

Separate out the fallback cases and remove af_format. af_convert24 does
24 bit <-> 32 bit conversions, while af_convertsignendian does sign and
endian conversions. Maybe the way the conversions are split sounds a bit
odd. But the former changes the size of the audio data, while the latter
is fully in-place, so there's at least different buffer management.

This requires a quite complicated algorithm to make sure all these
"partial" conversion filters can actually get from one format to
another. E.g. s24le->s32be always requires convertsignendian and
convert24, but af.c has no idea what the intermediate format should
be. So I added a graph search (trying every possible format and
filter) to determine required format and filter. When I wrote this,
it seemed this was still better than messing everything into
af_lavrresample, but maybe this is overkill and I'll change my
opinion. For now, it seems nice to get rid of af_format though.

The AC3->IEC61937 conversion isn't supported anymore, but I don't think
this is needed anywhere. Most AOs test all formats explicitly, or use
the AF_FORMAT_IS_IEC61937() macro (which includes AC3).

One positive consequence of this change is that conversions always
include dithering (done by libav/swresample), instead of possibly going
through af_format, which doesn't do anything fancy.

Rename af_force to af_format. It's essentially compatible with command
line uses of af_format. We retain a compatibility alias for af_force.
2013-10-23 10:04:12 +02:00
..
af.rst audio/filter: split af_format into separate filters, rename af_force 2013-10-23 10:04:12 +02:00
ao.rst ao_sndio: add documentation 2013-10-05 22:47:20 +02:00
changes.rst changes.rst: add some replaced options, follow conventions better 2013-10-15 23:41:52 +02:00
encode.rst
input.rst command: add commands for displaying overlays 2013-10-05 22:46:55 +02:00
lua.rst
mpv.rst docs: Add osc.rst to mpv.rst 2013-10-15 22:42:00 +02:00
options.rst spelling fixes 2013-10-16 12:36:34 +02:00
osc.rst osc: make transparency of background-box configurable 2013-10-18 00:33:01 +02:00
vf.rst
vo.rst spelling fixes 2013-10-16 12:36:34 +02:00