color harmonizer

Technical information
Description
Harmoniser les couleurs vers une palette sélectionnée dans l’espace perceptuel.
Objectif
Gradation créative des couleurs.
Entrée
Relatif à la scène, linéaire, RVB.
Traitement
Darktable UCS / JCH (perceptuel).
Sortie
Relatif à la scène, linéaire, RVB.

L’harmoniseur de couleurs réduit la dissonance chromatique en déplaçant les teintes vers une palette de couleurs sélectionnée. Cette palette est définie par un ensemble d’angles de teinte appelés nœuds d’harmonie. Les couleurs « hors palette » sont doucement tirées vers le nœud le plus proche ; les couleurs déjà présentes sur un nœud restent inchangées. Un multiplicateur de saturation par nœud peut en outre augmenter ou réduire la couleur des couleurs à proximité de chaque nœud.

🔗Contrôles du module

règle d’harmonie
Sélectionnez l’une des règles d’harmonie. Toutes les positions des nœuds sont des décalages par rapport à la teinte d’ancrage. Les angles sont en degrés.

| Règle | Nœuds |   Positions des nœuds   | Caractère | |——| :——-: |—————-|———–| | Monochromatique | 1 | 0° | Famille de teintes simples | | Analoge | 3 | 0°, −30°, +30° | Voisins adjacents ; naturaliste, cohésif | | Complémentaire analoge | 4 | 0°, −30°, +30°, +180° | Triade analogue plus son opposée | | Complémentaire | 2 | 0°, +180° | Opposées directes ; contraste maximal | | Complémentaire divisé | 3 | 0°, +150°, +210° | Ancre plus les deux voisins de son complément | | Dyad | 2 | −30°, +30° | L’ancre est un axe de symétrie et non un nœud | | Triade | 3 | 0°, +120°, +240° | Uniformément espacées ; équilibrées, colorées | | Tetrad | 4 | −30°, +30°, +150°, +210°  | Deux paires de dyades ; l’ancre est un axe de symétrie, pas un nœud | | Carré | 4 | 0°, +90°, +180°, +270° | Quatre teintes également espacées | | Personnalisée | 2–4 | Placé librement | Positions de nœuds définies par l’utilisateur |

Remarque sur la dyade et la tétrade : la teinte d’ancrage définit l’axe de symétrie du motif, et non la position d’un nœud. La palette est symétrique autour de l’ancre. Cela correspond à la superposition du guide d’harmonie du vectorscope.

déduire-de-l’image déduire de l’image (modes standard uniquement)
Analyse l’histogramme de teinte pondéré en chrominance de l’image d’aperçu et sélectionne automatiquement la règle d’harmonie et la teinte d’ancrage qui correspondent le mieux à la distribution de couleurs existante de l’image — c’est-à-dire la combinaison qui couvre déjà le plus d’énergie chromatique et nécessite donc le moins de correction.
teinte ancrée
La teinte primaire à partir de laquelle toutes les positions des nœuds sont dérivées (non affichée en mode * personnalisé*). Exprimé comme une valeur normalisée affichée en degrés. Une pipettte  eye-dropper est disponible pour échantillonner directement une couleur de l’image. La bande d’échantillons de couleurs située sous le curseur affiche les couleurs réelles des nœuds pour un retour visuel rapide.
synchronisation bidirectionnelle du vectorscope
Lorsqu’il est activé (par défaut), toute modification de la règle d’harmonie, de la teinte d’ancrage ou des positions de nœud personnalisées est immédiatement reflétées dans la superposition d’harmonie du vectorscope, et les modifications apportées au vectorscope, c’est-à-dire la modification de la règle superposée ou la rotation de la superposition, sont reflété dans le module. Désactiver pour effectuer des ajustements sans perturber le vectorscope afficher. Si cette option est activée, l’utilisation du module commutera automatiquement le module de portée pour afficher le vectorscope.
importer -du-vectorscope importer du vectorscope (modes standard uniquement)
Importe la règle d’harmonie et la teinte d’ancrage actuellement configurées dans le panneau vectorscope, puis bascule le panneau d’histogramme vers la vue vectorscope.
nœuds (mode personnalisé uniquement)
Nombre de nœuds d’harmonie actifs en mode personnalisé (2–4). Seules les N premières lignes de nœuds sont affichées et actif ; les autres sont cachés.
curseurs de teinte de nœud (mode personnalisé uniquement)
Une ligne par nœud actif. Chaque rangée montre un échantillon de couleur et un curseur de teinte avec une pipette. Le curseur de teinte définit la position du nœud sur la roue de teinte (0°–360°). Utilisez la pipette pour échantillonner une teinte souhaitée directement à partir de l’image.

