AgX

Transform the colors and tonal range of an image to fit a display.

La principale innovation du module AgX est une méthode avancée de gestion des couleurs qui garantit une apparence naturelle et semblable à celle d’un film, évitant ainsi les artefacts de sursaturation courants avec les techniques de mappage de tons plus simples. Il est dérivé de la transformation d’affichage du même nom, utilisée dans le modeleur Blender 3D par TJ Sobotka, Eary_Chow, Sakari Kapanen et d’autres.

Modules placed before AgX in the pipeline operate in scene-referred space. Modules after AgX work in display-referred space.

You can automatically enable AgX in new images by setting the value of preferences > processing > auto-apply pixel workflow defaults to ‘scene-referred (AgX)’.

🔗Primaires

Les « primaires » sont la caractéristique déterminante d’AgX et le cœur de la façon dont il gère la couleur. Ils déterminent l’apparence de couleur de base de l’image avant que la courbe de mappage de tons ne soit appliquée. Pour des définitions précises des termes de couleur utilisés dans cette section, veuillez vous référer aux dimensions de couleur de darktable.

Le principal défi pour intégrer la plage dynamique large d’une scène dans la plage plus étroite d’un écran est de gérer la couleur sur toute l’échelle tonale. Sans mappage de tons, les transitions seraient abruptes et entraîneraient des distorsions de couleur :

Une simple courbe par canal fait souvent passer les objets colorés à des couleurs primaires ou secondaires pures et d’apparence non naturelle à mesure que leur intensité change - un effet parfois appelé le « Notorious 6 » :

Les contrôles primaires dans AgX fonctionnent pour éviter cela en créant un espace colorimétrique personnalisé pour la courbe de tonalité. En ajustant les primaires avant l’application de la courbe, AgX crée un « chemin vers le blanc » plus gracieux, permettant aux couleurs de se désaturer et de changer de teinte d’une manière qui semble plus naturelle et crédible. Ce processus influence le rendu des couleurs sur toute la gamme tonale pour créer une image finale cohérente :

🔗Utilisation

Veuillez prendre note des directives suivantes lorsque vous utilisez ce module dans le cadre de votre flux de travail :

only use one display transform

Never use AgX together with another display transform module (i.e. sigmoid, filmic rgb or base curve).

adjust for the mid-tones first

By default, the module preserves middle gray. Before using AgX, you should first use the exposure module to adjust the mid-tones to your liking.

Un flux de travail recommandé pour l’utilisation de ce module est fourni à la fin de cette page.

🔗Contrôles du module

The module’s controls are divided into three categories:

• Contrôles de mappage de tonalité (plage d’entrée et courbe)

• Ajustements post-mappage des tons (« look »)

• Contrôles relatifs à la couleur (primaires)

Dans la documentation de ce module, des références seront faites à d’autres mappeurs de tons, à savoir filmique rvb et sigmoïde. Ceci permet de prendre en compte les utilisateurs déjà familiers avec ces modules, cependant, la connaissance de ces modules n’est pas requise pour utiliser AgX.

En raison de la nature complexe de ce module, les commandes associées sont regroupées en sections pliables et réparties sur deux onglets.

🔗the settings tab

L’onglet Paramètres contient les commandes les plus couramment utilisées.

🔗input exposure range

Cette section fournit des contrôles similaires à ceux du module filmique rvb, vous permettant de définir les points noir et blanc. La plage d’exposition sélectionnée sera ensuite projetée dans la plage [0, 1] à l’aide d’une transformation logarithmique. Cela signifie que chaque stop d'1 EV de plage dynamique correspond à une distance égale le long de l’axe horizontal de la courbe. Le point gris moyen est situé proportionnellement sur cet axe entre les extrêmes sélectionnés. Après cette projection initiale, les données seront traitées ultérieurement par la courbe (ci-dessous).

exposition relative du blanc

