summaryrefslogtreecommitdiffstats
path: root/DOCS/man/options.rst
diff options
context:
space:
mode:
authorNiklas Haas <git@haasn.dev>2023-11-19 14:39:02 +0100
committersfan5 <sfan5@live.de>2023-11-20 17:32:40 +0100
commit8faa0abae8270aedee8972070cd7c83b1cb0a095 (patch)
tree0d7c3d270e22843495edab99bec083694607e639 /DOCS/man/options.rst
parentd40e623fd5c27544bd9af7b749b44cfa41f0f2fa (diff)
downloadmpv-8faa0abae8270aedee8972070cd7c83b1cb0a095.tar.bz2
mpv-8faa0abae8270aedee8972070cd7c83b1cb0a095.tar.xz
DOCS/options: admonish users for touching --3dlut-size
The "auto" logic is vastly better than setting a specific size. This option amounts to "allow users to shoot themselves in the foot" flag, given that the vast majority of ICC profiles in the wild are fine on 17x17x17 or even smaller 3DLUTs. Setting stupidly high --3dlut-size is the main source of ICC-related slow startup issues, and there is absolutely no conceivably benefit to going above the defaults except for pixel peeping and chasing tiny PSNR increments.
Diffstat (limited to 'DOCS/man/options.rst')
-rw-r--r--DOCS/man/options.rst7
1 files changed, 5 insertions, 2 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index bfb41cfcab..e0445d4654 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -6838,8 +6838,11 @@ them.
``--icc-3dlut-size=<auto|RxGxB>``
Size of the 3D LUT generated from the ICC profile in each dimension. The
- default of ``auto`` means to pick the size automatically based on internal
- heuristics. Sizes may range from 2 to 512.
+ default of ``auto`` means to pick the size automatically based on the
+ profile characteristics. Sizes may range from 2 to 512.
+
+ NOTE: Setting this option to anything other than ``auto`` is **strongly**
+ discouraged, except for testing.
``--icc-force-contrast=<no|0-1000000|inf>``
Override the target device's detected contrast ratio by a specific value.