From ea2b19f64673a975a6bafe3292d26eab51142a5f Mon Sep 17 00:00:00 2001 From: wm4 Date: Thu, 18 Sep 2014 01:19:27 +0200 Subject: 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.) --- DOCS/man/options.rst | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'DOCS/man') 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=`` + 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=`` + Similar as ``--osd-msg1``, but for OSD level 2. If this is an empty string + (default), then the playback time is shown. + +``--osd-msg3=`` + 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=`` 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=`` Show a message on OSD when playback starts. The string is expanded for properties, e.g. ``--osd-playing-msg='file: ${filename}'`` will show the -- cgit v1.2.3