Définissez le point blanc. Toute valeur supérieure à celle-ci sera coupée à 1. Utilisez la pipette pour définir automatiquement cette valeur.

exposition relative du noir

Définissez le point noir. Toute valeur inférieure à celle-ci sera coupée à 0. Utilisez la pipette pour définir automatiquement cette valeur.

ajustement de la plage dynamique

Appliquez une marge de sécurité lors de l’utilisation des pipettes pour sélectionner l’exposition relative blanche et noire.

niveaux de réglage automatiques

Sélectionnez l’icône de la pipette de réglage automatique pour définir les expositions relatives des points blanc et noir en même temps (comme si vous cliquiez sur les deux sélecteurs ci-dessus).

Le bouton récupérer l’exposition (icône de l’appareil photo) n’analyse pas le contenu de l’image, comme le font les pipettes. Au lieu de cela, il estime les expositions relatives en noir et blanc en fonction des paramètres du module exposition. S’il existe plusieurs instances d’exposition, le bouton lira les paramètres de la première instance activée et démasquée. Si toutes les instances sont masquées, la première instance sera utilisée.

L’utilisation du bouton n’a de sens que si l’entrée de AgX est réellement influencée par le module d’exposition - c’est-à-dire si le module exposition précède AgX dans le pipeline (ce qui est normalement le cas). Cela vous permet de prendre en compte toute compensation d’exposition intégrée à l’appareil photo, la préservation des hautes lumières intégrées à l’appareil photo (si elle est prise en charge par darktable) et les réglages manuels. Le mécanisme est similaire à celui utilisé par filmique rvb, mais n’est pas appliqué automatiquement.

🔗basic curve parameters

Dans le propos qui suit, les parties de la courbe de tonalité sont identifiées comme suit :

• Le pivot est le point de la courbe autour duquel le contraste est ajusté (le point de contraste le plus élevé)
• L’épaule est la courbure la plus élevée de la courbe (les points forts)
• Le pied est la courbure inférieure de la courbe (les ombres)
• Le contraste est la pente de la courbe (courbe plus raide = contraste plus élevé)

Si vous ne comprenez pas ces termes à partir des définitions, il peut être utile d’afficher la courbe tout en ajustant les contrôles associés et d’observer l’effet.

exposition relative du pivot

Définit la valeur d’entrée du point pivot (le point de la plage tonale où le contraste sera le plus élevé), en EV par rapport au gris moyen. Étant donné que le contraste est normalement le plus élevé autour du pivot, ce curseur vous permet de choisir quelle partie de la plage tonale d’entrée doit avoir le plus de contraste. La pipette correspondante ajuste uniquement ce curseur, mais pas _sortie cible du pivot _ (ci-dessous). Vous pourriez être tenté de l’utiliser comme contrôle de luminosité (déplacer le pivot vers le noir, sans modifier sa valeur de sortie, éclaircira l’image, tandis que le déplacer vers le blanc assombrira l’image), mais la sortie cible pivot est mieux adaptée à cela, car elle influence directement la luminosité, sans changer le point de contraste le plus élevé.

Lors du réglage des valeurs de l’exposition relative du noir/blanc, l’exposition relative du pivot sera maintenue aussi longtemps que possible. Cela l’amènera à se déplacer le long de l’axe des x, car la quantité préservée est la valeur d’exposition par rapport au gris moyen, et sa position sur l’axe des x dépend des extrémités de cet axe (les valeurs d’exposition relatives en noir et blanc). Si un réglage provoque une chute du pivot en dehors des limites d’exposition, elle sera forcée à l’intérieur de la plage disponible.

sortie cible du ivot

Définit la valeur linéaire de sortie cible (puissance) pour la tonalité sélectionnée par l’ajustement du pivot. La valeur est indiquée sur l’axe des y de la courbe. Notez que l’échelle de l’axe des y n’est pas uniforme et dépend de la courbe gamma y, décrite dans la section paramètres de courbe avancés. La pipette correspondante ajuste à la fois l’exposition relative du pivot (le point de contraste le plus élevé) et la sortie cible du pivot, en essayant de préserver la luminosité moyenne de la région sélectionnée.

