diff options
author | archenemies <frederik-github@ofb.net> | 2016-01-23 22:17:12 -0800 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2016-01-31 00:12:45 +0100 |
commit | 006c9694c0990a05eb8f967448489958b6d7a5e8 (patch) | |
tree | 7d3be359841d1be05d8ed7368cb94e46f51b7e28 | |
parent | ca9124cd07100b94d99563ff4d1a5df0bdad6eab (diff) | |
download | mpv-006c9694c0990a05eb8f967448489958b6d7a5e8.tar.bz2 mpv-006c9694c0990a05eb8f967448489958b6d7a5e8.tar.xz |
DOCS: explain about DVD situation in man page.
Explains libdvdnav vs libdvdread situation (as much as I know),
workarounds for bugs, and limitations of image-based subtitles.
(try #4)
-rw-r--r-- | DOCS/man/mpv.rst | 39 |
1 files changed, 39 insertions, 0 deletions
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst index 84c5247d2f..ec188d7bd5 100644 --- a/DOCS/man/mpv.rst +++ b/DOCS/man/mpv.rst @@ -381,6 +381,45 @@ file stops playing. If option ``--c`` is changed during playback of ``file2.mkv``, it is reset when advancing to ``file3.mkv``. This only affects file-local options. The option ``--a`` is never reset here. + +Playing DVDs +------------ + +DVDs can be played with the ``dvd://[title]`` syntax. The optional +title specifier is a number which selects between separate video +streams on the DVD. If no title is given (``dvd://``) then the longest +title is selected automatically by the library. This is usually what +you want. mpv does not support DVD menus. + +DVDs which have been copied on to a hard drive or other mounted +filesystem (by e.g. the ``dvdbackup`` tool) are accommodated by +specifying the path to the local copy: ``--dvd-device=PATH``. +Alternatively, running ``mpv PATH`` should auto-detect a DVD directory +tree and play the longest title. + +.. note:: + + mpv uses a different default DVD library than MPlayer. MPlayer + uses libdvdread by default, and mpv uses libdvdnav by default. + Both libraries are developed in parallel, but libdvdnav is + intended to support more sophisticated DVD features such as menus + and multi-angle playback. mpv uses libdvdnav for files specified + as either ``dvd://...`` or ``dvdnav://...``. To use libdvdread, + which will produce behavior more like MPlayer, specify + ``dvdread://...`` instead. Some users have experienced problems + when using libdvdnav, in which playback gets stuck in a DVD menu + stream. These problems are reported to go away when auto-selecting + the title (``dvd://`` rather than ``dvd://1``) or when using + libdvdread (e.g. ``dvdread://0``). + + DVDs use image-based subtitles. Image subtitles are implemented as + a bitmap video stream which can be superimposed over the main + movie. mpv's subtitle styling and positioning options and keyboard + shortcuts generally do not work with image-based subtitles. + Exceptions include options like ``--stretch-dvd-subs`` and + ``--stretch-image-subs-to-screen``. + + CONFIGURATION FILES =================== |