diff options
author | wm4 <wm4@nowhere> | 2014-09-18 01:19:27 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2014-09-18 01:23:33 +0200 |
commit | ea2b19f64673a975a6bafe3292d26eab51142a5f (patch) | |
tree | a93fc536215ba676f3d182f452b1bac0a3c2c20a /DOCS | |
parent | 6c3d25e6f5f09a110ad0fffaeeea6a65ee5d228b (diff) | |
download | mpv-ea2b19f64673a975a6bafe3292d26eab51142a5f.tar.bz2 mpv-ea2b19f64673a975a6bafe3292d26eab51142a5f.tar.xz |
player: allow overriding OSD message for all OSD levels
Until now, you could override only level 3 with --osd-status-msg. Extend
this, add add --osd-msg1 to --osd-msg3 (one for each OSD level). OSD
level 0 always means disable OSD, so that isn't included.
--osd-msg3 corresponds to --osd-status-msg, but they're not exactly the
same. To allow more customization, --osd-msgN do not include the OSD
symbol. The symbol can be manually added with "${osd-sym-cc}". We keep
the "old" option for some short-term compatibility.
--osd-msg1 should be particularly useful; for example you could do:
--osd-msg1='${?pause==yes:${osd-sym-cc}}'
to display a "paused" symbol when paused, and nothing during normal
playback. (Although admittedly, the syntax is quite a bit of work.)
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 2a1bf8ded1..a0e5f59a41 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -2197,6 +2197,26 @@ OSD Default: 45. +``--osd-msg1=<string>`` + Show this string as message on OSD with OSD level 1 (visible by default). + The message will be visible by default, and as long no other message + covers it, and the OSD level isn't changed (see ``--osd-level``). + Expands properties; see `Property Expansion`_. + +``--osd-msg2=<string>`` + Similar as ``--osd-msg1``, but for OSD level 2. If this is an empty string + (default), then the playback time is shown. + +``--osd-msg3=<string>`` + Similar as ``--osd-msg1``, but for OSD level 3. If this is an empty string + (default), then the playback time, duration, and some more information is + shown. + + This is also used for the ``show_progress`` command (by default mapped to + ``P``), or in some non-default cases when seeking. + + ``--osd-status-msg`` is a legacy equivalent (but with a minor difference). + ``--osd-status-msg=<string>`` Show a custom string during playback instead of the standard status text. This overrides the status text used for ``--osd-level=3``, when using the @@ -2204,6 +2224,10 @@ OSD non-default cases when seeking. Expands properties. See `Property Expansion`_. + This option has been replaced with ``--osd-msg3``. The only difference is + that this option implicitly includes ``${osd-sym-cc}``. This option is + ignored if ``--osd-msg3`` is not empty. + ``--osd-playing-msg=<string>`` Show a message on OSD when playback starts. The string is expanded for properties, e.g. ``--osd-playing-msg='file: ${filename}'`` will show the |