summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/input.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2014-03-30 19:09:31 +0200
committerwm4 <wm4@nowhere>2014-03-30 19:21:33 +0200
commit392997fa109ec8b6431b16af070cc2dbd043ae8f (patch)
tree41233f1c723898561855b559c116935c4d5680e8 /DOCS/man/en/input.rst
parent3fe6426ae0a6c2cd926d37e8b3c704963a573056 (diff)
downloadmpv-392997fa109ec8b6431b16af070cc2dbd043ae8f.tar.bz2
mpv-392997fa109ec8b6431b16af070cc2dbd043ae8f.tar.xz
command: change what the metadata property returns
Change the type of the property from a string list (alternating key/value entries) to a map. Using the client API, this will return MPV_FORMAT_NODE_MAP, while Lua mp.get_property_native returns a dictionary-like table.
Diffstat (limited to 'DOCS/man/en/input.rst')
-rw-r--r--DOCS/man/en/input.rst12
1 files changed, 9 insertions, 3 deletions
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 5d383b4f28..6fe4c90759 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -662,9 +662,15 @@ an option at runtime.
Current DVD angle.
``metadata``
- Metadata key/value pairs. The raw property value will return a list of
- key and value strings separated by ``,``. (If a key or value contains ``,``,
- you're screwed.)
+ Metadata key/value pairs.
+
+ If the property is accessed with Lua's ``mp.get_property_native``, this
+ returns a table with metadata keys mapping to metadata values. If it is
+ accessed with the client API, this returns a ``MPV_FORMAT_NODE_MAP``,
+ with tag keys mapping to tag values.
+
+ For OSD, it returns a formatted list. Trying to retrieve this property as
+ a raw string doesn't work.
This has a number of sub-properties: