command, dvd: add property which returns list of DVD titles

This was requested.

It seems libdvdread can't get the duration for titlesets other than the
currently opened title. The data structures contain dangling pointers
for these, and MPlayer works this around by opening every title
separately for the purpose of dumping the title list.

1 files changed, 27 insertions, 0 deletions

diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index dd2c20bee3..5bfa7c3150 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -773,6 +773,33 @@ Property list
 ``disc-titles``
     Number of BD/DVD titles.
 
+    This has a number of sub-properties. Replace ``N`` with the 0-based edition
+    index.
+
+    ``disc-titles/count``
+        Number of titles.
+
+    ``disc-titles/id``
+        Title ID as integer. Currently, this is the same as the title index.
+
+    ``disc-titles/length``
+        Length in seconds. Can be unavailable in a number of cases (currently
+        it works for libdvdnav only).
+
+    When querying the property with the client API using ``MPV_FORMAT_NODE``,
+    or with Lua ``mp.get_property_native``, this will return a mpv_node with
+    the following contents:
+
+    ::
+
+        MPV_FORMAT_NODE_ARRAY
+            MPV_FORMAT_NODE_MAP (for each edition)
+                "id"                MPV_FORMAT_INT64
+                "length"            MPV_FORMAT_DOUBLE
+
+``disc-title-list``
+    List of BD/DVD titles.
+
 ``disc-title`` (RW)
     Current BD/DVD title number. Writing works only for ``dvdnav://`` and
     ``bd://`` (and aliases for these).