Tone mapping — du HDR à l'écran
Avec le soleil du chapitre ↘ Couleurs & Soleil, ta scène calcule des couleurs linéaires qui dépassent 1.0 : un ciel vaut 2 ou 3, le disque du soleil 40, un reflet 10. La cible RGBA16Float les garde (chapitre ↘ Formats de pixel), mais un écran ordinaire s'arrête à 1.0 : tout ce qui dépasse devient blanc, et les couleurs vives virent au blanc ou au jaune.
Une courbe de tone mapping décide comment écraser \( [0, \infty[ \) dans \( [0, 1] \) : garder les ombres presque intactes, comprimer les hautes lumières en douceur, et ne jamais couper net. C'est la dernière étape du fragment shader, juste avant l'écriture du pixel.
- Comprendre pourquoi une couleur linéaire au-dessus de 1.0 doit être compressée
- Lire une courbe de tone mapping : gris 18 %, blanc, hautes lumières
- Comparer Reinhard, Hable, ACES, Lottes, AgX et PBR Neutral sur la même scène
- Éviter le piège des matrices HLSL recopiées en MSL
Lire la courbe
L'axe horizontal est l'entrée : la couleur linéaire de la scène, multipliée par l'exposition. Il est gradué en stops : chaque graduation double la lumière, comme le réglage d'un appareil photo. L'axe vertical est la sortie, celle que l'écran affiche. Deux repères comptent :
- Le gris 18 % : une surface grise moyenne sous un éclairage normal. Une bonne courbe le garde lisible, ni écrasé dans le noir ni délavé.
- 1.0 : le blanc d'un écran SDR. Sans tone mapping, tout ce qui est à droite de ce repère est coupé net.
Choisis deux courbes : A s'affiche à gauche de l'image, B à droite, et tu peux faire glisser la séparation. Les bandes de couleur doublent d'intensité tous les dixièmes de largeur, de 1/16 à 64 ; en bas, un ciel (≈ 2) et un soleil (≈ 40).
Courbe : entrée linéaire (scène) → sortie (écran)
Scène HDR — glisse pour déplacer la séparation A | B
Valeurs repères
/// MSL — ToneMapping.metal — update:20/10/26
#include <metal_stdlib> // les includes nécessaires au fichier
using namespace metal;
Le piège des matrices en MSL
Stephen Hill a écrit ACESFitted en HLSL, où ses deux matrices se lisent par lignes. En MSL, float3x3(float3 a, float3 b, float3 c) range a, b et c en colonnes. Recopiées telles quelles et utilisées en ACESInputMat * color, les matrices sont donc transposées. Rien ne plante, mais la somme des colonnes de la matrice d'entrée vaut (0.70, 1.40, 0.90) au lieu de 1 : un gris neutre 0.18 ressort en (0.08, 0.15, 0.09), et toute l'image vire au vert. Choisis « ACES — Stephen Hill (matrices transposées) » en courbe B pour le voir.
La correction tient en deux lignes : multiplier à gauche.
/// MSL — Exemple — update:20/10/26
color = color * ACESInputMat; // et non ACESInputMat * color
// … RRT and ODT fit …
return saturate(color * ACESOutputMat); // et non ACESOutputMat * color
En MSL, v * M calcule le produit du vecteur ligne v par M : chaque composante du résultat est le produit scalaire de v avec une colonne de M, c'est-à-dire avec une ligne de la matrice HLSL. C'est exactement le calcul de Hill.
Quelle courbe choisir
- Reinhard : la plus simple, \( x / (1 + x) \). Elle n'atteint jamais le blanc pur et ternit les hautes lumières ; la variante étendue fixe la valeur qui devient blanche.
- Uncharted 2 (John Hable) : la courbe « filmic » des jeux de 2010, ombres douces et épaule progressive.
- ACES (Narkowicz, Hill) : le contraste et la saturation du cinéma. Hill est la plus fidèle à l'ACES complet, au prix d'un décalage de teinte : un rouge très fort tire vers l'orange.
- Timothy Lottes : réglable par paramètres — ici le gris 0.18 donne 0.267 et 8.0 donne le blanc.
- AgX (Troy Sobotka, celle de Blender) : les couleurs très fortes tendent vers le blanc au lieu de saturer, comme sur une pellicule.
- ACES Hill pour un look plus contrasté et cinéma, en acceptant que l'orange de ta charte tire vers le jaune dans les hautes lumières.
- PBR Neutral (Khronos) : ne touche à rien sous 0.76, puis compresse. Le choix des rendus de produits, où la couleur doit rester celle du matériau.
Toutes les courbes attendent une couleur linéaire et rendent du linéaire. Avec une cible …Unorm_sRGB, Metal encode en sRGB tout seul à l'écriture ; sinon, encode toi-même. AgX est l'exception : l'approximation de Benjamin Wrensch sort déjà encodée, on la remet en linéaire avec pow(x, 2.2) pour la comparer aux autres.
Brancher une courbe dans un shader
Le tone mapping est la toute dernière opération du fragment shader : tout l'éclairage se calcule en linéaire, avec des valeurs au-dessus de 1, puis la courbe ramène le résultat dans \( [0, 1] \) juste avant le return. Sur le shader d'↘ Assimp : un #include en haut du fichier, une ligne avant le return de fragment_Assimp.
/// MSL — AssimpBlender.metal — update:20/10/26
#include "ToneMapping.metal"
float3 finalColor = ambient + diffuse + specular;
finalColor = ACESFitted(finalColor); // ou reinhard, hableFilmic, acesNarkowicz, lottes, agx, pbrNeutral
return float4(finalColor, albedo.a);
Pour changer de courbe, remplace ACESFitted par une autre fonction du fichier — reinhardExtended prend en plus la valeur qui devient blanche, par exemple reinhardExtended(finalColor, 4.0f). Le reste du shader ne bouge pas.