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.
This commit is contained in:
Niklas Haas 2023-11-19 14:39:02 +01:00 committed by sfan5
parent d40e623fd5
commit 8faa0abae8
1 changed files with 5 additions and 2 deletions

View File

@ -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.