summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2019-12-16 02:32:17 +0100
committerwm4 <wm4@nowhere>2019-12-16 02:32:17 +0100
commitd07b7f068db56aa5fa7cf16b9d077721ff0a8452 (patch)
tree355bb260fc26e1b8f43d373c1441a21662ad13b5 /DOCS/man
parent98008558950c3eb99bad031cb478afa287e428aa (diff)
downloadmpv-d07b7f068db56aa5fa7cf16b9d077721ff0a8452.tar.bz2
mpv-d07b7f068db56aa5fa7cf16b9d077721ff0a8452.tar.xz
command: change "window-scale" property behavior
This is similar to the "edition" change. I considered making this go through deprecation, but didn't have a good idea how to do that. Maybe it's fine, because this is pretty obscure. But it might break some API users/scripts (it certainly broke stats.lua), and all I have to say is sorry for that.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/input.rst18
1 files changed, 14 insertions, 4 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index fbfede5869..08edf618b1 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -2026,6 +2026,20 @@ Property list
(or to be exact, the size the video filters output). ``2`` will set the
double size, ``0.5`` halves the size.
+ See ``current-window-scale`` for the value derived from the actual window
+ size.
+
+ Since mpv 0.31.0, this always returns the previously set value (or the
+ default value), instead of the value implied by the actual window size.
+ Before mpv 0.31.0, this returned what ``current-window-scale`` returns now,
+ after the window was created.
+
+``current-window-scale``
+ The ``window-scale`` value calculated from the current window size. This
+ has the same value as ``window-scale`` if the window size was not changed
+ since setting the option, and the window size was not restricted in other
+ ways. The property is unavailable if no video is active.
+
``display-names``
Names of the displays that the mpv window covers. On X11, these
are the xrandr names (LVDS1, HDMI1, DP1, VGA1, etc.). On Windows, these
@@ -2731,10 +2745,6 @@ caveats with some properties (due to historical reasons):
option is for loading playlist during command line parsing. For client API
uses, you should use the ``loadlist`` command instead.
-``window-scale``
- 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,
exactly as if they were used on the mpv CLI commandline. Their only use is