diff options
author | wm4 <wm4@nowhere> | 2019-06-15 18:02:54 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2019-09-19 20:37:05 +0200 |
commit | 530b203e5d150362adbbbb49783e3d1a23a730f5 (patch) | |
tree | bf59d8c97debd91d3a35adc874e4c8876a692edd /DOCS | |
parent | 0b4790f23f045ada592be14f4cd1ceaa7ae47008 (diff) | |
download | mpv-530b203e5d150362adbbbb49783e3d1a23a730f5.tar.bz2 mpv-530b203e5d150362adbbbb49783e3d1a23a730f5.tar.xz |
osc: add feature to bottombar to not cover the video
Normally I use the OSC like this: not at all, but have a key binding
that does "cycle osc" to show it. And in that case, I don't really want
it to overlap the damn video.
I could use the zoom/pan options to move the video out of the way, but
this is also sort of annoying. Likewise, you could write a script or so
which does this automatically if the OSC appears, but that's still
annoying, and computing values for these options such that the video is
moved correctly is tricky.
So I added a bunch of options that set explicit video borders (previous
commit), and a option for the OSC to use them (this commit).
Disabled by default, since I'm afraid this is too awkward and
unpolished, especially with OSC default settings.
I'm also using "osc-visibility=always". Effectively, making the OSC
appear will box the video, and making it disappear (by unloading
osc.lua) will restore the video back to normal.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/osc.rst | 20 |
1 files changed, 20 insertions, 0 deletions
diff --git a/DOCS/man/osc.rst b/DOCS/man/osc.rst index 5ff77409dd..d8a82a0ee7 100644 --- a/DOCS/man/osc.rst +++ b/DOCS/man/osc.rst @@ -321,6 +321,26 @@ Configurable Options default is conservative to allow wide fonts to be used without overflow. However, with many common fonts a bigger number can be used. YMMV. +``boxvideo`` + Default: no + + Whether to overlay the osc over the video (``no``), or to box the video + within the areas not covered by the osc (``yes``). If this option is set, + the osc may overwrite the ``--video-margin-ratio-*`` options, even if the + user has set them. (It will not overwrite them if all of them are set to + default values.) + + Currently, this is supported for the ``bottombar`` layout only. The other + layouts do not change if this option is set. + + The border is static and appears even if the OSC is configured to appear + only on mouse interaction. If the OSC is invisible, the border is simply + filled with the background color (black by default). + + This currently still makes the OSC overlap with subtitles (if the + ``--sub-use-margins`` option is set to ``yes``, the default). This may be + fixed later. + Script Commands ~~~~~~~~~~~~~~~ |