aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS
diff options
context:
space:
mode:
authorGravatar wm4 <wm4@nowhere>2015-09-29 21:12:26 +0200
committerGravatar wm4 <wm4@nowhere>2015-09-29 21:12:26 +0200
commitee63c9c210683df9cbf17f7bbc5f4de8725260f3 (patch)
tree4079022e388fb4ff4bf0dfefe03f0f4d3cffbe0c /DOCS
parentb4491c00c4b514e925b6bbf501e26de801f28a39 (diff)
video: replace vf_format outputlevels option with global option
The vf_format suboption is replaced with --video-output-levels (a global option and property). In particular, the parameter is removed from mp_image_params. The mechanism is moved to the "video equalizer", which also handles common video output customization like brightness and contrast controls. The new code is slightly cleaner, and the top-level option is slightly more user-friendly than as vf_format sub-option.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst2
-rw-r--r--DOCS/man/input.rst4
-rw-r--r--DOCS/man/options.rst20
-rw-r--r--DOCS/man/vf.rst20
4 files changed, 24 insertions, 22 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 476932df26..2bdf8e25d9 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -20,6 +20,8 @@ Interface changes
::
--- mpv 0.12.0 ---
+ - replace vf_format outputlevels suboption with "video-output-levels" global
+ property/option; also remove "colormatrix-output-range" property
- vo_opengl: remove sharpen3/sharpen5 scale filters, add sharpen sub-option
--- mpv 0.11.0 ---
- add "af-metadata" property
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 3f4ed5c3dc..6d8f5f9d11 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -1260,8 +1260,8 @@ Property list
``colormatrix-input-range`` (R)
See ``colormatrix``.
-``colormatrix-output-range`` (R)
- See ``colormatrix``.
+``video-output-levels`` (RW)
+ See ``--video-output-levels``,
``colormatrix-primaries`` (R)
See ``colormatrix``.
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index cbbb9188fd..9784ee314f 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -774,6 +774,26 @@ Video
For audio-only playback, any value greater than 0 will quit playback
immediately after initialization. The value 0 works as with video.
+``--video-output-levels=<outputlevels>``
+ RGB color levels used with YUV to RGB conversion. Normally, output devices
+ such as PC monitors use full range color levels. However, some TVs and
+ video monitors expect studio RGB levels. Providing full range output to a
+ device expecting studio level input results in crushed blacks and whites,
+ the reverse in dim gray blacks and dim whites.
+
+ Not all VOs support this option. Some will silently ignore it.
+
+ Available color ranges are:
+
+ :auto: automatic selection (equals to full range) (default)
+ :limited: limited range (16-235 per component), studio levels
+ :full: full range (0-255 per component), PC levels
+
+ .. note::
+
+ It is advisable to use your graphics driver's color range option
+ instead, if available.
+
``--hwdec-codecs=<codec1,codec2,...|all>``
Allow hardware decoding for a given list of codecs only. The special value
``all`` always allows all codecs.
diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst
index f4453cb729..857ba1d881 100644
--- a/DOCS/man/vf.rst
+++ b/DOCS/man/vf.rst
@@ -259,26 +259,6 @@ Available filters are:
:limited: limited range (16-235 for luma, 16-240 for chroma)
:full: full range (0-255 for both luma and chroma)
- ``<outputlevels>``
- RGB color levels used with YUV to RGB conversion. Normally, output devices
- such as PC monitors use full range color levels. However, some TVs and
- video monitors expect studio RGB levels. Providing full range output to a
- device expecting studio level input results in crushed blacks and whites,
- the reverse in dim gray blacks and dim whites.
-
- The same limitations as with ``<colormatrix>`` apply.
-
- Available color ranges are:
-
- :auto: automatic selection (equals to full range) (default)
- :limited: limited range (16-235 per component), studio levels
- :full: full range (0-255 per component), PC levels
-
- .. note::
-
- It is advisable to use your graphics driver's color range option
- instead, if available.
-
``<primaries>``
RGB primaries the source file was encoded with. Normally this should be set
in the file header, but when playing broken or mistagged files this can be