From 3b8dfddb4cb6e9431da659b10c5b31a9f17c81b5 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Mon, 22 Jul 2013 14:43:58 +0200
Subject: audio/filter: use new option API

Make the VF/VO/AO option parser available to audio filters. No audio
filter uses this yet, but it's still a quite intrusive change.

In particular, the commands for manipulating filters at runtime
completely change. We delete the old code, and use the same
infrastructure as for video filters. (This forces complete
reinitialization of the filter chain, which hopefully isn't a problem
for any use cases. The old code forced reinitialization too, but it
could potentially allow a filter to cache things; e.g. consider loaded
ladspa plugins and such.)
---
 DOCS/man/en/changes.rst |  2 ++
 DOCS/man/en/input.rst   | 22 ++++++++--------------
 2 files changed, 10 insertions(+), 14 deletions(-)

(limited to 'DOCS')

diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst
index 26c9e9d9d2..5ff532ddc9 100644
--- a/DOCS/man/en/changes.rst
+++ b/DOCS/man/en/changes.rst
@@ -186,6 +186,8 @@ input.conf and Slave Commands
     +--------------------------------+----------------------------------------+
     | ``show_chapters``              | ``show_text ${chapter-list}``          |
     +--------------------------------+----------------------------------------+
+    | ``af_switch``, ``af_add``, ... | ``af [set|add|...]``                   |
+    +--------------------------------+----------------------------------------+
 
 Other
 ~~~~~
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index fd1aad9c58..804d37d976 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -253,20 +253,10 @@ List of Input Commands
 Input Commands that are Possibly Subject to Change
 --------------------------------------------------
 
-``af_switch "filter1=params,filter2,..."``
-    Replace the current filter chain with the given list.
+``af set|add|toggle|del|clr "filter1=params,filter2,..."``
+    Change audio filter chain. See ``vf`` command.
 
-``af_add "filter1=params,filter2,..."``
-    Add the given list of audio filters to the audio filter chain.
-
-``af_del "filter1,filter2,..."``
-    Remove the given list of audio filters.
-
-``af_clr``
-    Remove all audio filters. (Conversion filters will be re-added
-    automatically if needed.)
-
-``vf set|add|toggle|del "filter1=params,filter2,..."``
+``vf set|add|toggle|del|clr "filter1=params,filter2,..."``
     Change video filter chain.
 
     The first argument decides what happens:
@@ -290,6 +280,10 @@ Input Commands that are Possibly Subject to Change
         indexes start from the last filter, and ``-1`` denotes the last
         filter.
 
+    clr
+        Remove all filters. Note that like the other sub-commands, this does
+        not control automatically inserted filters.
+
     You can assign labels to filter by prefixing them with ``@name:`` (where
     ``name`` is a user-chosen arbitrary identifier). Labels can be used to
     refer to filters by name in all of the filter chain modification commands.
@@ -322,7 +316,7 @@ Undocumented commands: ``tv_start_scan``, ``tv_step_channel``, ``tv_step_norm``,
 ``tv_step_freq``, ``tv_set_norm``, ``dvb_set_channel``, ``radio_step_channel``,
 ``radio_set_channel``, ``radio_set_freq``, ``radio_step_freq`` (all of these
 should be replaced by properties), ``stop`` (questionable use), ``get_property``
-(?), ``af_cmdline``, ``vo_cmdline`` (experimental).
+(?), ``vo_cmdline`` (experimental).
 
 Input Command Prefixes
 ----------------------
-- 
cgit v1.2.3