diff options
author | Anton Kindestam <antonki@kth.se> | 2018-12-01 12:01:17 +0100 |
---|---|---|
committer | Jan Ekström <jeebjp@gmail.com> | 2018-12-01 15:42:20 +0200 |
commit | f0509d3738ec37cfa4afa81f070c8abd876e6561 (patch) | |
tree | cc2a7c485c01825b01b66e8277d4750bb9f23bf5 /DOCS/interface-changes.rst | |
parent | c151fae054d12ef9b392f5b6dcc1bafe894005b0 (diff) | |
download | mpv-f0509d3738ec37cfa4afa81f070c8abd876e6561.tar.bz2 mpv-f0509d3738ec37cfa4afa81f070c8abd876e6561.tar.xz |
drm: rename plane options to better, invariant, names
This commit bumps the libmpv version to 1.102
drm-osd-plane -> drm-draw-plane
drm-video-plane -> drm-drmprime-video-plane
drm-osd-size -> drm-draw-surface-size
"draw plane", as in the plane that OpenGL draws to, whether it be
video + OSD or just OSD.
"drmprime video plane", as in the plane used for hwdec video imported
via drmprime.
"draw surface size", as in the size of the surface used for the draw plane
The new names are invariant whether or not hwdec_drmprime_drm is being
used or not. The original naming was very confusing, as when doing
regular rendering (swdec or vaapi) the video would be displayed on the
"OSD plane", and the "Video plane" would remain unused.
Diffstat (limited to 'DOCS/interface-changes.rst')
-rw-r--r-- | DOCS/interface-changes.rst | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index f7ed1597ab..26f39beba7 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -20,9 +20,16 @@ Interface changes :: --- mpv 0.30.0 --- - - the `--drm-osd-plane-id` and `--drm-video-plane-id` + - rename `--drm-osd-plane-id` to `--drm-draw-plane`, `--drm-video-plane-id` to + `--drm-drmprime-video-plane` and `--drm-osd-size` to `--drm-draw-surface-size` + to better reflect what the options actually control, that the values they + accept aren't actually internal DRM ID's (like with similar options in + ffmpeg's KMS support), and that the video plane is only used when the drmprime + overlay hwdec interop is active, with the video being drawn to the draw plane + otherwise. + - in addition to the above, the `--drm-draw-plane` and `--drm-drmprime-video-plane` options now accept either an integer index, or the values primary or overlay. - `--drm-osd-plane-id` now defaults to primary and `--drm-video-plane-id` + `--drm-draw-plane` now defaults to primary and `--drm-drmprime-video-plane` defaults to overlay. This should be similar to previous behavior on most drivers due to how planes are usually sorted. - rename --opensles-frames-per-buffer to --opensles-frames-per-enqueue to |