Document negative saturation (#15062)

This commit is contained in:
nauta-turbidus 2024-09-12 23:42:33 +02:00 committed by GitHub
parent 72c306d920
commit b12e67699a
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

@ -8540,8 +8540,17 @@ child will follow movement and rotation of that bone.
* Passing no arguments resets lighting to its default values. * Passing no arguments resets lighting to its default values.
* `light_definition` is a table with the following optional fields: * `light_definition` is a table with the following optional fields:
* `saturation` sets the saturation (vividness; default: `1.0`). * `saturation` sets the saturation (vividness; default: `1.0`).
* values > 1 increase the saturation * It is applied according to the function `result = b*(1-s) + c*s`, where:
* values in [0,1] decrease the saturation * `c` is the original color
* `b` is the greyscale version of the color with the same luma
* `s` is the saturation set here
* The resulting color always has the same luma (perceived brightness) as the original.
* This means that:
* values > 1 oversaturate
* values < 1 down to 0 desaturate, 0 being entirely greyscale
* values < 0 cause an effect similar to inversion,
but keeping original luma and being symmetrical in terms of saturation
(eg. -1 and 1 is the same saturation and luma, but different hues)
* `shadows` is a table that controls ambient shadows * `shadows` is a table that controls ambient shadows
* `intensity` sets the intensity of the shadows from 0 (no shadows, default) to 1 (blackness) * `intensity` sets the intensity of the shadows from 0 (no shadows, default) to 1 (blackness)
* This value has no effect on clients who have the "Dynamic Shadows" shader disabled. * This value has no effect on clients who have the "Dynamic Shadows" shader disabled.