DOCS: deprecate --gamma-factor and --gamma-auto

Removed the outdated information about environmental brightness
with respect to --gamma-factor, and mention that the option is
deprecated and subject to future removal. Also deprecated the
--gamma-auto option as it relies on the same outdated way of doing
things.
This commit is contained in:
Leo Izen 2022-09-30 17:14:58 -04:00
parent 98e6fb26a3
commit 2207236aaa
2 changed files with 4 additions and 14 deletions

View File

@ -46,6 +46,8 @@ Interface changes
- add `engine` option to the `rubberband` audio filter to support the new - add `engine` option to the `rubberband` audio filter to support the new
engine introduced in rubberband 3.0.0. Defaults to `finer` (new engine). engine introduced in rubberband 3.0.0. Defaults to `finer` (new engine).
- add `--wayland-configure-bounds` option - add `--wayland-configure-bounds` option
- deprecate `--gamma-factor`
- deprecate `--gamma-auto`
--- mpv 0.34.0 --- --- mpv 0.34.0 ---
- deprecate selecting by card number with `--drm-connector`, add - deprecate selecting by card number with `--drm-connector`, add
`--drm-device` which can be used instead `--drm-device` which can be used instead

View File

@ -6188,25 +6188,13 @@ them.
other ways (like with the ``--gamma`` option or key bindings and the other ways (like with the ``--gamma`` option or key bindings and the
``gamma`` property), the value is multiplied with the other gamma value. ``gamma`` property), the value is multiplied with the other gamma value.
Recommended values based on the environmental brightness: This option is deprecated and may be removed in the future.
1.0
Pitch black or dimly lit room (default)
1.1
Moderately lit room, home
1.2
Brightly illuminated room, office
NOTE: This is based around the assumptions of typical movie content, which
contains an implicit end-to-end of about 0.8 from scene to display. For
bright environments it can be useful to cancel that out.
``--gamma-auto`` ``--gamma-auto``
Automatically corrects the gamma value depending on ambient lighting Automatically corrects the gamma value depending on ambient lighting
conditions (adding a gamma boost for bright rooms). conditions (adding a gamma boost for bright rooms).
With ambient illuminance of 16 lux, mpv will pick the 1.0 gamma value (no This option is deprecated and may be removed in the future.
boost), and slightly increase the boost up until 1.2 for 256 lux.
NOTE: Only implemented on macOS. NOTE: Only implemented on macOS.