Pour des résultats plus prévisibles, il vous est conseillé d’utiliser la pipette sur des zones uniformes, car des transitions tonales soudaines dans la zone sélectionnée entraîneront un changement radical des valeurs moyennes, entraînant des fluctuations à la fois de l’entrée et de la sortie du pivot.

contraste

Définit la pente de la courbe au point de pivot. Cette valeur est mise à l’échelle en interne pour maintenir un contraste de sortie final (linéaire) cohérent, compensant les modifications apportées à la fois à la plage dynamique et au paramètre courbe gamma y.

power épaule / power pied

Ces curseurs déterminent la vitesse à laquelle le contraste diminue à mesure que la courbe se rapproche du noir ou du blanc. Des valeurs plus élevées entraînent une courbure plus prononcée, maintenant le contraste plus longtemps avant une chute plus brusque. Si le contraste global n’est pas suffisant pour atteindre le point noir et/ou blanc, l’une ou les deux extrémités de la courbe peuvent devenir « inversées », rendant ces contrôles inefficaces. Si cela se produit, une icône d’avertissement apparaîtra à côté du ou des curseurs concernés. Le survol de l’avertissement fournit une info-bulle avec des actions suggérées et, si la section montrer la courbe est développée (ci-dessous), la partie affectée de la courbe sera surlignée en jaune.

🔗show curve

Développez la section montrer la courbe pour afficher un tracé de la courbe. Cela peut être un outil utile pour en savoir plus sur le comportement des courbes en observant l’effet des contrôles associés, ou lors de l’étude de problèmes tels que la perte de détails ou « l’inversion de courbe » (voir le contrôle power épaule / power pied ci-dessus). Le tracé n’est pas interactif : il illustre simplement l’effet des curseurs.

L’axe des x montre la plage d’exposition d’entrée sélectionnée, mesurée en EV, avec toutes les valeurs relatives au gris moyen (indiquées par la marque 0 EV).

L’axe des Y montre la valeur de sortie linéaire, 18 % représentant le gris moyen. La mise à l’échelle de l’axe des Y n’est pas linéaire : les lignes de grille horizontales aident à visualiser cette non-linéarité. Le degré de non-linéarité est régi par une valeur gamma (par défaut : 2,2). De plus amples informations sur le gamma sont fournies dans la description des paramètres avancés de la courbe.

La courbe comporte 5 points importants:

• Les points noirs et blancs se trouvent respectivement sur les bords gauche et droit du graphique ; leurs valeurs de sortie linéaires finales peuvent être contrôlées par les curseurs noir cible et blanc cible (voir paramètres avancés de la courbe).

• Le pivot est le point autour duquel la courbe est construite, indiqué par un point. Par défaut, il mappe le gris moyen au gris moyen. Vous pouvez déplacer ce point pour qu’il corresponde à votre sujet principal à l’aide de la pipette fournie.

• Les débuts de pied et épaule définissent où la courbe passe d’une section linéaire au pied compressé (ombres) et à l’épaule (hautes lumières). Par défaut, ceux-ci sont réglés sur le point pivot.

🔗advanced curve parameters

début de l’épaule

Définit le point où la partie linéaire de la courbe se termine et où l’épaulement commence. Maintenir la valeur à 0 % permet de démarrer la transition en douceur au niveau du pivot. Des valeurs plus élevées poussent le point de transition vers le blanc cible choisi. Cela peut entraîner une transition dure, ce qui peut entraîner une perte de détails dans les hautes lumières.

blanc cible

La limite supérieure vers laquelle converge la courbe. Cela peut être utilisé pour limiter la luminance de sortie maximale.

début du pied

