summaryrefslogtreecommitdiffstats
path: root/DOCS/man/input.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2019-11-25 01:16:03 +0100
committerwm4 <wm4@nowhere>2019-11-25 01:16:03 +0100
commit13afc2150beeb1117e9c1724b2910e41ee4cc28b (patch)
tree65652f65f0dfce9b0c0abba27842e827acef5fa9 /DOCS/man/input.rst
parentf5daae12ff600b1c109d66efeca5e18176089b90 (diff)
downloadmpv-13afc2150beeb1117e9c1724b2910e41ee4cc28b.tar.bz2
mpv-13afc2150beeb1117e9c1724b2910e41ee4cc28b.tar.xz
command: change af/vf property behavior wrt. filter creation failures
The behavior is slightly different in a messy way. The change is in line with the option-to-property bridge removal mentioned some commits ago and thus is deemed necessary.
Diffstat (limited to 'DOCS/man/input.rst')
-rw-r--r--DOCS/man/input.rst14
1 files changed, 8 insertions, 6 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index a098de99e2..ced5363ea1 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -2708,12 +2708,13 @@ caveats with some properties (due to historical reasons):
``vf``, ``af``
If you set the properties during playback, and the filter chain fails to
- reinitialize, the new value will be rejected. Setting the option or
- setting the property outside of playback will always succeed/fail in the
- same way. Also, there are no ``vf-add`` etc. properties, but you can use
- the ``vf``/``af`` group of commands to achieve the same.
+ reinitialize, the option will be set, but the runtime filter chain does not
+ change. On the other hand, the next video to be played will fail, because
+ the initial filter chain cannot be created.
- Option changes at runtime are affected by this as well.
+ This behavior changed in mpv 0.31.0. Before this, the new value was rejected
+ *iff* video (for ``vf``) or audio (for ``af``) was active. If playback was
+ not active, the behavior was the same as the current behavior.
``edition``
While a file is loaded, the property will always return the effective
@@ -2726,7 +2727,8 @@ caveats with some properties (due to historical reasons):
uses, you should use the ``loadlist`` command instead.
``window-scale``
- Might verify the set value when setting while a window is created.
+ Returns the current window values if a window exists, and the option value
+ otherwise.
``profile``, ``include``
These are write-only, and will perform actions as they are written to,