mpv/DOCS/man
wm4 0728726251 client API, lua: add new API for setting OSD overlays
Lua scripting has an undocumented mp.set_osd_ass() function, which is
used by osc.lua and console.lua. Apparently, 3rd party scripts also use
this. It's probably time to make this a public API.

The Lua implementation just bypassed the libmpv API. To make it usable
by any type of client, turn it into a command, "osd-overlay".

There's already a "overlay-add". Ignore it (although the manpage admits
guiltiness). I don't really want to deal with that old command. Its main
problem is that it uses global IDs, while I'd like to avoid that scripts
mess with each others overlays (whether that is accidentally or
intentionally). Maybe "overlay-add" can eventually be merged into
"osd-overlay", but I'm too lazy to do that now.

Scripting now uses the commands. There is a helper to manage OSD
overlays. The helper is very "thin"; I only want to force script authors
to use the ID allocation, which may help with putting multiple scripts
into a single .lua file without causing conflicts (basically, avoiding
singletons within a script's environment). The old set_osd_ass() is
emulated with the new API.

The JS scripting wrapper also provides a set_osd_ass() function, which
calls internal mpv API. Comment that part (to keep it compiling), but
I'm leaving it to @avih to finish the change.
2019-12-23 11:44:24 +01:00
..
af.rst audio: remove unreferenced af_lavrresample 2019-09-19 20:37:05 +02:00
ao.rst ao_pulse: add --pulse-allow-suspended 2019-09-21 12:54:36 +02:00
changes.rst
console.rst console: use hidpi scale reporting 2019-12-20 13:00:39 +01:00
encode.rst options: increase consistency between list options and document them 2019-12-18 05:32:02 +01:00
input.rst client API, lua: add new API for setting OSD overlays 2019-12-23 11:44:24 +01:00
ipc.rst ipc: alias set_property_string to set_property 2018-05-25 10:45:59 +02:00
javascript.rst js: read_options: on_update: don't re-read the config file 2019-12-22 14:51:13 +02:00
libmpv.rst manpage: define stricter rules for C plugin return values 2017-01-14 17:41:04 +01:00
lua.rst client API, lua: add new API for setting OSD overlays 2019-12-23 11:44:24 +01:00
mpv.rst manpage: add osc and console default keys to keyboard control section 2019-12-20 13:00:39 +01:00
options.rst video/out/x11: add fs-screen fallback 2019-12-22 02:33:48 +01:00
osc.rst manpage: document that --vo=xv breaks "boxvideo" 2019-12-23 11:11:24 +01:00
stats.rst manpage: document stats page 3 2019-10-31 11:06:22 +01:00
vf.rst options: deprecate -del for list options 2019-12-18 06:57:24 +01:00
vo.rst sws_utils, zimg: destroy vo_x11 and vo_drm performance 2019-10-31 16:51:12 +01:00