Définit le point où la partie linéaire de la courbe se termine et où commence le pied. Maintenir la valeur à 0 % permet de démarrer la transition en douceur au niveau du pivot. Des valeurs plus élevées poussent le point de transition vers le bas en direction du noir cible choisi. Cela peut entraîner une transition dure, ce qui peut entraîner une perte de détails dans les ombres.

target black

The lower bound that the curve converges to. This can be used to create a faded analog look, similar to the lift control in the look section or the global offset in color balance rgb.

garder le pivot sur la diagonale  : Ajuste automatiquement gamma Y courbe pour tenter de garantir que la courbe reste en forme de S, tant que le réglage du contraste est suffisamment élevé. Cela fonctionne un peu comme l’ajustement automatique de la dureté dans Filmique RVB. Lorsque la case à cocher est cochée, gamma Y courbe ne peut pas être ajustée manuellement et est masquée.

gamma Y courbe

Décale la représentation du pivot le long de l’axe y sans modifier sa luminance de sortie. Il s’agit d’un paramètre interne de l’algorithme et n’a pas besoin de correspondre au gamma de votre écran. Son objectif est principalement de vous permettre de conserver la forme en S de la courbe, garantissant ainsi que les commandes power épaule et power pied restent efficaces. Les réglages manuels sont désactivés lorsque garder le pivot sur la diagonale est coché.

🔗Look

Les contrôles « look » définissent la manière dont l’image est traitée après l’opération de mappage de tonalité. Cela signifie qu’il s’agit d’opérations relatives à l’affichage et qu’elles peuvent entraîner un écrêtage, alors utilisez-les avec précaution.

pente

Multiplie les valeurs de sortie par ce facteur. Le noir n’est pas affecté (puisqu’il a une valeur de 0). Les valeurs supérieures à 1 éclaircissent l’image et augmentent le contraste, tandis que celles inférieures à 1 assombrissent l’image et réduisent le contraste.

lift

Décale les valeurs vers le haut ou vers le bas. Seuls les noirs sont entièrement affectés, l’effet étant progressivement réduit pour des tons plus clairs. Les blancs ne sont pas affectés si pente est à sa valeur par défaut de 1. Les valeurs négatives écrasent les ombres, tandis que les valeurs positives peuvent produire un aspect délavé.

luminosité

Applique de la puissance (réglage gamma) à l’image. Les points noirs et blancs ne sont pas affectés. Les valeurs supérieures à 1 augmenteront les tons moyens, ouvrant les ombres, tandis que celles inférieures à 1 assombriront les tons moyens et comprimeront les ombres.

saturation

Controls color intensity by adjusting the image’s chroma. For a precise definition of chroma vs. saturation, please see darktable’s color dimensions. A value of zero makes the image monochrome.

préserver la teinte

La courbe de mappage des tons, étant une courbe par canal, introduit des changements de couleur, la couleur tendant vers les couleurs primaires (rouge, vert et bleu) et secondaires (jaune, cyan et magenta) dans les hautes lumières. À une valeur de 0 %, ces changements de couleur sont conservés. En augmentant ce curseur, les teintes d’entrée (celles avant la courbe de tonalité) peuvent être partiellement ou totalement restaurées.

Notez que les teintes d’entrée elles-mêmes sont affectées par les « manipulations primaires » qui sont effectuées avant le mappage de tonalité, et les teintes finales sont affectées par les « manipulations primaires » qui sont appliquées après le mappage de tonalité. Pour une description détaillée de l’ordre des opérations, voir détails techniques ci-dessous.

🔗the primaries tab

Les contrôles de l’onglet primaires sont similaires, mais plus étendus, à ceux de la section pliable primaires du module sigmoïde :

Désactiver les réglages

Désactive toutes les manipulations des couleurs primaires. Il n’est pas recommandé de cocher cette case lors du traitement proprement dit – elle est davantage destinée à servir d’outil d’apprentissage permettant d’effectuer des comparaisons rapides. Pour obtenir un point de départ sans réglages, que vous pourrez affiner manuellement, utilisez la configuration non-modifiées.

