mpv/DOCS/man
Niklas Haas dd78cc6fe7 vo_opengl: refactor vo performance subsystem
This replaces `vo-performance` by `vo-passes`, bringing with it a number
of changes and improvements:

1. mpv users can now introspect the vo_opengl passes, which is something
   that has been requested multiple times.

2. performance data is now measured per-pass, which helps both
   development and debugging.

3. since adding more passes is cheap, we can now report information for
   more passes (e.g. the blit pass, and the osd pass). Note: we also
   switch to nanosecond scale, to be able to measure these passes
   better.

4. `--user-shaders` authors can now describe their own passes, helping
   users both identify which user shaders are active at any given time
   as well as helping shader authors identify performance issues.

5. the timing data per pass is now exported as a full list of samples,
   so projects like Argon-/mpv-stats can immediately read out all of the
   samples and render a graph without having to manually poll this
   option constantly.

Due to gl_timer's design being complicated (directly reading performance
data would block, so we delay the actual read-back until the next _start
command), it's vital not to conflate different passes that might be
doing different things from one frame to another. To accomplish this,
the actual timers are stored as part of the gl_shader_cache's sc_entry,
which makes them unique for that exact shader.

Starting and stopping the time measurement is easy to unify with the
gl_sc architecture, because the existing API already relies on a
"generate, render, reset" flow, so we can just put timer_start and
timer_stop in sc_generate and sc_reset, respectively.

The ugliest thing about this code is that due to the need to keep pass
information relatively stable in between frames, we need to distinguish
between "new" and "redrawn" frames, which bloats the code somewhat and
also feels hacky and vo_opengl-specific. (But then again, this entire
thing is vo_opengl-specific)
2017-07-01 00:58:27 +02:00
..
af.rst af, vf: improvements to libavfilter bridge 2017-05-31 17:42:55 +02:00
ao.rst ao_coreaudio: insane hack for passing through AC3 as float PCM 2017-06-30 09:06:01 +02:00
changes.rst manpage: mention the client API/interface change logs 2016-09-02 09:48:35 +02:00
encode.rst
input.rst vo_opengl: refactor vo performance subsystem 2017-07-01 00:58:27 +02:00
ipc.rst manpage: document tricky issue with IPC observe_property command 2017-05-16 12:20:39 +02:00
javascript.rst js: add javascript scripting support using MuJS 2017-06-14 12:29:32 +02:00
libmpv.rst manpage: define stricter rules for C plugin return values 2017-01-14 17:41:04 +01:00
lua.rst manpage: replace gendered pronouns 2017-04-19 16:05:56 +02:00
mpv.rst options: change path list options, and document list options 2017-06-30 16:39:36 +02:00
options.rst vo_opengl: refactor vo performance subsystem 2017-07-01 00:58:27 +02:00
osc.rst osc: add user_opts.boxmaxchars for box layout title limit 2017-04-19 20:35:58 +01:00
vf.rst vo_opengl: implement sony s-log2 trc 2017-06-18 20:54:44 +02:00
vo.rst image_writer, vo_image: change license to LGPL 2017-06-18 15:45:24 +02:00