diff options
author | Niklas Haas <git@haasn.xyz> | 2019-10-04 18:45:37 +0200 |
---|---|---|
committer | Niklas Haas <github-c6e1c8@haasn.xyz> | 2019-10-04 21:34:22 +0200 |
commit | cb95ce75b5c114b6fd2c6b37ac6941b6848c8014 (patch) | |
tree | 8b5efcb27976dd475a867767c661ed9715a8112c /DOCS/man/input.rst | |
parent | 6064720011c7864bb97b4bb6dd2872246908c1c5 (diff) | |
download | mpv-cb95ce75b5c114b6fd2c6b37ac6941b6848c8014.tar.bz2 mpv-cb95ce75b5c114b6fd2c6b37ac6941b6848c8014.tar.xz |
options: rename --video-aspect to --video-aspect-override
The justification for this is the fact that the `video-aspect` property
doesn't work well with `cycle_values` commands that include the value
"-1".
The "video-aspect" property has effectively no change in behavior, but
we may want to make it read-only in the future. I think it's probably
fine to leave as-is, though.
Fixes #6068.
Diffstat (limited to 'DOCS/man/input.rst')
-rw-r--r-- | DOCS/man/input.rst | 13 |
1 files changed, 4 insertions, 9 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index d2050bc7b4..92327f2dd6 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -1937,10 +1937,11 @@ Property list Estimated deviation factor of the vsync duration. ``video-aspect`` (RW) - Video aspect, see ``--video-aspect``. + Deprecated. This is tied to ``--video-aspect-override``, but always + reports the current video aspect if video is active. - If video is active, this reports the effective aspect value, instead of - the value of the ``--video-aspect`` option. + The read and write components of this option can be split up into + ``video-params/aspect`` and ``video-aspect-override`` respectively. ``osd-width``, ``osd-height`` Last known OSD width (can be 0). This is needed if you want to use the @@ -2537,12 +2538,6 @@ caveats with some properties (due to historical reasons): Option changes at runtime are affected by this as well. -``video-aspect`` - While video is active, always returns the effective aspect ratio. Setting - a special value (like ``no``, values ``<= 0``) will make the property - set this as option, and return whatever actual aspect was derived from the - option setting. - ``display-fps`` If a VO is created, this will return either the actual display FPS, or an invalid value, instead of the option value. |