réinitialise les primaires  : Cliquer sur ce bouton révèle un menu contextuel pour appliquer l’un des ensembles intégrés de primaires, sans modifier aucun des autres paramètres.

primaires de base

Définit quel espace colorimétrique est utilisé comme base de l’espace de traitement AgX. Les commandes d’atténuation et de rotation ci-dessous sont appliquées par rapport à cet espace. Pour les couleurs particulièrement problématiques, vous constaterez peut-être que des espaces plus larges offrent un meilleur contrôle.

🔗before tone mapping

Les contrôles de ce groupe affectent les opérations effectuées avant l’application de la courbe de mappage de ton.

atténuation du rouge/vert/bleu

Contrôle la quantité de désaturation appliquée à la couleur primaire. Cela ajuste la rapidité de déplacement de la couleur vers le blanc à mesure que son intensité augmente. Des valeurs plus faibles entraînent un décalage plus lent et des changements de teinte plus prononcés, au risque d’artefacts. La saturation de toutes les couleurs sera réduite, quelle que soit la luminosité, mais cela peut être inversé pour les ombres et les tons moyens à l’aide des curseurs boost de pureté dans la section Mappage après tonalité, l’effet global étant une désaturation des hautes lumières.

rotation du rouge/vert/bleu

Fait pivoter l’angle de teinte de la couleur primaire. Cela affecte la direction du changement de teinte des couleurs à mesure que leur intensité change. Par exemple, la rotation du rouge peut influencer sa tendance vers le jaune ou le magenta.

🔗after tone mapping

Les contrôles de ce groupe affectent le traitement effectué après le mappage de ton. Utilisez-les comme commandes artistiques pour vous aider à obtenir le look final souhaité.

inverser tout

Cocher cette case masquera les autres contrôles du groupe et ajustera les paramètres de traitement comme si les curseurs d’inversion maître, décrits ci-dessous, étaient définis sur 100 %, les paramètres boost de pureté s’appliquant aux valeurs des curseurs d’atténuation correspondants et les paramètres rotation inverse reflétant les valeurs définies avec les curseurs rotation. Les valeurs des curseurs cachés seront conservées, mais ne seront pas utilisées pour le traitement. Décocher la case les rendra à nouveau visibles et leurs paramètres de nouveau effectifs.

La case à cocher est destinée à simplifier l’interface utilisateur (les utilisateurs peuvent souhaiter créer des préréglages avec la case à cocher cochée) et pour effectuer des vérifications rapides « et si ».

défini depuis au dessus

Cliquer sur le bouton copiera les valeurs des curseurs de la section mappage avant tonalité et définira les commandes maître à 100 %, produisant le même effet visuel que de cocher inverser tout. Cependant, cela ne fournit qu’un point de départ : les curseurs ne seront pas cachés et pourront être ajustés selon votre goût.

boost de pureté maître, inversion de rotation maître

Ce sont des multiplicateurs qui affectent les contrôles rouges/verts/bleus individuels ci-dessous, vous permettant d’augmenter ou de diminuer globalement leur effet.

renforcer la pureté du rouge/vert/bleu

Restaure la pureté des couleurs après l’application de la courbe de tonalité. Des valeurs plus élevées rendent l’image plus colorée et chargée de chrominance, mais peuvent introduire des artefacts si elles sont poussées trop loin. Lorsqu’il est combiné avec atténuation (ci-dessus), l’effet net est une désaturation sélective des hautes lumières (puisque l’augmentation de pureté ne récupère pas complètement la pureté des hautes lumières, car elles sont fortement désaturés par le processus de mappage des tons).

rotation inverse du rouge/vert/bleu

