summaryrefslogtreecommitdiffstats
path: root/DOCS/man/vo.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2015-03-29 15:12:11 +0200
committerwm4 <wm4@nowhere>2015-03-29 16:09:56 +0200
commit8fff12542279960ff6e0a14f186d5c4c4d2bdfe4 (patch)
treec14e7d25ece5613d91cb507d40872a63825dfc2d /DOCS/man/vo.rst
parent38b05daf7d16898f4a63e4ccf48479d8964e6e19 (diff)
downloadmpv-8fff12542279960ff6e0a14f186d5c4c4d2bdfe4.tar.bz2
mpv-8fff12542279960ff6e0a14f186d5c4c4d2bdfe4.tar.xz
RPI support
This requires FFmpeg git master for accelerated hardware decoding. Keep in mind that FFmpeg must be compiled with --enable-mmal. Libav will also work. Most things work. Screenshots don't work with accelerated/opaque decoding (except using full window screenshot mode). Subtitles are very slow - even simple but huge overlays can cause frame drops. This always uses fullscreen mode. It uses dispmanx and mmal directly, and there are no window managers or anything on this level. vo_opengl also kind of works, but is pretty useless and slow. It can't use opaque hardware decoding (copy back can be used by forcing the option --vd=lavc:h264_mmal). Keep in mind that the dispmanx backend is preferred over the X11 ones in case you're trying on X11; but X11 is even more useless on RPI. This doesn't correctly reject extended h264 profiles and thus doesn't fallback to software decoding. The hw supports only up to the high profile, and will e.g. return garbage for Hi10P video. This sets a precedent of enabling hw decoding by default, but only if RPI support is compiled (which most hopefully it will be disabled on desktop Linux platforms). While it's more or less required to use hw decoding on the weak RPI, it causes more problems than it solves on real platforms (Linux has the Intel GPU problem, OSX still has some cases with broken decoding.) So I can live with this compromise of having different defaults depending on the platform. Raspberry Pi 2 is required. This wasn't tested on the original RPI, though at least decoding itself seems to work (but full playback was not tested).
Diffstat (limited to 'DOCS/man/vo.rst')
-rw-r--r--DOCS/man/vo.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/DOCS/man/vo.rst b/DOCS/man/vo.rst
index 7ac4cfe367..d0fe3c070a 100644
--- a/DOCS/man/vo.rst
+++ b/DOCS/man/vo.rst
@@ -866,3 +866,16 @@ Available video output drivers are:
``mpv --vo=opengl-cb:help`` for a list.
This also supports the ``vo_cmdline`` command.
+
+``rpi`` (Raspberry Pi)
+ Native video output on the Raspberry Pi using the MMAL API.
+
+ ``display=<number>``
+ Select the display number on which the video overlay should be shown
+ (default: 0).
+
+ ``layer=<number>``
+ Select the dispmanx layer on which the video overlay should be shown
+ (default: -10). Note that mpv will also use the 2 layers above the
+ selected layer, to handle the window background and OSD. Actual video
+ rendering will happen on the layer above the selected layer.