🔗Effect controls

force de déplacement
Les couleurs seront décalées en fonction de leur proximité avec les nœuds. Le décalage est le plus fort pour les pixels entre les nœuds, et le plus faible (ou zéro) pour les pixels exactement sur un nœud.

Remarque : la force de déplacement met à l’échelle uniquement la correction de teinte. La correction de saturation (multiplicateurs de saturation par nœud) est appliquée indépendamment, à pleine puissance quel que soit ce curseur.

largeur du déplacement
Met à l’échelle la largeur de la zone d’attraction de chaque nœud.
  • < 1 (étroit) : décroissance rapide ; seules les teintes très proches d’un nœud sont attirées. Le reste de la roue de teinte est à peine touché. Utile pour les images déjà proches de l’harmonie, ou autrement, une correction chirurgicale de teintes spécifiques est nécessaire.

  • = 1 (par défaut) : décroissance moyenne — séparation de zone propre avec transitions douces.

  • > 1 (large) : pas de décroissance ; tous les pixels sont attirés sensiblement quelle que soit la distance qui les sépare d’un nœud. Utile pour supprimer les couleurs en dehors de l’harmonie cible.

    L’augmentation de la largeur du déplacement ne déplace jamais les pixels qui se trouvent déjà exactement sur un nœud d’harmonie — leur distance angulaire par rapport au nœud le plus proche est nulle, donc leur décalage de teinte est toujours nul.

protection de couleurs neutres
Protège de la correction les pixels à faible chrominance.

Le curseur définit le degré d’agressivité les pixels à faible chrominance sont épargnés : les valeurs faibles protègent uniquement les gris quasi absolus ; les valeurs élevées s’étendent protection contre les tons discrets et pastel. Même au maximum, les couleurs vives restent largement inchangées.

Par défaut: 0.50.

lissage
Cela lisse les transitions spatiales aux limites des zones — visibles sous forme de pas de couleur subtils dans des gradients lisses comme le ciel ou la peau lorsque les régions adjacentes tombent dans différentes zones d’attraction.

Le sigma de flou varie en fonction à la fois de ce curseur et de la largeur d’attraction actuelle : des zones d’attraction plus larges couvrent des plages de teintes plus étendues et génèrent des corrections plus importantes, ce qui peut produire des limites spatiales plus nettes lorsque des pixels proches les uns des autres se trouvent de part et d’autre du point médian d’une zone.

  • 0 (par défaut, désactivé) : les transitions sont gérées uniquement par l’interpolation gaussienne dans l’espace des teintes. Le maximum de détails est préservé. Recommandé pour la plupart des utilisations.

  • 0,1–0,5 : moyenne spatiale subtile pour réduire le bruit de couleur dans les zones lisses.

  • > 1.0 : mélange spatial large ; peut créer un effet pictural mais peut faire déborder les corrections sur les bords de l’image.

🔗Section de saturation (pliable)

Une ligne par nœud d’harmonie actif. Chaque ligne affiche un échantillon de couleur (la teinte du nœud) et un curseur multiplicateur de saturation.

curseurs de saturation des nœuds
Multiplicateur de saturation pour les couleurs proches du nœud d’harmonie correspondant.
  • 100 % (par défaut) : la saturation reste inchangée.

  • < 100 % : désature les couleurs proches de ce nœud, proportionnellement à leur proximité gaussienne.

  • > 100 % : augmente la saturation à proximité de ce nœud.