Inverse la rotation primaire initiale après la courbe de tonalité. Cela offre un contrôle final sur les teintes rendues. Cela peut être utilisé pour inverser partiellement ou totalement les changements de teinte introduits par les curseurs de rotation correspondants, principalement dans les ombres et les tons moyens. Étant donné que la courbe est appliquée par canal, elle est soumise aux décalages « 6 Notoires », qui affectent principalement les hautes lumières.

🔗Préréglages

Le module fournit des préréglages intégrés, basés sur Blender, et sur le préréglage doux du module sigmoïde. Lorsque vous ajustez les primaires à partir de ces préréglages, vous devrez prendre en compte les éléments suivants :

• Dans Blender, la rotation des primaires n’est pas inversée et la pureté est restaurée en utilisant des valeurs différentes de celles utilisées pour l’atténuation. Par conséquent, les préréglages par défaut comme-blender et relatif à la scène correspondants d’AgX sont livrés avec boost de pureté maître = 100 %, inversion de rotation maître = 0 %. Cela signifie que, bien que les curseurs d’inversion de rotation par canal soient configurés pour une inversion complète, ils n’ont aucun effet. Vous pouvez les activer progressivement en augmentant la commande inversion de rotation maître et, une fois que celle-ci n’est plus réglée à 0 %, ajustez les curseurs de canal individuels selon votre goût.

• Dans le préréglage doux du module sigmoïde, les rotations sont toujours complètement inversées, mais la pureté n’est pas du tout augmentée par défaut. Par conséquent, les préréglages AgX correspondants, également appelés doux, définissent boost de pureté maître = 0%, inversion de rotation maître = 100%. Les curseurs d’augmentation de pureté par canal sont configurés pour inverser complètement l’atténuation, mais sont effectivement désactivés par le curseur principal. Les curseurs d’inversion de rotation par canal reflètent les paramètres du curseur d’inversion et sont entièrement activés par la commande principale.

Vous êtes bien entendu libre de créer vos propres préréglages avec votre combinaison préférée de commandes principales et par canal (par exemple, en définissant les commandes d’inversion principales à 100 % et les commandes par canal sur vos valeurs préférées).

🔗réglage sélectif pour les tons moyens et les hautes lumières

Il est important de noter qu’en utilisant les contrôles primaires, les propriétés de la courbe en S (contraste plus faible dans les hautes lumières) et l’application par canal de la courbe permettent ensemble d’appliquer différents ajustements aux tons moyens et aux hautes lumières, même si cela peut ne pas être évident au premier coup d’œil.

Les courbes en S par canal ont la propriété de désaturer les hautes lumières, indépendamment du contrôle attenuation. Cela signifie que vous pouvez inverser l’atténuation (restaurer la saturation) pour les tons moyens en utilisant renforcer la pureté, mais pas pour les hautes lumières.

Une autre propriété des courbes en S par canal est l’inclinaison des couleurs vives mentionnées ci-dessus : le « 6 Notoires ». AgX utilise intelligemment cet effet pour exagérer les changements de teinte introduits à l’aide de la rotation des primaires. Par exemple, un primaire rouge tourné de quelques degrés vers le vert (jaune) deviendra très légèrement jaune, et cela peut être inversé plus tard à l’aide du curseur rotation inverse du rouge, si vous le souhaitez. Cependant, pour des tons plus clairs, le décalage « 6 Notoires » inclinera davantage le rouge légèrement teinté de jaune vers le jaune, vous permettant d’obtenir des couchers de soleil orange au lieu de roses. L’inversion de rotation ne récupérera pas complètement cette inclinaison supplémentaire. Pour contrôler la quantité de biais supplémentaire que vous souhaitez autoriser, utilisez le curseur préserver la teinte dans la section look.

🔗recommended workflow

The following workflow is recommended when using this module:

1. Définissez l’exposition globale des tons moyens à l’aide du module exposition. Alternativement, utilisez contraste et power pied / épaule pour remplir la plage tonale de sortie.

