diff options
authorwm4 <wm4@nowhere>2017-04-04 17:16:54 +0200
committerwm4 <wm4@nowhere>2017-04-04 17:17:56 +0200
commit54ea3282a05c1be06a2143a82574c6118f6ea8eb (patch)
parentb96a74ec2a77a4fb8d62d331dcd9ed087e9813e6 (diff)
DOCS/interface-changes.rst: document --vf/--af deprecations
And also future directions. Basically, it tells the user that he can't hope for perfect forward-compatibility.
1 files changed, 10 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index bcffc69cee..0584409eb9 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -31,6 +31,16 @@ Interface changes
- add --sub-filter-sdh
- add --sub-filter-sdh-harder
- remove --input-app-events option (macOS)
+ - deprecate most --vf and --af filters. Only some filters not in libavfilter
+ will be kept.
+ Also, you can use libavfilter filters directly (e.g. you can use
+ --vf=name=opts instead of --vf=lavfi=[name=opts]), as long as the
+ libavfilter filter's name doesn't clash with a mpv builtin filter.
+ In the long term, --vf/--af syntax might change again, but if it does, it
+ will switch to libavfilter's native syntax. (The above mentioned direct
+ support for lavfi filters still has some differences, such as how strings
+ are escaped.) If this happens, the non-deprecated builtin filters might be
+ moved to "somewhere else" syntax-wise.
--- mpv 0.24.0 ---
- deprecate --hwdec-api and replace it with --opengl-hwdec-interop.
The new option accepts both --hwdec values, as well as named backends.