Auto Gain Node

L'Auto Gainest un normalisateur automatique : il détecte la valeur minimale et maximale de l'image puis remappe ces valeurs vers le noir et le blanc configurés. Équivalent du « Auto Levels » dans Photoshop / DaVinci Resolve.

Fonctionne bien comme premier diagnostic sur un plan plat, mais produit souvent des résultats instables en animation (le black/white point change à chaque frame selon les valeurs détectées — risque de flicker).

• Effects Library : Tools > Color > Auto Gain
• Ajout rapide : clic droit dans le Node Editor → Add Tool > Color > Auto Gain

• Input (orange) — requis. Image 2D à normaliser.
• Effect Mask (bleu) — optionnel. Restreint la normalisation à une zone.

MediaIn → Auto Gain → Merge 2D → Saver

Placer en début de chaîne, juste après le MediaIn/Loader. Les ajustements fins (Color Corrector, Color Curves) viendront ensuite.

Do Z (défaut : désactivé)

Applique la normalisation au canal Z-depth au lieu des canaux RGB. Utile pour matcher les plages d'un Z pass 3D entre plusieurs plans, ou pour visualiser un Z flottant en niveaux de gris.

Range

Définit le black point et le white point de sortie. Par défaut, 0 et 1 (noir pur et blanc pur). Ajuster pour une normalisation plus douce (ex. 0.05 à 0.95 pour garder un peu de headroom dans les extrêmes).

Un Z-depth pass issu d'un renderer 3D peut avoir des valeurs dans des plages très variables (0 à 1000, ou valeurs infinies au skybox). Visuellement, ces images semblent complètement blanches ou noires dans un viewer standard.

Activer Do Z fait glisser ces valeurs dans [0, 1] basé sur le min/max détecté, rendant le canal Z lisible visuellement. Pratique pour :

• Débugger un Z pass en voyant les dégradés de profondeur
• Matcher deux Z passes entre plans pour un compositing cohérent
• Utiliser le Z comme mask (normalisé en [0,1], il peut piloter un Vari Blur ou un Merge 2D en mask)

• Compensation rapide d'un lighting plat — un plan sous-exposé ou surexposé retrouve de la dynamique en un clic.
• Visualisation d'une image EXR float — un rendu linéaire avec des valeurs au-delà de 1 apparaît blanc partout. Auto Gain le ramène dans une plage visualisable.
• Debug d'un canal Z-depth — activer Do Z pour voir la profondeur de la scène en niveaux de gris.
• Premier passage sur un plan vintage / low-contrast — donne une base correcte sur laquelle faire un grading fin avec Color Corrector.
• Normalisation avant extraction de mask — sur une image à extraire pour un key, normaliser le contraste peut aider le keyer.

• Flicker en animation — piège classique. Sur une séquence, le min/max de chaque frame varie → le black/white point change à chaque image, produisant un flicker de luminosité. Pour une séquence, préférez un Color Corrector réglé manuellement avec des valeurs fixes.
• Alternative : « View Normalized Image » du viewer — pour juste visualiserune image float sans modifier le flux, activez l'option « View Normalized » du viewer (clic droit dans le viewer → View Options). Plus propre que d'ajouter un Auto Gain si c'est juste pour voir.
• Pas optimal pour du grading fin— l'Auto Gain est agressif. Après utilisation, vous perdez les détails subtils des extrêmes. À éviter en rendu final, sauf pour un look délibéré ultra contrasté.
• Effet irréversible — les pixels « remappés » sont écrasés. Pour une reversible adjustment, préférez Brightness Contrast qui a un mode Forward/Reverse.
• Pour une normalisation plus douce, ajustez le Range à [0.1, 0.9] plutôt que [0, 1] — évite le clipping des extrêmes.