2. Choisissez un préréglage comme point de départ. Si darktable est configuré pour appliquer un flux de travail relatif à la scène par défaut (voir préférences > traitement > flux de travail par défaut), le module appliquera automatiquement des valeurs par défaut raisonnables. Dans d’autres cas (par exemple, lors de l’utilisation de l’ancien flux de travail relatif à l’affichage ou si la préférence de flux de travail est définie sur « aucun »), sélectionnez manuellement le préréglage blender-like|base ou doux|base pour de meilleurs résultats. Les préréglages punchy sont plus contrastés et colorés.

3. Utilisez le sélecteur niveaux automatiques pour définir la plage d’exposition souhaitée.

4. Définissez le pivot sur le sujet à l’aide du curseur à côté de exposition relative du pivot (facultatif) - cela garantit que le contraste est maximisé autour de la zone sélectionnée.

5. Déplacez le curseur sortie cible du pivot pour régler la luminosité du point pivot (facultatif).

6. Set the contrast.

7. Adjust toe and shoulder power to set contrast in shadows and highlights, respectively (optional).

8. Enfin, si vous le souhaitez, vous pouvez ajouter une « ambiance dramatique » en ajustant les commandes dans la section look : ajoutez de la luminosité, réglez la saturation globale et ajustez les couleurs avec préserver la teinte.

Veuillez également noter ce qui suit :

• Les préréglages fournis (à l’exception de primaires de base non modifiées) fournissent des primaires soigneusement réglées. Au début, il est préférable de s’appuyer sur ces paramètres. Les ajuster, en fonction du goût individuel et/ou des conditions d’éclairage particulières (par exemple Lumières LED, éclairage de scène) fait partie d’un flux de travail plus avancé.

• À moins que traitement de haute qualité ne soit activé, l’effet du réglage des primaires ne peut pas être jugé correctement, en particulier avec des couleurs très saturées et des sources lumineuses à spectre étroit comme les LED.

• N’oubliez pas que le module AgX n’est qu’un autre mappeur de tons. Aussi flexible soit-il, il n’est pas destiné à résoudre toutes les tâches de traitement d’image liées à la couleur et au contraste, dont beaucoup seront mieux résolues en utilisant d’autres modules.

🔗additional options

Les options supplémentaires suivantes sont « masquées » par défaut mais peuvent être basculées en modifiant manuellement votre fichier darktablerc alors que darktable est fermé.

🔗Mode « 3 onglets »

Pour les personnes disposant de petits écrans, où l’espace vertical sur l’écran est limité, un mode optionnel « 3 onglets » est fourni afin de réduire le besoin de faire défiler le module. Ce mode déplace le tracé de la courbe et les paramètres avancés de la courbe de l’onglet paramètres vers un onglet courbe dédié, et duplique certains autres contrôles de l’onglet paramètres pour plus de commodité.

Vous pouvez activer ce mode en définissant plugins/darkroom/agx/enable_curve_tab=TRUE dans darktablerc. Lorsqu’il est défini sur FALSE, tous les contrôles de courbe apparaissent normalement dans l’onglet paramètres.

🔗disabling curve warnings

Les avertissements documentés dans la section paramètres basiques de la courbe peuvent être désactivés en définissant plugins/darkroom/agx/enable_curve_warnings=FALSE dans darktablerc.

🔗développez toujours la section « look »

Par défaut, les contrôles de look sont placés à l’intérieur d’une section repliable. Si vous souhaitez les garder visibles à tout moment, vous pouvez définir plugins/darkroom/agx/look_always_visible=TRUE dans darktablerc.

🔗technical details

Ce qui suit est une description détaillée des étapes suivies lors du traitement avec le module AgX. Cette section est fournie à titre de référence pour les lecteurs intéressés, mais n’est pas obligatoire pour utiliser le module.

1. Linear, scene-referred data arrives in the pipe’s working space, defined in the input color profile module (e.g. Rec 2020)

