summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorNiklas Haas <git@haasn.xyz>2018-10-17 11:23:16 +0200
committersfan5 <sfan5@live.de>2018-10-19 22:58:01 +0200
commit7ad60a7c5e8dd05e6097fd24e43d0f3458201eeb (patch)
tree7280f18b1a748b81354357465676edc8c0a84179 /DOCS/man
parent448cbd472ef8154704e6ae2c0b88464b2bba54f4 (diff)
downloadmpv-7ad60a7c5e8dd05e6097fd24e43d0f3458201eeb.tar.bz2
mpv-7ad60a7c5e8dd05e6097fd24e43d0f3458201eeb.tar.xz
vo_gpu: split --linear-scaling into two separate options
Since linear downscaling makes sense to handle independently from linear/sigmoid upscaling, we split this option up. Now, linear-downscaling is its own option that only controls linearization when downscaling and nothing more. Likewise, linear-upscaling / sigmoid-upscaling are two mutually exclusive options (the latter overriding the former) that apply only to upscaling and no longer implicitly enable linear light downscaling as well. The old behavior was very confusing, as evidenced by issues such as #6213. The current behavior should make much more sense, and only minimally breaks backwards compatibility (since using linear-scaling directly was very uncommon - most users got this for free as part of gpu-hq and relied only on that). Closes #6213.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/options.rst46
1 files changed, 28 insertions, 18 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 53d293eb4d..19f972a891 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -4314,11 +4314,6 @@ The following video options are currently all specific to ``--vo=gpu`` and
will reproduce the source image perfectly if no scaling is performed.
Enabled by default. Note that this option never affects ``--cscale``.
-``--linear-scaling``
- Scale in linear light. It should only be used with a
- ``--fbo-format`` that has at least 16 bit precision. This option
- has no effect on HDR content.
-
``--correct-downscaling``
When using convolution based filters, extend the filter size when
downscaling. Increases quality, but reduces performance while downscaling.
@@ -4327,6 +4322,32 @@ The following video options are currently all specific to ``--vo=gpu`` and
better than without it) since it will extend the size to match only the
milder of the scale factors between the axes.
+``--linear-downscaling``
+ Scale in linear light when downscaling. It should only be used with a
+ ``--fbo-format`` that has at least 16 bit precision. This option
+ has no effect on HDR content.
+
+``--linear-upscaling``
+ Scale in linear light when upscaling. Like ``--linear-downscaling``, it
+ should only be used with a ``--fbo-format`` that has at least 16 bits
+ precisions. This is not usually recommended except for testing/specific
+ purposes. Users are advised to either enable ``--sigmoid-upscaling`` or
+ keep both options disabled (i.e. scaling in gamma light).
+
+``--sigmoid-upscaling``
+ When upscaling, use a sigmoidal color transform to avoid emphasizing
+ ringing artifacts. This is incompatible with and replaces
+ ``--linear-upscaling``. (Note that sigmoidization also requires
+ linearization, so the ``LINEAR`` rendering step fires in both cases)
+
+``--sigmoid-center``
+ The center of the sigmoid curve used for ``--sigmoid-upscaling``, must be a
+ float between 0.0 and 1.0. Defaults to 0.75 if not specified.
+
+``--sigmoid-slope``
+ The slope of the sigmoid curve used for ``--sigmoid-upscaling``, must be a
+ float between 1.0 and 20.0. Defaults to 6.5 if not specified.
+
``--interpolation``
Reduce stuttering caused by mismatches in the video fps and display refresh
rate (also known as judder).
@@ -4715,7 +4736,8 @@ The following video options are currently all specific to ``--vo=gpu`` and
LINEAR (fixed)
Linear light image, before scaling. This only fires when
- ``--linear-scaling`` is in effect.
+ ``--linear-upscaling``, ``--linear-downscaling`` or
+ ``--sigmoid-upscaling`` is in effect.
SIGMOID (fixed)
Sigmoidized light, before scaling. This only fires when
@@ -4772,18 +4794,6 @@ The following video options are currently all specific to ``--vo=gpu`` and
remaining quantization artifacts. Higher numbers add more noise. (Default
48)
-``--sigmoid-upscaling``
- When upscaling, use a sigmoidal color transform to avoid emphasizing
- ringing artifacts. This also implies ``--linear-scaling``.
-
-``--sigmoid-center``
- The center of the sigmoid curve used for ``--sigmoid-upscaling``, must be a
- float between 0.0 and 1.0. Defaults to 0.75 if not specified.
-
-``--sigmoid-slope``
- The slope of the sigmoid curve used for ``--sigmoid-upscaling``, must be a
- float between 1.0 and 20.0. Defaults to 6.5 if not specified.
-
``--sharpen=<value>``
If set to a value other than 0, enable an unsharp masking filter. Positive
values will sharpen the image (but add more ringing and aliasing). Negative