diff options
Diffstat (limited to 'DOCS/man/stats.rst')
-rw-r--r-- | DOCS/man/stats.rst | 81 |
1 files changed, 63 insertions, 18 deletions
diff --git a/DOCS/man/stats.rst b/DOCS/man/stats.rst index 58d73b4072..30ce0796df 100644 --- a/DOCS/man/stats.rst +++ b/DOCS/man/stats.rst @@ -35,19 +35,15 @@ UP Scroll one line up DOWN Scroll one line down ==== ================== -Font -~~~~ - -For optimal visual experience, a font with support for many font weights and -monospaced digits is recommended. By default, the open source font -`Source Sans Pro <https://github.com/adobe-fonts/source-sans-pro>`_ is used. +Page 4 also binds ``/`` to search for input bindings by typing part of a binding +or command. Configuration ------------- This script can be customized through a config file ``script-opts/stats.conf`` placed in mpv's user directory and through the ``--script-opts`` command-line -option. The configuration syntax is described in `ON SCREEN CONTROLLER`_. +option. The configuration syntax is described in `mp.options functions`_. Configurable Options ~~~~~~~~~~~~~~~~~~~~ @@ -69,6 +65,8 @@ Configurable Options Default: UP ``key_scroll_down`` Default: DOWN +``key_scroll_search`` + Default: / ``scroll_lines`` Default: 1 @@ -92,6 +90,18 @@ Configurable Options respective duration. This can result in overlapping text when multiple scripts decide to print text at the same time. +``term_width_limit`` + Default: -1 + + Sets the terminal width. + A value of 0 means the width is infinite, -1 means it's automatic. + +``term_height_limit`` + Default: -1 + + Sets the terminal height. + A value of 0 means the height is infinite, -1 means it's automatic. + ``plot_perfdata`` Default: yes @@ -104,19 +114,24 @@ Configurable Options Show graphs for vsync and jitter values (page 1). Only when toggled. +``plot_tonemapping_lut`` + Default: no + + Enable tone-mapping LUT visualization automatically. Only when toggled. + ``flush_graph_data`` Default: yes Clear data buffers used for drawing graphs when toggling. ``font`` - Default: Source Sans Pro + Default: same as ``osd-font`` Font name. Should support as many font weights as possible for optimal visual experience. ``font_mono`` - Default: Source Sans Pro + Default: monospace Font name for parts where monospaced characters are necessary to align text. Currently, monospaced digits are sufficient. @@ -127,9 +142,9 @@ Configurable Options Font size used to render text. ``font_color`` - Default: FFFFFF + Default: same as ``osd-color`` - Font color. + Color of the text. ``border_size`` Default: 0.8 @@ -137,20 +152,42 @@ Configurable Options Size of border drawn around the font. ``border_color`` - Default: 262626 + Default: same as ``osd-border-color`` + + Color of the text border. - Color of drawn border. +``shadow_x_offset`` + Default: 0 + + The horizontal distance from the text to position the shadow at. + +``shadow_y_offset`` + Default: 0 + + The vertical distance from the text to position the shadow at. + +``shadow_color`` + Default: same as ``osd-shadow-color`` + + Color of the text shadow. ``alpha`` Default: 11 - Transparency for drawn text. + Transparency of text when ``font_color`` is specified, of text borders when + ``border_color`` is specified, and of text shadows when ``shadow_color`` is + specified. ``plot_bg_border_color`` Default: 0000FF Border color used for drawing graphs. +``plot_bg_border_width`` + Default: 0.5 + + Border width used for drawing graphs. + ``plot_bg_color`` Default: 262626 @@ -161,6 +198,14 @@ Configurable Options Color used for drawing graphs. +``vidscale`` + Default: auto + + Scale the text and graphs with the video. + ``no`` tries to keep the sizes constant. + ``auto`` scales the text and graphs with the OSD, which is scaled with the + window or kept at a constant size, depending on the ``--osd-scale-by-window`` option. + Note: colors are given as hexadecimal values and use ASS tag order: BBGGRR (blue green red). @@ -181,7 +226,7 @@ Active key bindings page ~~~~~~~~~~~~~~~~~~~~~~~~ Lists the active key bindings and the commands they're bound to, excluding the -interactive keys of the stats script itself. See also `--input-test`_ for more +interactive keys of the stats script itself. See also ``--input-test`` for more detailed view of each binding. The keys are grouped automatically using a simple analysis of the command @@ -195,7 +240,7 @@ set by changing ``yes`` to a number (at least 40), and escape sequences can be disabled by adding ``-`` before the value, e.g. ``...=-yes`` or ``...=-120``. Like with ``--input-test``, the list includes bindings from ``input.conf`` and -from user scripts. Use `--no-config`` to list only built-in bindings. +from user scripts. Use ``--no-config`` to list only built-in bindings. Internal stuff page ~~~~~~~~~~~~~~~~~~~ @@ -227,8 +272,8 @@ are missing. Memory usage is approximate and does not reflect internal fragmentation. JS scripts memory reporting is disabled by default because collecting the data -at the JS side has an overhead. It can be enabled by exporting the env var -``MPV_LEAK_REPORT=1`` before starting mpv, and will increase JS memory usage. +at the JS side has an overhead and will increase memory usage. It can be +enabled by setting the ``--js-memory-report`` option before starting mpv. If entries have ``/time`` and ``/cpu`` variants, the former gives the real time (monotonic clock), while the latter the thread CPU time (only if the |