summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-02-15 16:42:48 +0100
committerwm4 <wm4@nowhere>2014-02-16 03:51:02 +0100
commitc236cb767918c751c3db2e04901dd47ed93402cd (patch)
tree796395649af00a709d205f0feea24bc4fcf84432 /DOCS
parent309ae76e0b159d4000e24f04aabef8e29f41e86a (diff)
downloadmpv-c236cb767918c751c3db2e04901dd47ed93402cd.tar.bz2
mpv-c236cb767918c751c3db2e04901dd47ed93402cd.tar.xz
command: export more video params as properties
This uses the previously added sub-property mechanism to export a bunch of stuff. For example, "video-params/w" now contains the video width.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/input.rst43
1 files changed, 40 insertions, 3 deletions
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 56f3a5ba2a..a6e7bc4fda 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -730,15 +730,52 @@ an option at runtime.
frame has been decoded yet, the (possibly incorrect) container indicated
size.
-``fps``
- Container FPS. This can easily contain bogus values. For videos that use
- modern container formats or video codecs, this will often be incorrect.
+``video-params``
+ Video parameters, as output by the decoder (with overrides like aspect
+ etc. applied). This has a number of sub-properties:
+
+ ``video-params/pixelformat``
+ The pixel format as string. This uses the same names as used in other
+ places of mpv.
+
+ ``video-params/w``, ``video-params/h``
+ Video size as integers, with no aspect correction applied.
+
+ ``video-params/dw``, ``video-params/dh``
+ Video size as integers, scaled for correct aspect ratio.
+
+ ``video-params/aspect``
+ Display aspect ratio as float.
+
+ ``video-params/par``
+ Pixel aspect ratio.
+
+ ``video-params/colormatrix``
+ The colormatrix in use as string. (Exact values subject to change.)
+
+ ``video-params/colorlevels``
+ The colorlevels as string. (Exact values subject to change.)
+
+ ``video-params/chroma-location``
+ Chroma location as string. (Exact values subject to change.)
``dwidth``, ``dheight``
Video display size. This is the video size after filters and aspect scaling
have been applied. The actual video window size can still be different
from this.
+``video-out-params``
+ Same as ``video-params``, but after video filters have been applied. If
+ there are no video filters in use, this will contain the same values as
+ ``video-params``. Note that this is still not necessarily what the video
+ window uses, since all real VOs do their own scaling.
+
+ Has the same sub-properties as ``video-params``.
+
+``fps``
+ Container FPS. This can easily contain bogus values. For videos that use
+ modern container formats or video codecs, this will often be incorrect.
+
``window-scale`` (RW)
Window size multiplier. Setting this will resize the video window to the
values contained in ``dwidth`` and ``dheight`` multiplied with the value