summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-06-15 00:15:32 +0200
committerwm4 <wm4@nowhere>2013-08-19 13:03:08 +0200
commit216e8320b02e76a407b114ca4de73763e9df3507 (patch)
treecf96184f0eb011d41366e23357914e385ee0cdf1 /DOCS/man
parent67704e2977d2bb5c35f962b154d5e8e481e2d508 (diff)
downloadmpv-216e8320b02e76a407b114ca4de73763e9df3507.tar.bz2
mpv-216e8320b02e76a407b114ca4de73763e9df3507.tar.xz
video: make it possible to scale/pan the video by arbitrary amounts
Add --video-align-x/y, --video-pan-x/y, --video-scale options and properties. See the additions to the manpage for description and semantics. These transformations are intentionally done on top of panscan. Unlike the (now removed) --panscanrange option, this doesn't affect the default panscan behavior. (Although panscan itself becomes kind of useless if the new options are used.)
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/en/input.rst5
-rw-r--r--DOCS/man/en/options.rst33
2 files changed, 38 insertions, 0 deletions
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index ae887a2080..bacb99c14b 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -452,6 +452,11 @@ Name W Comment
``aspect`` x video aspect
``vid`` x current video track (similar to ``--vid``)
``video`` x alias for ``vid``
+``video-align-x`` x see ``--video-align-x``
+``video-align-y`` x see ``--video-align-y``
+``video-pan-x`` x see ``--video-pan-x``
+``video-pan-y`` x see ``--video-pan-y``
+``video-zoom`` x see ``--video-zoom``
``program`` x switch TS program (write-only)
``sid`` x current subtitle track (similar to ``--sid``)
``sub`` x alias for ``sid``
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 210f89381b..4174e1f0d6 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -2458,6 +2458,39 @@
``--vid=<ID|auto|no>``
Select video channel. ``auto`` selects the default, ``no`` disables video.
+``--video-align-x=<-1-1>``, ``--video-align-y=<-1-1>``
+ Moves the video rectangle within the black borders, which are usually added
+ to pad the video to screen if video and screen aspect ratios are different.
+ ``--video-align-y=-1`` would move the video to the top of the screen
+ (leaving a border only on the bottom), a value of ``0`` centers it
+ (default), and a value of ``-1`` would put the video at the bottom of the
+ screen.
+
+ If video and screen aspect match perfectly, these options do nothing.
+
+ This option is disabled if the ``--no-keepaspect`` option is used.
+
+``--video-pan-x=<value>``, ``--video-pan-y=<value>``
+ Moves the displayed video rectangle by the given value in the X or Y
+ direction. The unit is in fractions of the size of the scaled video (the
+ full size, even if parts of the video are not visible due to panscan or
+ other options).
+
+ For example, displaying a 1280x720 video fullscreen on a 1680x1050 screen
+ with ``--video-pan-x=-0.1`` would move the video 168 pixels to the left
+ (making 128 pixels of the source video invisible).
+
+ This option is disabled if the ``--no-keepaspect`` option is used.
+
+``--video-zoom=<value>``
+ Adjust the video display scale factor by the given value. The unit is in
+ fractions of original video size.
+
+ For example, given a 1280x720 video, ``--video-zoom=-0.1`` would make the
+ video by 128 pixels smaller in X direction, and 72 pixels in Y direction.
+
+ This option is disabled if the ``--no-keepaspect`` option is used.
+
``--vo=<driver1[:suboption1[=value]:...],driver2,...[,]>``
Specify a priority list of video output drivers to be used. For
interactive use, one would normally specify a single one to use, but in