diff options
| author | wm4 <wm4@nowhere> | 2019-06-15 17:53:59 +0200 |
|---|---|---|
| committer | wm4 <wm4@nowhere> | 2019-09-19 20:37:05 +0200 |
| commit | 0b4790f23f045ada592be14f4cd1ceaa7ae47008 (patch) | |
| tree | a2b0b0e6a1e09c794a58928f246e892238edbef6 /DOCS | |
| parent | e1c8069b686bf67d0c2aa6a1527d5b244e170a18 (diff) | |
| download | mpv-0b4790f23f045ada592be14f4cd1ceaa7ae47008.tar.bz2 mpv-0b4790f23f045ada592be14f4cd1ceaa7ae47008.tar.xz | |
aspect: add video margin options
Semantics a bit questionable. This is done for the OSC (next commit),
and a comment added the manpage explicitly states this. Meaning this is
probably garbage and needs to revisit when the OSC changes and/or
someone wants to use this margin feature for something else.
Not sure about the subtitle thing. It's imaginable that someone uses
these options to create empty borders for subtitles on the bottom, so
subtitles should be located there. On the other hand, this gives a
rather unpolished user experience when using the (later added) OSC
feature to not overlap with the video. There's not much of a point if
the OSC still overlaps the video. However, I'm too lazy to think about
this, so it stays like it is.
Diffstat (limited to 'DOCS')
| -rw-r--r-- | DOCS/man/options.rst | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index c70b26aa2c..79a2287467 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -1261,6 +1261,30 @@ Video This option is disabled if the ``--no-keepaspect`` option is used. +``--video-margin-ratio-left=<val>``, ``--video-margin-ratio-right=<val>``, ``--video-margin-ratio-top=<val>``, ``--video-margin-ratio-bottom=<val>`` + Set extra video margins on each border (default: 0). Each value is a ratio + of the window size, using a range 0.0-1.0. For example, setting the option + ``--video-margin-ratio-right=0.2`` at a window size of 1000 pixels will add + a 200 pixels border on the right side of the window. + + The video is "boxed" by these margins. The window size is not changed. In + particular it does not enlarge the window, and the margins will cause the + video to be downscaled by default. This may or may not change in the future. + + The margins are applied after 90° video rotation, but before any other video + transformations. + + This option is disabled if the ``--no-keepaspect`` option is used. + + Subtitles still may use the margins, depending on ``--sub-use-margins`` and + similar options. + + These options were created for the OSC. Some odd decisions, such as making + the margin values a ratio (instead of pixels), were made for the sake of + the OSC. It's possible that these options may be replaced by ones that are + more generally useful. The behavior of these options may change to fit + OSC requirements better, too. + ``--correct-pts``, ``--no-correct-pts`` ``--no-correct-pts`` switches mpv to a mode where video timing is determined using a fixed framerate value (either using the ``--fps`` |