Chapitre -105 · Tone mapping

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.

Objectif de ce chapitreWhat you’ll learn
Wat je leert
  • 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
⏱ ~20 min
PrérequisPrerequisites
Vereisten

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 :

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)

Survole le graphique pour lire les valeurs.

Scène HDR — glisse pour déplacer la séparation A | B

Survole l'image pour lire la couleur de la scène et celle affichée.

Valeurs repères

Code MSL de la courbe A —
/// 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

Linéaire en entrée, linéaire en sortie

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.

⬡CheckPoint Compilation — essaie les 8 courbes sur le shader de ton choix