diff options
author | wm4 <wm4@nowhere> | 2014-11-13 18:00:07 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2014-11-13 18:01:27 +0100 |
commit | 5d12a2696e87c9ab5a92e55b01972d543b7661d9 (patch) | |
tree | 4eef361086e965107d45cdbfc71c82e328a2dc69 /DOCS/man/input.rst | |
parent | 71168e740e028dc33e22652589b095e870888615 (diff) | |
download | mpv-5d12a2696e87c9ab5a92e55b01972d543b7661d9.tar.bz2 mpv-5d12a2696e87c9ab5a92e55b01972d543b7661d9.tar.xz |
command: export some option metadata
This might be interesting for GUIs and such.
It's probably still a little bit insufficient. For example, the filter
and audio/video output lists are not available through this.
Diffstat (limited to 'DOCS/man/input.rst')
-rw-r--r-- | DOCS/man/input.rst | 25 |
1 files changed, 24 insertions, 1 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index db544d3ddd..65e734187a 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -1446,7 +1446,15 @@ Property list Additional per-option information. This has a number of sub-properties. Replace ``<name>`` with the name of - a top-level option. + a top-level option. No guarantee of stability is given to any of these + sub-properties - they may change radically in the feature. + + ``option-info/<name>/name`` + Returns the name of the option. + + ``option-info/<name>/type`` + Return the name of the option type, like ``String`` or ``Integer``. + For many complex types, this isn't very accurate. ``option-info/<name>/set-from-commandline`` @@ -1454,6 +1462,21 @@ Property list ``no`` otherwise. What this is set to if the option is e.g. changed at runtime is left undefined (meaning it could change in the future). + ``option-info/<name>/default-value`` + The default value of the option. May not always be available. + + ``option-info/<name>/min``, ``option-info/<name>/max`` + Integer minimum and maximum values allowed for the option. Only + available if the options are numeric, and the minimum/maximum has been + set internally. It's also possible that only one of these is set. + + ``option-info/<name>/choices`` + If the option is a choice option, the possible choices. Choices that + are integers may or may not be included (they can be implied by ``min`` + and ``max``). Note that options which behave like choice options, but + are not actual choice options internally, may not have this info + available. + ``property-list`` Return the list of top-level properties. |