L’effet est pondéré en fonction de la proximité gaussienne du pixel par rapport au nœud, puis modulé par la protection des couleurs neutres, ce qui permet d’épargner les pixels quasi-achromatiques. Au niveau du nœud lui-même (pondération maximale), la saturation est multipliée exactement par la valeur du curseur.


🔗Usage guide

🔗Basic workflow

Lorsque le module est activé pour la première fois, il est dans un état neutre et il n’y aura donc aucun changement visible dans l’image.

  1. teinte ancrée. Utilisez la pipette pour choisir la couleur dominante ou la plus importante dans la scène — un ciel, un vêtement, un teint de peau — ou faites glisser le curseur manuellement tout en regardant la bande d’échantillons.

  2. Choisissez une règle d’harmonie. Pour le portrait, complémentaire (sujet vs arrière-plan) ou analogue (tons chauds) sont des points de départ naturels. Pour les paysages, triade ou complémentaire divisé fonctionne souvent bien. Activer la synchronisation bidirectionnelle du vectorscope (selon la règle d’harmonie) pour voir la palette sur le vectorscope pendant que vous choisissez.

  3. Augmenter la force de déplacement. Commencez autour de 0,2–0,3. L’effet est graduel.

  4. Ajustez la largeur du déplacement si nécessaire. Si de nombreuses teintes hors palette ne bougent pas suffisamment, élargissez les zones. Si vous souhaitez corriger uniquement des plages de teintes spécifiques sans toucher au reste, réduisez-les. Le résultat peut être très subtil si l’image présente déjà une harmonie inhérente et que le module est configuré pour correspondre. Dans ce cas, fixer à la fois la force et la largeur à leurs valeurs maximales, puis les réduire progressivement, peut être une stratégie plus efficace.

  5. Utilisez la protection des couleurs neutres selon votre goût. Augmentez-la pour les images avec de nombreux tons désaturés (architecture, looks de film décolorés) pour exempter de toute correction les pastels et les tons atténués.

  6. Utilisez la section de saturation pour le lissage de la palette. Une fois le déplacement de teinte définie, ouvrez la section de saturation pour booster ou atténuer la chrominance par nœud — par exemple booster les nœuds chauds et désaturer les plus froid pour un look cinématographique à deux tons.

🔗Règle d’harmonie personnalisée

Utilisez personnalisé lorsqu’aucune des règles géométriques ne correspond à la palette prévue pour l’image.

  1. Définissez la règle d’harmonie sur personnalisé. Les positions des nœuds de la règle précédente sont copiées comme point de départ.

  2. Utilisez nœuds pour sélectionner le nombre de palettes dont vous avez besoin (2–4).

  3. Faites glisser le curseur de teinte de chaque nœud ou utilisez sa pipette pour positionner les nœuds sur la teinte souhaitée dans la palette.

  4. Augmentez la force de déplacement pour tirer les couleurs hors palette vers les nœuds personnalisés.

Les nœuds personnalisés sont synchronisés avec le vectorscope en tant que marqueurs d’angle flottants (le vectorscope ne montre pas de nom de règle standard pour les palettes personnalisées).

🔗Travailler avec le vectorscope

Lorsque la synchronisation bidirectionnelle du vectorscope est activée, le vectorscope superpose le guide d’harmonie à la répartition des couleurs de l’image. Les couleurs situées à l’intérieur des arcs du guide correspondent à la palette ; celles situées à l’extérieur sont en cours de correction. Utilisez cette fonction pour vérifier que le réglage évolue dans la direction souhaitée. Outre l’utilisation du curseur de teinte, vous pouvez déplacer la teinte d’ancrage en faisant glisser le curseur sur le vectorscope.

Pour démarrer à partir d’une palette déjà définie dans le panneau vectorscope, cliquez sur le bouton importer depuis vectorscope (![import-from-vectorscope](./harmoniseur de couleurs/import-from-vectorscope.png#icon)).

translations