mirror of https://github.com/mpv-player/mpv
236 lines
6.8 KiB
ReStructuredText
236 lines
6.8 KiB
ReStructuredText
STATS
|
|
=====
|
|
|
|
This builtin script displays information and statistics for the currently
|
|
played file. It is enabled by default if mpv was compiled with Lua support.
|
|
It can be disabled entirely using the ``--load-stats-overlay=no`` option.
|
|
|
|
Usage
|
|
-----
|
|
|
|
The following key bindings are active by default unless something else is
|
|
already bound to them:
|
|
|
|
==== ==============================================
|
|
i Show stats for a fixed duration
|
|
I Toggle stats (shown until toggled again)
|
|
==== ==============================================
|
|
|
|
While the stats are visible on screen the following key bindings are active,
|
|
regardless of existing bindings. They allow you to switch between *pages* of
|
|
stats:
|
|
|
|
==== ==================
|
|
1 Show usual stats
|
|
2 Show frame timings (scroll)
|
|
3 Input cache stats
|
|
4 Active key bindings (scroll)
|
|
0 Internal stuff (scroll)
|
|
==== ==================
|
|
|
|
On pages which support scroll, these key bindings are also active:
|
|
|
|
==== ==================
|
|
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.
|
|
|
|
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`_.
|
|
|
|
Configurable Options
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
``key_page_1``
|
|
Default: 1
|
|
``key_page_2``
|
|
Default: 2
|
|
``key_page_3``
|
|
Default: 3
|
|
``key_page_4``
|
|
Default: 4
|
|
``key_page_0``
|
|
Default: 0
|
|
|
|
Key bindings for page switching while stats are displayed.
|
|
|
|
``key_scroll_up``
|
|
Default: UP
|
|
``key_scroll_down``
|
|
Default: DOWN
|
|
``scroll_lines``
|
|
Default: 1
|
|
|
|
Scroll key bindings and number of lines to scroll on pages which support it.
|
|
|
|
``duration``
|
|
Default: 4
|
|
|
|
How long the stats are shown in seconds (oneshot).
|
|
|
|
``redraw_delay``
|
|
Default: 1
|
|
|
|
How long it takes to refresh the displayed stats in seconds (toggling).
|
|
|
|
``persistent_overlay``
|
|
Default: no
|
|
|
|
When `no`, other scripts printing text to the screen can overwrite the
|
|
displayed stats. When `yes`, displayed stats are persistently shown for the
|
|
respective duration. This can result in overlapping text when multiple
|
|
scripts decide to print text at the same time.
|
|
|
|
``plot_perfdata``
|
|
Default: yes
|
|
|
|
Show graphs for performance data (page 2).
|
|
|
|
``plot_vsync_ratio``
|
|
Default: yes
|
|
``plot_vsync_jitter``
|
|
Default: yes
|
|
|
|
Show graphs for vsync and jitter values (page 1). Only when toggled.
|
|
|
|
``flush_graph_data``
|
|
Default: yes
|
|
|
|
Clear data buffers used for drawing graphs when toggling.
|
|
|
|
``font``
|
|
Default: Source Sans Pro
|
|
|
|
Font name. Should support as many font weights as possible for optimal
|
|
visual experience.
|
|
|
|
``font_mono``
|
|
Default: Source Sans Pro
|
|
|
|
Font name for parts where monospaced characters are necessary to align
|
|
text. Currently, monospaced digits are sufficient.
|
|
|
|
``font_size``
|
|
Default: 8
|
|
|
|
Font size used to render text.
|
|
|
|
``font_color``
|
|
Default: FFFFFF
|
|
|
|
Font color.
|
|
|
|
``border_size``
|
|
Default: 0.8
|
|
|
|
Size of border drawn around the font.
|
|
|
|
``border_color``
|
|
Default: 262626
|
|
|
|
Color of drawn border.
|
|
|
|
``alpha``
|
|
Default: 11
|
|
|
|
Transparency for drawn text.
|
|
|
|
``plot_bg_border_color``
|
|
Default: 0000FF
|
|
|
|
Border color used for drawing graphs.
|
|
|
|
``plot_bg_color``
|
|
Default: 262626
|
|
|
|
Background color used for drawing graphs.
|
|
|
|
``plot_color``
|
|
Default: FFFFFF
|
|
|
|
Color used for drawing graphs.
|
|
|
|
Note: colors are given as hexadecimal values and use ASS tag order: BBGGRR
|
|
(blue green red).
|
|
|
|
Different key bindings
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Additional keys can be configured in ``input.conf`` to display the stats::
|
|
|
|
e script-binding stats/display-stats
|
|
E script-binding stats/display-stats-toggle
|
|
|
|
And to display a certain page directly::
|
|
|
|
i script-binding stats/display-page-1
|
|
e script-binding stats/display-page-2
|
|
|
|
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
|
|
detailed view of each binding.
|
|
|
|
The keys are grouped automatically using a simple analysis of the command
|
|
string, and one should not expect documentation-level grouping accuracy,
|
|
however, it should still be reasonably useful.
|
|
|
|
Using ``--idle --script-opts=stats-bindlist=yes`` will print the list to the
|
|
terminal and quit immediately. By default long lines are shortened to 79 chars,
|
|
and terminal escape sequences are enabled. A different length limit can be
|
|
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.
|
|
|
|
Internal stuff page
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
Most entries shown on this page have rather vague meaning. Likely none of this
|
|
is useful for you. Don't attempt to use it. Forget its existence.
|
|
|
|
Selecting this for the first time will start collecting some internal
|
|
performance data. That means performance will be slightly lower than normal for
|
|
the rest of the time the player is running (even if the stats page is closed).
|
|
Note that the stats page itself uses a lot of CPU and even GPU resources, and
|
|
may have a heavy impact on performance.
|
|
|
|
The displayed information is accumulated over the redraw delay (shown as
|
|
``poll-time`` field).
|
|
|
|
This adds entries for each Lua script. If there are too many scripts running,
|
|
parts of the list will simply be out of the screen, but it can be scrolled.
|
|
|
|
If the underlying platform does not support pthread per thread times, the
|
|
displayed times will be 0 or something random (I suspect that at time of this
|
|
writing, only Linux provides the correct via pthread APIs for per thread times).
|
|
|
|
Most entries are added lazily and only during data collection, which is why
|
|
entries may pop up randomly after some time. It's also why the memory usage
|
|
entries for scripts that have been inactive since the start of data collection
|
|
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.
|
|
|
|
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
|
|
corresponding pthread API works and is supported).
|