From 216e8320b02e76a407b114ca4de73763e9df3507 Mon Sep 17 00:00:00 2001 From: wm4 Date: Sat, 15 Jun 2013 00:15:32 +0200 Subject: 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.) --- DOCS/man/en/input.rst | 5 +++++ DOCS/man/en/options.rst | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+) (limited to 'DOCS/man') 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=`` 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=``, ``--video-pan-y=`` + 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=`` + 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=`` 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 -- cgit v1.2.3