diff options
Diffstat (limited to 'DOCS/man/stats.rst')
-rw-r--r-- | DOCS/man/stats.rst | 97 |
1 files changed, 85 insertions, 12 deletions
diff --git a/DOCS/man/stats.rst b/DOCS/man/stats.rst index 31cb7ee123..be46fe67f2 100644 --- a/DOCS/man/stats.rst +++ b/DOCS/man/stats.rst @@ -22,7 +22,17 @@ stats: ==== ================== 1 Show usual stats -2 Show frame timings +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 @@ -42,20 +52,28 @@ option. The configuration syntax is described in `ON SCREEN CONTROLLER`_. Configurable Options ~~~~~~~~~~~~~~~~~~~~ -``key_oneshot`` - Default: i -``key_toggle`` - Default: I - - Key bindings to display stats. - ``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 @@ -149,14 +167,69 @@ Note: colors are given as hexadecimal values and use ASS tag order: BBGGRR Different key bindings ~~~~~~~~~~~~~~~~~~~~~~ -A different key binding can be defined with the aforementioned options -``key_oneshot`` and ``key_toggle`` but also with commands in ``input.conf``, -for example:: +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 -Using ``input.conf``, it is also possible to directly display a certain page:: +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). |