2. Si nécessaire, les données sont converties dans l’espace « de base » sélectionné

3. Les couleurs qui sont hors gamut pour l’espace « de base » (triplets RVB qui ont une composante négative dans cet espace) sont « glissées » dans le gamut (les couleurs dans la gamut ne sont pas modifiées, bien qu’il soit possible qu’une couleur précédemment hors gamut « écrase » une couleur dans le gamut). Le module sigmoïde effectue une opération similaire, mais la méthode est différente.

4. Une matrice d’entrée est calculée et appliquée, en fonction des valeurs d’atténuation RVB et de rotation primaire. Cela désature les couleurs (mélange des canaux les uns dans les autres) et fait tourner les primaires. C’est la même chose qu’avec sigmoïde.

5. La représentation HSV est calculée à partir de l’encart + tournée RVB. La teinte (H) sera utilisée ultérieurement pour restaurer la teinte selon le curseur look / préserver la teinte.

6. Pour chaque composant (canal RVB), les mêmes étapes de traitement sont exécutées indépendamment (mais, comme la désaturation (atténuation des primaires) mélange les canaux entre eux, cela signifie que par rapport à la couleur d’origine, le traitement n’est pas du tout indépendant) :

   • Un encodage logarithmique est appliqué : pour l’entrée x, log2(x) est calculé (x serait la valeur du canal rouge, vert ou bleu)

   • La valeur logarithmique est mise à l’échelle et décalée en fonction des paramètres d’exposition sélectionnés, de sorte que le point noir sélectionné devient 0, le point blanc 1 et la valeur correspondant au gris moyen (18 %) se retrouve sur l’axe des x de la courbe dans un rapport exposition relative du noir : exposition relative du blanc (par défaut, 10 : 6,5, ou à environ 0,61)

   • La courbe est appliquée. Cela produit une sortie qui est considérée comme encodée selon le gamma. Cela peut être considéré comme des données prêtes à être affichées sur un moniteur en utilisant la valeur gamma spécifiée (le gamma est uniquement utilisé pour le traitement et ne doit pas nécessairement correspondre au gamma de l’écran utilisé pour l’édition, ni à celui de l’espace colorimétrique de sortie).

7. Le look est appliqué en mode purement référencé par affichage, comme l’édition héritée d’images encodées gamma, et similaire à l’édition de JPG sRGB dans les éditeurs traditionnels. À l’exception de saturation, il s’agit également d’opérations par canal :

   • d’abord la pente et le lift

   • then the brightness

   • finally the saturation

8. Pour chaque canal, les données encodées gamma sont linéarisées en appliquant linear = gamma_encoded ^ gamma (elles sont donc référencées par scène 0..1, mais l’encodage est linéaire, comme toujours dans le pipeline de darktable ; le gris moyen est à 0,18)

9. La représentation HSV du résultat est calculée. La teinte résultante (du composant H) et la teinte d’origine sont mélangées selon le paramètre préserver la teinte pour produire la teinte finale. Cela ne garantit pas une préservation complète de la couleur, car la teinte « originale » a déjà été enregistrée après la matrice d’entrée, et après ce mélange, la matrice de sortie (voir l’étape suivante) modifie à nouveau les couleurs.

10. La matrice de sortie est appliquée à chaque canal, qui :

    • effectue l’inversion de rotation (c’est une différence avec sigmoïde : ce dernier inverse toujours complètement la rotation, dans AgX, l’inversion appartient à l’utilisateur)

    • applique l’augmentation/boost de pureté (tout comme sigmoïde)

    • reconvertit le résultat dans l’espace de travail du pipe.

Pour une plongée en profondeur dans la théorie et le développement qui sous-tend AgX, la ressource principale est le fil de discussion sur Blender Artists : Feedback & Development - Filmic - Baby Step to a v2.

translations

• English: AgX
• German: AgX
• Lao: AgX
• Ukrainian: AgX