diff options
| author | wm4 <wm4@nowhere> | 2016-08-28 18:15:37 +0200 |
|---|---|---|
| committer | wm4 <wm4@nowhere> | 2016-08-28 18:26:59 +0200 |
| commit | 5086b2d4568bfd8b39a4418a2db4dbfbb1fae92f (patch) | |
| tree | 32488fc28c014e96a83c575eb728443020f5557c /DOCS | |
| parent | 7af6e64db748f71b472cd2b70ef7ebbe9da97859 (diff) | |
| download | mpv-5086b2d4568bfd8b39a4418a2db4dbfbb1fae92f.tar.bz2 mpv-5086b2d4568bfd8b39a4418a2db4dbfbb1fae92f.tar.xz | |
player: add option to disable video OSD
Normally, OSD can be disabled with --osd-level=0. But this also disables
terminal OSD, and some users want _only_ the terminal OSD. Add
--video-osd=no, which essentially disables the video OSD.
Ideally, it should probably be possible to control terminal and video
OSD levels independently, but that would require separate OSD timers
(and other state) for both components, so don't do it. But because the
current situation isn't too ideal, add a threat to the manpage that
might be changed in the future.
Fixes #3387.
Diffstat (limited to 'DOCS')
| -rw-r--r-- | DOCS/man/options.rst | 23 |
1 files changed, 19 insertions, 4 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index ec8f82349d..7cc66dcb8d 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -2890,6 +2890,17 @@ OSD Default: 0. +``--video-osd=<yes|no>`` + Enabled OSD rendering on the video window (default: yes). This can be used + in situations where terminal OSD is preferred. If you just want to disable + all OSD rendering, use ``--osd-level=0``. + + It does not affect subtitles or overlays created by scripts (in particular, + the OSC needs to be disabled with ``--no-osc``). + + This option is somewhat experimental and could be replaced by another + mechanism in the future. + Screenshot ---------- @@ -3136,11 +3147,15 @@ Terminal Only show warnings or worse, and let the ao_alsa output show errors only. -``--term-osd, --no-term-osd``, ``--term-osd=force`` - Display OSD messages on the console when no video output is available. - Enabled by default. +``--term-osd=<auto|no|force>`` + Control whether OSD messages are shown on the console when no video output + is available (default: auto). + + :auto: use terminal OSD if no video output active + :no: disable terminal OSD + :force: use terminal OSD even if video output active - ``force`` enables terminal OSD even if a video window is created. + The ``auto`` mode also enables terminal OSD if ``--video-osd=no`` was set. ``--term-osd-bar``, ``--no-term-osd-bar`` Enable printing a progress bar under the status line on the terminal. |