Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/natural-harmonia-gropius/hdr-toys
Componentized Rec.2100 to Rec.709 conversion shader for mpv-player, featuring dynamic curves and a uniform color space.
https://github.com/natural-harmonia-gropius/hdr-toys
color-conversion color-management color-transformations gamut-mapping glsl mpv shader tone-mapping
Last synced: 3 months ago
JSON representation
Componentized Rec.2100 to Rec.709 conversion shader for mpv-player, featuring dynamic curves and a uniform color space.
- Host: GitHub
- URL: https://github.com/natural-harmonia-gropius/hdr-toys
- Owner: natural-harmonia-gropius
- License: mit
- Created: 2023-02-09T14:52:50.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-07-25T17:53:12.000Z (4 months ago)
- Last Synced: 2024-07-25T20:37:58.517Z (4 months ago)
- Topics: color-conversion, color-management, color-transformations, gamut-mapping, glsl, mpv, shader, tone-mapping
- Language: GLSL
- Homepage:
- Size: 1.07 MB
- Stars: 114
- Watchers: 6
- Forks: 1
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mpv - hdr-toys - Componentized Rec.2100 to Rec.709 conversion shader. (Other)
README
# HDR Toys
Componentized Rec.2100 to Rec.709 conversion shader for mpv-player.
Featuring dynamic curves and a uniform color space.
## Getting started
> [!Important]
> Requires [**_vo=gpu-next_**](https://mpv.io/manual/master/#video-output-drivers-gpu-next).
> [!Tip]
> Full portable_config: [natural-harmonia-gropius/mpv-config](https://github.com/natural-harmonia-gropius/mpv-config).
1. Download [hdr-toys.zip](https://github.com/natural-harmonia-gropius/hdr-toys/archive/refs/heads/master.zip), extract it and copy `shaders`, `scripts` and `hdr-toys.conf` to your mpv config folder.
2. Append `include=~~/hdr-toys.conf` to your `mpv.conf`
- Don't set target-peak, icc-profile...
Make sure there are _**no**_ built-in tone map, gamut map, 3DLUT... in "Frame Timings" page.
- If you are not using a BT.709 display, replace all gamut-mapping/\* with `gamut-mapping/clip.glsl`.
Then change `#define to *` to match your display.
## Detailed information
Most shaders have a link at the top, if you want to go deeper, you can visit it.
- About how to set parameters, see: [--glsl-shader-opts](https://mpv.io/manual/master/#options-glsl-shader-opts)
### Tone mapping
- HDR peak defaults to 1000nit, should be the max luminance of video.
hdr-toys-helper.lua can get it automatically from mpv.
You can set it manually with `set glsl-shader-opts L_hdr=N`
- SDR peak defaults to 203nit, should be the reference white of video.
In many videos it is 100nit and if so you'll get a dim result.
Unfortunately you have to guess the value and set it manually.
You can set it manually with `set glsl-shader-opts L_sdr=N`
You can change the tone mapping operator by replacing this line.
For example, use bt2446c instead of dynamic.
```diff
- glsl-shader=~~/shaders/hdr-toys/tone-mapping/dynamic.glsl
+ glsl-shader=~~/shaders/hdr-toys/tone-mapping/bt2446c.glsl
```
This table lists the features of operators.
| Operator | Applied to | Conversion peak |
| -------- | ---------- | --------------- |
| dynamic | JzCzhz | Frame peak |
| bt2390 | ICtCp | HDR peak |
| bt2446a | YCbCr | HDR peak |
| bt2446c | xyY | 1000nit |
| reinhard | YRGB | HDR peak |
| hable | YRGB | HDR peak |
| hable2 | YRGB | HDR peak |
| lottes | maxRGB | HDR peak |
| hejl2015 | RGB | HDR peak |
| linear | ICtCp | HDR peak |
| clip | RGB | SDR peak |
| false | Heatmap | Infinity |
Typical representation of the same curve applied to different color spaces.
| RGB | YRGB | maxRGB | Hybrid in JzCzhz |
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
|  |  |  |  |
Typical representation of static and dynamic curves applied to the same color space.
| BT.2446C | Dynamic | BT.2446C | Dynamic | BT.2446C | Dynamic |
| --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
|  |  |  |  |  |  |
### Gamut mapping
> [!CAUTION]
> Screenshots are outdated and will be updated in the next release.
`clip` is the exact conversion, Others are various forms of compression.
| clip | jedypod | bottosson | lea | toru | false |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|  |  |  |  |  |  |
|  |  |  |  |  |  |
- The result of `clip` is different from libplacebo, which is due to the black point of BT.1886.
I consider that the black point should be set to zero for transcoding and conversion.