diff options
author | wm4 <wm4@nowhere> | 2019-11-25 01:16:03 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2019-11-25 01:16:03 +0100 |
commit | 13afc2150beeb1117e9c1724b2910e41ee4cc28b (patch) | |
tree | 65652f65f0dfce9b0c0abba27842e827acef5fa9 /DOCS/man | |
parent | f5daae12ff600b1c109d66efeca5e18176089b90 (diff) | |
download | mpv-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')
-rw-r--r-- | DOCS/man/input.rst | 14 |
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, |