darktable 3.8 user manual

darktable est une application open source qui offre un flux de travail pour le traitement des photographies. C'est un développeur de fichier RAW — une table lumineuse et une chambre noire virtuelles. Il gère vos négatifs numériques dans une base de données, vous les laisse voir au travers d'une table lumineuse zoomable et vous permet de développer et d'améliorer vos images RAW.

Le dépôt source de cette documentation peut être trouvé à https://github.com/darktable-org/dtdocs.git. Tout commentaire relatif à cette documentation peut être fourni en créant un ticket ou une pull request sur ce dépôt.

Vous pouvez aussi cliquer sur les liens suivants pour obtenir ce manuel au format PDF ou epub.

Cette documentation est publiée sous la licence GPL 3.0.

Présentation

interface utilisateur

formats de fichier supportés

fichiers liés et édition non destructive

une introduction au flux de travail de darktable

interface utilisateur

vues

disposition de l'affichage

pellicule

panneau supérieur

raccourcis clavier

vues

Les fonctionnalités de darktable sont réparties en six vues différentes :

table lumineuse

Gérer les images et les collections.

chambre noire

Développer une seule image.

carte

Montrer sur une carte les images géolocalisées et les nouvelles images géolocalisées manuellement.

impression

Envoyer des images à une imprimante.

diaporama

Affichez les images sous forme de diaporama, en les traitant à la volée.

capture

Capturez à distance et enregistrer des images prises avec un appareil photo connecté.

Vous pouvez basculer entre les vues en cliquant sur le nom de la vue en haut du panneau de droite (la vue actuellement active est mise en surbrillance) ou en utilisant l'un des raccourcis clavier suivants :

L 	basculer vers la vue table lumineuse
D 	basculer vers la vue chambre noire
M 	basculer vers la vue carte
P 	basculer vers la vue impression
S 	basculer vers diaporama
T 	basculer vers la vue capture

disposition de l'affichage

La disposition de l'affichage est la même pour toutes les vues de darktable. Elle consiste en une zone centrale bordée par des panneaux :

zone centrale : Contient des informations et la fonctionnalité spécifique de la vue actuelle.

panneau gauche : Contient des modules principalement utilisés pour fournir des informations.

panneau droit  : Contient des modules principalement utilisés pour le traitement d'image.

bannière supérieure : Contient des informations sur la version actuelle de darktable et vous permet de basculer entre les vues. Également utilisé par certains modules pour afficher des conseils et des messages.

panneau supérieur : Fournit l'accès aux paramètres globaux et aux raccourcis.

panneau inférieur  : Permet d'accéder aux paramètres et raccourcis spécifiques à la vue.

panneau pellicule/chronologie : Un panneau facultatif qui peut être activé en bas de l'écran pour afficher une chronologie (dans la vue table lumineuse) ou une pellicule (dans d'autres vues) des images de la collection actuelle.

taille d'un panneau et sa visibilité

Les panneaux gauche, droit et pellicule/chronologie peuvent être redimensionnés en faisant glisser leurs bordures intérieures.

Chacun des panneaux peut être affiché ou masqué en appuyant sur le triangle situé sur le bord extérieur du panneau. La visibilité du panneau peut également être ajustée à l'aide de raccourcis clavier, comme suit :

TAB  Étendre temporairement la vue centrale pour remplir toute la fenêtre.
                Appuyez à nouveau pour revenir à la vue précédente
F11  Basculer en mode plein écran
Shift+Ctrl+t  Afficher/masquer le panneau supérieur (entre l'image et la bannière du haut)
Shift+Ctrl+b  Afficher/masquer le panneau inférieur (entre l'image et le panneau pellicule/chronologie s'il est affiché)
Shift+Ctrl+l  Afficher/masquer le panneau gauche
Shift+Ctrl+r  Afficher/masquer le panneau droit
Ctrl+f  Afficher/masquer le panneau pellicule/chronologie
Ctrl+h  Afficher/masquer la bannière supérieure
b  Afficher/masquer tous les bords et les contrôles de réduction des panneaux

Remarque : La taille et la visibilité des panneaux sont stockées indépendamment pour chaque vue.

pellicule

La pellicule, lorsqu'elle est activée, est affichée en bas de l'écran ; sauf dans la vue table lumineuse, où elle est remplacée par le module chronologie. Elle affiche les images de la collection actuelle (sélectionnée dans la vue table lumineuse). Vous pouvez naviguer le long de la pellicule en faisant défiler avec la molette de la souris.

La pellicule vous permet d'interagir avec les images lorsque vous n'êtes pas dans la vue table lumineuse. Par exemple, lors du développement d'une image en mode chambre noire, vous pouvez passer à une autre image en cliquant sur sa miniature dans la pellicule. Vous pouvez également évaluer et classer par couleur les images comme vous le faites dans la vue table lumineuse, ainsi que copier et coller l'historique à l'aide de raccourcis clavier.

Voir la documentation du module pellicule pour plus d'informations.

panneau supérieur

Le panneau supérieur est commun à toutes les vues darktable. Il fournit l'accès à un certain nombre de fonctions courantes.

Sur le côté gauche

afficher

Choisir les images à afficher dans la table lumineuse/la pellicule, en fonction de l'évaluation par étoiles et du statut de rejet.

trier par

Choisir un critère de tri des images.

top-panel_sort-order icon ordre de tri

Changer l'ordre de tri (croissant/décroissant).

Sur le côté droit

top panel_grouping icon groupement

Montrer ou cacher les images groupées.

top panel_overlays icon surimpression des miniatures

Définir quelles informations sont mises en surimpression sur les miniatures de la table lumineuse/de la pellicule.

Vous pouvez définir différents paramètres en fonction de la taille des miniatures. Voir préférences > table lumineuse pour avoir des détails sur la façon dont les délimiteurs de taille sont définis.

top panel_help icon aide contextuelle

Cliquez cette icône puis sur un élément de contrôle pour être dirigé vers la page d'aide en ligne correspondante.

icône de mappage de raccourci du panneau supérieur mappage de raccourci

Cliquez cette icône pour entrer dans le mode mappage visuel des raccourcis afin de créer des raccourcis clavier/souris.

top panel_preferences icon préférences

Afficher et modifier les préférences de darktable.

raccourcis clavier

La plupart des fonctionnalités de darktable peuvent être contrôlées via des raccourcis clavier qui peuvent être personnalisés dans préférences>raccourcis clavier.

Appuyez sur la touche H (pour obtenir de l'aide) dans n'importe quelle vue de darktable pour afficher une liste de tous les raccourcis applicables à cette vue.

formats de fichier supportés

darktable prend en charge un grand nombre de formats de divers fabricants d’appareils. De plus, il peut lire des images de petite et de grande plage dynamique -- principalement pour des échanges de données entre darktable et d’autres logiciels.

Pour que darktable puisse importer un fichier, il doit avoir l’une des extensions suivantes (la casse n’a pas d’importance) : 3FR, ARI, ARW, BAY, BMQ, CAP, CINE, CR2, CR3, CRW, CS1, DC2, DCR, DNG, GPR, ERF, FFF, EXR, IA, IIQ, JPEG, JPG, K25, KC2, KDC, MDC, MEF, MOS, MRW, NEF, NRW, ORF, PEF, PFM, PNG, PXN, QTK, RAF, RAW, RDC, RW1, RW2, SR2, SRF, SRW, STI, TIF, TIFF, X3F.

Si darktable a été compilé avec la prise en charge de JPEG2000, les extensions suivantes sont aussi reconnues : J2C, J2K, JP2, JPC.

Si darktable a été compilé avec la prise en charge de GraphicsMagick, les extensions suivantes sont aussi reconnues : BMP, DCM, GIF, JNG, JPC, JP2, MIFF, MNG, PBM, PGM, PNM, PPM.

fichiers RAW du boîtier

darktable lit les fichiers RAW en utilisant la bibliothèque open source RawSpeed, originellement développée par Klaus Post et maintenue à présent dans le projet darktable lui-même. Le nombre d’appareils et de formats de fichier pris en charge est en constante augmentation. La plupart des appareils modernes sont pris en charge et la tendance est d'ajouter les nouveaux très rapidement. En donner la liste exhaustive dépasse le cadre de ce manuel.

À l'exception des boîtiers Fujifilm X-Trans, darktable ne décode pas les images provenant d'appareils n'ayant pas un capteur Bayer (ex. les appareils Sigma avec le capteur Foveon X3).

autres fichiers image

darktable lit nativement les images « ordinaires » au format JPEG, PNG 8 bits/16 bits et TIFF 8 bits/16 bits, ainsi que les formats TIFF en virgule flottante 16 bits/32 bits.

darktable lit aussi les images à grande plage dynamique dans les formats OpenEXR, RVBE et PFM.

fichiers liés et édition non destructive

fichiers liés

importer des fichiers liés générés par d'autres applications

copies locales

fichiers liés

darktable est un éditeur d’images non destructif. Il ouvre les images en lecture seule. Toutes les données créées dans darktable (métadonnées, mots-clés et étapes du traitement d'image) sont enregistrées dans un fichier séparé .XMP appelé fichier lié. Ces fichiers sont stockés à côté des fichiers RAW d'origine. Ils permettent à darktable de stocker des informations concernant les images ainsi que l'historique complet de développement sans toucher aux fichiers RAW originaux. Lorsque vous importez une image pour la première fois dans darktable, un fichier lié XMP est automatiquement créé. La génération automatique de ces fichiers liés XMP peut être désactivée dans préférences > stockage> xmp mais ceci n'est pas recommandé dans un usage normal.

Pour une image source donnée, plusieurs versions d'édition, appelées clones, peuvent coexister, partageant les mêmes données d'entrée mais chacune ayant ses propres métadonnées, mots-clés et étapes de traitement. Chaque clone d'une image donnée (nommée <basename>.<extension) est représenté par un fichier lié XMP distinct. Son nom est construit sous la forme <basename>_nn.<extension>.xmp, où nn représente le numéro de version de ce développement. Les informations du premier développement de l'image -- le clone avec le numéro de version zéro -- sont stockées dans le fichier lié <basename>.<extension>.xmp. Dans chacune des vues de darktable, le numéro de version de chaque clone est affiché dans les informations de l'image.

Votre travail est automatiquement synchronisé avec les fichiers liés sans qu'il soit nécessaire d'appuyer sur un bouton « enregistrer ». Lors de la sauvegarde de vos données, assurez-vous de conserver également des copies des fichiers XMP, car ceux-ci sont nécessaires pour reconstruire entièrement votre travail en cas de catastrophe.

Pour un accès rapide, en plus des fichiers liés, darktable conserve toutes les données associées aux images dans une base de données. Une image ne peut être affichée et modifiée dans darktable que si ses données ont été au préalable chargées dans la base de données. Ceci se fait automatiquement lorsque vous importez une image pour la première fois (voir importer). Si une image est ultérieurement réimportée, la base de données sera mise à jour à partir du contenu de son fichier XMP.

Dès qu'une image a été importée dans darktable, les entrées de la base de données ont priorité sur le fichier XMP. Les modifications ultérieures apportées à un fichier XMP par tout autre logiciel ne sont pas visibles par darktable -- ces modifications seront écrasées la prochaine fois que darktable synchronisera ce fichier. Sur demande, darktable peut être configuré pour, au démarrage, rechercher les fichiers XMP mis à jour, offrant le choix de mettre à jour la base de données ou d'écraser le fichier XMP là où des modifications auront été identifiées. Cette configuration peut être modifiée dans préférences > stockage > xmp.

importer des fichiers liés générés par d'autres applications

Lorsqu'il importe une image, darktable teste automatiquement s'il est accompagné d'un fichier lié. En plus de rechercher les fichiers nommés <basename>.<extension>.xmp et <basename>_nn.<extension>.xmp (les formats de dénomination des fichiers XMP de darktable), il vérifie également la présence d'un fichier sous la forme <basename>.xmp (le format de dénomination des fichiers liés XMP de Lighroom). Les fichiers avec ce dernier format de dénomination seront lus par darktable mais il n'y écrira pas. Une fois l'image importée, darktable générera un fichier XMP supplémentaire en utilisant sa propre convention de nommage.

À ce jour, pendant la phase d'importation, darktable est capable de charger les métadonnées suivantes à partir de fichiers liés générés par Lightroom :

mots-clés (y compris les mots-clés hiérarchiques)

les labels de couleurs

les évaluations

les informations GPS

De plus, darktable a été conçu pour faciliter la migration d'opérations de développement des images provenant de certaines applications. L'objectif n’est pas de faire de darktable un remplaçant direct de tout autre logiciel ; il s'agit plutôt de vous aider à récupérer une partie du travail que vous avez déjà investi dans votre image. Il est important de comprendre que ce processus d’importation ne donnera jamais des résultats identiques. Les moteurs de développement sous-jacents sont très différents d’une application à l’autre et dépendent en outre beaucoup de l’image concernée. Dans certains cas, les résultats peuvent être similaires, mais souvent un ajustement supplémentaire sera nécessaire dans darktable.

Cette migration est automatique lorsqu’on entre dans la vue chambre noire à condition qu’un fichier lié XMP soit trouvé.

À ce jour, darktable est capable de prendre en charge les étapes de développement suivantes des fichiers XMP générés par Lightroom (module correspondant de darktable entre parenthèses) :

recadrer et pivoter (recadrer et pivoter)

niveau de noir (exposition)

exposition (exposition)

vignettage (vignettage)

clarté (contraste local)

courbes des tonalités (courbe des tonalités)

TSL (zones de couleur)

virage partiel (virage partiel)

grain (grain)

correction des taches (correction des taches)

copies locales

De nombreux utilisateurs ont d'énormes collections d'images stockées sur des disques durs supplémentaires dans leur ordinateur de bureau ou sur un support de stockage externe (NAS RAID, disques durs externes, etc.).

Il est fréquent de vouloir développer des images lors d’un voyage en utilisant un ordinateur portable et de vouloir ensuite les synchroniser sur le support de stockage d'origine. Mais copier les fichiers manuellement du stockage principal vers l’ordinateur portable et inversement est fastidieux et source d’erreurs. La fonctionnalité de « copies locales » de darktable a été conçue pour prendre en charge ces cas d’utilisation.

Vous pouvez créer des copies locales d'images sélectionnées dans la table lumineuse. Ces copies locales sont toujours utilisées quand elles sont présentes, donnant un accès continu aux images même si le stockage externe n'est plus connecté. Ultérieurement, lorsque votre support de stockage principal a été reconnecté, vous pouvez synchroniser les fichiers liés XMP sur ce stockage, en supprimant toutes les copies locales. Ces opérations peuvent être trouvées dans le panneau images sélectionnées de la table lumineuse.

Pour des raisons de sécurité, s’il existe des copies locales et que le stockage externe est disponible, alors les fichiers liés XMP locaux seront automatiquement synchronisés au démarrage.

Les copies locales sont enregistrées dans le répertoire $HOME/.cache/darktable et sont nommées img-<SIGNATURE>.<EXT> (où SIGNATURE est une signature de hachage (MD5) du chemin complet et EXT est l'extension du fichier d'origine.

Une copie locale est identifiée dans la vue table lumineuse par une marque blanche dans le coin supérieur droit de la miniature. De plus toutes les copies locales possèdent le mot-clé darktable|local-copy pour pouvoir être sélectionnées rapidement.

une introduction au flux de travail de darktable

introduction

importer et examiner

processus

exporter

introduction

Cette section est destinée à vous donner un aperçu de ce que darktable peut faire et à suggérer un flux de travail permettant de traiter des images de bout en bout. Les nouveaux utilisateurs doivent commencer par parcourir cette introduction et suivre les liens fournis pour plus de détails.

Veuillez noter qu'il ne s'agit pas d'un guide exhaustif et que de nombreux sujets utiles ne sont pas traités. Il est conseillé de lire les sections de référence de ce manuel une fois que vous vous êtes familiarisé avec les bases.

De plus amples informations sur la plupart des sujets de ce guide sont également couvertes dans la section autres ressources.

importer et examiner

Avant de pouvoir faire quoi que ce soit dans darktable, vous devez d'abord ajouter des fichiers d'images à la bibliothèque en utilisant le module importer dans la vue table lumineuse. Cela créera des entrées pour vos images dans la base de données de darktable afin qu'elle puisse suivre les modifications que vous apportez. Il existe trois façons d'importer des images, chacune accessible via les boutons du module importer :

ajouter à la bibliothèque

Cette option ajoute des images à la bibliothèque sans rien copier ni déplacer -- vos fichiers originaux resteront à leur emplacement actuel et ne seront pas modifiés. Lors de l'importation, darktable lira les métadonnées des fichiers image et tous les fichiers XMP associés. Si une image a déjà été ajoutée à la base de données, toutes les mises à jour que vous avez apportées à son fichier lié seront chargées.

copier et importer

Copie les images dans l'emplacement de stockage (en suivant le modèle de nommage de fichier défini dans préférences > importer), puis ajoute les images copiées à la bibliothèque -- les images originales ne sont ni modifiées ni déplacées.

copier et importer depuis le boîtier

Connectez le boîtier à votre système avec un câble USB (si votre boîtier est monté automatiquement par votre système, vous devrez tout d'abord le démonter pour que darktable puisse y accéder). Si vous ne voyez pas votre boîtier répertorié dans le module importer, appuyez sur le bouton « rechercher les appareils ». Une fois que votre boîtier est détecté, le module importer devrait offrir la possibilité de copier et d'importer les images qu'il contient. Cliquer sur le bouton "copier et importer" déclenche la copie physique des images sélectionnées du boîtier dans un répertoire spécifié (en suivant le modèle de nommage de fichier défini dans préférences > importer). Les images copiées sont ensuite ajoutées à la bibliothèque.

Une fois les images importées, leurs miniatures sont affichées dans la vue table lumineuse, dans laquelle vous pouvez organiser et cataloguer vos images importées -- veuillez vous référer à la section gestion des actifs numériques pour plus d'informations.

Une utilisation importante de la vue table lumineuse consiste à examiner vos images pour décider lesquelles vous souhaitez développer, et lesquelles vous allez rejeter. Voici un processus de sélection possible pour choisir les images à développer/rejeter :

À l'aide du paramètre afficher du panneau supérieur, réglez la vue table lumineuse pour qu'elle n'affiche que les images avec une évaluation d'exactement 1 étoile. Puisque darktable attribue par défaut une évaluation de 1 étoile aux images nouvellement importées, seront affichées toutes les images que vous venez d'importer. Vous pouvez utiliser le module collections pour affiner davantage votre sélection si nécessaire.

Effectuez un examen rapide de premier niveau de chacune de vos images : si une image est très floue ou indésirable, rejetez-la ou attribuez-lui une évaluation de 0 étoile (en appuyant sur les touches "R" ou "0", respectivement, en survolant cette image avec votre souris). Si vous souhaitez qu'une image soit examinée à la phase suivante, appuyez sur 2 pour lui attribuer une évaluation de 2 étoiles. Toutes les images n'ayant plus une évaluation de 1 étoile disparaîtront automatiquement de la vue. Continuez de cette manière jusqu'à ce que plus aucune image ne reste visible dans la vue table lumineuse.

Modifiez la vue table lumineuse pour qu'elle affiche uniquement les images avec 2 étoiles. Examinez chacune de ces images plus attentivement et décidez si vous souhaitez la promouvoir à 3 étoiles ou la ramener à une évaluation inférieure. Encore une fois, continuez jusqu'à ce qu'il ne reste plus d'image dans la vue table lumineuse.

Modifiez la vue table lumineuse pour qu'elle affiche uniquement les images avec 3 étoiles. Effectuez des modifications et des expériences rapides sur chacune de ces images dans la vue chambre noire pour décider si elle mérite un effort supplémentaire. Si, pour une image donnée, vous êtes satisfait des résultats de ces modifications, attribuez lui une évaluation de 4 étoiles pour qu'elle participe au développement final.

Effectuez les dernières modifications sur chacune de vos images 4 étoiles, puis exporter-la pour voir le résultat final. Augmentez son évaluation une dernière fois à 5 étoiles pour indiquer que son traitement est terminé.

Si l'espace est limité, vous pouvez envisager de supprimer définitivement vos images rejetées ou 0 étoile. Sélectionnez ces images dans la vue table lumineuse et utilisez l'option 'supprimer (poubelle)' dans le module images sélectionnées. Vous ne devez le faire que pour les images dont vous êtes certain de ne plus jamais avoir besoin.

processus

Cette section est destinée à vous mettre à l'aise lors du traitement des images dans la vue chambre noire en utilisant le flux de travail relatif à la scène. Il est conseillé de suivre les directives fournies ci-dessous, jusqu'à la fin de la section traitement d'image en 3 modules. Ensuite, au fur et à mesure de vos besoins, vous pourrez choisir d'autres domaines pour apprendre des techniques que vous pourrez utiliser dans vos images.

pour commencer

prendre une photo bien exposée

Les bonnes techniques de traitement d'image commencent dans le boîtier -- une image bien exposée (sans hautes lumières cramées et sans noirs fortement bouchés) rendra toujours le post-traitement beaucoup plus simple. La sous-exposition ou la surexposition peut être "corrigée" dans une certaine mesure par darktable, mais aucun logiciel ne peut récupérer des informations qui ne sont pas présentes dans l'image RAW. Dans la mesure du possible, il est conseillé d'utiliser des techniques d'exposition à droite (ETTR) pour maximiser la quantité de données disponibles pour le traitement. En règle générale, il est prudent de sous-exposer toutes les images de 0,5 à 1 IL (en réduisant la sensibilité ISO si possible) même si l'aperçu du boîtier semble plus sombre que prévu (l'aperçu n'est pas celui des données RAW) .

flux de travail relatif à la scène : une nouvelle approche

Si vous avez utilisé dans le passé d'autres logiciels traitant les images RAW (ou darktable avant la version 3.0), vous remarquerez peut-être des différences significatives par rapport à ce à quoi vous êtes habitué -- darktable utilise maintenant une approche relatif à la scène pour la plupart de ses modules de traitement. Cette approche est largement utilisée en cinématographie et est connue pour être beaucoup plus robuste que l'approche traditionnelle relatif à l'affichage.

Dans le traitement relatif à l'affichage, les données de votre fichier RAW sont initialement compressées dans une plage qui représente le noir pur par 0 et le blanc pur par 1, fixant le gris moyen à 0,5. Une courbe de tonalité est automatiquement (et irréversiblement) appliquée à ces données pour que l'image soit « bonne » sur votre écran. Ensuite des transformations sont effectuées sur ces données d'image déjà fortement modifiées. Le coût de ce traitement relatif à l'affichage est une perte précoce de la relation entre la luminosité et la saturation des pixels (il entraîne aussi généralement des décalages de teinte). Ceci est responsable du tristement célèbre "aspect HDR" lorsque la plage dynamique augmente.

Dans le monde réel, le "noir pur" n'existe pas vraiment (il y a toujours un peu de lumière) et il n'y a pas de limite à la luminosité des choses (donc pas de "blanc pur" non plus). Le traitement relatif à la scène tente de conserver les propriétés physiques de la scène aussi longtemps que possible en plaçant les données RAW sur une échelle linéaire non bornée et en ne compressant les données dans la plage dynamique de votre affichage qu'une fois le traitement de l'image terminé.

Dans un flux de travail relatif à la scène, de nombreux outils courants (courbes et niveaux de tonalité, par exemple) ne sont plus des moyens utiles pour manipuler l'image, car ils reposent sur des définitions désormais invalides du noir, du blanc et du gris. Les utilisateurs expérimentés peuvent avoir besoin d'apprendre de nouvelles techniques et de se débarrasser des anciennes, mais seront récompensés par des résultats beaucoup plus robustes et prévisibles.

Définissez maintenant préférences > traitement > flux de travail par défaut à "relatif à la scène".

Entrez les préférences en cliquant sur l'icône d'engrenage dans le panneau supérieur.

balance des blancs et calibration des couleurs

La plupart des logiciels de traitement utilisent un modèle traditionnel de température/teinte pour ajuster la balance des blancs d'une image. Dans darktable, le module calibration des couleurs fournit une approche beaucoup plus robuste et flexible, vous permettant de définir explicitement la couleur de la source lumineuse. Ceci est particulièrement utile pour les scènes illuminées par un éclairage artificiel.

Veuillez noter que le module balance des blancs est toujours activé dans cette approche, mais ses paramètres ne devraient normalement pas être modifiés.

Définissez maintenant préférences> traitement> appliquer l'adaptation chromatique par défaut sur «moderne».

développer dans un environnement contrôlé

Le traitement des images doit être effectué dans un environnement contrôlé, éclairé par une source de lumière blanche sur un fond proche du gris moyen, et avec un moniteur correctement calibré.

Bien que cela puisse ne pas être pratique dans de nombreux environnements de développement à domicile, vous pouvez contrôler les couleurs d'arrière-plan de l'écran de votre moniteur. Vous devez définir le schéma de couleurs de darktable en utilisant l'un des thèmes "gris" et utiliser le mode d'évaluation des couleurs lors de la modification des tons et des couleurs de votre image. Les thèmes sombres peuvent sembler intéressants, mais, à moins que vous ne traitiez des images à visionner sur un écran de cinéma dans une pièce sombre, ils ne doivent pas être utilisés pour le traitement de photos.

Définissez maintenant préférences > général > thème à "darktable-elegant-grey" ou à "darktable-icons-grey".

entrer dans la chambre noire

Choisissez une image à développer dans la vue table lumineuse et double-cliquez pour charger cette image dans la vue chambre noire. Pour l'instant, essayez de choisir une image bien exposée -- nous discuterons plus tard de certaines techniques pour récupérer des images mal exposées.

Dans la vue chambre noire, vous verrez à droite de votre image une liste de modules de traitement. Chaque module effectue son propre traitement sur l'image, dans l'ordre indiqué dans la liste des modules, en commençant par le bas de la liste et en remontant vers le haut. Vous pouvez considérer cela comme une pile de blocs de construction où chaque bloc s'appuie sur le traitement effectué par les modules en dessous.

Sur le côté gauche se trouve l'historique (vous devrez peut-être développer le module) qui montre l'ordre dans lequel des ajustements ont été apportés aux contrôles des différents modules. Cela vous permet d'annuler les modifications en revenant à une étape antérieure de l'historique. Vous verrez qu'un certain nombre de modules sont appliqués automatiquement - ils sont nécessaires pour générer une image lisible à partir des données brutes.

Il est important de comprendre la distinction entre l'ordre des modules sur le côté droit de l'écran (qui représente l'ordre dans lequel les modules seront exécutés) et l'ordre des modules dans l'historique (qui représente l'ordre dans lequel les modules ont été modifiés).

En haut à droite se trouve le module des scopes qui montre la répartition des tons/couleurs dans votre image.

Si vous avez déjà visualisé ou modifié l'image dans la vue chambre noire, commencez par effacer l'historique (cliquez sur le bouton réinitialiser dans l'historique). Cela réappliquera les valeurs par défaut en utilisant vos nouveaux paramètres et fournira un point de départ propre pour le développement.

pourquoi l'image RAW ne ressemble-t-elle pas à l'image JPEG ?

...parce que vous ne l'avez pas encore traitée

L'une des premières choses que les gens remarquent lorsqu'ils passent de la vue table lumineuse à la vue chambre noire est que l'image est différente -- souvent plus plate et moins saturée que celle affichée dans la vue table lumineuse. En effet, la vue chambre noire affiche l'image RAW (principalement non traitée), mais la vue table lumineuse affiche initialement l'aperçu JPEG (du boîtier). Maintenant que vous avez ouvert l'image dans la vue chambre noire, la vue table lumineuse sera mise à jour pour afficher la version développée.

La plupart des logiciels de traitement des photos RAW se donnent beaucoup de mal pour reproduire l'apparence des photos JPEG des boîtiers standard prêts à l'emploi. Bien que cela puisse être utile (si vous ne souhaitez apporter que des ajustements très mineurs au rendu d'une photo fournie par le boîtier), nous supposons que vous utilisez un éditeur RAW pour personnaliser l'image et que le boîtier ne sait pas comment faire cela. Certes, si vous utilisez les techniques ETTR mentionnées ci-dessus, les photos JPEG fournies par le boîtier seront rarement proches de l'aspect que vous souhaitez leur donner.

Les paramètres par défaut de darktable sont donc destinés à vous fournir un point de départ neutre pour une édition ultérieure et rien de plus. Nous n'avons pas l'intention de changer cela.

les groupes de modules

Sous le module des scopes en haut à droite de l'écran se trouve un ensemble d'onglets dans lesquels les modules de darktable sont groupés. Si vous ne trouvez pas un module dans l'un des onglets, vous pouvez utiliser la fonction de recherche pour le localiser.

Pour les besoins de ce guide, cliquez sur l'icône du hamburger (à droite des onglets) et sélectionnez maintenant le préréglage « flux de travail : relatif à la scène ».

traitement d'images en 3 modules

Les modifications basiques suivantes sont fondamentales pour les développements relatif à la scène et seront nécessaires, dans une certaine mesure, pour la majorité des images. Vous pouvez généralement produire une belle image avec ces seules étapes.

Comme vous allez ajuster les tons et les couleurs de l'image, commencez par activer le mode évaluation des couleurs (appuyez sur Ctrl+B) et effectuez dans ce mode les modifications suivantes sur l'image dézoomée.

Définir la luminosité globale de l'image : tout d'abord, définissez la luminosité globale (moyenne) de l'image (le point gris moyen) en ajustant le curseur exposition dans le module exposition. Il s'agit d'un paramètre purement artistique et doit être défini en fonction de votre objectif -- par exemple, pour obtenir une image à tons clairs prédominants (high-key), vous définirez une luminosité moyenne plus intense que celle que vous définiriez pour obtenir une image à tons foncés prédominants (low-key). Le mode évaluation des couleurs vous fournit deux points de référence pour vous aider en entourant l'image d'un cadre blanc sur un fond gris moyen.

À ce stade, ne vous inquiétez pas si les parties les plus lumineuses de votre image perdent des détails -- cela peut être récupéré à l'étape suivante.

Remarque : Le module correction des objectifs peut également affecter la luminosité de l'image donc vous pouvez envisager de l'activer avant de régler l'exposition.

Définir les points blanc et noir : Les deux étapes suivantes utilisent le module filmique rvb pour définir comment les tons de votre image seront projetés sur la plage dynamique de votre écran. Commencez par régler les curseurs d'exposition relative du blanc et du noir dans l'onglet scène. Ce sont des paramètres purement techniques, définissant le blanc et le noir par rapport au point gris moyen que vous avez défini à l'étape précédente. Si votre image contient des tons que vous souhaitez traiter comme du blanc pur ou du noir pur, vous pouvez utiliser les pipettes de couleur situés à côté des curseurs pour définir ces valeurs (en utilisant les luminosités maximale et minimale de l'image). Sinon, définissez les valeurs manuellement en utilisant les cadres d'évaluation des couleurs comme référence.

Ajuster le contraste : Passez maintenant à l'onglet look dans filmique rvb (pour l'instant, nous allons sauter l'onglet reconstruire). Activez la vue look uniquement en haut du module pour voir une représentation de la courbe des tonalités filmique. Elle est constituée au milieu d'une section rectiligne (utilisée pour régler le contraste des tons moyens) et en haut et en bas de sections courbes (où les ombres et les hautes lumières sont compressées pour s'adapter à la plage dynamique de l'affichage).

Le curseur contraste modifie la pente de la section rectiligne (le contraste de l'image dans les demi-tons), le curseur latitude modifie sa longueur et le curseur balance ombres/hautes lumières change sa position. Il y a beaucoup de concessions mutuelles ici -- si vous voulez augmenter le contraste dans les tons-moyens, vous devez sacrifier le contraste dans les ombres/hautes lumières et vice versa. Les paramètres par défaut de ce module sont réglés pour fonctionner pour la majorité des images, mais vous devez expérimenter avec ces curseurs pour comprendre comment ils affectent l'image.

Remarque : La compression des hautes lumières dans le module filmique rvb peut entraîner la perte de détails dans les hautes lumières. Vous pouvez atténuer cela dans une certaine mesure en réduisant l'exposition relative des blancs, en ajustant la balance des ombres/hautes lumières ou en modifiant le contraste hautes lumières dans l'onglet options. Le module égaliseur de ton peut également être utilisé pour réduire la luminosité relative du ciel.

Conservation des couleurs : Le mappage des tons dans le module filmique tente de redistribuer les tons de votre image sans affecter la reproduction des couleurs. Bien que l'algorithme de préservation des couleurs par défaut fonctionne pour la plupart des images, nous vous encourageons à expérimenter en modifiant le paramètre préserver couleur dans l'onglet options si vous n'aimez pas la façon dont les couleurs apparaissent.

Saturation : votre image ne sera probablement pas très colorée à ce stade. Vous pouvez régler la saturation globale de l'image à l'aide du module balance couleur rvb. "ajoute saturation de base" preset devrait vous fournir des valeurs par défaut généralement raisonnables, mais nous vous encourageons à expérimenter davantage avec ces paramètres si nécessaire.

Remarque : Ce guide suppose que la balance des blancs de l'image a été correctement capturée par votre boîtier. Si ce n'est pas le cas, vous devrez peut-être d'abord effectuer quelques corrections dans le module calibration des couleurs.

Vous pouvez maintenant désactiver le mode évaluation des couleurs en appuyant à nouveau sur Ctrl+B.

autres techniques de traitement

Avec de la pratique, le flux de travail ci-dessus peut rapidement vous fournir une image d'apparence raisonnable, bien que la plupart nécessitent un travail supplémentaire avant d'être prêtes à être exportées. Les sections suivantes sont destinées à fournir un bref aperçu de quelques autres techniques de traitement d'image dans darktable, avec des liens vers les sections de référence pertinentes pour plus d'informations.

En règle générale, vous devez commencer par les étapes de base décrites dans la section précédente, puis effectuer corrections et terminer avec ajustements créatifs.

corrections

calibration des couleurs

La correction traditionnelle de la balance des blancs tente de s'assurer que les blancs et les gris sont vraiment neutres (R = V = B) et n'essaie pas vraiment de gérer l'impact sur les autres couleurs. L'onglet CAT du module calibration des couleurs étend ce traitement pour gérer le reste de la gamme de couleurs et travaille dans un espace colorimétrique conçu spécifiquement pour l'adaptation chromatique (couleur). Comme avec les contrôles de la balance des blancs traditionnelle, vous pouvez sélectionner une zone de gris neutre dans votre image pour calculer la balance des blancs, ou utiliser une sélection d'autres méthodes automatiques et manuelles. Les paramètres par défaut utilisent la balance des blancs des données Exif de l'image et sont généralement suffisants.

Si vous devez effectuer des ajustements dans le module calibration des couleurs, vous pouvez également souhaiter revoir les corrections de saturation que vous avez faites précédemment dans le module balance couleur rvb.

corriger les distorsions de l'objectif

Tous les objectifs introduisent des artefacts à l'image (distorsion, aberrations chromatiques, vignettage). Le module correction des objectifs peut corriger bon nombre de ces problèmes pour une grande variété d'objectifs. Les modules aberrations chromatiques et aberrations chromatiques RAW peuvent également être utilisés pour gérer les aberrations chromatiques pour les objectifs qui ne sont pas (ou qui le sont seulement partiellement) pris en charge par le module correction des objectifs. Dans la plupart des cas, le simple fait d'activer le module correction des objectifs détectera automatiquement votre objectif et appliquera automatiquement toutes les corrections disponibles.

Si vous décidez d'utiliser le module correction des objectifs, il doit être activé au début de votre développement, avant de régler l'exposition, car la correction du vignettage peut altérer la luminosité globale de votre image.

réduire le bruit / conserver les détails

Au niveau du pixel, il y a un compromis à faire entre la conservation des détails fins et la réduction/suppression du bruit du capteur. Dans la plupart des situations, une petite quantité de bruit est parfaitement acceptable et ne sera pas perceptible sauf lorsque vous zoomez à 100 %. À cette échelle, vous ne visualisez pas l'image à une taille réaliste -- même lorsqu'elle est représentée sur un grand écran ou une impression, le bruit qui est évident à des facteurs de zoom élevés sera pratiquement invisible sur l'image finale. Cependant, certains modules intervenant plus tardivement dans le pipeline graphique (en particulier ceux qui augmentent le contraste local) peuvent finir par exagérer tout bruit présent, donc, encore une fois, il y a des compromis à faire.

Le premier module que vous pouvez utiliser pour gérer cela est dématriçage, qui contrôle la façon dont les pixels monochromes (R, V ou B) dans votre fichier RAW sont convertis en pixels image en combinant les trois couleurs. Chaque algorithme de dématriçage a ses propres compromis entre la conservation des détails fins et la réduction du bruit. L'algorithme de dématriçage par défaut (RCD) fournit généralement un compromis raisonnable.

Les algorithmes de dématriçage ne peuvent pas faire grand-chose pour gérer le bruit dans votre image. Le module réduction du bruit (profil) est réglé spécifiquement pour un certain nombre de capteurs de boîtier courants et peut être utilisé pour réduire ou supprimer le bruit des pixels. Comme pour le dématriçage, vous devez modifier les paramètres jusqu'à ce que vous soyez satisfait de l'équilibre entre la réduction du bruit et la reproduction des détails fins. Les paramètres par défaut sont généralement suffisants.

netteté et contraste local

Un certain nombre de modules peuvent être utilisés pour ajuster le contraste local et la netteté de votre image. La plupart de ces modules visent à accentuer le contraste apparent des contours et n'ajoutent pas de "vraie" netteté (ce ne sont pas les mêmes que la déconvolution de l'objectif). Vous devez faire attention lorsque vous utilisez ces modules car la plupart d'entre eux peuvent introduire des artefacts (tels que des halos) lorsque les paramètres sont poussés trop loin :

le module égaliseur de contraste vous permet d'ajuster le contraste, en limitant l'effet à des éléments de certaines tailles. Par exemple, vous pouvez l'utiliser pour augmenter le contraste des détails fins sans impacter les objets de plus grande échelle, ou vice versa

le module diffusion/netteté offre un certain nombre de préréglages pour renforcer la netteté, pour atténuer le flou d'objectif et pour ajouter du contraste local

le module contraste local fournit une interface plus simple pour ajouter rapidement un contraste local à vos images -- activer le module ou sélectionner l'un des préréglages est souvent tout ce qui est requis

le module renforcer la netteté est destiné à réintroduire la netteté qui a été supprimée par le filtre anti-alias de votre boîtier (le cas échéant) et peut être activé par défaut dans préférences > traitement > applique automatiquement de la netteté. Les méthodes répertoriées ci-dessus sont généralement préférées à ce module originel.

Comme pour les modules mentionnés dans la section précédente, vous devez faire attention lorsque vous ajoutez du contraste à des objets de petite échelle -- une image vue à 100% n'est pas une représentation réaliste de votre développement final et les ajustements de contraste locaux sont généralement mieux évalués quand un zoom arrière a été appliqué à l'image.

reconstruire les hautes lumières cramées

Alors qu'une image bien exposée rendra le post-traitement beaucoup plus facile, darktable fournit certains outils pour gérer les hautes lumières cramées et même dans certains cas pour reconstruire les couleurs ou la structure perdues.

Le module reconstruire hautes lumières fournit une tentative très basique pour gérer les hautes lumières cramées. Par défaut, si un canal de couleur d'un pixel est écrêté, ce module affectera à ce pixel la couleur blanche -- cela évite que darktable affiche des couleurs non naturelles dans les hautes lumières. Cependant, le module peut être modifié afin qu'il tente de reconstruire la clarté ou la couleur en utilisant des canaux non écrêtés. Bien que cela puisse réintroduire certains détails, méfiez-vous des couleurs irréalistes qui peuvent en résulter.

Une meilleure alternative est de désactiver reconstruire hautes lumières et d'utiliser à la place l'onglet reconstruire du module filmique rvb. Comme le module reconstruire hautes lumières, filmique est capable de reconstruire les détails sur la base de canaux non écrêtés. Lorsque cela n'est pas possible, il peut également mélanger en douceur les hautes lumières cramées avec le reste de l'image ou extraire les couleurs des pixels adjacents. Lorsque vous incorporez cette étape dans votre flux de travail, vous devez le faire en même temps que d'autres modifications filmique rvb, en effectuant des ajustements dans chaque onglet du module à tour de rôle, de gauche à droite.

ajuster l'angle et la perspective

Le module rotation et perspective peut être utilisé pour ajuster l'angle de l'image ou pour simuler la fonctionnalité d'un objectif à bascule/décalage en modifiant la perspective, en rendant parallèles des lignes horizontales ou verticales qui sont concourantes (correction trapézoïdale). Cette dernière technique est plus couramment utilisée pour la photographie d'architecture. Si vous voulez juste corriger l'angle de l'horizon, vous pouvez le faire en cliquant avec le bouton droit et en faisant glisser le long de la ligne d'horizon.

enlever les taches et les objets indésirables

Utilisez le module retouche pour supprimer les objets indésirables en remplaçant des pixels par des détails provenant d'une autre partie de l'image. Ce module propose également des techniques puissantes pour éliminer les objets à grande échelle (comme les taches ou les imperfections) tout en laissant intacts les détails à petite échelle (comme les poils et les follicules). L'utilisation la plus courante de ce module est d'éliminer les taches de poussière des images ou les imperfections de la peau.

éliminer la brume atmosphérique

Il existe deux méthodes pour éliminer la brume atmosphérique dans darktable. Le module suppression de la brume fournit une interface beaucoup plus simple, mais le préréglage "suppression de brume" du module diffusion ou netteté peut offrir plus de flexibilité en cas de besoin.

ajustements créatifs

recadrer et encadrer

Utilisez le module recadrer pour recadrer votre image et le module cadre décoratif pour entourer votre image d'un cadre coloré. Les deux modules peuvent être configurés pour utiliser un rapport hauteur/largeur prédéfini ou personnalisé. Par exemple, vous pouvez placer une image recadrée au carré dans un cadre 3:2.

assombrir et brûler (dodge and burn)

Assombrir et brûler est une technique traditionnelle de chambre noire pour ajouter et supprimer de la luminosité à une image. Il existe deux méthodes recommandées pour y parvenir

Si vous souhaitez assombrir ou brûler de manière sélective uniquement certains objets, vous pouvez appliquer une nouvelle instance du module exposition en utilisant un masque dessiné pour isoler l'effet à la zone requise de l'image (voir aussi la section affinement du masque pour plus d'informations). Déplacez le curseur d'exposition pour modifier la luminosité de la zone définie par le masque.

Si vous souhaitez assombrir ou brûler des zones ayant une luminosité similaire (par exemple, pour éclaircir les ombres ou assombrir les hautes lumières), vous devez utiliser le module égaliseur de ton.

convertir en monochrome

darktable propose plusieurs méthodes pour supprimer la couleur de votre image. La méthode la plus flexible consiste à utiliser l'onglet gris du module calibration des couleurs. Un certain nombre de préréglages d'émulation de film sont disponibles dans ce module pour vous fournir un point de départ.

Voir la section développer des images monochromes pour avoir des détails sur d'autres techniques.

gradation des couleurs

Le module balance couleur rvb est votre service tout en un pour contrôler les couleurs de votre image. Les ajustements peuvent être isolés aux ombres, aux hautes lumières et aux tons moyens, ou appliqués à un niveau global.

d'autres sujets importants

réutiliser les paramètres de module communs

Si vous utilisez souvent les mêmes paramètres de module, vous pouvez créer des préréglages contenant vos paramètres préférés. Si vous utilisez les mêmes paramètres sur toutes les images, vous pouvez également faire en sorte que les préréglages s'appliquent automatiquement aux nouvelles images. Par exemple, vous pouvez vous retrouver en train d'ajouter les mêmes paramètres d'exposition à toutes les images prises par un certain boîtier -- dans ce cas, vous pouvez créer un préréglage qui applique automatiquement ces paramètres uniquement aux images de ce boîtier.

Vous pouvez également avoir des groupes de paramètres de module que vous n'appliquez généralement qu'à certains types d'images. Vous pouvez utiliser des styles pour appliquer plusieurs paramètres de module à la fois à une sélection d'images.

effectuer des réglages localement

La plupart des modules de darktable peuvent être appliqués à l'ensemble de l'image ou peuvent voir leur action limitée à des parties de l'image en utilisant des masques dessinés et paramétriques.

contrôler darktable avec d'autres méthodes de saisie

Vous n'avez pas nécessairement besoin d'utiliser l'interface utilisateur de darktable pour développer vos images. La plupart des fonctionnalités de darktable peuvent également être contrôlées à l'aide de raccourcis définis pour votre clavier/souris et même pour d'autres périphériques d'entrée tels que les manettes de jeu et les périphériques MIDI. Voir la section raccourcis pour plus de détails.

exporter

darktable est un éditeur non destructif, ce qui signifie que toutes les modifications sont enregistrées dans la base de données de la bibliothèque (avec une sauvegarde stockée dans un fichier lié XMP) et que le fichier RAW d'origine n'est pas modifié. Vous devez donc exporter les images afin d'intégrer vos modifications dans un fichier de sortie pouvant être distribué en dehors de darktable.

Choisissez un scénario d'exportation.

Le module exporter offre de nombreuses options, mais l'utilisation de loin la plus courante consiste à « enregistrer une image brute développée au format JPEG ». Vous pouvez soit exporter l'image actuellement éditée directement depuis la vue chambre noire, soit sélectionner une ou plusieurs images depuis la vue table lumineuse et les exporter toutes en même temps.

Sélectionnez les images à exporter (si vous êtes dans la vue table lumineuse), ouvrez le module exporter, définissez stockage cible sur "fichier sur le disque" et sélectionnez un emplacement pour enregistrer vos images -- par défaut, elles seront exportées vers un répertoire nommé "darktable_exported" dans le répertoire qui contient votre (vos) fichier(s) RAW. Choisissez un "format de fichier" JPEG et conservez les paramètres par défaut.

Cliquez le bouton "exporter" pour enregistrer vos images traitées dans l'emplacement sélectionné.

Remarque : Bien que JPEG soit utile dans la plupart des cas, si vous souhaitez effectuer d'autres modifications dans un éditeur raster comme GIMP ou Krita, il est normalement préférable d'exporter au format tiff.

Table lumineuse

présentation

disposition de la vue table lumineuse

annuler/refaire

modes de la table lumineuse

gestion des données numériques

présentation

La vue de la table lumineuse vous permet de visualiser et de gérer votre collection d'images.

La zone centrale contient des miniatures de vos images -- la manière dont elles sont affichées dépend du mode dans lequel vous travaillez.

Lorsque la souris se trouve sur une miniature d'image ou lorsque des images sont sélectionnées, vous pouvez exécuter les actions suivantes à l'aide de raccourcis clavier :

0 – 5      définir l'évaluation de l'image
           si une image a 1 étoile et si vous appuyez sur la touche 1, l'image devient non évaluée
R          évaluer l'image comme « rejetée »
F1 – F5    définir un label de couleur
Ctrl+C     copier l'historique
Ctrl+V     coller l'historique copié
D          ouvrir la vue chambre noire pour développer
W          zoomer complètement l'image actuelle tant que la touche est enfoncée
Ctrl+W     zoomer complètement l'image actuelle et afficher les zones de mise au point

disposition de la vue table lumineuse

panneau gauche

De haut en bas :

importer

Importer des images depuis le système de fichiers ou depuis un boîtier connecté.

collections

Filtrer les images affichées dans le panneau central de la table lumineuse -- aussi utilisé pour contrôler les images affichées dans les modules pellicule et chronologie.

collections récemment utilisées

Afficher les collections d'images récemment utilisées.

informations de l'image

Afficher les informations de l'image.

installer les scripts Lua (optionnel)

Installer les scripts Lua.

panneau droit

De haut en bas :

sélection

Sélectionner des images de la table lumineuse en utilisant des critères simples.

images sélectionnées

Effectuer des actions sur les images sélectionnées.

développement

Manipuler le développement des images sélectionnées.

styles

Stocker l'historique d'une image en tant que style nommé et l'appliquer à d'autres images.

éditeur de métadonnées

Éditer les métadonnées des images sélectionnées.

mots-clés

Étiqueter par mots-clés les images sélectionnées.

géolocalisation

Importe et applique les données de suivi GPX aux images sélectionnées.

exporter

Exportez les images sélectionnées vers des fichiers locaux ou des services externes.

panneau inférieur

De gauche à droite :

évaluations par étoiles

Appliquer des évaluations par étoiles aux images.

labels de couleur

Appliquer des catégories de couleurs aux images.

sélecteur du mode

Choisir un mode de la table lumineuse.

zoomer

Ajuster la taille des miniatures.

icône mise au point active le mode détection de mise au point

Mettre en surbrillance les parties de l'image qui sont dans la zone de mise au point.

icône écran définir le profil écran

Choisir le profil écran de votre (vos) moniteur(s).

annuler/refaire

La plupart des modifications de la table lumineuse sont enregistrées et peuvent être annulées. Cela inclut les modifications apportées aux labels de couleur, aux évaluations, à la géolocalisation, aux mots-clés, aux métadonnées, à l'orientation, au copier/coller de l'historique, au clonage de l'image ou à l'application d'un style. Notez que cette fonction annuler/refaire accepte un nombre illimité d'enregistrements d'états tant qu'on reste dans la table lumineuse, mais elle est réinitialisée à chaque fois que vous passez à une autre vue.

Tapez Ctrl+Z pour annuler la dernière modification et Ctrl+Y pour refaire la dernière modification annulée (s'il y en a une).

modes de la table lumineuse

navigateur de fichiers

table lumineuse zoomable

sélection

aperçu complet

navigateur de fichiers

Dans le mode par défaut, les images sont affichées dans une grille avec un nombre réglable d'images par ligne.

contrôles

zoomer

Le nombre d'images dans chaque ligne peut être modifié à l'aide du curseur dans le panneau inférieur ou en maintenant la touche Ctrl enfoncée tout en faisant défiler la vue centrale avec votre souris.

naviguer

Vous pouvez naviguer dans les images à l'aide des touches fléchées (←/→/↑/↓) ou en faisant défiler avec votre souris. Appuyez sur la touche Début pour faire défiler vers le haut de la collection, la touche Fin pour faire défiler vers le bas et PageUp/PageDown pour faire défiler d'une page vers le haut/bas.

sélectionner

Vous pouvez sélectionner l'image sous le pointeur en cliquant sur sa miniature ou en appuyant sur Entrée. Une plage d'images peut être sélectionnée en cliquant sur la première image, puis en faisant un Maj+clic sur la dernière. Les images peuvent être ajoutées ou supprimées d'une sélection en faisant un Ctrl+clic sur leurs miniatures ou en appuyant sur la barre d'espace.

table lumineuse zoomable

Le mode table lumineuse zoomable fournit une manière alternative de parcourir de grandes collections d'images, mais avec quelques similitudes avec le mode navigateur de fichiers (décrit ci-dessous).

contrôles

zoomer

Faites défiler avec la molette de la souris pour effectuer un zoom avant et arrière de la table lumineuse (à comparer à Ctrl+défilement dans le mode navigateur de fichiers.

Le zoom des miniatures ne modifie pas le nombre de miniatures par ligne, de sorte que la table lumineuse peut dépasser la zone visible de tous les côtés.

naviguer

Maintenez le bouton gauche de la souris enfoncé et faites glisser pour déplacer la table lumineuse et naviguer dans votre collection.

sélectionner

Comme dans le mode navigateur de fichiers, vous pouvez sélectionner l'image sous le pointeur en cliquant sur sa miniature ou en appuyant sur Entrée. Une plage d'images peut être sélectionnée en cliquant sur la première image, puis en faisant un Maj+clic sur la dernière. Les images peuvent être ajoutées ou supprimées d'une sélection en appuyant sur Ctrl+clic sur leurs miniatures ou en appuyant sur la barre d'espace.

Conseil : vous constaterez peut-être que le chargement des miniatures des images est lent lorsque vous effectuez un zoom rapide dans une grande collection. Une façon d'accélérer la navigation consiste à générer un cache contenant toutes les miniatures à l'aide de la commande darktable-generate-cache.

sélection

Le mode sélection vous permet d'afficher des images côte à côte pour les comparer facilement.

contrôles

zoomer

En mode sélection, vous pouvez zoomer les images (jusqu'à 100%) en maintenant la touche Ctrl enfoncée tout en faisant défiler avec la molette de la souris.

Effectuez un panoramique dans les images zoomées avec un clic+glisser.

Par défaut, zoomer et faire un panoramique sont synchronisés entre toutes les images visibles. Si vous souhaitez zoomer ou faire un panoramique uniquement sur une image spécifique, ajoutez la touche Maj aux actions ci-dessus.

naviguer

Utilisez la molette de la souris ou les touches fléchées (←/→) pour faire défiler votre collection.

modes

Deux modes sélection différents définissent le nombre d'images affichées simultanément : « fixé » et « dynamique ». En mode sélection basculer entre ces deux modes en pressant la touche « < ».

mode fixé

Le nombre d'images affichées est toujours le même, indépendamment de la longueur de la sélection. Ce nombre peut être défini avec un curseur sur le panneau inférieur.

Dans ce mode, vous naviguerez dans toutes les images sélectionnées. Si aucune sélection n'est définie (ou si une seule image est sélectionnée), vous parcourrez toutes les images.

Le raccourci clavier par défaut pour entrer dans le mode sélection fixé est X.

mode dynamique

Toutes les images sélectionnées sont affichées. Si aucune sélection n'est définie (ou si une seule image est sélectionnée), la dernière valeur du mode fixé est utilisée.

Le raccourci clavier par défaut pour entrer dans le mode sélection dynamique est Ctrl + X.

Conseil : Pour améliorer les performances lors du chargement d'images zoomées, vous pouvez activer (préférences > traitement > cpu / gpu / mémoire > utilisation du disque pour le cache des images 100%). Gardez à l'esprit que cela pourrait prendre beaucoup d'espace disque.

aperçu complet

Dans chacun des modes de la table lumineuse, vous pouvez afficher un aperçu entièrement agrandi de l'image qui se trouve actuellement sous le pointeur de la souris en appuyant et en maintenant enfoncée la touche W. Ceci est utile pour inspecter de plus près une image lors de l'évaluation et de la sélection d'images.

Maintenir enfoncées les touches Ctrl+W réalise un zoom complet de l'image et identifie aussi les zones de netteté qui peuvent désigner la zone de mise au point de l'image. Pour que cet outil fonctionne, l'image d'entrée doit contenir une miniature JPEG intégrée, ce qui est le cas pour la plupart des fichiers RAW.

Les régions de l'image avec un niveau de netteté élevé sont signalées par des bordures rouges. Si de telles régions ne sont pas trouvées, toutes les régions de netteté modérée sont identifiées par une bordure bleue. Notez que ceci n'est pas identique à la détection de focus, qui propose un autre moyen d'identifier les zones de netteté d'une image.

Parfois, appuyer sur W ou Ctrl + W peut sembler ne pas avoir d'effet -- dans de tels cas, cliquez sur la miniature de l'image et appuyez à nouveau sur la touche correspondante.

Si vous souhaitez que l'aperçu complet reste en place sans avoir à maintenir la touche W enfoncée, vous pouvez activer le mode d'aperçu permanent en tapant F. Dans ce mode permanent, vous pouvez effectuer un zoom et un panoramique dans l'image de la même façon que dans le mode sélection. Tapez F ou ECHAP pour revenir à l'affichage initial.

gestion des données numériques

collections & pellicules

miniatures

évaluation par étoiles et labels de couleur

grouper des images

métadonnées et mots clés

collections & pellicules

Une collection est un ensemble d'images correspondant à un critère de sélection donné.

Le type de collection le plus basique est une pellicule, qui contient toutes les images qui ont été importées d'un répertoire spécifique du disque. Chaque fois que vous importez des images du système de fichiers, ces images sont organisées dans une pellicule dont le nom est dérivé de celui de leur répertoire parent.

Dans le module collections vous pouvez facilement construire d'autres types de collections basées sur divers attributs d'image (données Exif, nom de fichier, mots-clés, etc.). Plusieurs critères peuvent être logiquement combinés pour affiner ou étendre votre collection.

Pour un accès rapide, darktable garde une liste des collections les plus récemment utilisées. Celles-ci sont accessibles à partir du module collections récentes.

miniatures

Chaque image de la collection actuelle est représentée par une miniature dans la vue table lumineuse et dans le module pellicule. Un cache des miniatures les plus récemment utilisées est stocké dans un fichier sur le disque. Il est chargé en mémoire au démarrage. La taille de ce cache peut être ajustée dans préférences > traitement > cpu/gpu/mémoire.

création des miniatures

Une miniature est créée quand darktable importe une image pour la première fois, quand une image a été modifiée dans la chambre noire, ou quand on revisite une image dont la miniature n'est plus disponible.

Lorsqu'une image est importée pour la première fois, darktable peut soit essayer d'extraire une miniature intégrée à l'image d'entrée (la plupart des fichiers RAW en contiennent, généralement au format JPEG), soit traiter l'image RAW elle-même en utilisant les paramètres par défaut. Vous pouvez définir comment darktable obtient ses miniatures dans préférences > table lumineuse > miniatures.

Extraire une miniature intégrée à l'image d'entrée est généralement très rapide. Cependant, ces miniatures ont été générées par le convertisseur RAW du boîtier et ne représente pas la “vue” qu'a darktable de cette image. Vous remarquerez la différence dès que vous ouvrez l'image en mode chambre noire, après que darktable a remplacé la miniature intégrée par sa propre version traitée en interne.

Après l'importation, selon les besoins, darktable génère automatiquement des miniatures pour les nouvelles images. Lors de l'importation d'un grand nombre de nouvelles images, la génération de miniatures peut ralentir la navigation dans la vue table lumineuse. Alternativement, vous pouvez stopper darktable, puis générer séparément le cache des miniatures en exécutant darktable-generate-cache. Ce programme générera en une seule fois toutes les miniatures manquantes.

Comme le fichier cache des miniatures a une taille maximale prédéfinie il finira probablement par se remplir. Alors, si de nouvelles miniatures sont ajoutées, les plus anciennes doivent être supprimées du cache. Cependant, darktable conservera toutes les miniatures sur le disque si l'option de sauvegarde sur disque est activée dans l'onglet préférences > traitement > cpu/gpu/mémoire. L'accès aux miniatures dans ce cache secondaire est plus lent que l'accès à celles du cache primaire, mais reste beaucoup plus rapide que la reconstruction des miniatures à partir de zéro. La taille du cache secondaire est uniquement limitée par l'espace disque disponible.

Les miniatures ne seront jamais supprimées du cache secondaire. Si vous souhaitez le vider, vous pouvez le faire manuellement en supprimant récursivement toutes les images du répertoire $HOME/.cache/darktable/mipmaps-xyz.d (où xyz dénote un identificateur alphanumérique du cache). Après avoir effacé le cache secondaire, vous pouvez simplement autoriser darktable à re-générer les miniature si nécessaire, ou vous pouvez générer toutes les miniatures en une seule fois en exécutant le binaire darktable-generate-cache.

Si vous choisissez de ne pas activer l'utilisation du disque et si vous sélectionnez une taille de cache trop petite, darktable pourrait ne plus répondre. Vous pourriez aussi constater une régénération continue des miniatures lorsque vous parcourez votre collection ou un scintillement de ces miniatures. Un bon choix de taille pour le cache est 512 Mo ou plus (voir mémoire pour plus d'informations).

Toutes les miniatures sont gérées en pleines couleurs. Les couleurs sont rendues avec précision à l'écran si votre système est correctement configuré pour transmettre le bon profil de moniteur à darktable. Pour plus d'informations, consultez la section gestion des couleurs.

têtes de mort

Si pour une raison quelconque darktable ne peut pas générer une miniature, il affiche à la place une tête de mort icône tête de mort . Pas de panique !

Il y a trois raisons principales pour que cela se produise :

Fichier d'image manquant : darktable se souvient de toutes les images importées, tant qu'elles n'ont pas été supprimées de votre base de données. S'il souhaite créer une miniature mais ne parvient pas à ouvrir le fichier d'entrée, un crâne s'affiche à la place. Il est conseillé aux utilisateurs de supprimer les images de la base de données en utilisant le module images sélectionnées avant de les supprimer physiquement du disque. Sinon, pour nettoyer votre base de données, vous pouvez occasionnellement exécuter le script purge_non_existing_images.sh du jeu d'outils de darktable.

Format d'image invalide : soit le contenu du fichier contenant l'image n'est pas d'un format pris en charge par darktable -- malgré son extension qui peut laisser penser le contraire, soit ce fichier est corrompu.

Mémoire faible : si darktable manque de mémoire lors de la génération d'une miniature, il vous en avertira et affichera une tête de mort. Cela peut se produire si darktable est exécuté avec des paramètres sous-optimaux, en particulier sur un système 32 bits. Voir mémoire pour plus d'informations.

évaluation par étoiles et labels de couleur

Les évaluations par étoiles et les labels de couleur vous aident à sélectionner et à classer les images selon vos propres critères. Évaluations par étoiles et labels de couleur peuvent être affichés sur les miniatures de la vue table lumineuse et de la pellicule.

évaluation par étoiles

Vous pouvez donner à une image une évaluation de zéro à cinq étoiles. Lors de l’importation, chaque image reçoit une évaluation par défaut que vous pouvez définir dans le module importer. Vous pouvez également marquer une image comme “rejetée”.

Il y a plusieurs manières de modifier une évaluation. Avec le pointeur de la souris placé sur la miniature d'une image, vous pouvez presser une touche numérique 0 – 5 pour le nombre d'étoiles ou la touche R pour “rejeter” une image. Ceci est probablement la manière la plus rapide d’évaluer vos images lors de la première inspection d’une pellicule.

Vous pouvez aussi cliquer directement sur les étoiles superposée aux miniatures ou dans le panneau inférieur. Cliquez x pour rejeter.

Comme le rejet d'une image supprime le classement par étoiles actuellement appliqué, vous pouvez annuler le rejet en cliquant sur x ou en appuyant à nouveau sur R.

De même, vous pouvez cliquer une deuxième fois sur la première étoile pour réinitialiser l'évaluation de l'image à non classée ou à zéro étoile. Ce comportement peut être modifié dans préférences > table lumineuse.

Pour évaluer plusieurs images à la fois, sélectionnez ces images dans la table lumineuse ou la pellicule, puis appuyez sur le raccourci approprié ou cliquez sur le nombre d'étoiles souhaité dans le panneau inférieur de la vue table lumineuse.

Vous pouvez filtrer les images par nombre d'étoiles dans le panneau supérieur.

labels de couleur

Les labels de couleur sont une autre façon de classer les images et peuvent être utilisées comme alternative aux évaluations par étoiles ou pour travailler avec elles. Chaque image peut porter n'importe quelle combinaison d'un ou plusieurs labels de couleur (rouge, jaune, vert, bleu ou violet).

Vous pouvez définir les labels de couleur pour une seule image en plaçant votre curseur sur sa miniature et en appuyant sur les touches de fonction F1 -- F5, qui correspondent aux labels dans l'ordre indiqué ci-dessus.

Pour basculer entre les étiquettes de couleur d'une ou plusieurs images, sélectionnez les images souhaitées dans la table lumineuse ou la pellicule, puis appuyez sur le raccourci approprié ou cliquez sur le bouton de couleur correspondant dans le panneau inférieur. Pour supprimer toutes les étiquettes des images sélectionnées, appuyez sur le bouton gris.

Vous pouvez filtrer les images par label de couleur dans le module collections.

grouper des images

Grouper des images aide à améliorer la structure et la clarté de votre collection d’images lorsqu’elle est affichée dans la vue table lumineuse.

Vous pouvez combiner des images dans un groupe en les sélectionnant et en cliquant sur le bouton “grouper” dans le module images sélectionnées ou en appuyant sur Ctrl+G. De même, vous pouvez enlever d'un groupe les images sélectionnées en cliquant sur le bouton “dégrouper” ou en appuyant sur Ctrl+Maj+G. Les images clonées sont automatiquement placées dans un groupe. De même, si vous importez plusieurs images d'un même répertoire, ayant le même nom de base, mais des extensions différentes (par exemple IMG_1234.CR2 et IMG_1234.JPG), ces images forment automatiquement un groupe.

Les images qui sont membres d'un groupe sont signalées par l'icône top panel_grouping icon dans leurs miniatures.

Cette icône apparaît également sous la forme d'un bouton, dans le panneau supérieur de la vue table lumineuse. Il peut être utilisé pour activer ou désactiver le groupement. Si le groupement est désactivé, toutes les images sont affichées sous forme de miniatures individuelles. Si le groupement est activé, les images d'un groupe sont représentées par une seule miniature (la tête de groupe). Si vous appuyez sur l'icône de groupe dans la miniature de la tête de groupe, ce groupe est déployé (cliquez une deuxième fois pour le replier). Si vous déployez ensuite un autre groupe, le premier groupe se replie.

Dans le mode navigateur de fichiers de la vue table lumineuse, un groupe déployé est signalé par un cadre orange apparaissant dès que le curseur de la souris survole l’une de ses images. Ce cadre entoure toutes les images du groupe.

Vous pouvez définir quelle image est considérée comme la tête de groupe en cliquant sur l'icône de groupe de l'image souhaitée pendant que ce groupe est déployé. Les icônes de groupe sont montrées uniquement si le mode groupement est activé. Donc pour modifier la tête d'un groupe, vous devez tout d'abord activer le groupement, déployer ce groupe et enfin cliquez sur l'icône de groupe de l'image souhaitée comme « tête de groupe ». La tête du groupe actuel est présentée dans une info-bulle lorsque vous survolez l'icône de groupe d'une image.

Si vous repliez un groupe d'images puis passez en mode chambre noire (par exemple en double-cliquant sur la miniature), l'image de la tête de groupe sera ouverte pour le développement.

Le groupement d’images offre aussi un moyen commode de protéger un historique de développement contre des modifications non intentionnelles. Si vous avez finalisé le traitement d'une image et si vous souhaitez protéger sa version actuelle, tout ce que vous avez à faire est de sélectionner cette image, de cliquer « cloner » dans le panneau images sélectionnées, de vous assurer que le groupement est activé et que le groupe est replié. Maintenant, lorsque vous ouvrirez le groupe de l'image dans la chambre noire, seule la tête du groupe sera modifiée. Le clone sous-jacent restera inchangé.

Remarque : « le clonage d'une image » génère uniquement une copie de l'historique de cette image ; historique qui sera stocké dans un autre petit fichier XMP. Il n'y a toujours qu'un seul fichier RAW.

métadonnées et mots clés

darktable vous permet de stocker des informations supplémentaires concernant vos images pour leur permettre d'être plus facilement recherchées et groupées. Ces informations sont stockées dans la base de données de darktable et dans des fichiers liés XMP. Elles peuvent également être incluses dans les images exportées.

métadonnées

Les métadonnées (par exemple le titre, la description) sont des textes de format libre. Elles sont généralement différentes pour chaque image. Vous pouvez ajouter des métadonnées aux images à l'aide de l'éditeur de métadonnées.

mots-clés

Les mots-clés sont généralement partagés entre plusieurs images et sont utilisés pour les catégoriser et les grouper. Vous pouvez ajouter des mots-clés aux images à l'aide du module mots-clés.

Chambre noire

présentation

disposition de la vue chambre noire

le pipeline graphique

modules de traitement

masquage et fusion

organisation

présentation

La vue chambre noire est l'endroit où vous développez vos images. Le panneau central contient l'image en cours de développement.

zoomer

Cliquez le panneau central avec le bouton central de la souris pour successivement « ajuster à l'écran », zoomer à 1:1, zoomer à 2:1.

Vous pouvez aussi zoomer entre 1:1 et « adapter à l'écran » en faisant défiler avec votre souris. Faites défiler tout en maintenant la touche Ctrl enfoncée pour étendre la plage de zoom entre 2:1 et 1:10.

disposition de la vue chambre noire

panneau gauche

De haut en bas :

navigation

Naviguer dans la vue centrale et la zoomer.

instantanés

Prendre et afficher des instantanés pour les comparer avec le développement actuel.

gestion des clones

Afficher et gérer les clones.

pipette de couleur globale

Sélectionner et afficher les informations de couleur provenant de parties de l'image.

mots-clés

Gérer les mots-clés.

informations de l'image

Afficher des informations de l'image actuelle.

gestion des masques

Afficher et modifier les formes dessinées.

exporter

Exportez les images sélectionnées vers des fichiers locaux ou des services externes.

panneau droit

De haut en bas :

scopes

Une représentation graphique des niveaux de luminosité et des couleurs de l'image. Ce module peut être déplacé vers le panneau de gauche si vous le souhaitez (voir préférences > divers > position du module des scopes).

groupes de modules

Sélectionnez des groupes de modules (si activé).

chercher module

Rechercher un module (si activé).

modules de traitement

Les modules utilisés pour traiter une image.

ordre des modules

Choisir l'ordre dans lequel les modules de traitement sont exécutés dans le pipeline graphique.

panneau inférieur

De gauche à droite :

icône-préréglages préréglages

Menu d'accès rapide aux préréglages des modules. Vous pouvez gérer le contenu de ce menu en sélectionnant « gérer la liste des préréglages... ».

icône-styles styles

Menu d'accès rapide aux styles.

icône-seconde-fenêtre seconde fenêtre de la chambre noire

Pour la configuration multi-moniteurs, permet à l'utilisateur d'afficher une seconde image sur un autre écran.

icône-détecter-focus détection de focus

Activer/désactiver le mode détection de focus.

icône-évaluation-des-couleurs évaluation des couleurs

Activer/désactiver la vue évaluation des couleurs ISO12646.

icône-zones-surexposées-RAW avertissement de surexposition RAW

Activer/désactiver les indicateurs de zones surexposées RAW (clic-droit pour les options).

icône-écrêtage avertissement d'écrêtage

Activer/désactiver les avertissements d'écrêtage (clic-droit pour les options).

icon-épreuvage-écran épreuvage écran

Activer/désactiver les superpositions de l'épreuvage écran (clic-droit pour les options).

icône-vérification-gamut vérification du gamut

Activer/désactiver la vérification du gamut (clic-droit pour les options).

icône-guides-superposition guides & superpositions

Cliquez avec le bouton gauche pour activer/désactiver les superpositions de guide global et cliquez avec le bouton droit pour modifier les paramètres du guide, y compris la couleur de tous les tracés sur l'image (masques, guides de recadrage, etc.)

Vous pouvez aussi activer le module pellicule en bas de l'écran pour vous permettre de sélectionner et d'interagir avec la collection actuellement sélectionnée dans la vue table lumineuse.

le pipeline graphique

l'anatomie d'un module de traitement

le pipeline graphique & l'ordre des modules

l'historique

annuler/refaire

l'anatomie d'un module de traitement

Les éléments de base du traitement d'image dans darktable sont les modules de traitement. Afin de traiter une image RAW, un certain nombre de ces modules agissent en séquence sur l'image d'entrée, chacun effectuant une opération différente sur les données de l'image. Pour ceux qui sont familiers avec Adobe Photoshop, le concept d'un module de traitement dans darktable est analogue à celui d'un calque d'ajustement car tous les deux effectuent un ajustement incrémentiel de l'image, en s'appuyant sur les ajustements précédents.

Des modules utilitaires sont également fournis par darktable, cependant ceux-ci ne sont pas directement impliqués dans le traitement d'image, mais ils fournissent à la place une interface graphique qui vous permet de gérer vos images, de leur attribuer des mots-clés, de les exporter etc.

Chaque module de traitement agit indépendamment des autres, mais tous les modules effectuent leur traitement de manière similaire :

Il reçoit son entrée en provenance du dernier module exécuté et effectue dessus une opération pour produire la sortie traitée. Cette opération est différente pour chaque module de traitement.

Il combine l'entrée du module et la sortie traitée à l'aide d'un opérateur de fusion pour produire la sortie fusionnée. Si aucune fusion n'est effectuée, la sortie de cette étape est la même que la sortie traitée.

Il génére un masque, qui définit une opacité pour chaque pixel de l'image. L'opacité est utilisée plus tard pour contrôler la force avec laquelle l'action du module est appliquée à chaque partie de l'image.

Vous pouvez définir votre propre masque en dessinant des formes sur l'image ou en utilisant les propriétés des pixels provenant de l'entrée du module ou de la sortie traitée (voir masques pour plus de détails). Ce masque peut être encore modifié avec un paramètre d'opacité globale, qui affecte chaque pixel de la même manière.

Si aucun masque dessiné/paramétrique n'est utilisé, la sortie de cette étape est un masque où chaque pixel a la même opacité (régie par le paramètre d'opacité globale). Si aucune opacité n'est définie (aucun mélange n'est effectué), une opacité globale de 1,0 (ou 100%) est supposée.

Il combine l'entrée du module et la sortie fusionnée pixel par pixel en utilisant le masque comme opérateur de fusion, pour produire la sortie finale. Lorsque l'opacité du masque est de 100%, la sortie finale est la sortie fusionnée pour ce pixel. Lorsque l'opacité du masque est égale à 0, la sortie finale est l'entrée du module pour ce pixel. Pour une opacité intermédiaire du masque, la sortie fusionnée et l'entrée du module sont combinées proportionnellement à cette opacité pour donner la sortie finale de ce pixel. La sortie finale est transmise au module suivant pour un traitement ultérieur.

Les étapes 2 et 3 sont facultatives et ne sont pas prises en charge par tous les modules. Par exemple, le module dématriçage doit être appliqué à l'ensemble du fichier RAW afin de produire une belle image, il est donc inutile de masquer ou de fusionner sa sortie.

Chacune des étapes ci-dessus est définie plus en détail dans les sections suivantes.

le pipeline graphique & l'ordre des modules

La séquence ordonnée des modules de traitement opérant sur un fichier d'entrée pour générer une image de sortie est connue sous le nom de "pipeline graphique".

L'ordre des modules du pipeline graphique est représenté graphiquement par l'ordre dans lequel les modules sont présentés dans l'interface utilisateur -- le pipeline graphique commence par une image RAW en bas de la liste des modules, et applique les modules de traitement un par un, en empilant une à une les couches de traitement de bas en haut, jusqu'à ce qu'il atteigne le haut de la liste, où il produit l'image entièrement traitée.

Remarque : L'ordre d'exécution des modules de traitement correspond exactement à l'ordre dans lequel les modules apparaissent dans l'interface utilisateur de darktable. La modification de cet ordre dans l'interface utilisateur change la façon dont votre image sera traitée.

ordre des modules et flux de travail

L'ordre dans lequel les modules sont exécutés dans le pipeline graphique a été soigneusement choisi pour donner la meilleure qualité de sortie. Dans les versions précédentes de darktable, il n'était pas possible de modifier l'ordre des modules. Cependant, il existe un certain nombre de cas d'utilisation très spécifiques où le déplacement de certains modules dans le pipeline graphique est conseillé.

L'une des principales raisons de changer l'ordre des modules est venue avec la version 3.0 de darktable, qui a introduit la nouvelle méthode de travail relative à la scène. La version 3.2 a officialisé cela en introduisant les flux de travail relatif à l'affichage et relatif à la scène, qui sont contrôlés par le réglage des préférences > traitement > flux de travail par défaut. À partir de la version 3.6, flux-de-travail-relatif-à-la-scène_ est désormais la façon officielle recommandée (et par défaut) d'utiliser darktable.

Le flux de travail relatif à la scène tente d'effectuer autant d'opérations que possible dans un espace colorimétrique RVB linéaire, en compressant uniquement les tons pour s'adapter au support de sortie (avec un mappage de tons non linéaire) à la fin du pipeline graphique. Cela a l'avantage d'être un espace physiquement plus réaliste pour effectuer des transformations que le flux de travail traditionnel relatif à l'affichage, qui tente d'effectuer des opérations dans un espace colorimétrique perceptuel non linéaire. Honorer le réalisme physique (plutôt que le réalisme perceptif) rend beaucoup plus facile la production d'algorithmes de traitement prévisibles introduisant un minimum d'artefacts.

Le diagramme suivant devrait vous aider à comprendre la différence entre ces flux de travail :

Les modules relatif à la scène traitent des données linéaires qui sont proportionnelles à la quantité de lumière collectée par le boîtier dans la scène. La plage dynamique d'une image dans la section relative à la scène du pipeline graphique est souvent plus grande que celle du support d'affichage.

À un moment donné dans le pipeline graphique, ces valeurs de pixels sont compressées par un mappage non-linéaire dans une plage dynamique plus petite et mieux adaptée à l'affichage sur un moniteur ou à l'impression.

Les modules restants opèrent dans la section relative à l'affichage non-linéaire pour produire l'image de sortie finale.

flux de travail relatif à l'affichage

Avant la version 3.0, le flux de travail de darktable était relatif à l'affichage (flux de travail par défaut = « relatif à l'affichage ») et cette option est toujours fournie en tant que mode originel. Dans ce flux de travail, la courbe de base ou filmique rvb effectue un mappage de tons au début du pipeline graphique et la plupart des autres modules de darktable agissent sur les données image dans l'espace compressé relatif à l'affichage.

La sélection du flux de travail relatif à l'affichage active l'ordre des modules originel (pré-darktable-3.0) et active automatiquement le module courbe de base pour les nouvelles images.

Les données des pixels dans l'espace relatif à l'affichage ne sont pas linéaires et ne sont pas une représentation physiquement réaliste de la scène originale. Cela peut conduire à divers artefacts avec certains modules, d'où la création du flux de travail relatif à la scène (maintenant par défaut).

flux de travail relatif à la scène

Le nouveau flux de travail relatif à la scène (dans les préférences globales l'option flux de travail par défaut = « relatif à la scène ») a été introduit dans le cadre de darktable 3.0. L'ordre des modules a été entièrement réorganisé pour placer les modules de mappage de tonalité filmique rvb et courbe de base beaucoup plus tard dans le pipeline graphique. Cela signifie que la plupart des modules opèrent désormais dans l'espace linéaire RVB avec seulement quelques modules restant dans l'espace non linéaire relatif à l'affichage. Dans ce flux de travail, il est maintenant recommandé que la majorité du traitement d'image ait lieu en utilisant les modules qui, dans la liste ordonnée des modules, sont situés avant filmique rvb (compris). Étant vraiment linéaires, les opérations de cette section du pipeline graphique sont beaucoup plus réalistes physiquement et produisent moins d'artefacts.

Sélectionner le flux de travail relatif à la scène active l'ordre des modules v3.0 et active automatiquement les modules exposition et filmique rvb en utilisant quelques préréglages conçus pour servir de point de départ raisonnable au traitement d'images relatif à la scène.

changer l'ordre des modules

Il reste fortement recommandé aux utilisateurs de ne pas modifier l'ordre des modules dans le pipeline graphique pour un certain nombre de raisons :

La séquence des modules a été choisie avec le plus grand soin afin d'obtenir la plus grande qualité de sortie. En général, les modifications apportées à la séquence feraient pire que mieux.

Certains modules de traitement d'image n'ont tout simplement pas de sens s'ils sont déplacés dans le pipeline graphique. Par exemple, la reconstruction des hautes lumières doit être effectuée sur les données raw avant le dématriçage, qui lui même doit être réalisé avant qu'un quelconque profil de couleur d'entrée ne soit appliqué.

La plupart des modules de traitement ont été conçus pour travailler dans un modèle de couleur spécifique (voir gestion de la couleur pour plus de détails). Une flexibilité totale exigerait des modules supportant différents algorithmes parallèles en fonction de l'espace colorimétrique dans lequel ils travaillent, ceci augmenterait considérablement la complexité.

Malgré la recommandation générale de laisser tel quel l'ordre des modules du pipeline graphique, il est possible de déplacer un module. Pour ce faire, il suffit de maintenir enfoncé Ctrl+Shift tout en faisant un glisser-déposer du module souhaité à son nouvel emplacement. Cela ne doit être fait que par des utilisateurs expérimentés qui comprennent l'impact que cela aura sur l'image.

L'ordre des modules peut être modifié manuellement vers les versions v3.0 ou originel à l'aide du module ordres des modules. Ce module peut également être utilisé pour définir vos propres préréglages d'ordre des modules.

l'historique

L'historique stocke l'intégralité de l'historique de développement pour une image donnée, dans l'ordre dans lequel les modifications ont été appliquées. Il est enregistré dans la base de données de la bibliothèque de darktable et dans le fichier lié XMP de l'image et persiste entre les sessions d'édition.

Chaque fois qu'un module de traitement est activé, désactivé, déplacé ou modifié, une nouvelle entrée est ajoutée en haut de l'historique.

L’historique peut être consulté et modifié dans le module historique de la chambre noire.

Remarque : L'historique n'est pas une représentation de l'ordre dans lequel les modules sont exécutés mais une représentation de l'ordre dans lequel ils ont été activés. L'ordre d'exécution est représenté par l'ordre des modules dans le panneau de droite.

annuler/refaire

Pendant que vous développez votre image, darktable enregistre toutes les modifications que vous apportez à cette image. Cela signifie qu'il est possible d'annuler et de refaire les modifications pour récupérer un état d'édition précédent. Notez que la fonction annuler/refaire est illimitée en nombre d'étapes lors du développement d'une image, mais elle est réinitialisée chaque fois que la chambre noire passe à une nouvelle image.

Tapez Ctrl+Z pour annuler la dernière modification et Ctrl+Y pour refaire la dernière modification annulée (s'il y en a une).

modules de traitement

en-tête d'un module

instances multiples

préréglages

contrôles du module

courbes

ondelettes

modules dépréciés

en-tête d'un module

En haut de chaque module de traitement se trouve l'en-tête du module.

Cliquez sur le nom du module pour développer le module et afficher les paramètres qui contrôlent son fonctionnement.

Par défaut, darktable n'autorisera qu'un seul module de traitement à être déplié à la fois -- si vous cliquez sur l'en-tête d'un autre module, le module précédemment ouvert sera replié. Si vous souhaitez déplier plus d'un module, vous pouvez le faire en Maj+cliquant sur les en-têtes d'autres modules et tous ceux qui ont été précédemment dépliés le resteront. Ce comportement peut être inversé via un paramètre dans les préférences > chambre noire.

Remarque : Déplier un module ne provoque pas son activation. Voir ci-dessous pour savoir comment activer les modules.

L'en-tête d'un module contient les contrôles suivants dans l'ordre de gauche à droite :

bouton marche/arrêt

Cliquer pour activer ou désactiver le module. Certains modules sont essentiels pour le traitement d'image et ne peuvent pas être désactivés (bien que leurs paramètres puissent être modifiés). De même, certains modules ne sont pas applicables à certains types d'images et ne peuvent pas être activés.

Ctrl+clic sur le bouton marche/arrêt pour donner ou non le focus au module. Donner le focus est généralement utilisé pour activer les superpositions qu'un module place sur l'image pour contrôler ses fonctionnalités. Par exemple, le module recadrer affiche les lignes de recadrage et la grille du guide de recadrage uniquement s'il a le focus. Les modules reçoivent automatiquement le focus quand ils sont dépliés.

nom du module

Le nom du module se compose d'une description de l'opération qu'il réalise (ce nom ne peut pas être modifié) suivi du nom de l'instance du module (qui peut être modifié). Par défaut, la première instance d'un module a un nom d'instance vide. Si vous créez des instances supplémentaires, le nom de chaque nouvelle instance sera indexé avec un entier unique. Par exemple, la deuxième instance créée du module exposition sera automatiquement nommée exposition 1.

Ctrl+clic sur le nom d'un module pour modifier manuellement son nom d'instance.

bascule de masque

Cette icône apparaîtra dans l'en-tête chaque fois qu'un masque est actif sur un module. Survolez l'icône pour voir quel type de masque est activé. Cliquez dessus pour afficher le masque actuel sous forme de superposition jaune sur une version en noir et blanc de l'image. Un jaune continu indique une opacité de 100% ; une image de fond gris entièrement visible (sans superposition jaune) indique une opacité de 0%. Ce bouton bascule peut être désactivé dans préférences > chambre noire > affiche la présence de masques dans l'en-tête du module.

menu d'instances multiples

Ce menu vous permet de créer, supprimer, déplacer et renommer des instances de module. Cliquez-droit sur cette icône pour créer directement une nouvelle instance du module. Voir la section instances multiples section for more information.

réinitialiser

Cliquez pour réinitialiser tous les contrôles du module à leurs valeurs par défaut. Ctrl+clic pour réappliquer les préréglages automatiques pour le module -- si aucun préréglage automatique n'est applicable pour ce module, Ctrl+clic réinitialisera simplement les valeurs par défaut (comme pour un clic).

menu des préréglages

Ce menu vous permet d'appliquer, de créer et de modifier les préréglages du module. Voir la section préréglages pour plus d'informations.

La visibilité des quatre icônes à droite du nom du module peut être contrôlée dans préférences > chambre noire> affichage des boutons sur la droite des modules de développement.

instances multiples

De nombreux modules de darktable peuvent être appliqués plus d'une fois dans le pipeline graphique. Chaque instance d'un module se comporte de manière indépendante, obtenant son entrée du module qui le précède dans le pipeline graphique et délivrant sa sortie au module qui le suit.

Comme pour l'instance de base d'un module, toutes les instances peuvent être déplacées indépendamment dans le pipeline graphique soit en maintenant Ctrl+Maj pendant le glisser-déposer, soit en choisissant « monter » ou « descendre » dans le menu déroulant multiples instances.

Les instances peuvent être renommées en faisant un Ctrl+clic sur le nom du module.

cas typiques d’utilisation

Il y a de nombreuses occasions où il est judicieux de faire appliquer un module plus d'une fois dans le pipeline graphique. Voici quelques cas d'utilisation typiques.

Le module exposition peut être utilisé en combinaison avec des masques pour éclaircir ou assombrir certaines parties d'une image. Une instance distincte peut être créée pour modifier chaque région définie par un masque de l'image.

Vous souhaiterez peut-être gérer indépendamment les bruits de luminance et de chromaticité. Cela peut être accompli en générant deux instances du module de réduction du bruit que vous avez choisi et en utilisant la première uniquement pour la luminance (en sélectionnant le mode de fusion « clarté ») et la seconde uniquement pour la chromaticité (en sélectionnant le mode de fusion « chromaticité »).

Remarque : Chaque instance augmente la charge de travail de votre pipeline graphique. Générer trop d'instances -- en particulier celles des modules les plus exigeants -- entraînera un ralentissement notable.

gérer les instances multiples

Cliquez sur le menu instances multiples dans l'en-tête du module pour afficher un menu, avec les options suivantes. Faites un clic-droit sur l'icône du menu pour créer directement une nouvelle instance (même action que de cliquer sur l'option « nouvelle instance » du menu).

nouvelle instance

Créez une nouvelle instance du module actuel avec tous ses paramètres réinitialisés à leurs valeurs par défaut. Un numéro unique est ajouté au nom du module pour que cette nouvelle instance soit distinguée des précédentes.

cloner l'instance

Créez une nouvelle instance du module actuel avec tous ses paramètres hérités de l'instance actuelle. Un numéro unique est automatiquement ajouté au nom du module pour la distinguer.

monter/descendre

Monter ou descendre l'instance dans le pipeline graphique

supprimer

Supprimer l'instance actuelle. Cette option n'est pas disponible si une seule instance est présente.

renommer

Renommez l'instance actuelle. Voir la section historique pour plus de détails sur l'impact du nom de l'instance sur la copie et le collage des historiques.

préréglages

Les préréglages vous permettent de stocker les paramètres de module couramment utilisés pour une utilisation future. Certains modules sont déjà fournis avec des préréglages prédéfinis (internes) et vous pouvez également définir les vôtres (définis par l'utilisateur). Les préréglages internes et définis par l'utilisateur peuvent être affichés en cliquant sur le menu des préréglages dans l'en-tête du module.

La plupart des fonctionnalités décrites ici s'appliquent uniquement aux modules de traitement. Cependant, les préréglages peuvent également être utilisés avec certains modules utilitaires. Quand ils le sont, la fonctionnalité d'application automatique ou d'affichage automatique des préréglages basés sur les données Exif de l'image n'est pas disponible.

Veuillez noter que, pour les modules de traitement, le préréglage enregistré comprend également l'état actif du module. Vous pouvez utiliser cela pour créer vos propres paramètres par défaut, que vous pouvez activer à la demande. Définissez simplement les valeurs par défaut souhaitées, désactivez le module et enregistrez le préréglage.

le menu des préréglages

Le menu des préréglages contiendra une ou plusieurs des entrées suivantes en fonction des préréglages définis ou sélectionnés pour le module actuel :

liste des préréglages

Une liste des préréglages disponibles pour le module actuel. Le préréglage actuellement sélectionné (le cas échéant) est affiché en gras et avec une petite coche à côté de lui.

modifier ce préréglage

Si un préréglage a été sélectionné, modifiez le préréglage sélectionné (voir ci-dessous).

supprimer ce préréglage

Si un préréglage a été sélectionné, supprimer le préréglage sélectionné.

mettre à jour le préréglage [nom]

Mettre à jour le préréglage nommé pour qu'il corresponde aux paramètres actuels du module.

stocker un nouveau préréglage

Créer un nouveau préréglage en utilisant les paramètres actuels du module.

Cliquez sur un nom de préréglage pour appliquer le préréglage à l'instance actuelle du module. Cliquez-droit sur un nom de préréglage pour créer une nouvelle instance du module et lui appliquer le préréglage sélectionné. Vous pouvez également appliquer un préréglage à tout moment lorsque vous êtes dans la chambre noire en utilisant un raccourci clavier -- si vous en avez attribué un (voir préférences > raccourcis).

créer et modifier des préréglages

Lors de la création ou de la modification des préréglages, la boîte de dialogue suivante s'affiche :

contrôles

nom

Le nom du préréglage

description

Une description consultable pour le préréglage (facultatif)

appliquer automatiquement ce préréglage aux images correspondantes (modules de traitement uniquement)

Cochez cette case pour appliquer automatiquement ce préréglage aux images correspondantes lorsqu'elles sont ouvertes dans la chambre noire pour la première fois (vous pouvez réappliquer ces préréglages automatiques en Ctrl+cliquant sur le bouton réinitialiser les paramètres dans l'en-tête du module). Des contrôles supplémentaires apparaîtront pour vous permettre de définir les images auxquelles le préréglage sera appliqué en fonction des données d'image Exif (voir ci-dessous).

Par exemple, si vous souhaitez qu'un préréglage soit appliqué à toutes les images d'un boîtier spécifique, laissez tous les champs aux valeurs par défaut, à l'exception du champ « modèle ». Laissez tous les champs inchangés pour appliquer automatiquement un préréglage à toutes les images.

L'exemple de boîte de dialogue ci-dessus définit les règles suivantes : si le nom de l'objectif correspond, si l'ouverture est supérieure ou égale à f/8 et si la distance focale est comprise entre 24 et 35 mm, le préréglage sera automatiquement appliqué.

Le module informations de l'image affiche le modèle de boîtier et le nom de l'objectif pour chaque image. Utilisez ceci pour vous assurer que vous avez l'orthographe correcte.

afficher uniquement ce préréglage pour les images correspondantes (modules de traitement seulement)

Cochez cette case pour afficher automatiquement le préréglage dans le menu des préréglages, en utilisant le même jeu de filtres.

critères de filtre

Les critères suivants peuvent être utilisés pour appliquer ou afficher automatiquement des préréglages pour les modules de traitement :

patron

Un motif à comparer avec le champ Exif qui décrit votre modèle de boîtier ; utilisez % comme joker.

fabricant

Un motif à faire correspondre avec le champ Exif qui décrit le fabricant de votre appareil photo ; utilisez % comme joker.

objectif

Un motif à comparer avec le champ Exif qui décrit votre objectif ; Utilisez % comme joker.

ISO

N'appliquer le préréglage que si la valeur ISO de votre image se situe dans la plage donnée.

exposition

N'appliquer le préréglage que si le temps d'exposition de votre image se situe dans la plage donnée ; définir + comme valeur supérieure pour correspondre à des expositions arbitrairement longues.

ouverture

N'appliquer le préréglage que si l'ouverture de votre image se situe dans la plage donnée ; mettez f/0 comme valeur la plus faible, elle correspondra aux valeurs d'ouverture arbitrairement grandes ; mettez f/+ comme valeur supérieure, elle correspondra aux valeurs d'ouverture arbitrairement petites.

distance focale

N'appliquer le préréglage que si la distance focale de votre image se situe dans la plage donnée (de 0 à 1000).

format

N'appliquez le préréglage qu'à certains types d'images. Cochez une case pour inclure les fichiers correspondant à un critère ; décochez la case pour exclure ces fichiers. Choisissez parmi « RAW », « non-RAW », « HDR », « monochrome » et « couleur ».

Remarque : Si vous désélectionnez à la fois « RAW » et « non-RAW », le filtre ne s'appliquera à aucun fichier (puisque tous les fichiers pris en charge sont soit RAW, soit non-RAW). De même si vous désélectionnez à la fois « monochrome » et « couleur ».

gérer les préréglages

Les préréglages définis par l'utilisateur et les préréglages internes peuvent être consultés et gérés à dans préférences > préréglages.

Remarque : Si vous créez un préréglage défini par l'utilisateur avec le même nom qu'un préréglage intégré, votre préréglage remplacera la version intégrée, qui ne sera plus accessible.

Si vous supprimez un préréglage qui porte le même nom que l'un des préréglages intégrés, votre préréglage utilisateur sera supprimé et ce nom de préréglage n'apparaîtra plus du tout dans le menu des préréglages. La prochaine fois que vous démarrez darktable, le préréglage intégré correspondant redeviendra visible.

contrôles du module

Cette section décrit comment interagir avec les contrôles des modules de traitement.

curseurs

Les curseurs proposent cinq méthodes d'interaction différentes, en fonction du niveau de contrôle dont vous avez besoin.

clic-gauche

Cliquez n'importe où dans la zone du curseur pour définir la valeur. Vous pouvez également cliquer et faire glisser pour le modifier. Vous n'avez pas à viser le triangle ou même la ligne -- vous pouvez cliquer n'importe où sur toute la hauteur du curseur, y compris le label.

molette de la souris

Survolez le curseur avec votre souris, puis utilisez la molette de votre souris pour ajuster la valeur.

touches flèches du clavier

Lorsque le curseur est activé, vous pouvez le survoler avec votre souris, puis utiliser les touches flèches de votre clavier (←/↓ et →/↑) pour ajuster la valeur. Afin de donner le focus au widget sans changer la valeur actuelle, vous pouvez cliquer avec le bouton droit de la souris, puis cliquer à nouveau avec le bouton droit.

clic-droit

Lorsque votre souris est sur un curseur, un clic droit active sous le curseur une fenêtre contextuelle multifonctionnelle pour un contrôle précis avec votre souris ou une entrée numérique à l'aide du clavier.

Une ligne courbe partant du marqueur triangulaire se déplace avec votre souris. Plus le pointeur de votre souris est proche du marqueur triangulaire, plus le contrôle que vous avez sur la valeur est grossier ; plus vous êtes éloigné du marqueur triangulaire, plus votre contrôle est fin. Cliquez avec le bouton gauche de la souris pour accepter la nouvelle valeur et masquer la fenêtre contextuelle.

Vous pouvez également saisir une nouvelle valeur à l'aide de votre clavier et valider en appuyant sur la touche Entrée. Vous pouvez même fournir la nouvelle valeur sous la forme d'une expression arithmétique que darktable calculera pour vous -- la valeur précédente est référencée par « x ».

double-clic

Vous pouvez double-cliquer sur un curseur ou son label pour réinitialiser sa valeur par défaut.

De plus, la précision des réglages de la molette de la souris et des touches flèches peut être modifiée :

maintenez la touche Maj enfoncée tout en ajustant pour augmenter la taille du pas d'un facteur 10.

maintenez la touche Ctrl enfoncée tout en ajustant pour diminuer la taille du pas d'un facteur 10.

Ces deux multiplicateurs peuvent être modifiés dans le fichier $HOME/.config/darktablerc :

darkroom/ui/scale_rough_step_multiplier=10.0
darkroom/ui/scale_precise_step_multiplier=0.1

boîtes déroulantes

Cliquez sur un menu déroulant pour afficher une liste d'options disponibles que vous pouvez sélectionner en cliquant dessus. Parfois, la liste de sélection s'ouvre près du bas ou du haut de l'écran, ce qui signifie que seuls certains éléments sont visibles. Il suffit de faire défiler la liste avec la molette de la souris pour afficher la liste complète. Vous pouvez également utiliser la molette de la souris et les touches fléchées du clavier pour sélectionner une option, ou commencer à taper pour filtrer les entrées de la liste déroulante.

pipettes de couleur

Un certain nombre de modules permettent de définir des paramètres à l'aide de pipettes de couleur (identifiés par l'icône pipette de couleur ). Celles-ci utilisent une interface standard et la plupart peuvent fonctionner en mode point ou en mode zone. Le mode point peut être activé en cliquant sur l'icône de la pipette de couleur. Le mode zone est activable par un Ctrl+clic ou clic droit.

raccourcis clavier

Les paramètres du module peuvent également être ajustés avec des raccourcis clavier. Voir préférences > raccourcis pour plus d'informations.

courbes

Les modules courbe de base, courbes des tonalités et courbe rvb utilisent des courbes pour contrôler les tons de l'image. Ces modules ont des caractéristiques communes qui méritent une discussion séparée.

nœuds

Dans leur état par défaut, les courbes sont des lignes droites, définies par deux nœuds d'ancrage en haut à droite et en bas à gauche du graphique. Vous pouvez déplacer les nœuds pour modifier la courbe ou générer de nouveaux nœuds en cliquant sur la courbe. Ctrl+clic pour générer un nouveau nœud à l'emplacement x du pointeur de la souris et l'emplacement y correspondant de la courbe actuelle - cela ajoute un nœud sans risque de modifier accidentellement la courbe. Jusqu'à 20 nœuds peuvent être définis par courbe. Pour supprimer un nœud, cliquez dessus et faites-le glisser hors de la zone des widgets.

contrôles de la courbe

Les commandes suivantes sont communes à deux ou plusieurs des modules de traitement ci-dessus et sont donc décrites séparément ici. Veuillez consulter la documentation de chaque module pour une discussion sur les commandes supplémentaires.

méthode d'interpolation

modules courbe des tonalités et courbe rvb uniquement

L'interpolation est le processus par lequel une courbe continue est dérivée de quelques nœuds. Comme ce processus n'est jamais parfait, plusieurs méthodes sont proposées qui peuvent atténuer certains des problèmes que vous pourriez rencontrer.

On peut soutenir que la méthode la plus agréable visuellement est la spline cubique -- puisqu'elle donne des courbes lisses et que le contraste de l'image est mieux amélioré. Cependant, cette méthode est très sensible à la position des nœuds, et peut produire des cuspides et des oscillations lorsque les nœuds sont trop proches les uns des autres, ou lorsqu'il y en a trop. Cette méthode fonctionne mieux lorsqu'il n'y a que 4 à 5 nœuds, régulièrement espacés.

La méthode des splines centripètes est conçue spécifiquement pour éviter les cuspides et les oscillations, mais comme inconvénient, elle suivra les nœuds de manière plus lâche. Elle est très robuste, quel que soit le nombre de nœuds et leur espacement, mais produira un contraste plus délavé et plus terne.

La spline monotone est une méthode spécialement conçue pour donner une interpolation monotone, ce qui signifie qu’il n’y aura aucune des oscillations que la spline cubique peut produire. Cette méthode est très appropriée lorsque vous essayez de créer une fonction analytique à partir d'une interpolation de nœuds (par exemple : exponentiel, logarithme, puissance, etc.). Ces fonctions sont fournies en tant que préréglages. C'est un bon compromis entre les deux méthodes susmentionnées.

préserver les couleurs

Si une courbe de tonalité non linéaire est appliquée à chacun des canaux RVB individuellement, alors la quantité de réglage de ton appliqué à chaque canal de couleur peut être différente, ce qui peut provoquer des changements de teinte. La zone de liste déroulante préserver couleur fournit différentes méthodes de calcul du « niveau de luminance » d'un pixel, dans le but de minimiser ces changements. La quantité de réglage de la tonalité est calculée en fonction de cette valeur de luminance, puis ce même réglage est appliqué aux trois canaux RVB. Différents estimateurs de luminance peuvent affecter le contraste dans différentes parties de l'image, en fonction des caractéristiques de cette image. L'utilisateur peut donc choisir un estimateur qui fournit les meilleurs résultats pour l'image donnée. Certaines de ces méthodes sont décrites en détail dans le contrôle préserver chrominance du module filmique rvb . Les options suivantes sont disponibles :

non

luminance Y

max rvb

moyenne rvb

somme rvb

norme rvb

puissance de base

échelle du graphe

modules courbe des tonalités et courbe de base uniquement

La mise à l'échelle vous permet de déformer l'affichage du graphique afin que certaines propriétés graphiques apparaissent pour vous aider à dessiner des courbes plus utiles. Notez que l'option de mise à l'échelle n'affecte que l'affichage de la courbe, pas les paramètres réels stockés par le module.

Par défaut, une échelle linéaire est utilisée (définie par un facteur d'échelle de 0). Cette échelle utilise des axes aux abscisses et aux ordonnées régulièrement espacées.

Une échelle logarithmique compressera les valeurs élevées et dilatera les valeurs basses, à la fois sur l'axe des abscisses et sur l'axe des ordonnées. Ainsi les nœuds, dans les basses lumières, obtiendront plus d'espace sur le graphique et pourront être contrôlés plus facilement.

Augmentez le curseur échelle du graphe pour définir la base du logarithme utilisé pour la mise à l'échelle des axes. Cela vous permet de contrôler la quantité de compression/dilatation opérée par la mise à l'échelle. Si vous dessinez des fonctions purement exponentielles ou logarithmiques à partir de la fonction identité, la définition de cette valeur définit la base de ces fonctions.

ondelettes

Les ondelettes sont utilisées pour séparer (ou décomposer) une image en un certain nombre de couches distinctes, chacune contenant un niveau de détail différent. Après avoir décomposé une image de cette manière, un module peut limiter son traitement à une ou plusieurs de ces couches de détail, puis reconstituer les couches à la fin pour former son image de sortie. Cela nous permet d'avoir une précision chirurgicale sur les caractéristiques de l'image que nous souhaitons impacter lorsque nous travaillons avec un module.

Certaines des opérations que darktable peut effectuer de cette manière sont :

réduction du bruit (dans les modules réduction bruit (profil), réduction du bruit RAW et égaliseur de contraste)

ajustement du contraste (dans le module égaliseur de contraste)

flou ou suppression de détails indésirables (dans le module retouche)

théorie

Une ondelette est une fonction mathématique oscillante, qui commence et termine à zéro. Le diagramme suivant montre quelques ondelettes simples de différentes tailles.

Ces fonctions d'ondelettes sont utilisées pour parcourir et décomposer l'image en utilisant une opération mathématique appelée convolution. Ceci sélectionne les détails de l'image qui sont à une échelle similaire à la taille d'une ondelette donnée et crée un certain nombre de couches de détails correspondant chacune à une échelle d'ondelettes différente.

Vous trouverez ci-dessous un exemple où des couches de détails ont été extraites de l'image ci-dessus. Dans ce cas, les images ont été produites en utilisant le module retouche, en divisant l'image en huit couches différentes et en utilisant le bouton « afficher l'échelle des ondelettes » du module pour visualiser chacune des couches détaillées :

Les barres de la section décomposition en ondelettes indiquent les couches qui ont été extraites à différentes échelles d'ondelettes. Le rectangle le plus sombre à gauche représente l'image entière (avant la décomposition) et les cases grises représentent chacune des couches de la décomposition. Cliquer sur l'icône d'escalier sous le graphique à barres active la superposition de visualisation afin que vous puissiez voir à quoi ressemble la couche actuellement sélectionnée.

Jetons un coup d'œil à certaines des couches générées pour l'image ci-dessus.

À l'échelle n°2, l'image ne contient que des détails très fins, dont les sourcils, les cils et les pores de la peau du mannequin. Elle n'inclut pas les détails plus grossiers de l'image, car ces détails ont été extraits vers d'autres couches :

Aux échelles n°5 et n°6, nous commençons à voir des détails de plus en plus grands :

À l'échelle n°8, nous ne voyons que des détails de très haut niveau du modèle tels que la forme générale du nez, des yeux et de la joue :

pourquoi utiliser des ondelettes ?

Supposons, dans l'exemple ci-dessus, que nous voulions lisser une partie des taches sur la peau du modèle, sans rien perdre de la texture sous-jacente à petite échelle. Avec la décomposition en ondelettes ceci est une opération triviale -- nous pouvons simplement utiliser le module retouche pour appliquer un flou gaussien uniquement au(x) couche(s) « tachée(s) », laissant toutes les autres couches non modifiées. Une fois l'ajustement terminé, le module retouche recombine simplement la ou les couches modifiées avec les couches non modifiées pour produire l'image finale.

La séquence d'images ci-dessous montre (1) L'image originale ; (2) La couche (échelle 5) que l'on souhaite flouter ; et (3) L'image finale après que la couche à l'échelle 5 a été floutée et que les différentes couches ont été recombinées :

Comme vous pouvez le voir, les taches cutanées à grande échelle ont été supprimées, mais les détails à plus petite échelle ont été conservés.

interagir avec les échelles d'ondelettes

Les modules de traitement vous permettent de modifier leur fonctionnement à l'aide d'échelles d'ondelettes en utilisant deux méthodes.

la décomposition en ondelettes

Comme indiqué ci-dessus, le module retouche vous permet de choisir le nombre de niveaux de détails dans lesquels diviser votre image. Il décompose l'image en couches séparées et vous permet d'effectuer des opérations de manière sélective sur chaque couche ou sur l'image dans son ensemble :

Voir la documentation du module retouche pour plus de détails.

contrôles de spline

Les modules réduction du bruit (profil), réduction du bruit RAW et égaliseur de contraste permettent d'appliquer plus ou moins leurs effets à chaque échelle d'ondelette à l'aide de splines.

Ici, chaque nœud du graphique représente un niveau de détails différent dans l'image, des détails grossiers à gauche aux détails fins à droite. À cette échelle d'ondelettes, vous pouvez augmenter ou diminuer chacun de ces nœuds avec votre souris pour augmenter ou diminuer l'effet du module.

Pour modifier la courbe, cliquez légèrement au-dessus ou en dessous de la ligne près d'un nœud et faites glisser vers le haut ou vers le bas. Vous pouvez changer la largeur de votre modification en faisant défiler avec la molette de votre souris, ce qui augmente ou réduit la taille du cercle affiché sous le pointeur de votre souris. Un petit cercle indique que l'effet de faire glisser la courbe vers le haut ou vers le bas sera principalement isolé sur le nœud en cours de réglage. Un cercle plus grand indique que l'effet sera plus large et affectera de plus en plus les nœuds adjacents. Lorsque vous passez la souris sur le graphique, les zones ombrées indiquent les parties de la spline qui seront affectées lorsque vous tentez de modifier la courbe.

modules dépréciés

L'équipe de darktable examine régulièrement les anciens modules et met à jour leur implémentation quand des problèmes sont trouvés ou quand des mises à jour de la science signifie qu'ils peuvent être améliorés. La plupart du temps, nous essayons de mettre à jour les modules existants avec de nouvelles fonctionnalités. Mais cela devient parfois problématique. Souvent parce qu’il faut maintenir plusieurs versions du module. Dans de telles circonstances, un nouveau module de remplacement est créé et l'ancien module devient déprécié.

Pour rendre un module déprécié un processus standard est utilisé : ce module ne peut plus être recherché ou ajouté aux groupes des modules personnalisés. Il est placé en lecture seule dans le groupe des modules dépréciés et un message lui est ajouté pour avertir de sa suppression et diriger l'utilisateur vers une alternative appropriée.

Après une année, le module est supprimé du groupe des modules dépréciés. Il est alors disponible uniquement pour une utilisation dans d'anciens développements (où il était actif pour une image donnée). Les modules dépréciés ne sont jamais complètement retirés de darktable (afin de conserver les anciens développements) mais le développement s'arrête et on vous conseille d'utiliser à la place des modules pris en charge si vous rencontrez un problème.

Par exemple, les modules dépréciés dans darktable 3.4 seront supprimés du groupe de modules dépréciés dans darktable 3.8 (en supposant deux versions majeures chaque année).

masquage et fusion

présentation

modes de fusion

masques

présentation

Chaque module de traitement reçoit son entrée du module le précédant dans le pipeline graphique, il effectue ses opérations sur les données image puis envoie sa sortie au module le suivant dans le pipeline graphique.

Les données de sortie d'un module peuvent être optionnellement retraitées (combinées) avec ses données d'entrée avant d'être transmises au module suivant. Cette étape supplémentaire dans le traitement est appelée fusion -- entrée et sortie peuvent être traitées avec différents algorithmes, appelés opérateurs de fusion ou modes de fusion.

Chaque mode de fusion est en outre contrôlé par le paramètre opacité (ayant une valeur comprise entre 0% et 100%) qui définit dans quelle mesure les images d'entrée et de sortie contribuent au résultat final. Typiquement une opacité de 0% délivre une image identique à l'image d'entrée (le module n'a pas d'effet) alors qu'une opacité de 100% délivre l'effet maximum du module.

Cette opacité peut être la même pour chaque pixel (en utilisant le curseur d'opacité globale), auquel cas la fusion agit uniformément sur toute l'image. Alternativement, les valeurs d'opacité peuvent varier en fonction des propriétés ou de l'emplacement de chaque pixel. Cette modification locale de l'opacité s'appelle un masque. Les masques permettent à l'utilisateur de contrôler précisément quelles parties d'une image sont affectées par un module et avec quelle importance elles le sont. L'utilisateur peut choisir d'activer un masque dessiné, un masque paramétrique ou une combinaison.

La fonctionnalité de fusion et de masquage est contrôlée via un groupe d'icônes situé au bas de chaque module où elle est applicable.

Ces icônes activent les options de masquage et de fusion suivantes, de gauche à droite :

désactivé

La sortie du module est transmise au module suivant dans le pipeline graphique sans retraitement supplémentaire. Aucun autre contrôle n'est affiché.

uniforme

Les images d'entrée et de sortie sont retraitées uniformément avec le mode de fusion choisi, où la quantité de fusion est contrôlée par le seul curseur d'opacité. Des contrôles supplémentaires sont affichés pour permettre de sélectionner le mode de fusion et l'opacité. La valeur par défaut est un mode de fusion « normal » avec une opacité de 100 %.

masque dessiné

Le retraitement a lieu avec le mode de fusion choisi et une opacité basée sur l'emplacement des pixels défini par une ou plusieurs formes dessinées. Des contrôles supplémentaires sont affichés pour permettre aux éléments de masque d'être dessinés. Si aucun élément de masque n'est dessiné, alors tous les pixels ont la même opacité, celle définie par le curseur d'opacité.

masque paramétrique

Le retraitement a lieu avec le mode de fusion choisi et une opacité basée sur les propriétés des pixels individuels. Des contrôles supplémentaires sont affichés pour permettre à l'opacité d'être ajustée sur une base par pixel, déterminée par les valeurs des pixels.

masque dessiné et paramétrique

Le retraitement a lieu avec le mode de fusion et l'opacité choisie en fonction d'une combinaison d'un masque paramétrique et d'un masque dessiné.

masque raster

Le retraitement a lieu avec le mode de fusion choisi et une opacité basée sur un masque qui a été généré par un module actif plus tôt dans le pipeline graphique.

options de fusion

Choisissez l'espace colorimétrique à utiliser lors du calcul du masque de fusion et spécifiez si vous souhaitez autoriser ou non la génération d'un masque en fonction des canaux de sortie du module (normalement, un masque paramétrique est généré en fonction des canaux d'entrée arrivant dans le module). Les options suivantes sont disponibles :

sélectionner l'espace couleur de fusion par défaut : utiliser l'espace colorimétrique par défaut du module pour spécifier le masque paramétrique.

Lab : utiliser l'espace colorimétrique Lab (s'il est disponible) pour spécifier le masque paramétrique.

RVB (affichage) : utiliser l'espace colorimétrique RVB/TSL relatif à l'affichage pour spécifier le masque paramétrique.

RVB (scène) : utiliser l'espace colorimétrique RVB / J z C z h z relatif à la scène pour spécifier le masque paramétrique.

afficher les canaux de sortie : afficher les contrôles des canaux de sortie afin que le masque paramétrique puisse être défini en fonction des canaux de sortie du module.

Remarque : Toutes ces options de fusion ne sont pas disponibles pour chaque module.

modes de fusion

Les modes de fusion définissent la manière dont l'entrée et la sortie d'un module sont combinées (fusionnées) avant que la sortie finale d'un module ne soit transmise au module le suivant dans le pipeline graphique.

Les modes de fusion classiques, conçus pour RVB relatif à l'affichage (contraint à 0-100 %), définissent implicitement dans leurs algorithmes un pivot à 50 % (gris) ou à 100 % (blanc), selon le mode de fusion. Étant donné que le mode relatif à la scène n'est pas soumis à ces restrictions, ce pivot doit être explicitement défini par l'utilisateur lors de l'exécution d'opérations de fusion dans l'espace colorimétrique « RVB (scène) ». Le paramètre supplémentaire pivot de fusion sera présenté à l'utilisateur lors de l'utilisation de l'un des modes de fusion dans cet espace colorimétrique. L'effet dépend de l'opérateur utilisé. Par exemple, les valeurs au-dessus du pivot peuvent être éclaircies et les valeurs inférieures obscurcies, ou vice versa.

La sortie finale d'un module est calculée « par pixel » comme suit :

sortie_finale = (1.0 - opacité) * entrée_du_module + opacité * sortie_fusionnée

où « sortie_fusionnée » est une combinaison des images d'entrée et de sortie, selon le mode de fusion (ci-dessous), et « l'opacité » est définie « par pixel » par une combinaison du masque et du paramètre d'opacité globale. Une opacité de 0% produit une image identique à l'image d'entrée du module.

Le bouton « inverser le masque » blend-reverse inverse les rôles des images d'entrée et de sortie dans le calcul « par pixel » :

sortie_finale = (1.0 - opacité) * sortie_du_module + opacité * entrée_fusionnée

où entrée_fusionnée est une combinaison des images de sortie et d'entrée, selon le mode de fusion ci-dessous où les références d'image sortie et entrée sont inversées. Dans les modes de fusion « inversés », une opacité de 0% génère une image identique à l'image de sortie du module.

modes normaux

normal

Le mode de fusion le plus couramment utilisé, « normal », fusionne simplement l'entrée et la sortie en utilisant le paramètre d'opacité. Ce mode est couramment utilisé pour réduire la force de l'effet d'un module en réduisant l'opacité. C'est aussi généralement le mode de fusion de choix lors de l'application sélective de l'effet d'un module avec des masques. Ce mode est également connu sous le nom d'opérateur de fusion alpha « sur » de Porter-Duff (voir simulation de transparence pour plus de détails).

normal borné

Non disponible dans l'espace couleur « RVB (scène) ».

Ce mode de fusion est identique à « normal », sauf que les données d'entrée et de sortie sont limitées à une plage de valeurs min/max particulière. Les valeurs hors plage sont effectivement bloquées et ne sont pas transmises aux modules suivants. Parfois, cela permet d'éviter les artefacts. Cependant, dans la plupart des cas (par exemple, pour les hautes lumières extrêmes très saturées), il est préférable de laisser les valeurs non bornées parcourir le pipeline graphique et de les traiter correctement plus tard. Le mode de fusion « normal » est donc généralement préféré.

modes arithmétiques

additionner

Additionnez les valeurs de pixels des images d'entrée et de sortie, éclaircissant la sortie. Lors de la fusion dans l'espace colorimétrique « RVB (scène) », les valeurs de pixels de l'image de sortie sont multipliées par une valeur proportionnelle au « pivot de fusion ».

soustraire

Soustraire la valeur de sortie du pixel de sa valeur d'_entrée. Lors de la fusion dans l'espace colorimétrique « RVB (scène) », les valeurs de pixels de l'image de sortie sont multipliées par une valeur proportionnelle au « pivot de la fusion ». Les valeurs de pixels inférieures à 0 sont définies à 0.

multiplier

Multipliez entre elles les valeurs de pixels d'entrée et de sortie. Lors de la fusion dans des espaces colorimétriques relatifs à l'affichage, les valeurs de pixel sont comprises entre 0 et 1.0, la sortie finale sera bridée et sera toujours plus sombre. Lors de la fusion dans l'espace colorimétrique « RVB (scène) », cette valeur est encore multipliée par une valeur proportionnelle au « pivot de la fusion ». Dans ce cas, les valeurs peuvent être supérieures à 1.0 et donc éclaircir l'image de base. Cela peut avoir d'autres effets secondaires, comme la mise à jour du point blanc dans le module filmique.

La fusion multiplier simule un filtre optique à densité variable, où la densité est définie par la sortie du module. Elle a de nombreuses applications, de l'amélioration de l'éblouissement et du contraste local (lorsqu'elle est utilisée avec un filtre de flou ou un filtre passe-bas) à assombrir/éclaircir (dodging and burning) et aux améliorations du contraste global (lorsqu'elle est utilisée avec l'exposition). Le pivot définit le seuil d'intensité de sortie entre l'assombrissement et l'éclaircissement (toute valeur RVB inférieure au pivot s'assombrira).

diviser

Diviser les valeurs de pixel de l'entrée par la sortie. Lors de la fusion dans l'espace colorimétrique « RVB (scène) », les valeurs de pixels de l'image de sortie sont multipliées par une valeur proportionnelle au « pivot de la fusion ».

Comme il s'agit de l'inverse du mode de multiplication, il s'assombrira là où la multiplication s'éclaircira et vice versa. Tout le reste fonctionne essentiellement de la même manière.

écran

non disponible dans l'espace colorimétrique « RVB (scène) »

Inverser les valeurs des pixels d'entrée et de sortie, multiplier ces valeurs entre elles et inverser le résultat. Cela produit approximativement l'effet inverse du mode « multiplier » : l'image résultante est généralement plus lumineuse et parfois « délavée » en apparence.

moyenne

Renvoie la moyenne arithmétique des valeurs de pixels d'entrée et de sortie.

différence

Renvoie la différence absolue entre les valeurs de pixel d'entrée et de sortie.

moyenne géométrique

Renvoie la racine carrée du produit des valeurs de pixels d'entrée et de sortie.

moyenne harmonique

Renvoie le produit des valeurs des pixels d'entrée et de sortie, multiplié par 2 et divisé par leur somme.

modes d'amélioration du contraste

Les modes suivants ne sont pas disponibles dans l'espace colorimétrique de fusion « RVB (scène) » car ils reposent sur une hypothèse de « 50% de gris moyen » qui ne s'applique qu'aux espaces colorimétriques non linéaires et relatif à l'affichage.

superposition

Ce mode combine les modes de fusion « multiplier » et « écran » : les parties de l'entrée où la sortie est plus lumineuse deviennent plus lumineuses ; les parties de l'image où la sortie est plus sombre deviennent plus sombres ; le gris moyen n'est pas affecté. Ce mode est souvent combiné avec les modules filtre passe bas et filtre passe haut .

lumière douce

Ce mode est similaire à « superposition », sauf que les résultats sont plus doux et moins lumineux. Comme pour superposition, il est souvent combiné avec les modules filtre passe bas et filtre passe haut.

lumière dure

Ce mode n'est lié à « lumière douce » que par le nom. Comme le mode superposition, il s'agit d'une combinaison des modes « multiplier » et « écran » et a un effet différent au-dessus et en dessous du gris moyen. Les résultats avec le mode de fusion lumière dure ont tendance à être assez intenses et doivent généralement être combinés avec une opacité réduite.

lumière vive

Ce mode est une version extrême de superposition/lumière douce. Les valeurs plus foncées que le gris moyen sont assombries ; les valeurs plus claires que le gris moyen sont éclaircies. Vous aurez probablement besoin d'atténuer son effet en réduisant l'opacité.

lumière linéaire

L'effet de ce mode est similaire à celui de « lumière vive ».

lumière ponctuelle

Ce mode effectue simultanément une fusion assombrir et éclaircir, en supprimant les tons moyens. Cela peut entraîner des artefacts tels que des taches et des plaques.

modes canaux de couleur

canaux Lab

Les modes suivants sont uniquement disponibles pour la fusion dans l'espace colorimétrique Lab.

clarté Lab

Fusionner la clarté des images d'entrée et de sortie, tout en prenant pour canaux de couleur (a et b) ceux, inchangés, de l'image d'entrée. Contrairement à « luminosité », ce mode de fusion n'implique aucune conversion d'espace colorimétrique et ne tronque aucune donnée. Dans certains cas, ce mode de fusion est moins sujet aux artefacts que le mode « luminosité ».

canal a de LAB

Fusionner le canal de couleur « a » de Lab à partir des images d'entrée et de sortie, tout en prenant pour les autres canaux ceux de l'image d'entrée sans les modifier.

canal b de LAB

Fusionner le canal de couleur « b » de Lab à partir des images d'entrée et de sortie, tout en prenant pour les autres canaux ceux de l'image d'entrée sans les modifier.

couleur Lab

Fusionner les canaux de couleur Lab (a et b) des images d'entrée et de sortie, tout en conservant la clarté de l'image d'entrée. Contrairement à « couleur », ce mode de fusion n'implique aucune conversion d'espace colorimétrique et ne tronque aucune donnée. Dans certains cas, ce mode de fusion est moins sujet aux artefacts que « couleur ».

canaux RVB

Les éléments suivants sont disponibles uniquement lors de la fusion dans les espaces colorimétriques RVB.

canal rouge RVB

Fusionner le canal « rouge » des images d'entrée et de sortie, tout en prenant les autres canaux inchangés de l'image d'entrée. Lors de la fusion dans l'espace colorimétrique « RVB (scène) », le canal « rouge » de l'image de sortie est multiplié par une valeur proportionnelle au « pivot de la fusion ».

canal vert RVB

Fusionner le canal « vert » des images d'entrée et de sortie, tout en prenant les autres canaux inchangés de l'image d'entrée. Lors de la fusion dans l'espace colorimétrique « RVB (scène) », le canal « vert » de l'image de sortie est multiplié par une valeur proportionnelle au « pivot de la fusion ».

canal bleu RVB

Fusionner le canal « bleu » des images d'entrée et de sortie, tout en prenant les autres canaux inchangés de l'image d'entrée. Lors de la fusion dans l'espace colorimétrique « RVB (scène) », le canal « bleu » de l'image de sortie est multiplié par une valeur proportionnelle au « pivot de la fusion ».

canaux TSV

Les éléments suivants sont uniquement disponibles lors de la fusion dans l'espace colorimétrique « RVB (affichage) ».

clarté TSV

Fusionner la clarté des images d'entrée et de sortie, tandis que la couleur est prise sans modification dans l'image d'entrée. Contrairement au mode « luminosité », ce mode de fusion n'implique pas d'écrêtage.

couleur TSV

Fusionner les couleurs des images d'entrée et de sortie, tandis que la clarté est prise sans modification dans l'image d'entrée. Contrairement à « couleur », ce mode de fusion n'implique pas d'écrêtage.

autres

clarté

Fusionner la clarté des images d'entrée et de sortie tandis que la couleur (chroma et teinte) est celle, non modifiée, de l'image d'entrée.

chroma

Fusionner la chroma (saturation) des images d'entrée et de sortie tandis que clarté et teinte sont prises telles quelles dans l'image d'entrée. Ce mode de fusion utilise les ratios RVB, divisés par une norme euclidienne.

éclaircir

non disponible dans l'espace colorimétrique « RVB (scène) »

Comparer les valeurs de pixels des images d'entrée et de sortie, et sortir la valeur la plus claire.

assombrir

non disponible dans l'espace colorimétrique « RVB (scène) »

Comparer les valeurs de pixels des images d'entrée et de sortie, et sortir la valeur la plus sombre.

teinte

non disponible dans l'espace couleur de fusion « RVB (scène) »

Fusionner la teinte (nuance des couleurs) des images d'entrée et de sortie, tout en conservant la clarté et la chroma de l'image d'entrée.

couleur

non disponible dans l'espace couleur « RVB (scène) ».

Fusionner la couleur (chroma et teinte) des images d'entrée et de sortie. La clarté est prise telle quelle dans l'image d'entrée.

Attention : Lorsque les modules modifient considérablement la teinte (par exemple lors de la génération de couleurs complémentaires), ce mode de fusion peut entraîner un fort bruit de couleur.

ajustement des couleurs

non disponible dans l'espace couleur « RVB (scène) ».

Certains modules agissent principalement sur les tonalités d'une image mais effectuent également des ajustements de saturation des couleurs (par exemple les modules niveaux et courbe des tonalités). Ce mode de fusion prend la clarté de la sortie du module et fusionne les couleurs de l'entrée et de la sortie, permettant de contrôler les ajustements de couleur du module.

masques

présentation

masques dessinés

masques paramétriques

combiner les masques dessinés/paramétriques

raffinement du masque et contrôles supplémentaires

masques raster

présentation

Les masques permettent de limiter l'effet d'un module afin qu'il ne s'applique qu'à certaines parties de l'image.

Un masque peut être considéré comme une image en niveaux de gris où chaque pixel a une valeur comprise entre 0,0 et 1,0 (ou entre 0 % et 100 %). Cette valeur est l'opacité et est utilisée pour déterminer dans quelle mesure un module affecte chaque pixel.

Les sections suivantes expliquent comment construire des masques dans darktable.

masques dessinés

Avec la fonctionnalité masque dessiné, vous pouvez construire un masque en dessinant des formes directement sur l'image. Les formes peuvent être utilisées seules ou combinées. Une fois qu'une forme a été dessinée sur une image, elle peut être ajustée, supprimée ou réutilisée dans d'autres modules.

Les formes sont stockées en interne sous forme de vecteurs et sont rendues avec la résolution requise pendant le traitement du pipeline graphique. Les formes sont exprimées dans le système de coordonnées de l'image d'origine et sont transformées avec le reste de l'image par tous les modules de distorsion actifs dans le pipeline graphique (par exemple correction des objectifs, rotation et perspective). Cela signifie qu'une forme fonctionnera toujours sur la même zone d'image, quelles que soient les modifications qui peuvent être appliquées par la suite.

Les contrôles nécessaires à la création et à la modification des masques dessinés peuvent être activés en sélectionnant l'icône « masque dessiné » ou « masque dessiné et paramétrique » au bas d'un module. Vous pouvez également créer et modifier des formes à l'aide du module gestions des masques.

créer des formes

Choisissez une forme en cliquant sur l'icône de forme appropriée (de gauche à droite : cercle, ellipse, chemin, pinceau, dégradé).

Cela vous amènera au mode de création pour cette forme. Une fois que vous avez fini de dessiner votre forme, vous passerez automatiquement en mode édition.

Ctrl+clic sur l'icône de la forme pour dessiner en continu plusieurs formes du même type -- chaque fois qu'une forme est terminée, vous revenez en mode création pour une nouvelle instance de cette forme. En mode de création continue, cliquez avec le bouton droit sur l'image pour arrêter de dessiner des formes et entrer en mode d'édition.

Pour toutes les formes dessinées, vous pouvez maintenir la touche Maj enfoncée tout en faisant défiler avec la molette de la souris pour modifier l'étendue du contour progressif de la forme (le flou au bord de la forme) et utiliser Ctrl+défilement pour modifier l'opacité de la forme (à quel point elle est transparente). Ces opérations sont disponibles aussi bien en mode création qu'en mode édition (tant que votre souris est sur la forme en question).

Par défaut, le défilement vers le haut de la molette souris augmente la valeur du paramètre de la forme en cours de modification. Ce comportement peut être modifié dans les préférences > chambre noire > défiler vers le bas pour réduire les paramètres de masque.

Remarque : Lorsqu'elles sont utilisées en mode création de forme, les opérations de défilement précédentes entraîneront également la modification du contour progressif ou de l'opacité par défaut. Les nouvelles valeurs par défaut seront utilisées la prochaine fois que vous créerez une nouvelle forme.

modification de formes

Cliquez sur l'icône «montre et édite les éléments d'un masque» show-and-edit-masks-icon pour entrer en mode d'édition de forme. Cela affichera tous les masques dessinés utilisés par le module actuel et vous permettra de modifier ces formes. Le groupe associé dans le gestionnaire de masques sera également développé.Ctrl+clic sur la même icône pour entrer en mode d'édition restreint, où certaines actions (par exemple, faire glisser une forme complète ou changer sa taille) sont bloquées. Ceci est particulièrement utile pour éviter des erreurs coûteuses lors de l'édition des formes de chemin et de pinceau.

Cliquez et faites glisser une forme pour la déplacer dans le canevas de l'image. Cliquez sur une forme sélectionnera également cette forme dans le gestionnaire de masques

supprimer des formes

En mode édition, cliquez avec le bouton droit de la souris sur une forme pour la supprimer.

réutiliser des formes

Vous pouvez réutiliser des formes que vous avez dessinées dans d'autres modules. Cliquez sur la liste déroulante des formes (à côté du bouton «montre et édite les éléments d'un masque») pour choisir individuellement les formes précédemment dessinées ou pour utiliser le même groupe de formes que celui utilisé par un autre module. Les options suivantes sont disponibles pour la sélection :

ajouter une forme existante

Choisissez une forme individuelle ou un groupe de formes que vous avez dessinées précédemment (soit dans le module gestion des masques ou depuis le masque dessiné d'un autre module). Si cette forme ou ce groupe est utilisé ailleurs, toutes les modifications que vous apportez seront reflétées partout où la forme ou le groupe seront utilisés.

utiliser les mêmes formes que

Ajoute une liste de formes utilisées dans un autre module au masque du module actuel. Cela diffère de l'option précédente en ce qu'elle crée un nouveau groupe de formes, permettant d'ajouter ou de supprimer des formes du groupe indépendamment du module à partir duquel elles ont été copiées. Toutes les formes communes aux deux groupes restent liées.

combinez et gérez les formes

Le module gestion des masques peut être utilisé pour gérer vos formes dessinées. Ce module permet également de regrouper et de combiner des masques dessinés à l'aide d'opérateurs ensemblistes (union, intersection, différence, exclusion).

distorsions de forme

Afin d'assurer un système de coordonnées cohérent, lorsque vous placez une forme sur l'image, elle est en fait dessinée sur le fichier RAW d'origine. Cette forme traverse ensuite le pipeline graphique avant d'être finalement utilisée par le module et dessinée à l'écran. Cela signifie que, si vous avez activé des modules de distorsion (comme la correction des objectifs), les formes dessinées peuvent apparaître déformées à l'écran et dans l'image finale. Cela peut conduire, par exemple, à ce que les cercles deviennent des ellipses et que les lignes de dégradé deviennent incurvées. Si vous avez besoin de créer une forme plus précise (pour surmonter ces distorsions), il est recommandé d'éviter d'utiliser les formes simples (cercles / ellipses) au profit de la forme chemin (qui peut être dessinée en utilisant plus de points, réduisant les distorsions). Vous pouvez ajuster la courbe sur les lignes de dégradé pour surmonter les simples distorsions introduites par le module correction des objectifs.

formes disponibles

cercle

Cliquez sur le canevas de l'image pour placer le cercle. Faites défiler tout en survolant le cercle pour modifier son diamètre. Faites défiler tout en survolant la bordure du cercle pour modifier la largeur du contour progressif (le même effet que de maintenir la touche Maj enfoncée tout en faisant défiler la molette de la souris dans la forme principale).

ellipse

Le principe général est le même que pour la forme cercle. De plus, quatre nœuds sont affichés sur la ligne de l'ellipse. Cliquez et faites glisser les nœuds pour ajuster l'excentricité de l'ellipse. Ctrl+clic et faites glisser les nœuds ou utilisez Maj+Ctrl+défilement (avec la molette de la souris) pour faire pivoter l'ellipse. Maj+clic dans la forme pour basculer la décroissance progressive entre le mode équidistant et proportionnel.

chemin

Cliquez sur le canevas de l'image pour placer trois nœuds ou plus et générer une forme fermée au format libre. Terminez le chemin par un clic droit après avoir défini le dernier point. Par défaut, les nœuds sont connectés avec des lignes lisses. Si vous voulez qu'un nœud définisse une pointe, vous pouvez le faire en le créant avec Ctrl+clic.

En mode édition faites un Ctrl+clic sur un nœud existant pour que la courbe lisse en ce nœud y devienne pointue et vice versa. Ctrl+clic sur l'un des segments de ligne pour insérer un nœud supplémentaire. Faites un clic-droit sur un nœud pour le supprimer. Assurez-vous que le pointeur de la souris se trouve sur le nœud souhaité et que le nœud est mis en surbrillance, pour éviter de supprimer accidentellement tout le chemin.

La taille de la forme terminée peut être modifiée par défilement. Il en va de même pour la largeur de la bordure (la zone avec une diminution progressive de l'opacité), qui peut être modifiée avec Maj+défilement. Les nœuds simples ainsi que les segments de chemin peuvent être déplacés en les faisant glisser avec la souris. Si un nœud est sélectionné en cliquant dessus, un autre point de contrôle apparaît. Vous pouvez, en le déplaçant, modifier la courbure de la ligne. Rétablissez l'ancienne courbure par un clic-droit sur ce nouveau point de contrôle. Faire glisser l'un des points de contrôle de la bordure ajuste la largeur de la bordure uniquement dans cette partie de la forme.

Vous avez la possibilité d'affiner les chemins en mode d'édition restreint (activée par Ctrl+clic sur l'icône «montre et édite les éléments d'un masque»). Cela vous permet d'ajuster des nœuds et des segments uniques sans risquer de déplacer ou de redimensionner accidentellement la forme entière.

pinceau

Commencez à dessiner un coup de pinceau en cliquant avec le bouton gauche sur le canevas de l'image et en déplaçant la souris tout en maintenant le bouton enfoncé. Le coup de pinceau est finalisé une fois que vous relâchez le bouton de la souris. Faites défiler la souris pour modifier la taille de la forme, soit avant de commencer à dessiner, soit à tout moment pendant l'opération. De même, vous pouvez utiliser les touches « { » et « } » pour diminuer/augmenter le dégradé, et les touches « < » et « > » pour diminuer/augmenter l'opacité.

Si vous disposez d'une tablette graphique avec sensibilité à la pression du stylet, darktable peut appliquer la pression du stylet enregistrée à certains attributs du coup de pinceau. Cette opération peut être contrôlée dans préférences > chambre noire > contrôle de la pression du pinceau du masque.

En soulevant le stylet ou en relâchant le bouton gauche de la souris, le coup de pinceau est converti en un certain nombre de nœuds connectés, qui définissent la forme finale. Une option de configuration (préférences > chambre noire > lissage du pinceau) contrôle le degré de lissage appliqué. Un niveau de lissage plus élevé entraîne la création de moins de nœuds -- ceci facilite l'édition ultérieure au détriment d'une précision moindre.

Les nœuds et segments d'un coup de pinceau peuvent être modifiés individuellement. Voir la documentation sur les formes de chemin (ci-dessus) pour plus de détails.

Remarque : Le rendu d'une forme de pinceau complexe peut consommer un nombre important de cycles CPU. Pensez à utiliser à la place les formes cercle, ellipse ou chemin lorsque cela est possible.

dégradé

La forme dégradé est un dégradé linéaire qui s'étend d'un point donné jusqu'au bord de l'image.

Cliquez sur le canevas de l'image pour définir la position de la ligne qui définit 50 % d'opacité. Les lignes pointillées indiquent la distance au-delà de laquelle l'opacité est de 100% et de 0%. Entre ces lignes pointillées, l'opacité change linéairement.

La ligne a deux nœuds d'ancrage que vous pouvez faire glisser pour modifier la rotation du dégradé. Vous pouvez également définir l'angle de rotation lors du placement de la forme de dégradé en cliquant et en faisant glisser pour placer la forme.

Les lignes de dégradé peuvent également être courbées en faisant défiler avec votre souris tout en survolant la ligne centrale. Cela peut être utile pour contrer la distorsion causée par le module correction des objectifs.

Selon le module et l'image sous-jacente, l'utilisation d'une forme de dégradé peut provoquer des artefacts de bandes. Vous devriez envisager d'activer le module homogénéisation pour atténuer ce problème.

inverser la polarité d'un masque dessiné

Cliquez sur le bouton « +/- » pour inverser la polarité de l'ensemble du masque dessiné. Par exemple, un masque circulaire entraînera, par défaut, l'application du module uniquement à la zone à l'intérieur du cercle dessiné. En inversant sa polarité, le module s'appliquera à l'ensemble de l'image, à l'exception de ce cercle.

masques paramétriques

La fonction masque paramétrique offre un contrôle sélectif précis sur la façon dont les pixels individuels sont masqués. Pour ce faire, il génère automatiquement un masque de fusion intermédiaire à partir de paramètres définis par l'utilisateur. Ces paramètres sont des coordonnées de couleur plutôt que des coordonnées géométriques utilisées dans les masques dessinés.

Pour chaque canal de données d'un module (par exemple, Lab, RVB) et pour certains canaux de données virtuels (par exemple, teinte, saturation), vous pouvez construire une fonction d'opacité. En fonction de la valeur de chaque pixel pour un canal donné, cette fonction calcule un facteur de fusion compris entre 0 et 1 (100 %) pour ce pixel.

Chaque pixel d'une image a ainsi des facteurs de fusion différents pour chacun de ses canaux de données. Tous les facteurs de fusion sont finalement multipliés entre eux (pixel par pixel) et avec la valeur du curseur d'opacité globale, pour former un masque de fusion paramétrique complet pour l'image.

Si le masque de fusion a une valeur de 0 pour un pixel donné, l'entrée du module reste inchangée. Si le masque de fusion a une valeur de 1 (100%) pour un pixel, le module a tout son effet.

onglets de canal

Cliquez sur l'un des onglets de canal pour sélectionner un canal de données à utiliser pour créer votre masque.

Les modules agissant dans l'espace colorimétrique Lab (relatif à l'affichage) ont des canaux de données pour L, a, b, C (chroma de LCh) et h (teinte de LCh).

Les modules agissant dans l'espace colorimétrique RVB relatif à l'affichage ont des canaux de données pour g (gris), R, V, B, T (teinte de TSL), S (saturation de TSL) et L (clarté de TSL).

Les modules agissant dans l'espace colorimétrique RVB relatif à la scène ont des canaux de données pour g (gris), R, G, B, Jz (composante de luminance de JzCzhz), Cz (chroma ou saturation de JzCzhz) et hz (teinte de JzCzhz). La valeur g (gris) est calculée comme une moyenne pondérée des canaux R, V et B, les pondérations exactes dépendant de l'espace colorimétrique de travail utilisé. L'espace colorimétrique JzCzhz est une représentation polaire de l'espace colorimétrique Jzazbz, de la même manière que LCh est une représentation polaire de l'espace Lab. Comme le L dans l'espace colorimétrique Lab, le Jz est une représentation de la luminosité d'un pixel qui s'aligne sur la façon dont nous percevons la luminosité. Cependant, l'espace colorimétrique Jzazbz est bien meilleur pour les images à plage dynamique élevée et est moins sensible aux changements de teinte que l'espace Lab.

Voir Wikipedia pour plus de détails sur ces espaces colorimétriques.

Deux curseurs peuvent être affichés pour chaque canal de données associé : un qui fonctionne sur les données d'entrée que le module reçoit et un qui fonctionne sur les données de sortie que le module produit avant la fusion. Les curseurs des canaux de données de sortie sont masqués par défaut et peuvent être affichés à l'aide de l'option afficher les canaux de sortie dans le menu de fusion.

Le curseur facteur de renforcement permet d'étendre la plage des valeurs ciblées par les curseurs du masque paramétrique. Il peut être utilisé pour cibler les hautes lumières dans le développement relatif à la scène, où les valeurs de luminance peuvent s'étendre au-delà de 100%. Ce curseur n'est disponible que pour les canaux où il est significatif.

afficher les données d'un canal et le masque résultant

Tapez sur la lettre C tout en survolant le curseur d'entrée/sortie d'un canal pour afficher les données d'image d'entrée/sortie pour ce canal de couleur. L'image centrale change pour afficher ce canal de couleur soit en niveaux de gris, soit en fausses couleurs selon le réglage dans préférences > chambre noire > affiche les différents canaux de couleur.

Tapez sur la lettre M pour superposer à l'image le masque résultant pour ce curseur.

Lorsque le pointeur de la souris quitte le curseur, l'image revient à la normale après un court délai.

mode linéaire / log

Tapez sur la lettre A tout en survolant le curseur pour passer son affichage en mode «logarithme». Cela permet un contrôle plus fin dans les ombres. Appuyez à nouveau sur A pour revenir au mode «linéaire».

curseurs d'entrée/sortie de canal

Avec chaque curseur de canal de couleur, vous pouvez construire une fonction d'opacité trapézoïdale. A cet effet, il y a quatre marqueurs par curseur. Deux triangles pleins au-dessus du curseur marquent la plage de valeurs où l'opacité est 1. Deux triangles ouverts en dessous du curseur marquent les valeurs de plage où l'opacité est 0. Les points intermédiaires entre plein et zéro reçoivent une opacité proportionnelle.

Les triangles pleins, ou marqueurs intérieurs, indiquent le bord fermé (généralement plus étroit) de la fonction trapézoïdale. Les triangles ouverts, ou marqueurs extérieurs, indiquent le bord ouvert (principalement plus large) de la fonction trapézoïdale. L'ordre des marqueurs reste toujours inchangée : ils peuvent se toucher mais ne peuvent pas échanger leur position.

Un bouton de polarité (+/-) à droite de chaque curseur bascule entre les modes « sélection de plage » et « dé-sélection de plage », avec une confirmation visuelle fournie en échangeant les marqueurs triangulaires supérieur et inférieur. Ces deux types de fonctions trapézoïdales sont représentés graphiquement dans les images suivantes.

sélection de plage

dé-sélection de plage

Dans leur état par défaut, tous les marqueurs sont à leurs positions extrêmes.

Dans cet état, une fonction sélection de plage sélectionne toute la plage de valeurs donnant un masque «tout à 100%». À partir de là, on peut déplacer les curseurs vers l'intérieur pour exclure progressivement de plus en plus de parties de l'image, à l'exception de la plage étroite restante.

Inversement, une fonction dé-sélection de plage (activée en basculant la polarité) désélectionne par défaut toute la plage de valeurs, donnant un masque «tout à zéro» comme point de départ. Le déplacement des curseurs vers l'intérieur inclut progressivement de plus en plus de parties de l'image, à l'exception de la plage étroite restante.

pipettes de couleur

Avec la pipette de couleur de gauche, vous pouvez sélectionner dans votre image un point ou une zone. Les valeurs correspondantes pour les canaux de données réels et virtuels sont ensuite affichées dans chaque curseur de canal de couleur.

Avec la pipette de couleur de droite, vous pouvez définir automatiquement les valeurs du curseur en fonction de la plage sélectionnée. Cliquez et faites glisser pour définir les paramètres du curseur d'entrée à partir du rectangle dessiné ; Ctrl+clic et faites glisser pour définir les paramètres du curseur de sortie.

inversion

Cliquez sur le bouton d'inversion au-dessus des curseurs pour inverser la polarité de l'ensemble du masque paramétrique. Cela diffère des boutons de polarité à côté des curseurs individuels qui inversent simplement les paramètres du curseur/canal actuel.

réinitialiser

Cliquez sur le bouton de réinitialisation au-dessus des curseurs pour rétablir tous les paramètres du masque paramétrique à leur état par défaut.

combiner les masques dessinés/paramétriques

Masques dessinés et paramétriques peuvent être utilisés conjointement pour former un masque unique pouvant être appliqué à un module.

Deux éléments principaux contrôlent la façon dont les masques individuels sont combinés : le réglage de la polarité de chaque masque individuel (défini par les boutons plus ou moins) et le réglage dans le menu déroulant « combinaison des masques ».

Le menu déroulant « combinaison des masques » contient les options suivantes, définissant comment les masques dessinés et paramétriques seront combinés :

exclusif

Méthode simple de combinaison des masques, le mode exclusif multiplie ensemble les valeurs individuelles des pixels de chacun des composants de masques.

Pour un pixel donné, le masque final aura la valeur 0 si chacun des masques individuels sont à 0 à cet endroit et il n'aura la valeur 1,0 que si tous les masques ont une valeur de 1,0 à cet endroit.

Tout masque individuel peut exclure un pixel en fixant sa valeur à 0, indépendamment de ce que font les autres masques. Une fois qu'un pixel est exclu par un masque, il n'y a aucun moyen pour un autre masque de l'inclure à nouveau.

inclusif

Le mode inclusif inverse d'abord chaque masque individuel (soustrait sa valeur de 1,0), multiplie les masques inversés ensemble, et enfin inverse à nouveau le masque combiné.

Pour un pixel donné, le masque final aura une valeur de 1,0 si n'importe le quel des masques individuels est à 1,0 à cet endroit et il n'aura une valeur de 0 que si tous les masques ont une valeur de 0 à cet endroit.

Tout masque individuel peut inclure un pixel en fixant sa valeur à 1,0, indépendamment de ce que font les autres masques. Une fois qu'un pixel est entièrement inclus par un masque (sa valeur est 1.0), il n'y a aucun moyen pour un autre masque de l'exclure à nouveau.

modes inversés exclusif et inclusif

L'utilisation des méthodes de combinaison ci-dessus seules serait encore assez limitative. Nous obtenons une flexibilité maximale en permettant une étape d'inversion supplémentaire pour chaque masque individuel. Ceci est régi par les boutons de polarité que vous trouvez près des canaux individuels.

Basculer le bouton de polarité d'un masque inverse ses valeurs (soustrait la valeur originale de 1.0).

Enfin, dans le menu déroulant « combinaison des masques », vous pouvez sélectionner les options exclusif & inversé ou inclusif & inversé. Chacune de ces options est équivalente aux modes exclusif et inclusif, respectivement, mais avec une étape finale qui inverse le masque résultant.

cas typiques d’utilisation

mode inclusif

Pour ce mode, vous réglez le menu déroulant « combinaison des masques » sur le mode inclusif et vous assurez que tous les boutons de polarité de tous les canaux individuels et du masque dessiné sont réglés sur négatif (-). Votre point de départ est un masque dont tous les pixels ont une valeur zéro (aucun pixel n'est sélectionné). Vous pouvez maintenant ajuster les curseurs du masque paramétrique pour inclure de plus en plus de pixels dans la sélection ou dessiner des formes sur le canevas pour sélectionner des zones spécifiques de votre image.

mode exclusif

Dans le cas contraire, vous réglez le menu déroulant « combinaison des masques » en mode exclusif et vous assurez que tous les boutons de polarité sont réglés sur positif (+). Votre point de départ est un masque dont toutes les valeurs sont à 1,0 (tous les pixels sont sélectionnés). Vous pouvez maintenant ajuster les curseurs du masque paramétrique pour exclure certaines parties de votre image selon vos besoins ou dessiner directement des formes sur le canevas pour exclure ces zones.

Pour votre commodité, l'interface graphique des masques paramétriques fournit un bouton de basculement qui inverse toutes les polarités des canaux et permet de basculer entre le mode inclusif et exclusif dans le menu déroulant « combinaison des masques ».

Pour les utilisateurs débutants, il est recommandé de s'en tenir aux deux cas d'utilisation ci-dessus. Cela signifie que vous devez décider à l'avance comment vous voulez construire votre masque.

raffinement du masque et contrôles supplémentaires

Lorsqu'un masque paramétrique ou dessiné est actif, plusieurs curseurs supplémentaires s'affichent pour permettre d'affiner le masque.

seuil de détails

Cette commande vous permet de modifier l'opacité du masque en fonction de la quantité de détails dans l'image. Utilisez ce curseur pour sélectionner soit des zones avec beaucoup de détails (valeurs positives) soit des zones plates et manquant de détails (valeurs négatives). La valeur par défaut (zéro) contourne efficacement le raffinement des détails. Ceci est surtout utile pour appliquer des effets de netteté et de flou qui ignorent les zones hors focus (bokeh) ou pour accentuer uniquement les parties floues, empêchant ainsi une netteté excessive des zones de focus.

Remarque : Les données utilisées pour le raffinement du masque de détails proviennent de l'étape de dématriçage dans le pipeline de traitement, et non de l'entrée du module (qui est utilisée pour les autres critères de masque paramétrique). Aucun des modules de traitement après le dématriçage n'aura d'effet sur le masque de détails et il n'est actuellement pas disponible pour les images non RAW.

guide de raffinement

Le raffinement du masque adoucit un masque dessiné ou paramétrique de sorte que les bords du masque s'alignent automatiquement avec les bords des entités de l'image. Le lissage est guidé soit par l'entrée soit par la sortie du module (avant la fusion), et peut se produire avant ou après le floutage du masque, selon ce qui est sélectionné dans la boîte déroulante «guide de raffinement». Le raffinement est particulièrement sensible au choix de l'image guide lorsqu'il est utilisé avec des modules de modification des contours (modules de netteté ou de floutage d'une image).

sortie avant flou : le dégradé est guidé à l'aide de l'image sortie du module et a lieu avant que le masque ne soit flouté

entrée avant flou : le dégradé est guidé à l'aide de l'image d'entrée du module et a lieu avant que le masque ne soit flouté

sortie après flou : le dégradé est guidé à l'aide de l'image sortie du module et a lieu après que le masque a été flouté

entrée après flou : le dégradé est guidé à l'aide de l'image d'entrée du module et a lieu après que le masque a été flouté

rayon du raffinement

Ajuste la force de l'effet de raffinement. Le raffinement fonctionne mieux si les bords du masque correspondent déjà approximativement à certains bords de l'image guide. Plus le «rayon de raffinement» est grand, mieux l'algorithme de raffinement peut aligner le masque sur des bords plus éloignés. Cependant, si ce rayon est trop grand, le masque raffiné peut déborder (couvrir les régions que l'utilisateur souhaite exclure). Le raffinement est désactivé lorsque le rayon de raffinement est défini sur 0.

rayon du flou

Le flou du masque crée une transition plus douce entre les parties fusionnées et non fusionnées d'une image et peut être utilisé pour éviter les artefacts. Le curseur de flou du masque contrôle le rayon d'un flou gaussien appliqué au masque de fusion final. Plus le rayon est élevé, plus le flou est fort (défini sur 0 pour un masque non flou). Par défaut, le flou du masque est appliqué après le raffinement si les deux types de réglage du masque sont activés. Cela permet de lisser les arêtes vives ou les artefacts résultants.

opacité du masque

La force de l'effet du module est déterminée par l'opacité locale du masque. Le raffinement et le floutage du masque peuvent réduire l'opacité du masque d'origine. Pour compenser cela, le curseur «opacité du masque» vous permet de réajuster l'opacité du masque. Si l'opacité du masque est diminuée (valeurs de curseur négatives), les parties moins opaques sont plus fortement affectées. Inversement, si l'opacité du masque est augmentée (valeurs de curseur positives), les parties plus opaques sont plus fortement affectées. En conséquence, des portions complètement opaques du masque restent toujours opaques et des portions complètement transparentes restent toujours transparentes. Cela permet de garantir que les régions qui ont été entièrement exclues ou incluses dans l'effet d'un module (en définissant l'opacité du masque sur 0% ou 100%) restent entièrement exclues ou incluses.

contraste du masque

Ce curseur augmente ou diminue le contraste du masque. Cela vous permet d'ajuster la transition entre les parties opaques et transparentes du masque.

icône œil désactiver temporairement le masque

Il est parfois utile de visualiser l'effet d'un module sans que le masque ne soit actif. Cliquez sur cette icône pour désactiver temporairement le masque (le mode de fusion sélectionné et l'opacité globale restent en vigueur).

icône masque afficher le masque

Cliquez sur cette icône pour afficher le masque actuel sous forme de superposition jaune sur une version noir et blanc de l'image. Le jaune uni indique une opacité de 100%; une image d'arrière-plan gris entièrement visible (sans superposition jaune) indique une opacité de 0%.

exemple : raffiner un masque dessiné

Il peut être assez fastidieux de créer un masque dessiné qui couvre précisément une caractéristique particulière d'une image. Dans cet exemple, nous souhaitons améliorer le contraste des couleurs de la sculpture de lion montrée dans l'image de gauche ci-dessus sans affecter l'arrière-plan.

La première image ci-dessus est l'originale, non modifiée.

La deuxième image montre une sélection approximative de la sculpture créée avec un masque dessiné. A noter que le masque est assez flou et ne suit pas précisément le contour de la sculpture du lion.

La troisième image montre l'effet de l'ajustement du rayon de raffinement, de l'opacité du masque et du contraste du masque, conduisant à un masque bien adapté avec peu d'effort. Dans cet exemple, le rayon de raffinement a été ajusté à 50 et un rayon de flou de 5 a été choisi pour lisser le masque dans une certaine mesure. L'opacité et le contraste du masque ont été augmentés à 0,3 et 0,5, respectivement.

La dernière image ci-dessus montre le résultat final, où l'amélioration des couleurs (via le module contraste de couleur) est limitée seulement à la sculpture du lion.

Le raffinement du masque fonctionne particulièrement bien dans cet exemple car la sculpture est bien séparée de l'arrière-plan flou. Le bord distinct à la frontière de la sculpture guide l'ajustement du masque de raffinement pour correspondre à la forme de la sculpture.

masques raster

Comme décrit dans les sections précédentes, la sortie finale du masque d'un module (l'effet combiné de tous les masques dessinés et paramétriques) est une image raster en niveaux de gris Indiquant dans quelle mesure l'effet du module doit être appliqué à chaque pixel. Cette image raster est stockée en interne pour les modules actifs et peut être réutilisée par la suite par d'autres modules dans le pipeline graphique.

Comme avec tout masque, si la valeur d'opacité d'un pixel dans un masque raster est égale à zéro, le module n'a aucun effet sur ce pixel. Si l'opacité d'un pixel est égale à 1, le module a son plein effet sur ce pixel. Si l'opacité d'un pixel est comprise entre 0 et 1, l'effet du module sur ce pixel est appliqué proportionnellement à cette opacité.

Vous pouvez choisir un masque raster dans la liste déroulante. Les masques raster peuvent être identifiés par le nom du module dans lequel ils ont été générés.

Remarque : Les masques raster sont générés dans le cadre du traitement interne d'un module. Une fois le traitement d'un module terminé, son masque devient alors disponible pour les modules suivants dans le pipeline graphique.

Cela a deux conséquences :

Les masques raster ne peuvent pas être générés par les modules désactivés car ceux-ci ne participent pas au traitement dans le pipeline graphique. Dès que vous désactivez un module, son masque n'est plus utilisable.

Les masques raster sont passés vers le haut du pipeline graphique après le traitement du module -- ils ne peuvent être utilisés que par les modules qui viennent plus tard que le module qui les génère.

organisation

présentation

les groupes de modules

panneau d'accès rapide

gérer les dispositions de modules

présentation

Les modules de traitement sont organisés et accessibles via le panneau de droite de la chambre noire :

Cliquez sur les icônes en haut de ce panneau pour faire apparaître, de gauche à droite,

accès rapide panneau d'accès rapide

Un panneau personnalisable permettant un accès rapide aux contrôles des modules couramment utilisés.

icône du groupe des modules actifs modules actifs

Un groupe contenant les modules qui sont actuellement actifs dans le pipeline graphique. Cliquez avec le bouton droit pour afficher tous les modules présents dans l'historique au sein du groupe actif, qu'ils soient ou non réellement actifs.

groupes de modules

Un ou plusieurs groupes de modules de traitement. Ces groupes sont définis par l'utilisateur, mais certains regroupements par défaut sont fournis en tant que préréglages.

menu des préréglages

Un menu qui vous permet d'accéder aux préréglages stockés des dispositions de modules et de créer les vôtres (via l'option « gérer préréglages.. »). Vous pouvez également accéder directement à la boîte de dialogue « gérer les préréglages.. » avec un Ctrl+clic sur le menu des préréglages.

Cliquez une fois sur l'icône d'un groupe de modules (y compris le groupe actif) pour afficher uniquement les modules de ce groupe. Cliquez une deuxième fois pour afficher une liste de tous les modules actuellement actifs ou présents dans n'importe quel groupe.

Vous pouvez modifier la liste des widgets qui apparaissent dans le panneau d'accès rapide et la liste des modules qui apparaissent dans les groupes de modules, en cliquant avec le bouton droit sur l'icône appropriée.

chercher

Sous les icônes de groupe de modules se trouve la barre de recherche, que vous pouvez utiliser pour accéder à n'importe quel module de traitement, qu'il fasse ou non partie d'un groupe. Certains modules ont des mots-clés supplémentaires stockés avec eux qui seront également interrogés lors de la recherche.

les groupes de modules

Un certain nombre de groupes de modules prédéfinis sont livrés avec darktable et peuvent être sélectionnés en tant que préréglages. Ceux-ci sont résumés ci-dessous.

Tous ces préréglages (à l'exception de modules : dépréciés et chercher seulement) incluent également le panneau d'accès rapide. Tous, à l'exception du groupe modules : dépréciés, incluent la barre de recherche.

modules : tous

Ce préréglage contient comme suit tous les modules, triés selon les groupes de modules traditionnels utilisés avant darktable 3.4 :

icône-groupe-modules-de-base base

L'ensemble minimal de modules normalement requis pour créer une image présentable.

icône-groupe-modules-tonalité tonalité

Des modules liés aux niveaux de tonalité et au contraste.

module-group-color-icon couleur

Modules liés à l'étalonnage des couleurs et aux profils de couleurs.

icône-groupe-modules-retouche retouche

Modules liés à la correction de problèmes tels que les distorsions de l'objectif, le bruit du capteur, la netteté, etc.

icône-groupe-modules-effet effets (spéciaux)

Modules « effets spéciaux » tels que retouche, liquéfier, lumière d'arrière-plan, renforcer la netteté, etc.

modules : défaut

Ce préréglage est la disposition par défaut de groupes de modules à partir de darktable 3.4. Il est constitué comme suit d'un ensemble simplifié de groupes de modules :

icône-groupe-modules-techniques technique

Modules qui traitent des problèmes techniques liés à la physique des capteurs et à la réduction de bruit, aux objectifs et aux corrections associées, aux profils de couleurs, à la plage dynamique et au mappage des tons, et à la récupération des dommages causés à l'image par des limitations physiques (pixels chauds, hautes lumières écrêtées, etc.).

icône-groupe-modules-étalonnage étalonnage couleur

Modules concernés par les corrections primaires (correctives) et secondaires (créatives) des couleurs et des tons.

icône-groupe-modules-effet effets (spéciaux)

Modules « effets spéciaux » tels que retouche, liquéfier, lumière d'arrière-plan, renforcer la netteté, etc.

flux de travail : relatif à la scène & flux de travail : relatif à l'affichage

Ces préréglages définissent des groupes de modules pertinents pour le flux de travail relatif à la scène et pour le flux de travail relatif à l'affichage, triés en groupes comme indiqué ci-dessous :

icône-groupe-base-modules base

Un ensemble de modules de base pour ajuster le recadrage/l'orientation, ajuster l'exposition et appliquer des mappages de tons et un contraste en fonction du flux de travail.

icône-groupe-modules-couleur couleur

Modules relatifs à l'étalonnage et à la saturation des couleurs.

icône-groupe-modules-retouche retouche

Modules relatifs à la correction des problèmes liés aux distorsions de l'objectif, au bruit du capteur, à la netteté, à la retouche, etc.

icône-groupe-modules-effet effets (spéciaux)

Modules « effets spéciaux » tels que filigrane, cadre décoratif, vignettage, etc.

flux de travail : débutant

Ce préréglage fournit un ensemble minimal de modules ciblés comme point de départ pour les débutants. Il est suggéré aux débutants de commencer par copier ce préréglage minimal et de l'enrichir au fur et à mesure qu'ils acquièrent de l'expérience avec d'autres modules.

icône-groupe-modules-base base

Un ensemble de modules de base pour ajuster le recadrage/l'orientation, ajuster l'exposition et appliquer un mappage de tonalité de base via une courbe de base ou des ajustements de base.

icône-groupe-modules-étalonnage couleur étalonnage couleur

Modules traitant de la gestion créative des tons et de l'étalonnage des couleurs.

icône-groupe-modules-effet effets (spéciaux)

Modules « effets spéciaux » tels que retouche, renforcer la netteté, filigrane, etc.

configuration antérieure

Ces préréglages sont générés automatiquement pour les utilisateurs qui ont effectué une mise à niveau à partir d'une version de darktable antérieure à 3.4. Là où vous avez précédemment configuré des favoris ou modifié le drapeau caché des modules, ces préréglages contiennent ces personnalisations, en conservant les groupes de modules originels (préréglages de la configuration antérieure) ou les nouveaux groupes de modules (préréglages de la configuration antérieure avec la nouvelle disposition).

Si des favoris ont été créés dans des versions antérieures, ils resteront disponibles dans un groupe supplémentaire :

icône-groupe-modules-favoris favoris

Ce groupe était auparavant utilisé par les utilisateurs pour faciliter la recherche des modules fréquemment utilisés et est disponible sous les préréglages « configuration antérieure ». Les nouveaux utilisateurs peuvent, bien sûr, toujours créer leur propre groupe personnalisé et le nommer « favoris » s'ils le souhaitent.

chercher seulement

Ce préréglage n'inclut aucun groupe de modules. Les modules ne sont accessibles qu'à l'aide de la fonction de recherche.

modules : dépréciés

Ce préréglage contient une liste de modules dépréciés. C'est le seul moyen d'accéder aux modules dépréciés pour les nouvelles modifications, mais soyez prévenu : ces modules seront supprimés pour les nouvelles modifications dans la prochaine version de darktable. Ce groupe ne peut pas être dupliqué et les modules qu'il contient ne peuvent pas être ajoutés à des groupes créés par l'utilisateur.

panneau d'accès rapide

Le panneau d'accès rapide vous permet, en un seul endroit, d'accéder aux widgets d'un certain nombre de modules de traitement.

Vous pouvez ajouter de nouveaux widgets en cliquant avec le bouton droit sur l'icône en haut à gauche ou en utilisant l'écran gérer les dispositions de modules.

Cliquez sur l'icône à droite du nom du module pour ouvrir la version complète de ce module. Cliquez sur l'icône à gauche du nom du module pour activer/désactiver le module.

Actuellement, seuls certains widgets peuvent être ajoutés à ce panneau (cases à cocher, curseurs, listes déroulantes) -- les widgets plus complexes tels que les courbes ne sont pas pris en charge.

Si un module a des instances multiples activées, vous ne pourrez plus gérer les widgets de ce module via le panneau d'accès rapide et devrez utiliser l'interface complète du module.

gérer les dispositions de modules

Gérer la disposition et le regroupement des modules de traitement ainsi que le panneau d'accès rapide.

Cet écran de maintenance est accessible à partir du menu préréglages à côté de la zone de recherche de module ou des icônes de groupe de modules (sous le module des scopes dans la vue chambre noire). Ctrl+clic sur le menu prédéfini pour ouvrir cet écran directement.

Les paramètres sont automatiquement enregistrés lorsque vous quittez l'écran. Cliquez sur réinitialiser pour abandonner les modifications apportées dans la session d'édition en cours.

contrôles du module

contrôles globaux

Les contrôles globaux suivants sont disponibles dans le panneau supérieur de l'écran.

préréglage

Sélectionner un préréglage existant de groupe de modules.

enlever

Supprimer le préréglage actuel (concerne uniquement les préréglages définis par l'utilisateur).

cloner

Cloner le préréglage actuel avec un nouveau nom. L'exemple ci-dessus montre un nouveau préréglage nommé « user defined », qui a été créé en clonant le préréglage « modules : par défaut ».

renommer

Renommer le préréglage actuel (préréglages définis par l'utilisateur uniquement). Faites un clic droit pour faire apparaître un menu qui peut être utilisé pour couper, copier, coller, supprimer, tout sélectionner ou insérer un émoji).

nouveau

Créer un nouveau préréglage contenant une liste minimale de modules.

montrer le zone de recherche

Choisir d'afficher ou non la barre de recherche sous les icônes des groupes de modules

afficher le panneau d'accès rapide

Choisir d'afficher ou non le panneau d'accès rapide. Si coché, une nouvelle entrée apparaîtra dans le panneau inférieur pour vous permettre d'ajouter ou de supprimer des widgets.

afficher tous les modules de l'historique dans le groupe actif

Sélectionnez cette option pour afficher tous les modules présents dans l'historique au sein du groupe actif, qu'ils soient ou non réellement actifs.

appliquer automatiquement ce préréglage

Les préréglages de groupe de modules peuvent être appliqués automatiquement en fonction du type d'image sur lequel vous travaillez. La case à cocher indique si ce préréglage a actuellement des règles d'application automatique. Cliquez sur l'icône représentant une roue dentée pour modifier les paramètres d'application automatique. Voir préréglages pour plus de détails.

les groupes de modules

Le panneau inférieur de l'écran vous permet de modifier le panneau d'accès rapide et les groupes de modules pour le préréglage sélectionné (préréglages définis par l'utilisateur uniquement).

ajouter un groupe

Cliquez sur le signe + à côté du libellé « groupes de modules »" pour ajouter un nouveau groupe.

supprimer un groupe

Supprimez un groupe en cliquant sur le bouton X à côté du nom du groupe.

ajouter un module/un widget

Ajoutez un module à un groupe, ou un widget au panneau d'accès rapide, en cliquant sur le signe + sous le nom du groupe. Sélectionnez le module/le widget requis dans la liste affichée.

supprimer un module/un widget

Supprimez un module d'un groupe ou un widget du panneau d'accès rapide en cliquant sur le X à côté du nom du module/du widget.

changer l'icône d'un groupe

Modifiez l'icône attribuée à un groupe en cliquant sur l'icône du groupe existant et en sélectionnant un nouveau dans la liste affichée.

modifier l'ordre des groupes

Modifiez l'ordre dans lequel les groupes sont affichés en cliquant sur les boutons < et > sous les noms des groupes.

renommer un groupe

Renommez un groupe de modules en cliquant sur le nom du groupe et en le tapant. Faites un clic droit pour faire apparaître un menu qui peut être utilisé pour couper, copier, coller, supprimer, tout sélectionner ou insérer un émoji)

Capture

présentation

disposition de la vue capture

exemples

dépannage

présentation

La vue capture vous permet de capturer des images directement dans darktable à partir d'un boîtier connecté.

Pour utiliser la fonctionnalité de capture, vous devez tout d'abord connecter votre boîtier à votre PC à l'aide d'un câble USB. Votre ordinateur peut vous demander de monter le boîtier connecté ou d'afficher son contenu. Ne le faites pas. Si votre boîtier est monté ou visualisé automatiquement, vous devrez le «démonter/éjecter» afin que darktable puisse y accéder. Cela le déverrouille et darktable peut en prendre le contrôle -- darktable le reverrouillera ensuite afin qu'il ne puisse pas être utilisé par d'autres applications.

Une fois le câble USB connecté, accédez au module importer de la vue table lumineuse. Si votre boîtier est prêt à l'emploi, une nouvelle section devrait apparaître dans le module importer contenant le nom de votre boîtier et un bouton «monter le boîtier». Cliquez sur ce bouton pour connecter votre boîtier et trois boutons supplémentaires apparaîtront : «copier & importer depuis le boîtier», «commander le boîtier» et «démonter le boîtier». Cliquez sur «commander le boîtier» pour entrer dans le mode capture. Lorsque vous avez terminé, appuyez sur le bouton "démonter le boîtier" avant de le déconnecter physiquement.

darktable utilise gphoto2 pour s’interfacer avec votre boîtier. S'il ne trouve pas votre boîtier connecté en utilisant la procédure indiquée ci-dessus, voyez la section dépannage dans ce chapitre pour vérifier que votre boîtier prend en charge le mode capture.

Les images sont affichées dans la vue centrale au fur et à mesure de leur capture. Vous pouvez effectuer une capture soit depuis l’interface utilisateur de darktable, soit en déclenchant manuellement. Si vous utilisez visée directe, votre image sera affichée sur la vue centrale de darktable.

Lorsque vous entrez dans le mode capture, une pellicule est créée en utilisant la même structure que celle définie lorsque vous faites une importation depuis le boîtier (voir préférences > importer > options de session). Le code de la tâche sera prédéfini à «capture».

Si vous désirez regrouper vos captures dans différentes pellicules, vous pouvez utiliser le module session du panneau de droite pour définir un code de projet différent. Lorsque vous entrez un nouveau nom et que vous tapez Entrée, une nouvelle pellicule est créée et les images capturées seront ajoutées à cette nouvelle pellicule.

darktable fournit quelques excellents outils pour configurer une capture depuis l’interface utilisateur. Vous pouvez configurer des accélérés (timelapse), du bracketing pour le HDR et même des captures séquentielles d'images. Pour plus d’informations, lisez la documentation concernant le module pilotage du boîtier et voyez les exemples plus loin dans ce chapitre.

disposition de la vue capture

panneau gauche

informations de l'image

Afficher les informations de l'image.

panneau droit

De haut en bas :

scopes

Une représentation graphique des niveaux de lumière et des couleurs de l'image actuelle. Ce module peut être déplacé vers le panneau de gauche si vous le souhaitez (voir préférences > divers > position du module scopes).

session

Paramètres de la session.

visée directe

Paramètres de la visée directe.

paramètres du boîtier

Paramètres du boîtier.

éditeur de métadonnées

Éditer les métadonnées des images sélectionnées.

mots-clés

Étiqueter par mots-clés les images sélectionnées.

panneau inférieur

De gauche à droite :

évaluation par étoiles

Appliquer une évaluation par étoiles aux images.

labels de couleur

Appliquer des catégories de couleurs aux images.

exemples

Les sections suivantes présentent deux cas d'utilisation typiques de la vue capture.

configuration de studio avec écran

Ceci est un cas d’utilisation assez habituel. Vous avez mis en place votre studio et votre sujet, le boîtier est connecté à votre ordinateur et la vue capture est active dans darktable. Vous opérez avec le boîtier et prenez des images. Quand vous le voulez, vous pouvez contrôler les images directement sur l’écran de votre ordinateur plutôt que d’utiliser l'écran LCD du boîtier.

Ce flux de travail est efficient et efficace, car vous pouvez examiner immédiatement vos captures sans attendre la fin de la prise de vue quand tout le monde est parti. Si vous faites des prises de vue d’un modèle, c'est une manière sympathique de prévisualiser les prises de vues avec le client plutôt que de le faire en tripotant votre appareil photo.

Travailler en mode capture peut vous épargner du temps et de l’énervement. Définissez un nom de session, prenez vos photos, elles seront sauvegardées dans la pellicule appropriée à la session et vous pourrez les examiner facilement sur place.

capture d’un accéléré (timelapse)

Un accéléré (timelapse) est un clip vidéo composé d’images prises séquentiellement. Un exemple typique est la prise d'un accéléré de photos de ville où vous capturez les nuages, la circulation, etc.

Afin de définir un accéléré (timelapse), créez une nouvelle session. Décidez ensuite si vous désirez effectuer la prise de vue en mode manuel ou automatique. N'utilisez le mode auto que dans les situations où la lumière ambiante change de manière significative pendant la durée de la prise de vue, par exemple, lorsque vous faites une prise de vues de plus de 24 heures.

Le panneau paramètres de la capture peut être utilisé pour définir le délai (la durée (pas de bkt. de l'interface), en secondes, entre les prises de vues) et la séquence (le nombre d’images (nombre de l'interface)) de votre accéléré.

Pour lancer la prise de vue, cliquez le bouton «capture» dans le même panneau et regardez la pellicule se remplir d’images. La dernière image capturée est toujours affichée sur la vue centrale.

dépannage

Ce guide de dépannage peut être utilisé pour vérifier que votre appareil peut ou non fonctionner en mode capture. Ceci est effectué en utilisant les mêmes outils (gphoto2) que darktable utilise pour s’interfacer avec votre boîtier.

Avant de commencer, vous devez d'abord trouver le nom du port auquel votre boîtier est connecté. Généralement le port "usb:" est suffisant et est donc utilisé dans le guide suivant.

votre boîtier est-il détecté ?

La commande suivante vérifiera que votre boîtier est connecté à l'ordinateur et détecté par gphoto2.

env LANG=C gphoto2 --auto-detect

vérifier les capacités du pilote de la caméra

Exécutez la commande suivante et vérifiez que les capacités de <> comportent <> et que la prise en charge de la configuration est à «oui» -- darktable vérifiera ces deux capacités et décidera si le bouton «commander le boîtier» doit ou ne doit pas être affiché.

env LANG=C gphoto2 --port usb: --abilities

capture à distance

Cette étape vérifiera que votre appareil photo peut être contrôlé à distance, c'est-à-dire qu'il peut capturer une image, la télécharger sur votre ordinateur et l'afficher dans darktable.

env LANG=C gphoto2 --port usb: --capture-image-and-download

capture connectée

Cette dernière étape teste si votre boîtier prend en charge les "événements", qui sont fortement utilisés par darktable. L'exécution de cette commande fera attendre le processus gphoto2 un événement de capture d'image que vous devez déclencher manuellement sur votre boîtier. En cas de succès, l'image sera téléchargée sur votre ordinateur.

env LANG=C gphoto2 --port usb: --capture-tethered

et maintenant ?

Si l’une quelconque de ces étapes échoue, il y a des problèmes avec votre boîtier et son pilote. Veuillez signaler ce problème sur la page github de gphoto2. Pour obtenir une meilleure assistance, ajoutez les indicateurs suivants à la commande ci-dessus qui a échoué, relancez-la et joignez à votre courriel le fichier journal (log) obtenu :

--debug --debug-file gphoto2_debug.log

Si vous avez réussi tous les tests ci-dessus, votre boîtier sera très probablement pris en charge par darktable. Si ces tests ont réussi mais que vous rencontrez néanmoins un problème dans darktable, veuillez le signaler sur la page github de darktable. Veuillez joindre les fichiers journaux (log) des étapes ci-dessus et le fichier journal généré après avoir lancé darktable avec la commande suivante :

darktable -d camctl 2>1 >camctl.log

Carte

présentation

disposition de la vue carte

présentation

La vue carte vous permet de voir où vos images géolocalisées ont été prises, ainsi qu'ajouter les informations de géolocalisation aux images qui en sont dépourvues.

La vue carte montre une carte du monde avec les images de la collection courante collection placées à la position géographique (si disponible). Cela implique que les images aient l'information de géolocalisation. Certains appareils photo récents, téléphones mobiles inclus, sont équipés d'un récepteur GPS. D'autres appareils photo ont besoin d'un GPS complémentaire.

Même si l'appareil photo n'a pas de GPS, il y a une autre méthode -- darktable peux retrouver la date/heure Exif des images dans les données d'un ficher GPX créé par le GPS qui a enregistré vos mouvements. Un GPS peut être acheté comme dispositif indépendant ou vous pouvez installer l'application GPS sur votre téléphone mobile. L'ajout de l'information géolocalisation à partir d'un fichier GPX est réalisé par le module géolocalisation, sur les vues table lumineuse et carte.

centre de la vue carte

Au centre de la vue carte vous avez la carte du monde.

Les cartes proviennent de sources cartographiques sur internet. Ainsi, une nouvelle carte n'est disponible que si vous êtes connecté à internet -- darktable conserve en cache disque les cartes déjà téléchargées.

Vous pouvez naviguer en utilisant la souris. Faites un clic gauche et faites glisser pour déplacer la carte. Utilisez la molette de défilement pour zoomer et dézoomer.

Des commandes et informations sont disponibles à l'écran pour vous aider. Une zone de navigation est placée en haut à gauche de la carte -- utilisez ceci comme une alternative au déplacement et zoom par la souris. L'échelle de la carte est affichée en bas à gauche. En bas à droite vous avez les coordonnées géographiques du centre de la carte.

Les images déjà géolocalisées sont affichées comme des miniatures sur la carte. Les images proches les unes des autres sont regroupées et le compte des images du groupe est affiché dans le coin en bas à gauche de la miniature.

Pour affecter des coordonnées géographiques à une image, activez la pellicule dans le panneau inférieur (pressez Ctrl+F). Vous pouvez affecter des coordonnées géographiques à une image en la glissant de la pellicule et en la positionnant sur la carte -- darktable enregistre la nouvelle position (latitude et longitude) dans les métadonnées de l'image. Ces données peuvent être incluses dans les images exportées.

Pour supprimer les données de géolocalisation d'une image il suffit de la glisser de la carte sur la pellicule.

Les images proches les unes des autres sont regroupées sous une unique miniature. Vous pouvez utiliser le module paramètres de carte pour régler le regroupement selon vos besoins. Le nombre affiché dans le coin inférieur gauche de la miniature est le nombre d'images regroupées. Un nombre de couleur blanche signifie que toutes les images du groupe sont exactement à la même position, alors qu'un nombre jaune signifie qu'elles ne le sont pas. Utilisez la roulette de la souris en survolant un groupe d'images pour faire défiler les miniatures des images du groupe.

Normalement, les miniatures sur la vue carte ont une bordure noire. Si une image est sélectionnée dans la pellicule, alors la miniature correspondante sur la carte est affichée avec une bordure blanche.

Clic+glisser pour ajuster la position d'une image. Maj+clic pour déplacer tout le groupe d'images.

Les panneaux gauche et droits fournissent des contrôles supplémentaires (voir affichage vue carte).

annuler/refaire

Tous les mouvements d'image dans la vue carte sont enregistrés par darktable. Il est possible d'annuler ou de refaire de telles modifications pour récupérer un état précédent. Notez que cette facilité annuler/refaire est illimitée lors du déplacement d'images, mais elle est réinitialisée à chaque fois que vous quittez la vue carte.

Tapez Ctrl+Z pour annuler la dernière modification et Ctrl+Y pour refaire la dernière modification annulée (s'il y en a une).

disposition de la vue carte

panneau gauche

Ces modules sont identiques à ceux de la table lumineuse. De haut en bas :

collections

Filtrer la liste des images affichées dans la vue carte.

collections récemment utilisées

Afficher les collections d'images récemment utilisées.

informations de l'image

Afficher les informations de l'image.

panneau droit

Ici vous trouvez les modules spécifiques à la vue carte. De haut en bas :

trouver un lieu

Rechercher un lieu sur la carte

emplacements

Gérer une liste hiérarchisée d'emplacements associés à une zone géographique.

paramètres de carte

Choisir le fournisseur de carte et configurer divers paramètres d'affichage de la carte.

mots-clés

Étiqueter par mots-clés les images sélectionnées.

géolocalisation

Appliquer les données de piste GPX aux images sélectionnées.

panneau inférieur

pellicule

Faites glisser les images de la pellicule sur la carte comme décrit dans la présentation de la vue carte.

Diaporama

présentation

utilisation

présentation

La vue diaporama vous permet de regarder un diaporama de votre collection actuelle avec les règles de filtrage associées et l'ordre de tri appliqué.

Pour en savoir plus sur la définition des règles de collection et de filtrage, consultez la section collections. Sélectionnez les critères de tri et l'ordre de tri des images dans le panneau supérieur.

La section suivante fournit plus de détails sur l'utilisation de la vue diaporama.

utilisation

La vue diaporama est encore à un stade précoce de développement avec seulement un ensemble de fonctionnalités de base.

Si vous n'avez pas besoin du mode d'avance automatique, vous pouvez même utiliser à la place le mode d'aperçu permanent de la table lumineuse.

Espace            démarrer et arrêter le mode avance automatique qui par défaut
          fait passer automatiquement à l'image suivante toutes les cinq secondes.

ESC                  quitter le diaporama et retourner à la table lumineuse.

+ ou                  augmenter le délai entre chaque image.
flèche haut

- ou                 diminuer le délai entre chaque image.
flèche bas

clic gauche ou
flèche droit ou       passer à l'image suivante de la collection.
Maj droite

clic droit ou
flèche gauche ou     passer à l'image précédente de la collection.
Maj gauche

Astuce : Pour tirer pleinement parti de la taille de votre écran, mettez darktable en mode plein écran en appuyant sur F11 et masquez les contrôles de bordure en appuyant sur la touche B.

Impression

présentation

disposition de la vue impression

présentation

Cette vue vous permet d'imprimer vos photos. Parce qu'imprimer n'est pas aisé, de nombreux aspects techniques doivent être pris en compte.

Après avoir sélectionné une image dans la table lumineuse vous pouvez entrer dans le module paramètres d'impression pour ajuster les paramètres d'impression et lancer l'impression.

Ce module prend en charge le profil ICC de l'imprimante, ce qui est quelque peu obligatoire si vous souhaitez obtenir une impression de haute qualité proche de l'image affichée à l'écran.

Il est important de noter que les profils ICC fournis par les fabricants de papier et/ou d'imprimante ne peuvent pas être utilisés sous GNU/Linux car ils dépendent des pilotes d'imprimante. Le module impression de darktable utilise CUPS et il n'y a pas de profils ICC prêts à l'emploi pour ce pilote.

disposition de la vue impression

La zone centrale affiche la disposition de l'image sur le papier (la zone blanche). Des bordures grises peuvent être affichées autour de l'image pour représenter la zone imprimable (la page moins les bordures) non remplie par l'image.

La pellicule sous l'image vous permet de sélectionner plus d'images.

panneau gauche

collections 

Filtrer la liste des images affichées dans la table lumineuse.

informations de l'image 

Afficher les informations de l'image

panneau droit

paramètres d'impression

Ajuster les paramètres d'impression et initialiser l'impression.

Références des modules

présentation

modules de traitement

modules utilitaires

présentation

Les modules de cette section de référence sont divisés en deux types :

les modules de traitement

Les modules de traitement sont utilisés exclusivement dans la vue chambre noire. Chaque module effectue une opération de traitement sur l'image avant de transmettre le résultat au module suivant pour un traitement ultérieur. Ensemble, cette séquence d'étapes de traitement forme le pipeline graphique.

les modules utilitaires

Les modules utilitaires peuvent être utilisés dans n'importe quelle vue de darktable. Ils ne sont pas directement impliqués dans le traitement des pixels d'une image mais remplissent d'autres fonctions annexes (gestion des métadonnées de l'image et des mots-clés, modification de l'historique, modification de l'ordre du pipeline graphique, gestion des instantanés et clones, exportation d'images, etc).

Les deux types de modules ont quelques aspects en commun, décrits ci-dessous.

en-tête d'un module

Chaque module a un en-tête en haut, normalement composé des éléments suivants :

nom du module

Cliquez sur le nom pour développer ou réduire le reste du module et afficher/masquer ses contrôles.

bouton de réinitialisation des paramètres

Il apparaît normalement à droite du nom du module et est utilisé pour réinitialiser le module à son état d'origine.

menu des préréglages

Il apparaît normalement à l'extrême droite de l'en-tête du module. Le menu préréglages est principalement utilisé dans les modules de traitement, mais de nombreux modules utilitaires permettent également de définir des préréglages. Vous pouvez également accéder à ce menu en cliquant n'importe où avec le bouton droit de la souris sur l'en-tête du module.

Les modules de traitement contiennent des éléments supplémentaires dans leur en-tête, comme décrit dans la section en-tête du module de traitement.

redimensionner un module

modules utilitaires

Certains modules utilitaires contiennent des listes d'informations qui peuvent s'allonger à mesure que de nouvelles entrées sont ajoutées. Pour aider à gérer l'écran, il est possible de réduire ou d'augmenter le nombre maximal d'entrées affichées avant l'apparition d'une barre de défilement. Pour modifier ce nombre, placez la souris sur une entrée de la liste et maintenez la touche Ctrl enfoncée tout en faisant défiler avec la molette de la souris. Si la liste contient actuellement plus d'entrées que ce maximum, une barre de défilement apparaîtra pour accéder aux entrées masquées.

Remarque : Il n'est pas possible d'étendre ces zones au-delà du nombre d'entrées actuellement affichées. Si vous tentez de le faire en utilisant Ctrl+défilement, le nombre maximal d'entrées augmentera et un message apparaîtra pour vous informer du nouveau maximum. Cependant, le module lui-même ne sera pas redimensionné, sauf si son contenu dépasse ce maximum.

modules de traitement

Certains modules de traitement contiennent des éléments graphiques dessinés qui peuvent occuper trop ou trop peu d'espace à l'écran en fonction de la largeur de vos panneaux latéraux. Ces zones ont généralement par défaut un format 16:9 et peuvent être redimensionnées de la même manière en les survolant et en maintenant la touche Ctrl enfoncée pendant le défilement.

modules de traitement

aberrations chromatiques

aberrations chromatiques raw

adoucir (effet Orton)

ajustements de base (déprécié)

balance couleur

balance couleur rvb

balance des blancs

cadre décoratif

calibration des couleurs

censurer

coloriser

contraste de couleur

contraste local

contraste luminosité saturation

correction des couleurs

correction des objectifs

correction des taches (déprécié)

correction du profil d'entrée

courbe de base

courbe des tonalités

courbe rvb

dématriçage

diffusion ou netteté

docteur néga

égaliseur de contraste

égaliseur de ton

exposition

faible lumière

filigrane

filmique rvb

filtre dégradé

filtre passe-bas

filtre passe-haut

flou de surface

flous

grain

homogénéisation

inverser (déprécié)

liquéfier

lumière d'appoint (déprécié)

lumière d'arrière plan

lut 3D

mappage des couleurs

mappage des tonalités (déprécié)

mappage global des tonalités (déprécié)

mise à l'échelle des pixels

mixeur de canaux (déprécié)

monochrome

niveaux

niveaux rvb

ombres et hautes lumières

orientation

pixels chauds

point noir/blanc raw

profil de couleur d'entrée

profil de couleur de sortie

recadrer

recadrer et pivoter (déprécié)

reconstruction des couleurs

reconstruire hautes lumières

réduction du bruit (profil)

réduction du bruit photo astro

réduction du bruit RAW

renforcer la netteté

retouche

rotation des pixels

rotation et perspective

suppression de la brume

suppression des franges (déprécié)

table correspondance couleurs

velvia

vibrance (déprécié)

vignetage

virage partiel

zones (déprécié)

zones de couleurs

aberrations chromatiques

Corriger les aberrations chromatiques.

Contrairement au module aberrations chromatiques raw, ce module ne nécessite pas de données RAW en entrée.

flux de travail

Pour obtenir le meilleur résultat, il est conseillé de procéder comme suit :

Atténuer au maximum les aberrations chromatiques dans le module correction des objectifs à l'aide des curseurs AC.

Augmenter la force dans ce module pour mieux voir son effet.

Augmenter le rayon jusqu'à ce que les aberrations chromatiques disparaissent. Si cela est insuffisant, essayez d'activer le paramètre "« berrations chromatiques très larges ».

Choisir le guide qui donne le meilleur résultat en terme de netteté et d'artefacts.

Réduire la force pour éviter de trop « lessiver » les couleurs.

Pour les cas plus compliqués, vous pouvez également essayer ce qui suit :

Utiliser plusieurs instances avec différents modes de correction -- par exemple, une première instance en mode « éclaircir seulement », et une seconde en mode « assombrir seulement ».

Utiliser plusieurs instances avec un curseur force faible pour corriger les aberrations chromatiques petit à petit sans trop dégrader les couleurs.

Utiliser le module avec des masques paramétriques ou dessinés.

Utiliser les modes de fusion RVB rouge, vert et bleu pour limiter l'effet à un canal particulier.

contrôles du module

guide

Le canal de couleur qui sera utilisé comme référence pour la correction.

rayon

Le rayon de l'effet. Augmenter jusqu'à l'élimination des aberrations chromatiques. C'est le curseur le plus important du module.

force

Ce curseur agit comme une garde-fou et peut aider à préserver les zones colorées qui ne souffrent pas d'aberrations chromatiques. Augmenter pour une correction plus forte, diminuer pour une conservation plus forte.

mode de correction

Vous permet de restreindre l'effet uniquement à l’éclaircissement ou à l'assombrissement des pixels. Pour un contrôle total, cela peut être utilisé en combinaison avec les modes de fusion R, V, B et des instances multiples.

aberrations chromatiques très larges

Rend l'algorithme itératif pour aider à réduire les très larges aberrations chromatiques.

aberrations chromatiques raw

Corriger les aberrations chromatiques des images RAW.

Comme ce module opère sur des données RAW avant le dématriçage, le modèle sous-jacent suppose une image photographique en entrée non recadrée. Il est donc susceptible d'échouer lorsque vous zoomez, car il ne peut opérer que sur la partie visible de l'image. À des niveaux de zoom élevés darktable sautera le module dans le pipeline graphique, et un message « sauté en zoomant » apparaîtra en haut du module. Cette limitation ne s'applique qu'au travail interactif et non à l'exportation finale.

Ce module ne fonctionne actuellement que pour les images RAW enregistrées avec un capteur Bayer (le capteur utilisé dans la majorité des boîtiers) -- pour les autres types d'images, vous devez utiliser à la place le module aberrations chromatiques.

Le module n'appliquera pas non plus de corrections aux photos identifiées comme monochromes (voir développement d'images monochromes pour plus d'informations).

contrôles du module

itérations

Le nombre d'itérations. Pour la plupart des images, « deux fois » est suffisant et correspond à la valeur par défaut. Parfois, l'augmentation de ce contrôle peut donner de meilleurs résultats.

éviter les dérives colorées

Si le module provoque une teinte violette, cochez cette case pour appliquer une correction.

adoucir (effet Orton)

Créer une image adoucie en utilisant l'effet Orton.

Michael Orton a obtenu ses résultats sur des diapositives en utilisant deux expositions de la même scène, une bien exposée et une surexposée. Il a ensuite utilisé une technique de chambre noire pour fusionner ces deux images en une image finale où l'image surexposée était floue.

Ce module est une quasi-copie du processus analogique d'Orton dans le domaine numérique.

contrôles du module

taille

La taille du flou de l'image surexposée. Plus la taille est grande, plus le résultat est doux.

saturation

La saturation de l'image surexposée.

luminosité

La luminosité (IL) de l'image surexposée.

fusion

Comment les deux images sont fusionnées. 50% représente une fusion à parts égales des images bien exposées et surexposées.

ajustements de base (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.6 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le panneau d'accès rapide à la place.

Un module pratique qui combine les contrôles des modules exposition, reconstruire hautes lumières, balance couleur et vibrance en un seul module.

Bien que ce module puisse fournir un moyen rapide et pratique d'effectuer des ajustements simples d'une image, il doit être utilisé avec précaution. Normalement, les ajustements d'exposition doivent précéder l’application du module profil de couleur d'entrée dans le pipeline graphique, et les ajustements de couleur doivent venir ensuite. Étant donné que le module ajustements de base combine toutes ces fonctions en une seule opération dans le pipeline graphique, il peut ne pas fonctionner correctement avec d'autres modules. Par conséquent, si vous prévoyez d'utiliser des ajustements de base avec d'autres modules, veuillez plutôt envisager d'utiliser les modules exposition + courbe de base/courbe des tonalités/filmique rvb + balance couleur afin que ces opérations se produisent aux bons endroits dans le pipeline graphique.

contrôles du module

correction du niveau de noir

Équivalent à la correction du niveau de noir dans le module exposition, ce curseur définit le seuil à partir duquel les valeurs de gris foncé sont tronquées en noir pur. Le réduire cela peut ramener des couleurs sombres dans le gamut. Augmenter ce curseur peut sembler augmenter le contraste et le pop d'une image, mais cela peut pousser les couleurs sombres hors du gamut et les données écrêtées ne peuvent pas être récupérées plus loin dans le pipeline graphique. Pour contrôler le contraste dans les ombres, il est préférable d'utiliser d'autres modules tels que courbe des tonalités ou niveaux, qui atténuent ces impacts négatifs plus loin dans le pipeline graphique.

exposition

Ajuster la compensation d'exposition. Ajouter 1 IL de correction d'exposition équivaut à doubler le temps d'exposition de l'appareil photo, à ouvrir l'ouverture d'un cran ou à doubler l'ISO.

Des corrections d'exposition positives rendront l'image plus lumineuse. Avec pour effet secondaire un niveau de bruit augmenté. En fonction du niveau de bruit de base de votre appareil photo et de la valeur ISO de votre image, des compensations d'exposition positives allant jusqu'à 1 IL ou 2 IL devraient toujours donner des résultats raisonnables.

Les corrections d'exposition négatives assombriront l'image. Compte tenu de la nature des images numériques, cela ne peut pas corriger les hautes lumières complètement brûlées, mais vous permet de reconstruire les données si seuls certains des canaux RVB sont écrêtés (voir le module reconstruire hautes lumières pour plus d'informations sur la façon de traiter les pixels tronqués).

compression des hautes lumières

Compresser les hautes lumières de l'image afin de récupérer les détails.

contraste

Équivalent au curseur contraste dans le module balance couleur, il est utilisé pour augmenter la séparation des valeurs de luminance autour d'un pivot, rendant en fait la courbe de tonalité plus raide. Le curseur gris moyen_ fixe le pivot du contraste et tous les pixels dont la luminance correspond à ce point gris moyen ne seront pas affectés. Les pixels plus lumineux que le point gris moyen deviendront encore plus lumineux et les pixels plus sombres que le point gris moyen deviendront encore plus sombres.

préserver les couleurs

Si une courbe de tonalité non linéaire est appliquée à chacun des canaux RVB individuellement, alors la quantité de réglage de ton appliqué à chaque canal de couleur peut être différente, ce qui peut provoquer des décalages de teinte. Par conséquent, le menu préserver les couleurs fournit différentes méthodes de calcul du "niveau de luminance" d'un pixel. Le réglage de la tonalité est calculé en fonction de cette valeur de luminance, puis ce même réglage est appliqué aux trois canaux RVB. Différents estimateurs de luminance peuvent affecter le contraste dans différentes parties de l'image, en fonction des caractéristiques spécifiques de cette image. L'utilisateur peut donc choisir un estimateur particulier qui fournit les meilleurs résultats pour l'image donnée.

gris moyen

Fixer le pivot du curseur contraste. Ceci est équivalent au curseur pivot du contraste du module balance couleur. Si le curseur contraste est fixé à 0 il n'aura aucun effet.

luminosité

Équivaut à augmenter le curseur facteur gamma dans le module balance couleur. Déplacer le curseur vers la droite augmentera la luminosité de l'image, en mettant l'accent sur les tons moyens.

saturation

Équivalent du curseur saturation de sortie du module balance couleur, ce curseur affecte la saturation, ou la brillance et l'intensité des couleurs. Déplacer le curseur vers la droite augmentera la quantité de couleur dans l'image ; déplacer le curseur vers la gauche réduira la quantité de couleur dans l'image.

vibrance

Accentuer les couleurs de l'image sans ajouter de couleurs artificielles, comme c'est souvent le cas avec le curseur saturation. Cela fonctionne en réduisant la clarté des pixels déjà saturés pour rendre les couleurs plus vives. Vous pouvez également obtenir des effets intéressants en le combinant avec le curseur de saturation pour cibler des zones plus ou moins saturées de l'image.

auto

Ajuster automatiquement l'exposition, en tenant compte de l'image entière, ou utiliser la pipette de couleur pour sélectionner une zone rectangulaire de l'image -- l'exposition sera automatiquement ajustée en fonction de la région sélectionnée. Cela vous permet de prioriser les parties de l'image qui doivent être bien exposées.

tronquer

Cela affecte le nombre de pixels qui seront écrêtés en noir ou blanc pendant le calcul de l'exposition automatique. Déplacer ce curseur vers la droite permettra de tronquer davantage de pixels et d'augmenter le contraste ; déplacer ce curseur vers la gauche compressera davantage l'image et diminuera le contraste.

balance couleur

Un outil polyvalent pour ajuster la balance des couleurs de l'image.

Ce module peut être utilisé pour inverser les dominantes de couleurs parasites ou pour améliorer l'atmosphère visuelle d'une image à l'aide de l'étalonnage des couleurs, une technique populaire dans l'industrie du cinéma. Pour le flux de travail relatif à la scène, vous devriez plutôt envisager d'utiliser le module amélioré balance couleur rvb.

présentation

Le module balance couleur vous permet de décaler les couleurs de manière sélective par plage de luminance (ombres, tons moyens et hautes lumières). Il le fait en utilisant deux méthodes différentes :

lift, gamma, gain

La méthode classique. Elle permet de contrôler plus indépendamment les ombres et les hautes lumières.

slope, offset, power

Le nouveau standard défini par l'American Society of Cinematographers Color Decision List (ASC CDL) et plus adapté au développement relatif à la scène.

Les paramètres maître affectent l'image entière. Ils ne sont pas disponibles en mode lift, gamma, gain (sRGB). Les plages de curseur sont limitées aux valeurs habituelles ([50% ; 150%] pour la saturation, [-50% ; 50%] pour le contraste), mais des valeurs supérieures et inférieures peuvent être définies via une entrée au clavier après un clic droit sur le curseur correspondant.

Pour une meilleure efficacité, en mode slope, offset, power, il est recommandé de régler d'abord slope, puis offset et enfin power, dans cet ordre. Le nom du mode peut être utilisé comme mnémonique pour se souvenir de l'ordre.

Le paramètre ombre a un effet beaucoup plus lourd en mode slope, offset, power qu'en mode lift, gamma, gain. Lors du passage du premier au second, vous devez adapter la saturation dans les ombres, en divisant environ par 10.

Remarque : Bien que ce module agisse sur les couleurs RVB, il reçoit en entrée des couleurs exprimées dans l'espace colorimétrique Lab. En conséquence, le module convertit les couleurs reçues de Lab en RVB, ajuste dans l'espace colorimétrique RVB les couleurs converties , puis reconvertit les couleurs résultantes dans l'espace Lab.

préréglages

Plusieurs préréglages sont fournis dans ce module pour vous aider à comprendre comment il peut être utilisé au mieux. Le préréglage « virage partiel bleu-sarcelle/orange » est un look très populaire au cinéma et est un bon modèle de vitrine. Il est destiné à être utilisé avec deux instances combinées avec des masques. La première instance exclura les tons chair et décalera les couleurs neutres vers le bleu-sarcelle. Le second rétablira partiellement le premier et ajoutera plus de vibrance aux tons de peau uniquement. Ensemble, ils créeront une séparation entre le sujet et l'arrière-plan. Les paramètres de masquage et de fusion devront être modifiés pour s'adapter à chaque image.

D'autres préréglages fournissent des émulations de films Kodak. De cette façon, vous pouvez recréer n'importe quel aspect de film que vous aimez en utilisant le module balance couleur.

contrôles du module

mode

lift, gamma, gain (sRGB) est le mode originel de darktable 2.4 et des versions antérieures. Dans ce mode, les transformations de couleur sont appliquées dans l'espace colorimétrique sRVB encodé avec le gamma sRVB (gamma moyen de 2,2).

lift, gamma, gain (ProPhoto RVB) est identique au mode précédent, mais travaille dans l'espace ProPhoto RVB, codé linéairement. Dans ce mode, les paramètres RVB sont corrigés en interne en luminance XYZ (canal Y) afin qu'ils n'affectent que la couleur, et seuls les « facteurs » ajustent la luminance.

slope, offset, power (ProPhotoRVB) applique le standard ASC CDL dans l'espace ProPhotoRVB, encodé linéairement. De la même manière que pour le mode précédent, les paramètres RVB sont corrigés, en interne, en luminance XYZ. Dans ce mode, le réglage slope (pente) agit comme compensation d'exposition, offset (décalage) agit comme une correction du niveau de noir et power (puissance) agit comme une correction gamma. Tous les paramètres auront un impact sur toute la plage de luminance, mais la pente (slope) affectera principalement les hautes lumières, le décalage (offset) affectera principalement les ombres et la puissance (power) affectera principalement les tons moyens.

curseurs de contrôle des couleurs

Cette sélection dans la zone de liste déroulante affecte l'interface utilisateur utilisée pour les contrôles d'ombres, des tons moyens et des hautes lumières.

Les contrôles RVBL permettent un accès direct aux paramètres RVB qui seront envoyés à l'algorithme et qui, selon le mode utilisé, seront ajustés en interne à la luminance XYZ. Ce sont les seuls stockés dans l'historique de développement de darktable.

Les contrôles TSL sont plus intuitifs, mais ne sont qu'une interface : les teintes et les saturations sont calculées dynamiquement à partir et vers les paramètres RVB et ne sont jamais stockées. Lors de la conversion TSL vers RVB, la clarté TSL est toujours supposée être de 50%, de sorte que les paramètres RVB soient toujours équilibrés pour éviter les changements de clarté. Cependant, lors de la conversion RVB vers TSL, la clarté TSL n'est pas corrigée.

En conséquence, une édition en RVB, puis en TSL, puis de nouveau en RVB ne conservera pas les paramètres RVB d'origine, mais les normalisera de sorte que leur clarté TSL soit de 50%. La différence est à peine perceptible dans la plupart des cas, notamment en utilisant les modes qui corrigent déjà les paramètres RVB en interne dans la luminance XYZ.

Dans les deux modes, des curseurs « facteur » supplémentaires agissent sur tous les canaux RVB à la fois. Leur effet est similaire aux contrôles du module niveaux et n'affecte que la luminance.

saturation en entrée

Une correction de saturation appliquée avant la balance couleur. Elle peut être utilisé pour atténuer les couleurs avant de régler la balance, afin de faciliter le traitement des images difficiles. Lorsque vous dé-saturez entièrement l’image, une image monochrome basée sur la luminance est créée. Elle peut servir comme masque de luminance, afin de créer des filtres de couleur, tels que le virage partiel ou le sépia (lorsque utilisée avec les modes de fusion), en utilisant les réglages du module balance couleur.

saturation en sortie

Une correction de saturation appliquée juste après la balance couleur. C'est utile une fois que vous avez trouvé une balance de teinte appropriée mais que vous trouvez l'effet trop lourd. Vous pouvez donc régler la saturation globale en une fois au lieu de modifier la saturation de chaque canal séparément au risque de gâcher les couleurs.

contraste/pivot du contraste

Le curseur de contraste permet d’augmenter la séparation de luminance. La valeur du pivot définit la valeur de luminance qui ne sera pas affectée par la correction du contraste, de sorte que le contraste sera modifié autour du pivot. Les valeurs de luminance au-dessus du pivot seront amplifiées presque linéairement. Les valeurs de luminance au dessous du pivot seront compressées avec une fonction de puissance (créant une butée). Cette correction intervient après la saturation en sortie et est appliquée séparément sur tous les canaux RVB. Par conséquent, les teintes et les saturations risquent de ne pas être préservées en cas de réglages critiques (les ombres peuvent être re-saturées, les hautes lumières peuvent être dé-saturées et un décalage de couleur est à prévoir).

ombres, tons moyens, hautes lumières

En fonction du mode sélectionné, les paramètres des ombres contrôlent soit le lift (élévation), soit l'offset (décalage) ; ceux des demi-tons contrôlent soit le gamma soit le power (fonction puissance), et ceux des hautes lumières contrôlent soit le gain ou soit le slope (pente). Les paramètres sont transférés tels quels lorsque vous changez de mode.

En mode RVBL, la plage des curseurs RVB est limitée à [-0,5 ; 0,5]. En mode TSL, la plage des curseurs de saturation est limitée à [0% ; 25%]. Les valeurs situées en dehors de ces limites peuvent être définies par le biais d'une saisie au clavier suite à un clic droit sur le curseur.

Remarque : Les curseurs des ombres, des tons moyens et des hautes lumières peuvent prendre beaucoup de place dans le module balance couleur. La disposition générale de ces curseurs peut donc être parcourue à travers trois dispositions différentes en cliquant sur l'un des en-tête ombres, tons moyens, hautes lumières. Vous pouvez également définir la disposition par défaut via préférences > chambre noire > disposition des contrôles du module balance des couleurs.

optimiser luma

La pipette de couleur à côté de l'étiquette d'optimisation de la luminance sélectionnera l'image entière et optimisera les facteurs d'ombres, de tons moyens et de hautes lumières de sorte que, à la sortie de ce module, la luminance moyenne de l'image soit de 50% Lab, le maximum de 100% et le minimum est 0 %. Il s'agit essentiellement d'une normalisation d'histogramme, similaire à celle effectuée par le module niveaux. L'optimiseur n'est vraiment précis que lorsqu'il est utilisé en mode slope, offset, power.

Si vous souhaitez plus de contrôle, vous pouvez définir trois patches de contrôle à l'aide des pipettes situées à droite de chaque curseur facteur, pour échantillonner la luminance dans les zones sélectionnées. La pipette des ombres échantillonne la luminance minimale, celle des demi-tons échantillonne la luminance moyenne et celle des hautes lumières, la luminance maximale. Le paramètre le plus sensible est le facteur des tons moyens, car la sélection d'une zone légèrement différente peut entraîner des modifications radicales des paramètres. Utilisez uniquement les pipettes des facteurs, sans déclencher l'optimisation luma, permettra d'effectuer des réglages sans optimisation générale, mais chaque paramètre est toujours calculé en tenant compte des deux autres. Une fois les patches sélectionnés, l’étiquette devient «optimiser luma à partir des patches». Pour réinitialiser un patch, vous pouvez simplement refaire la sélection. Les patches ne sont pas enregistrés dans les paramètres et ne sont conservés que pendant la session en cours.

Il est important de noter que l’ajustement de luminance effectué ne cible que la sortie du module balance couleur et ne tient pas compte des autres ajustements de luminance effectués dans les modules arrivant plus tard dans le pipeline graphique (filmique rvb, courbe des tonalités, zones de couleurs, niveaux). L'utilisation du module balance couleur pour redéfinir globalement la luminance de l'image n'est pas recommandée, car elle ne conserve pas les couleurs d'origine. Des modules tels que courbes des tonalités ou filmique rvb conviennent mieux pour cela. Les ajustements de luminance dans le module balance couleur conviennent mieux à la correction locale, en combinaison avec des ajustements de couleurs à l'aide de masques.

neutraliser les couleurs

Dans une image où certaines zones sont exposées à la lumière directe du soleil et certaines zones à la lumière réfléchie (ombres) ou lorsque plusieurs sources de lumière artificielle sont présentes simultanément, les ombres et les hautes lumières ont souvent des températures de couleur différentes. Ces images sont particulièrement difficiles à corriger car aucune balance des blancs générale ne correspond à toutes les couleurs à la fois. L’optimiseur de neutralisation des couleurs vise à vous aider à trouver la couleur complémentaire pour les ombres, les tons moyens et les hautes lumières, de sorte que toutes les dominantes de couleurs soient inversées et que la couleur moyenne de la photo soit un gris neutre.

Comme pour optimiser luma, la pipette de couleur située près de l'étiquette neutraliser les couleurs déclenchera une optimisation générale sur l'ensemble de l'image. Cela fonctionne assez bien pour la photographie de paysage ou pour toute photographie avec un spectre complet de couleurs et de luminances.

Pour la photographie de nuit et d'événements, cela échouera probablement et vous devrez saisir manuellement les zones d'échantillonnage avec les pipettes de couleur devant chaque curseur de teinte. Pour l’échantillonnage des hautes lumières, utilisez une couleur exposée à des points lumineux qui devraient être blanc neutre ou gris clair. Pour l'échantillonnage des ombres, utilisez une couleur exposée à la lumière ambiante qui devrait être noir neutre ou gris foncé. Pour l’échantillonnage des tons moyens, utilisez une couleur exposée à la fois à des lumières ambiantes et des points lumineux.

Le succès de l'optimisation dépend de la qualité des échantillons. Tous les échantillons ne vont pas tous converger vers une bonne solution. Vous devez vous assurer que les pastilles de couleur que vous choisissez sont des couleurs vraiment neutres dans la vie réelle. Dans de nombreux cas, l’optimiseur émettra la teinte correcte mais une saturation excessive qui nécessitera quelques ajustements supplémentaires. Dans certains cas, aucune optimisation valide ne sera délivrée et vous devrez réinitialiser les paramètres de saturation et recommencer, ou tout simplement arrêter après la sélection des zones. Notez que, dans l'optimisation automatique, la saturation maximale est de 25%, ce qui peut ne pas être suffisant dans très peu de cas, mais permet d'éviter les résultats incohérents dans la plupart des cas.

Si vous sélectionnez des pastilles de couleurs, depuis les pipettes de couleur, sans déclencher l'optimisation, le logiciel effectuera un cycle d'optimisation et s'arrêtera, ce qui vous permettra de contrôler chaque plage de luminance séparément et d'éviter une divergence de solution dans les cas difficiles. Les corrections des teintes et des saturations sont calculées en tenant compte des deux autres plages de luminance et des trois facteurs, et généreront toujours la couleur complémentaire de la zone sélectionnée. Si vous souhaitez plutôt renforcer la couleur de la zone, vous pouvez ajouter 180° à la teinte calculée. Une fois les patches sélectionnés, l’étiquette devient «neutraliser les couleurs à partir des patches». Pour réinitialiser un patch, vous pouvez simplement refaire la sélection. Les patches ne sont pas enregistrés dans les paramètres et ne sont conservés que pendant la session en cours. Les paramètres trouvés par la neutralisation automatique ne sont précis que dans le mode slope, offset, power, mais peuvent également fonctionner dans une certaine mesure dans lift, gamma, gain.

balance couleur rvb

Un module avancé qui apporte les outils de gradation des couleurs de la cinématographie dans le pipeline graphique relatif à la scène.

Ce module ne convient pas aux débutants qui n'ont aucune connaissance préalable de la théorie des couleurs. Ils devraient s'en tenir aux paramètres chroma globale et vibrance globale jusqu'à ce qu'ils aient une bonne compréhension des dimensions de la couleur.

introduction

La gradation de couleurs est une partie importante de l'édition d'images. Elle peut aider à éliminer les dominantes indésirables et peut également apporter une touche de couleur créative qui ajoutera une atmosphère à vos images. À l'époque de la photographie argentique, la majeure partie de l'ambiance des couleurs était due au film et aux produits chimiques de développement, avec un étalonnage basique effectué sous l'agrandisseur avec des têtes couleur. Cela consommait des ressources coûteuses et était principalement réservé à l'industrie du cinéma, où le travail était effectué par un coloriste.

À l'ère numérique, où les images RAW ont une apparence plate et uniforme, la gradation des couleurs assure le même rôle que les émulsions de film, en réintroduisant des changements de couleur à des fins esthétiques. Elle peut également servir à harmoniser les couleurs d'une série d'images (qui peuvent avoir été prises dans des conditions différentes) pour obtenir un aspect global cohérent. Pour cette tâche, le vectorscope est également extrêmement utile.

Les coloristes divisent généralement la gradation des couleurs en deux étapes distinctes :

Une gradation primaire des couleurs qui vise à corriger les dominantes de couleurs indésirables et à créer un point de départ neutre,

Une gradation secondaire des couleurs qui donne à l'image son aspect et son atmosphère finaux.

Il est préférable de laisser la gradation primaire des couleurs au module calibration des couleurs, qui fonctionne dans un cadre physique mieux adapté à la correction de l'illuminant. La balance couleur rvb, quant à elle, concerne principalement la gradation secondaire des couleurs. Effectuer une gradation primaire des couleurs vraiment neutre devrait faciliter le transfert de la gradation secondaire des couleurs entre les images (via les styles, les préréglages ou le copier-coller) avec un effet similaire.

principes généraux

Le module balance couleur rvb est une amélioration par rapport à American Society of Cinematographers Color Decision List (ASC CDL), et utilise des masques alpha pour appliquer séparément l'effet sur les ombres et les hautes lumières. Le CDL classique agit sur toute la plage de luminance, et chacun de ses paramètres se voit attribuer plus de poids sur certaines parties de l'image uniquement en tant qu'effet secondaire des mathématiques.

Ce module fonctionne pour l'essentiel (4 voies, chroma, vibrance, contraste), dans un espace colorimétrique RVB linéaire conçu spécifiquement pour la gradation des couleurs. Cet espace colorimétrique présente un espacement uniforme des teintes perceptives tout en conservant une luminance à l'échelle physique¹. La partie perceptuelle du module (saturation et brillance) fonctionne dans l'espace colorimétrique JzAzBz², qui fournit une mise à l'échelle perceptuelle de la clarté et de la chromaticité compatible avec les images HDR. Les deux espaces colorimétriques garantissent que les changements de saturation et de chroma ont lieu à teinte constante, ce qui n'est pas le cas pour la plupart des autres opérateurs de saturation dans darktable (notamment dans l'ancien module balance couleur).

Le module balance de couleurs RGB attend une entrée relative à la scène linéaire et produit une sortie RVB relative à la scène, qui peut être linéaire ou non, selon les paramètres du module (contraste et puissance délinéariseront la sortie).

À sa sortie, balance des couleurs RGB vérifie que les couleurs transformées rentrent dans l'espace colorimétrique RVB du pipeline (Rec 2020 par défaut) et applique un écrêtage de saturation progressif à teinte constante, visant à recentrer la couleur hors gamut vers la couleur dans le gamut la plus proche, en mettant à l'échelle à la fois la chroma et la clarté. Cela empêche les paramètres de chroma et de saturation de pousser les couleurs en dehors de la plage valide et permet d'utiliser des réglages plus drastiques en toute sécurité.

Notez que ce module respecte les définitions CIE de chroma et de saturation, comme expliqué dans la section dimensions de la couleur.

contrôles du module

onglet maitre

changement de teinte

Fait tourner toutes les couleurs de l'image d'un angle sur le plan de chromaticité, à luminance et chroma constantes. Vous pouvez utiliser ce contrôle pour supprimer les fuites de lumière colorée sur un sujet ou pour changer rapidement la couleur d'un objet. Ce paramètre est généralement mieux appliqué localement, en utilisant les masques.

vibrance globale

Cela affecte la dimension chroma de la couleur sur l'ensemble de l'image, en donnant la priorité aux couleurs à faible chroma. Cela permet d'augmenter la chroma des couleurs neutres sans exagérer les pixels déjà colorés.

contraste

Ce réglage est appliqué sur le canal de luminance à teinte et à chroma constantes. Le paramètre pivot du gris du contraste (dans seuil de l'onglet masques), vous permet de définir le point neutre de la courbe de contraste :

au point pivot, la courbe de contraste laisse la luminance inchangée,

en dessous du point pivot, la courbe de contraste diminue la luminance pour les valeurs de contraste positives, ou l'augmente pour les valeurs négatives,

au dessus du point pivot, la courbe de contraste augmente la luminance pour les valeurs de contraste positives, ou la diminue pour les valeurs négatives.

Le pivot a une valeur de 18,45 % par défaut, ce qui est cohérent avec le flux de travail actuel relatif à la scène et devrait s'adapter à la plupart des cas d'utilisation (en supposant que la luminosité globale ait été corrigée comme recommandé à l'aide du module exposition.

L'algorithme de contraste donne des résultats naturels qui imitent la partie centrale de la courbe de contraste d'un film analogique. Cependant, cela augmentera également la plage dynamique de l'image, ce qui peut invalider les paramètres filmique dans le pipeline. Pour les réglages de contraste globaux, vous devriez normalement utiliser le module égaliseur de ton -- le curseur de contraste dans balance des couleurs RGB est mieux utilisé avec les masques, par ex. pour des corrections sélectives sur le premier plan ou l'arrière-plan.

gradation de chroma linéaire

Le réglage de chroma linéaire affecte la dimension chroma proportionnellement à sa valeur d'entrée, à teinte et luminance constantes. Il le fait globalement, avec un coefficient constant (en utilisant la chroma globale), et sur chacun des masques ombres, tons moyens et hautes lumières (définis dans l'onglet masques sous étendues de luminance).

gradation de saturation perceptuelle

Le réglage de saturation perceptuelle affecte à la fois la luminance et la chroma, dans un espace perceptuel, proportionnellement à sa valeur d'entrée, à teinte constante. Il le fait globalement avec saturation globale, et sur chacun des masques ombres, tons moyens et hautes lumières (définis dans l'onglet masques sous étendues de luminance).

gradation de la brillance perceptuelle

Le réglage de la brillance perceptuelle affecte à la fois les dimensions de luminance et de chroma, dans un espace perceptuel, proportionnellement à sa valeur d'entrée, à teinte constante, et dans une direction orthogonale à la saturation. Son effet est proche de celui d'une modification de l'exposition, mais à l'échelle perceptuelle. Il le fait globalement avec saturation globale, et sur chacun des masques ombres, tons moyens et reflets (définis dans l'onglet masques sous étendues de luminance).

onglet 4 voies

Chacun des paramètres de l'onglet 4 voies est composé des trois mêmes composants, qui définissent une couleur à l'aide de coordonnées indépendantes :

luminance,

teinte,

chroma.

Une entrée de couleur comme celle-ci définit un virage de couleur appliqué à l'image globalement ou sur la plage de luminance définie.

Chaque curseur de teinte a une pipette de couleur, qui peut être utilisé pour calculer la couleur opposée de la région sélectionnée. Ceci est utile pour réduire les dominantes de couleur indésirables (par exemple, la rougeur de la peau), car le fait de déplacer la couleur vers son opposée la neutralise.

décalage global

Cela équivaut au décalage ASC CDL et revient à ajouter une valeur RVB constante à tous les pixels, tout comme la correction du niveau de noir dans le module exposition. Ce contrôle n'utilise pas de masquage.

lift des ombres

Ceci est conceptuellement équivalent au lift de lift/gamma/gain, bien qu'implémenté différemment, et revient à multiplier les pixels masqués par une valeur RVB constante. Il est appliqué à l'aide du masque ombres.

gain hautes lumières

Cela équivaut à la pente ASC CDL et revient à multiplier les pixels masqués par une valeur RVB constante. Il est appliqué à l'aide du masque hautes lumières.

puissance globale

Cela équivaut à la puissance ASC CDL et revient à appliquer un exposant constant en RVB. Il n'est pas masqué et doit être normalisé, car la fonction puissance a un comportement différent au-dessus et en dessous de 1, et nous sommes dans un pipeline illimité où le blanc est généralement supérieur à 1. Le paramètre de normalisation pivot du blanc est disponible dans seuil de l'onglet masques.

onglet masques

Cet onglet définit des contrôles auxiliaires pour les onglets précédents. Les contrôles de masquage ne nécessitent généralement aucune modification de l'utilisateur, car les valeurs par défaut sont calibrées pour répondre à la plupart des besoins et répondent aux attentes normales du pipeline de pixels relatif à la scène. Vous ne devriez avoir besoin de modifier ces paramètres que dans des scénarios spécifiques.

étendues de luminance

Les graphiques montrent l'opacité (sur l'axe y) des 3 masques de luminance par rapport à la luminance du pixel (sur l'axe x). La courbe la plus sombre représente le masque ombres, la plus claire représente le masque hautes lumières et la troisième courbe représente le masque tons moyens.

Seuls les masques ombres et hautes lumières peuvent être contrôlés directement -- le masque tons moyens est calculé à partir des deux autres et agit comme une variable d'ajustement.

transition des ombres

Contrôle la douceur ou la dureté de la transition de totalement opaque (100%) à totalement transparent (0%) pour le masque d'ombres.

pivot du gris moyen du masque

Définit la valeur de luminance où les trois masques ont une opacité de 50 %. En pratique, cela est utilisé pour définir comment l'image est séparée en ombres et en hautes lumières.

transition des hautes lumières

Contrôle la douceur ou la dureté de la transition d'entièrement opaque (100%) à entièrement transparent (0%) pour le masque de hautes lumières.

Pour chacun de ces paramètres, un bouton de masque, à droite du curseur, affiche le masque correspondant (ombres, demi-tons, hautes lumières), superposé en damier. La zone encore visible de l'image (non masquée par le masque) est la zone qui sera affectée par les curseurs ombres, tons moyens et hautes lumières des autres onglets.

Tous les aperçus de masque affichent la sortie du module, y compris les modifications de couleur apportées, vous pouvez donc également les activer lors de l'édition, pour ne voir que la partie affectée de l'image.

Les masques de luminance sont calculés à l'entrée du module, ce qui signifie qu'ils sont insensibles aux changements de luminance effectués par le module.

seuils

pivot du point blanc

Règle la luminance du point blanc en IL. Ceci est utilisé pour normaliser le paramètre puissance dans l'onglet 4 voies. Les implémentations relatives à la scène des fonctions de puissance supposent que le blanc est à 100 %, ce qui élimine le besoin de normalisation. Dans un contexte relatif à la scène, cela doit être pris en compte.

La pipette de couleur à droite du curseur règle automatiquement le pivot du blanc sur la luminance maximale de la région sélectionnée, ce qui devrait être suffisant dans la plupart des cas.

pivot du gris du contraste

Définit le pivot pour le paramètre contraste dans l'onglet maître. Cela correspond à la valeur de luminance qui sera laissée inchangée par le réglage du contraste. Ce paramètre correspond généralement à la valeur linéaire du gris moyen. Si vous avez suivi les recommandations de flux de travail relatif à la scène et défini la luminosité globale au début du pipeline, à l'aide du module exposition, la valeur correcte doit généralement être d'environ 18 à 20 %.

La pipette de couleur à droite du curseur règle automatiquement le pivot du gris du contraste sur la luminance moyenne de la région sélectionnée. Cela repose sur l'hypothèse que la luminance moyenne est généralement proche du gris moyen, ce qui n'est pas vrai si vous avez des reflets spéculaires ou des sources lumineuses primaires dans le cadre, ou pour des images low/high-key.

paramètres de prévisualisation du masque

Ces paramètres s'appliquent aux aperçus de masque, affichés en cliquant sur les boutons de masque dans la section étendues de luminance. Ces paramètres sont enregistrés globalement et seront donc appliqués à toutes les images suivantes, à moins qu'ils ne soient modifiés.

couleur 1 et 2 du damier

Définit les deux couleurs de la sous-couche du masque du damier d'arrière-plan. Vous pouvez les définir sur des couleurs opposées de l'image actuelle pour faciliter la lisibilité.

taille du damier

Définit la largeur des cellules du damier en pixels (ajustée en fonction du paramètre DPI de l'écran).

FAQ

saturation ou chroma ?

Comme décrit dans la section dimensions de la couleur, la saturation et la chroma parcourent le plan (clarté, chroma) dans différentes directions. De plus, la chroma de la balance des couleurs RVB utilise un espace linéaire relatif à la scène, tandis que la saturation utilise un espace perceptuel, qui redimensionne la couleur pour un espacement uniforme.

En pratique, vous devez utiliser le réglage de chroma si vous souhaitez conserver la linéarité de la scène de l'émission lumineuse et/ou conserver la luminance inchangée. Cependant, ces changements peuvent affecter certaines teintes plus fortement que d'autres, en raison du fait que l'espace colorimétrique n'est pas entièrement mis à l'échelle perceptuellement.

La saturation est plus proche de l'effet du mélange de peinture blanche avec une couleur de base. La réduction de la saturation du rouge le dégradera en rose, tandis que la réduction de sa chroma se dégradera en une nuance de gris à la même luminance. La saturation est peut-être un moyen plus intuitif d'interagir avec la couleur, en raison de son lien avec la peinture.

Choisir l'un ou l'autre est principalement une question de décider où sur le graphique (clarté, chroma) vous voulez pousser vos couleurs, et où elles doivent commencer. Pour atteindre des couleurs pastel, la saturation est la voie à suivre. Pour atteindre des couleurs laser (presque monochromatiques), au risque de paraître synthétiques, la chroma est la voie à suivre.

quel est le lien avec lift/gamma/gain ?

L'algorithme lift/gamma/gain repose sur un espace colorimétrique relatif à l'affichage, car il suppose une plage dynamique limitée et symétrique, avec un point blanc à 100 % et un gris à 50 %. En tant que tel, il est tout simplement inutilisable dans un espace relatif à la scène. Cependant, la seule partie incompatible est le lift. Le gamma est exactement la puissance ASC CDL, et le gain est exactement la pente ASC CDL.

Le module balance des couleurs RGB a simplement deux pentes au lieu d'une : le gain, appliqué sur les hautes lumières extraites de l'ensemble de l'image par un masque, et le lift, appliqué de manière similaire mais sur les ombres.

modification du contraste

Alors que la balance des couleurs RVB concerne principalement la couleur (d'autres modules gèrent le contraste global de manière à préserver la chromaticité), la luminance fait autant partie de la couleur que la teinte ou la chroma, et elle doit être traitée ici aussi, car la perception de la saturation repose dessus. Si vous souhaitez passer du rouge au rose, par exemple, réduire sa chroma le rendra gris, vous devez donc également augmenter sa luminance.

Il existe plusieurs manières de modifier le contraste dans balance des couleurs RVB, soit localement (avec masques) soit globalement (sans) :

dans l'onglet maître, utilisez le paramètre contraste (et éventuellement pivot du gris du contraste dans l'onglet masques). Sachez que cela augmentera le point blanc et augmentera donc la plage dynamique de l'image, ce qui peut invalider les paramètres filmiques plus tard dans le pipeline.

dans gradation de saturation perceptuelle, désaturer les hautes lumières et resaturer les ombres pour augmenter le contraste de luminance,

dans gradation de brillance perceptuelle, ajoutez de la brillance dans les hautes lumières et supprimez la brillance dans les ombres pour augmenter le contraste de luminance,

dans l'onglet 4 voies, réglez la luminance de lift des ombres sur des valeurs négatives et la luminance gain des hautes lumières sur des valeurs positives, ce qui produit également une augmentation du contraste de luminance.

La différence entre ces méthodes réside dans la façon dont l'effet sera pondéré par rapport à l'entrée du module. Il est conseillé d'effectuer la majorité des réglages de contraste de luminance dans les modules filmique et égaliseur de ton, puis d'effectuer les modifications finales de balance des couleurs RVB tout en examinant les couleurs.

traitement interne

Voici l'ordre interne des opérations au sein du module :

Transforme depuis l'espace RGB du pipeline vers l'espace Ych de Kirk/Filmlight,

Applique un décalage de teinte à chroma constante et luminance constante,

Calcule les masques de luminance avec Y,

Appliquer les paramètres chroma linéaire et vibrance à teinte et luminance constantes,

Convertit vers l'espace RVB de Kirk/Filmlight,

Applique les paramètres 4 voies (sauf la puissance de luminance),

Revient dans l'espace Yrg de Kirk/Filmlight,

Applique la puissance de luminance et le contraste,

Convertit dans l'espace JzAzBz,

Applique les paramètres saturation perceptuelle et brillance perceptuelle,

Écrête progressivement la chroma en utilisant le gamut RVB du pipeline, à teinte et clarté constantes,

Retourne à l'espace RGB du pipeline.

mises en garde

Le réglage de la chroma globale à -100 % ne produira pas une véritable image monochrome, comme c'est le cas avec d'autres algorithmes. La raison en est que l'espace RVB utilisé a un point blanc D65 défini dans l'espace CIE LMS 2006, tandis que darktable utilise un point blanc défini dans l'espace CIE XYZ 1931, et il n'y a pas de conversion exacte entre ces espaces. Le résultat sera donc une image en noir et blanc légèrement teintée. Si votre intention est d'obtenir une vraie image en noir et blanc en utilisant le canal de luminance, le module calibration des couleurs propose un préréglage N&B : basé sur la luminance qui fait exactement la même chose mais sans la différence de point blanc.

Ce module a un mappage de gamut (dans l'espace RGB du pipeline) constamment activé. Cela signifie que si votre image d'origine contient des couleurs largement hors gamme pour commencer, le simple fait d'activer balance des couleurs RVB sans paramètre particulier modifiera légèrement ses couleurs. C'est probablement pour le mieux.

La saturation maximale autorisée dans l'espace RVB de travail du pipeline est enregistrée pour chaque teinte lors de l'initialisation du module, et est ensuite mise en cache dans une LUT (table de correspondance) pour économiser les performances. Si le profil de travail est modifié ultérieurement, balance des couleurs RGB n'est pas notifié, ce qui signifie qu'il ne mettra pas à jour sa LUT de teinte/saturation en cache. Pour forcer une mise à jour LUT, vous pouvez simplement modifier n'importe quel paramètre dans le module balance des couleurs RGB, puis le modifier à nouveau. Il n'est pas recommandé de modifier l'espace RVB de travail à mi-chemin d'une session d'édition, car cela pourrait entraîner des changements inattendus de chroma et de teinte.

Pour des raisons de performances, les conversions non linéaires depuis et vers l'espace RVB de travail sont ignorées, ce qui signifie que la colorimétrie interne sera erronée lors de l'utilisation d'espaces colorimétriques non linéaires. Notez qu'il n'y a aucune raison d'utiliser des espaces non linéaires comme espace RVB de travail car ils rendent le mélange alpha plus difficile sans aucun avantage.

Richard A. Kirk, Coordonnées de chromaticité pour les arts graphiques basées sur CIE 2006 LMS avec espacement régulier des couleurs Munsell, 2019. https://doi.org/10.2352/issn.2169-2629.2019.27.38 ↩︎

Safdar et al., Perceptually uniform color space for image signals including high dynamic range and wide gamut, 2017. https://doi.org/10.1364/OE.25.015131 ↩︎

balance des blancs

Ajuster la balance des blancs de l'image en modifiant la température et la teinte, en définissant un coefficient pour chaque canal RVB ou en choisissant dans la liste des paramètres de balance des blancs prédéfinis.

Les paramètres par défaut de ce module sont dérivés de la balance des blancs du boîtier stockée dans les données Exif de l'image.

La balance des blancs n'est pas conçue comme un module «créatif» -- son objectif principal est de corriger techniquement la balance des blancs de l'image en s'assurant que les objets de couleur neutre de la scène sont rendus avec des couleurs neutres dans l'image. Pour les opérations créatives concernant la couleur, il est généralement préférable d'utiliser d'autres modules tels que le module calibration des couleurs ou le module balance couleur rvb.

Remarque : Le module calibration des couleurs fournit désormais une méthode plus moderne et plus flexible de contrôle de la balance des blancs. Le module calibration des couleurs peut être activé par défaut pour les nouvelles images en sélectionnant "moderne" dans préférences > traitement > appliquer l'adaptation chromatique par défaut. Certains paramètres de base sont toujours requis (et appliqués automatiquement) dans le module balance des blancs, afin que le dématriçage fonctionne correctement.

contrôles du module

température de l'illuminant de la scène

Cette section fournit les contrôles température et teinte de l'illuminant de la scène pour ajuster la balance des blancs de l'image. Cliquez sur l'étiquette de la section 'température de l'illuminant de scène' pour choisir entre trois [modes de couleur] (#curseurs-colorés) différents pour les curseurs de température et de teinte.

température

Définir la température de couleur en kelvin.

teinte

Modifier la teinte de la couleur de l'image, du magenta (teinte <  1) au vert (teinte > 1).

préréglages de la balance des blancs

réglage

Choisir parmi une liste prédéterminée de balances des blancs. Les paramètres disponibles sont dérivées des préréglages existants dans le boîtier utilisé pour prendre la photo. Les options suivantes sont fournies en plus des préréglages de balance des blancs définis dans le boîtier.

boîtier (par défaut) : la balance des blancs utilisée par le boîtier

depuis une zone image : dessiner un rectangle sur une couleur neutre de l'image pour calculer la balance des blancs depuis cette zone.

manuel : réglage le plus récemment modifié. Le réglage manuel des coefficients de température, de teinte ou de canal r/v/b sélectionnera automatiquement cette option. Le choix de ce réglage après avoir sélectionné un autre préréglage ramènera les paramètres à l'état le plus récent modifié par l'utilisateur.

neutre boîtier : régler la température sur le point blanc de référence du boîtier, qui est supposé être D65 (ou ~ 6502K). Les multiplicateurs des canaux de la balance des blancs sont calculés de telle sorte que le blanc pur dans l'espace colorimétrique du boîtier soit converti en blanc pur dans sRGB D65 (où blanc pur signifie que chaque canal de couleur a la même valeur).

Pour plus de commodité, ces quatre modes peuvent également être définis en cliquant sur l'un des boutons de la barre de boutons au-dessus de la liste déroulante paramètres.

affiner

Ajuster un préréglage de la balance des blancs spécifique au boîtier. Ceci n'est affiché que s'il est disponible pour le boîtier en question. La direction du réglage dépend des préréglages fournis. Si votre boîtier n'a pas de préréglage de balance des blancs disponibles, consultez ce guide pour voir comment vous pouvez soumettre les vôtres.

coefficients des canaux

Les coefficients des canaux RVB sont automatiquement calculés à partir des paramètres ci-dessus et, en tant que tels, sont masqués par défaut. Vous pouvez développer/réduire la section des coefficients de canal en cliquant sur l'étiquette "coefficients de canal" ou sur le bouton triangulaire adjacent.

rouge/vert/bleu

Régler la valeur de chaque coefficient de canal RVB de 0 à 8

fonctionnalité supplémentaire

curseurs colorés

Par défaut, les curseurs du module sont monochromes. Cependant, deux types de curseurs colorés peuvent être activés dans préférences > chambre noire > contrôles colorés de la balance des blancs ou en cliquant sur l'étiquette de la section 'température de l'illuminant de scène' dans le module.

sans couleur (par défaut)

L'arrière-plan des curseurs n'est pas coloré.

couleur de l'illuminant

Les couleurs du curseur représentent la couleur de la source lumineuse (la couleur que vous ajustez pour obtenir un blanc neutre).

émulation de l'effet

Les couleurs du curseur représentent l'effet que l'ajustement aurait eu sur la scène. C'est ainsi que la plupart des autres processeurs raw affichent les couleurs des curseurs de température/teinte.

barre de boutons

La barre de boutons est un simple ajout pour permettre un accès en un clic aux paramètres de balance des blancs interne. Si vous le souhaitez, vous pouvez désactiver cela en éditant votre fichier darktablerc. Trouvez la ligne qui dit

plugins/darkroom/temperature/button_bar=TRUE

et changez-la de TRUE à FALSE :

avertissement d'utilisation

Les seuls paramètres qui sont utilisés en interne par les opérations de ce module sont les coefficients des canaux rvb. Les curseurs température et teinte sont fournis simplement comme des moyens plus conviviaux d'ajuster ces paramètres. La relation entre les coefficients des canaux et les curseurs de température/teinte dépend des caractéristiques spécifiques du boîtier utilisé pour prendre la photo. Cela signifie qu'appliquer les paramètres de la balance des blancs d'une image réalisée avec un boîtier, à une image réalisée avec un autre boîtier, ne donnera généralement pas des résultats cohérents.

La relation mathématique entre les deux ensembles de valeurs n'est pas simple. Il est possible de définir les coefficients des canaux de telle sorte qu'il n'y ait pas de réglage valide équivalent des réglages de température et de teinte (principalement lorsque des valeurs de température très élevées sont calculées à partir des valeurs du curseur). L'édition de la balance des blancs à l'aide de la température et de la teinte sur une image précédemment modifiée à l'aide des coefficients des canaux peut donc donner des résultats étranges, au moins lorsque des valeurs de température élevées sont impliquées.

cadre décoratif

Générer un cadre autour de l'image.

Le cadre se compose d'une bordure (d'une couleur définie par l'utilisateur) et d'une ligne de cadre à l'intérieur de cette bordure (d'une deuxième couleur définie par l'utilisateur). Différentes options sont disponibles pour contrôler la géométrie et la couleur du cadre.

contrôles du module

taille du cadre

La taille du cadre en pourcentage de l'image complète sous-jacente.

aspect

Le rapport hauteur/largeur de la sortie finale du module (c'est-à-dire de l'image sous-jacente plus le cadre)

orientation

L'orientation du cadre (portrait/paysage). Sélectionnez 'auto' pour que darktable choisisse l'orientation la plus raisonnable en fonction de l'image sous-jacente.

position horizontale/verticale

Faites votre choix parmi un ensemble de rapports prédéfinis définissant où vous voulez que votre image sous-jacente soit positionnée sur l'axe horizontal/vertical. Vous pouvez également cliquer avec le bouton droit de la souris et saisir votre propre ratio sous la forme "x/y".

taille du cadre interne

La taille en pourcentage de la ligne au milieu du cadre par rapport à la largeur totale du cadre dans sa plus petite partie.

décalage du cadre interne

La position de la ligne au milieu du cadre, par rapport à l'image sous-jacente. Choisissez 0% pour que la ligne touche l'image. Choisissez 100% pour que la ligne touche la bordure extérieure.

couleur de la bordure/couleur du cadre interne

Paire de sélecteurs de couleur qui permettent de définir les couleurs de la bordure et du cadre. Cliquer sur le champ coloré ouvrira une boîte de dialogue de sélection de couleur qui offre un choix des couleurs couramment utilisées, ou vous permet de définir une couleur dans l'espace colorimétrique RVB. Vous pouvez aussi activer une pipette de couleur pour sélectionner une couleur dans l'image.

montrer les guides

Cochez la case pour afficher les superpositions de guides chaque fois que le module est activé. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides et superpositions pour plus de détails.

calibration des couleurs

Un module complet de correction de l'espace de couleur, de réglage de la balance des blancs, ainsi qu'un mixeur de canaux.

Ce module simple mais puissant peut être utilisé des manières suivantes :

Pour régler la balance des blancs (adaptation chromatique), en travaillant en tandem avec le module balance des blancs. Ici, le module balance des blancs effectue quelques réglages initiaux (requis pour que le module dématriçage fonctionne efficacement), puis le module calibration des couleurs calcule ensuite une balance des blancs plus précise du point de vue perceptif une fois que le profil de couleur d'entrée a été appliqué.

En tant que simple mélangeur de canaux RVB, permet d'ajuster les canaux de sortie R, V et B en fonction des canaux d'entrée R, V et B pour effectuer une gradation des couleurs par diaphonie.

Pour régler la saturation et la luminosité des couleurs de l'image, en fonction de la valeur relative des canaux R, V et B de chaque pixel.

Pour produire des niveaux de gris basés sur les valeurs relatives des canaux R, V et B, d'une manière similaire à la réponse d'un film noir et blanc à un spectre lumineux.

Pour améliorer la précision des couleurs du profil de couleur d'entrée à l'aide d'une charte de couleurs.

balance des blancs dans l'onglet Transformation d'Adaptation Chromatique (CAT)

L'adaptation chromatique vise à prédire à quoi ressembleraient toutes les surfaces de la scène si elles avaient été éclairées par un autre illuminant. Ce que nous voulons en fait prédire, cependant, c'est à quoi ces surfaces auraient ressemblé si elles avaient été éclairées par le même illuminant que votre moniteur, afin que toutes les couleurs de la scène correspondent au changement d'illuminant. La balance des blancs, quant à elle, vise uniquement à garantir que les blancs et les gris sont vraiment neutres (R = V = B) et ne se soucie pas vraiment du reste de la gamme de couleurs. La balance des blancs n'est donc qu'une adaptation chromatique partielle.

L'adaptation chromatique est contrôlée dans l'onglet Transformation d'adaptation chromatique (CAT) du module calibration des couleurs. Lorsqu'il est utilisé de cette manière, le module balance des blancs est toujours requis car il doit effectuer une opération de balance des blancs de base (connectée aux valeurs de profil de couleur d'entrée). Cette balance des blancs technique (mode « neutre boîtier ») est un réglage constant qui donne un aspect achromatique aux gris éclairés par un illuminant D65 standard, et rend le processus de dématriçage plus précis, mais n'effectue aucune adaptation perceptuelle en fonction de la scène. L'adaptation chromatique proprement dite est alors effectuée par le module calibration des couleurs, en plus des corrections effectuées par les modules balance des blancs et profil de couleur d'entrée. L'utilisation de matrices personnalisées dans le module profil de couleur d'entrée est donc déconseillée. De plus, les coefficients RVB du module balance des blancs doivent être précis pour que ce module fonctionne de manière prévisible.

Les modules calibration des couleurs et balance des blancs peuvent être automatiquement appliqués pour effectuer une adaptation chromatique pour les nouveaux traitements en définissant l'option de flux de travail d'adaptation chromatique à « moderne » dans (préférences> traitement> appliquer l'adaptation chromatique par défaut). Si vous préférez effectuer tous les équilibrages des blancs dans le module balance des blancs, une option « originel » est également disponible. Aucune des deux options n'empêche l'utilisation d'autres modules tels que balance des couleurs RGB plus tard dans le pipeline graphique pour le gradation créative des couleurs.

Par défaut, le module calibration des couleurs effectue une adaptation chromatique en :

lisant les données Exif du fichier RAW pour récupérer la balance des blancs de la scène définie par le boîtier,

ajustant ce paramètre depuis le module balance des blancs à l'aide de la balance des blancs de référence du boîtier,

ajustant de plus ce paramètre avec le profil de couleur d'entrée utilisé (matrice standard uniquement).

Par souci de cohérence, les paramètres par défaut du module calibration des couleurs supposent toujours que la matrice standard est utilisée dans le module profil de couleur en entrée -- tous les paramètres non standard de ce module sont ignorés. Cependant, le module calibration des couleurs peut lire ses valeurs par défaut dans n'importe quel préréglage appliqué automatiquement dans le module balance des blancs.

Il est également intéressant de noter que, contrairement au module balance des blancs, le module calibration des couleurs peut être utilisé avec des masques. Cela signifie que vous pouvez corriger sélectivement différentes parties de l'image pour tenir compte des différentes sources de lumière.

Pour ce faire, créez une instance du module calibration des couleurs pour effectuer des ajustements globaux en utilisant un masque pour exclure les parties de l'image que vous souhaitez gérer différemment. Créez ensuite une seconde instance du module réutilisant le masque de la première instance (inversé) en utilisant un masque raster.

flux de travail de l'onglet CAT

L'illuminant et l'espace colorimétrique par défaut utilisés par l'adaptation chromatique sont initialisés à partir des métadonnées Exif du fichier RAW. Il y a quatre options disponibles dans l'onglet CAT pour définir ces paramètres manuellement :

Utilisez la pipette de couleur (à droite de la pastille de couleur) pour sélectionner une couleur neutre dans l'image ou, si aucune n'est disponible, sélectionnez l'image entière. Dans ce cas, l'algorithme trouve la couleur moyenne dans la zone choisie et définit cette couleur comme illuminant. Cette méthode repose sur l'hypothèse du « monde gris », qui prédit que la couleur moyenne d'une scène naturelle sera neutre. Cette méthode ne fonctionnera pas pour les scènes artificielles, par exemple celles avec des surfaces peintes.

Sélectionnez « (IA) détecter depuis les bords de l'image », qui utilise une technique d'apprentissage-machine pour détecter l'illuminant à l'aide de l'image entière. Cet algorithme trouve la couleur moyenne du dégradé sur les bords de l'image et définit cette couleur comme illuminant. Cette méthode repose sur l'hypothèse du "bord gris", qui peut échouer si de grandes aberrations chromatiques sont présentes. Comme toute méthode de détection des contours, elle est sensible au bruit et mal adaptée aux images à haute sensibilité ISO, mais elle est très bien adaptée aux scènes artificielles où aucune couleur neutre n'est disponible.

Sélectionnez « (IA) détecter depuis les surfaces de l'image », qui combine les deux méthodes précédentes, en utilisant également l'image entière. Cet algorithme trouve la couleur moyenne dans l'image, donnant plus de poids aux zones où des détails précis sont trouvés et où les couleurs sont fortement corrélées. Cela l'immunise mieux contre le bruit que la variante bords et l'immunise mieux contre les surfaces réellement non-neutres que la simple moyenne, mais les textures aux couleurs vives (comme l'herbe verte) sont susceptibles de le faire échouer.

Sélectionnez « tel que pris par le boîtier » pour restaurer les paramètres par défaut du boîtier et relire le RAW Exif.

La pastille de couleur montre la couleur de l'illuminant actuellement calculé projeté dans l'espace sRGB. Le but de l'algorithme d'adaptation chromatique est de transformer cette couleur en blanc pur, ce qui ne signifie pas forcément déplacer l'image vers sa couleur opposée perceptive. Si l'illuminant est correctement réglé, l'image aura la même teinte que celle indiquée dans la pastille de couleur lorsque le module est désactivé.

À gauche de la pastille de couleur se trouve l'approximation CCT (température de couleur corrélée). Il s'agit de la température la plus proche, en kelvin, de l'illuminant actuellement utilisé. Dans la plupart des logiciels de traitement d'image, il est courant de régler la balance des blancs en utilisant une combinaison de température et de teinte. Cependant, lorsque l'illuminant est éloigné de la lumière du jour, le CCT devient imprécis et non pertinent, et la CIE (Commission internationale de l'éclairage) décourage son utilisation dans de telles conditions. Le texte du CCT vous informe de la correspondance CCT la plus proche trouvée :

Lorsque le CCT est suivi de « (lumière du jour) », cela signifie que l'illuminant actuel est proche d'un spectre de lumière du jour idéal ± 0,5 %, et le chiffre du CCT est donc significatif. Dans ce cas, il est conseillé d'utiliser l'illuminant « D (lumière du jour) ».

Lorsque le CCT est suivi de « (corps noir) », cela signifie que l'illuminant actuel est proche d'un spectre idéal de corps noir (planckien) ± 0,5 %, et le chiffre du CCT est donc significatif. Dans ce cas, il est conseillé d'utiliser l'illuminant « Planckien (corps noir) ».

Lorsque le CCT est suivi de « (invalide) » , cela signifie que le chiffre CCT n'a pas de sens et est faux, car nous sommes trop loin d'un spectre de lumière du jour ou d'un spectre de la lumière du corps noir. Dans ce cas, il est conseillé d'utiliser l'illuminant personnalisé. L'adaptation chromatique fonctionnera toujours comme prévu (voir la remarque ci-dessous), de sorte que le mot clé « (invalide) » signifie uniquement que la couleur de l'illuminant actuel n'est pas précisément liée au CCT affiché. Ce mot clé n'a rien d'inquiétant -- il est simplement là pour vous dire de ne pas utiliser la lumière du jour et les illuminants planckiens car ils ne se comporteront pas comme vous pourriez vous y attendre.

Lorsqu'une des méthodes de détection d'illuminant ci-dessus est utilisée, le module vérifie où se trouve l'illuminant calculé en utilisant les deux spectres idéalisés (lumière du jour et corps noir) et choisit le modèle de spectre le plus précis à utiliser dans son paramètre illuminant. L'interface utilisateur changera en conséquence :

Un curseur de température sera fourni si l'illuminant détecté est proche d'un spectre D (lumière du jour) ou planckien (corps noir), pour lesquels le CCT est significatif.

Des curseurs de teinte et de chroma dans l'espace CIE 1976 Luv sont proposés pour l'illuminant personnalisé, ce qui permet une sélection directe de la couleur de l'illuminant dans un cadre perceptif sans aucune hypothèse intermédiaire.

Remarque : En interne, l'illuminant est représenté par ses coordonnées de chromaticité absolue dans l'espace colorimétrique CIE xyY. Les options de sélection de l'illuminant dans le module ne sont que des interfaces pour configurer cette chromaticité à partir de relations du monde réel et sont destinées à accélérer ce processus. Peu importe pour l'algorithme si le CCT est étiqueté « invalide » -- cela signifie simplement que la relation entre le CCT et les coordonnées xyY correspondantes n'est pas physiquement exacte. Quoi qu'il en soit, la couleur définie pour l'illuminant, telle qu'affichée dans la pastille de couleur, sera toujours respectée par l'algorithme.

Lors du passage d'un illuminant à un autre, le module tente de traduire le plus précisément possible les réglages précédents vers le nouvel illuminant. Le passage de n'importe quel illuminant à personnalisé préserve entièrement vos paramètres, puisque l'illuminant personnalisé est un cas général. Le basculement entre d'autres modes, ou de personnalisé à tout autre mode, ne conservera pas précisément vos paramètres du mode précédent en raison d'erreurs d'arrondi.

D'autres illuminants codés en dur sont disponibles (voir ci-dessous). Leurs valeurs proviennent des illuminants standards CIE et sont absolues. Vous pouvez les utiliser directement si vous savez exactement quel type d'ampoule a été utilisé pour éclairer la scène et si vous faites confiance au profil d'entrée de votre boîtier et à la précision des coefficients de référence D65. Sinon, voir les mises en garde ci-dessous.

contrôles de l'onglet CAT

adaptation

L'espace colorimétrique de travail dans lequel le module effectuera sa transformation d'adaptation chromatique et son mixage de canal. Les options suivantes sont fournies :

Bradford linéaire (1985): Ceci est précis pour les illuminants proches de la lumière du jour et est compatible avec la norme standard ICC v4, mais produit des couleurs hors gamut pour les illuminants plus difficiles.

CAT16 (2016): Il s'agit de l'option par défaut. Elle est plus robuste pour éviter les couleurs imaginaires tout en travaillant avec un large gamut ou du cyan et du violet saturés. Elle est plus précise que le CAT Bradform dans la plupart des cas.

Bradford non-linéaire (1985): Cela peut parfois produire de meilleurs résultats que la version linéaire mais n'est pas fiable.

XYZ: Il s'agit de la méthode la moins précise et n'est généralement pas recommandée, sauf à des fins de test et de débogage.

aucun (contourné): Désactive toute adaptation et utiliser l'espace de travail RVB du pipeline graphique.

illuminant

Le type d'illuminant supposé avoir éclairé la scène. Choisissez parmi les éléments suivants :

identique à la chaîne de traitement (D50) : n'effectue pas d'adaptation chromatique dans cette instance de module, mais effectue simplement le mixage des canaux, en utilisant l'espace colorimétrique adaptation sélectionné.

illuminant standard CIE : Choisissez parmi l'un des illuminants standard CIE (lumière du jour, incandescent, fluorescent, équi-énergie ou corps noir), ou un illuminant « lumière LED » non standard. Ces valeurs sont toutes pré-calculées - tant que le capteur de votre appareil photo est correctement profilé, vous pouvez simplement les utiliser telles quelles. Pour les illuminants proches du locus planckien, un contrôle supplémentaire de « température » est également fourni (voir ci-dessous).

personnalisé : Si un patch gris neutre est disponible dans l'image, la couleur de l'illuminant peut être sélectionnée à l'aide de la pipette de couleur, ou peut être spécifiée manuellement à l'aide des curseurs de teinte et de saturation (dans l'espace colorimétrique perceptuel LCh). L'échantillon de couleur à côté de la pipette de couleur montre la couleur de l'illuminant calculé utilisé dans la compensation CAT. La pipette de couleur peut également être utilisé pour restreindre la zone utilisée pour la détection de l'IA (ci-dessous).

(AI) détecter depuis les surfaces de l'image: Cet algorithme obtient la couleur moyenne des zones de l'image qui ont une covariance élevée entre les canaux de chroma dans l'espace YUV et une variance intra-canal élevée. En d'autres termes, il recherche les parties de l'image qui semblent être grises sans considérer les surfaces colorées plates qui peuvent être réellement teintées. Il ignore également le bruit de chroma ainsi que les aberrations chromatiques.

(AI) détecter depuis les bords de l'image : contrairement à l'équilibrage des blancs automatique du module balance des blancs qui repose sur l'hypothèse du « monde gris », cette méthode détecte automatiquement un illuminant approprié en utilisant l'hypothèse du « bord gris », en calculant le Minkowski p-norm (p = 8) du laplacien et en essayant de le minimiser. C'est-à-dire qu'il suppose que les bords doivent avoir le même dégradé sur tous les canaux (bords gris). Elle est plus sensible au bruit que la précédente méthode de détection basée sur la surface.

tel que pris par le boîtier : calcule l'illuminant en fonction des paramètres de balance des blancs fournis par l'appareil photo.

température

Ajuste la température de couleur de l'illuminant. Déplacez le curseur vers la droite pour adopter un illuminant plus bleu, ce qui donnera à l'image une apparence plus chaude/plus rouge. Déplacez le curseur vers la gauche pour adopter un illuminant plus rouge, ce qui rend l'image plus froide/plus bleue après compensation.

Ce contrôle n'est disponible que pour les illuminants qui se trouvent près du locus de Planck et fournit un réglage fin le long de ce locus. Pour les autres illuminants, le concept de « température de couleur » n'a pas de sens, donc aucun curseur de température n'est fourni.

teinte

Pour une balance des blancs personnalisée, définissez la teinte de la couleur de l'illuminant dans l'espace colorimétrique LCh (dérivée de l'espace CIE Luv).

chroma

Pour une balance des blancs personnalisée, définissez la chroma (ou la saturation) de la couleur de l'illuminant dans l'espace colorimétrique LCh (dérivé de l'espace CIE Luv).

compression gamut

La plupart des capteurs de caméra sont légèrement sensibles aux longueurs d'onde UV invisibles, qui sont enregistrées sur le canal bleu et produisent des couleurs « imaginaires ». Une fois corrigées par le profil de couleur d'entrée, ces couleurs finiront par sortir du gamut (c'est-à-dire qu'il ne sera peut-être plus possible de représenter certaines couleurs comme un triplet [R, V, B] valide avec des valeurs positives dans l'espace colorimétrique de travail) et produire des artefacts visuels dans les dégradés. L'adaptation chromatique peut également repousser d'autres couleurs valides hors du gamut tout en repoussant encore plus loin les couleurs déjà hors du gamut.

La compression gamut utilise une méthode perceptive, non destructive, pour tenter de compresser la chroma en préservant la luminance inchangée et en conservant la teinte aussi proche que possible. L'objectif de cette méthode est d'adapter l'image entière au gamut de l'espace colorimétrique de travail. Cette fonctionnalité est par exemple très utile pour les scènes contenant des lumières LED bleues, qui sont souvent assez problématiques et peuvent entraîner un affreux écrêtage du gamut dans l'image finale.

écrêter les valeurs RVB négatives du gamut

Supprime toutes les valeurs RVB négatives (les met à zéro). Cela permet de gérer un mauvais niveau de noir ainsi que les problèmes d'écrêtage du canal bleu qui peuvent survenir avec les lumières LED bleues. Cette option est destructrice pour la couleur (elle peut changer la teinte) mais garantit une sortie RVB valide quoi qu'il arrive. Il ne doit jamais être désactivé à moins que vous ne vouliez vous occuper du mappage du gamut manuellement et compreniez ce que vous faites. Dans ce cas, utilisez la correction du niveau de noir dans le module exposition pour vous débarrasser de toute valeur RVB négative (RVB signifie lumière, qui est de l'énergie, et qui devrait toujours être une quantité positive), puis augmentez la compression gamut jusqu'à ce qu'il ne reste plus de taches noires unies dans l'image. Un débruitage approprié peut également aider à éliminer les valeurs RVB incorrectes. A noter que cette approche peut encore être insuffisante pour récupérer quelques bleus profonds et lumineux.

Remarque 1 : il a été signalé que certains pilotes OpenCL ne fonctionnent pas correctement lorsque des valeurs RVB négatives sont présentes dans le pipeline de pixels, car de nombreux opérateurs de pixels utilisent des logarithmes et des fonctions de puissance (filmique, balance des couleurs, toutes les conversions d'espace colorimétrique CIE Lab < -> CIE XYZ), qui ne sont pas définies pour les nombres négatifs. Bien que les entrées soient nettoyées avant les opérations sensibles, cela ne suffit pas pour certains pilotes OpenCL, qui produisent des valeurs isolées NaN (pas un nombre). Ces valeurs NaN peuvent ensuite être diffusées par des filtres locaux (opérations de flou et de netteté, telles que netteté, contraste local, égaliseur de contraste, passe-bas, passe-haut, flou de surface et reconstruction des hautes lumières de filmique), résultant en de grands carrés noirs, gris ou blancs.

Dans tous ces cas, vous devez activer l'option « écrêter les valeurs RVB négatives du gamut » dans le module calibration des couleurs.

Remarque 2 : Un cas courant d'échec des algorithmes de couleur dans le module calibration des couleurs (en particulier la compression du gamut) concerne les pixels qui ont une valeur de luminance de 0 (canal Y de l'espace CIE 1931 XYZ), mais une chromaticité non nulle (canaux X et Z de l'espace CIE 1931 XYZ). Ce cas est une bizarrerie numérique qui ne correspond à aucune réalité physique (un pixel sans luminance ne devrait pas avoir de chromaticité non plus), produira une division par zéro dans les espaces colorimétriques xyY et Yuv, et créera en conséquence des valeurs RVB NaN. Ce problème n'est pas corrigé dans calibration des couleurs car il s'agit du symptôme d'un mauvais profilage d'entrée et/ou d'un mauvais niveau de point noir, et doit être résolu manuellement soit en ajustant le profil de couleur d'entrée avec le mélangeur de canaux ou dans la correction du niveau de noir du module exposition.

avertissements CAT

Pour que l'adaptation chromatique fonctionne correctement il faut que soient satisfaites un certain nombre d'hypothèses concernant les étapes antérieures du traitement dans le pipeline graphique. Il peut être facile d'invalider ces hypothèses par inadvertance. Pour vous aider à éviter ce genre d'erreur, le module calibration des couleurs affichera des avertissements dans les circonstances suivantes.

Si le module calibration des couleurs est configuré pour effectuer une adaptation chromatique mais que le module balance des blancs n'est pas réglé sur « boîtier », des avertissements seront affichés dans les deux modules. Ces erreurs peuvent être résolues soit en réglant le module balance des blancs sur « boîtier » soit en désactivant l'adaptation chromatique dans le module calibration des couleurs. Notez que certains capteurs peuvent nécessiter des corrections mineures dans le module balance des blancs, auquel cas ces avertissements peuvent être ignorés.

Si deux ou plusieurs instances de calibration des couleurs ont été créées, chacune essayant d'effectuer une adaptation chromatique, une erreur sera affichée sur la seconde instance. Cela peut être un cas d'utilisation valide (par exemple, lorsque des masques ont été configurés pour appliquer différentes balances des blancs à différentes zones ne se chevauchant pas de l'image), auquel cas les avertissements peuvent être ignorés. Dans la plupart des autres cas, l'adaptation chromatique doit être désactivée dans l'une des instances pour éviter les doubles corrections.

Par défaut, si une instance du module calibration des couleurs effectue déjà une adaptation chromatique, chaque nouvelle instance que vous créez aura automatiquement son adaptation réglée sur « aucun (contourner) » pour éviter cette erreur de « double correction ».

Les modes d'adaptation chromatique dans le module calibration des couleurs peuvent être désactivés en définissant adaptation sur « aucun (contourner) » ou en réglant illuminant sur « identique à la chaîne de traitement (D50) » dans l'onglet CAT.

Dans un flux de travail d'édition RAW typique, ces avertissements visent à éviter les erreurs courantes que l'on peut facilement faire quand on utilise des préréglages automatiques par défaut dans le module. Lors de l'utilisation de préréglages personnalisés et de certains flux de travail spécifiques, tels que l'édition de numérisations de films ou de fichiers JPEG, ces avertissements peuvent et doivent être ignorés.

Les utilisateurs avancés peuvent désactiver les avertissements du module dans préférences > traitement > montrer les messages d'alerte.

mixeur de canaux

Le reste de ce module est un mélangeur de canaux standard, vous permettant d'ajuster les sorties R, V, B, la couleur, la luminosité et le gris du module en fonction des valeurs relatives des canaux d'entrée R, V et B.

Le mixage des canaux est effectué dans l'espace colorimétrique défini par le contrôle adaptation de l'onglet CAT. À toutes fins pratiques, ces espaces CAT sont des espaces RVB particuliers liés à la physiologie humaine et proportionnels aux émissions de lumière dans la scène, mais ils se comportent toujours de la même manière que tout autre espace RVB. L'utilisation de l'un des espaces CAT peut faciliter le processus de réglage du mixeur de canaux, en raison de leur connexion avec la physiologie humaine, mais il est également possible de mixer les canaux dans l'espace de travail RVB du pipeline en réglant adaptation sur « aucun (contourner) ». Pour effectuer un mixage de canaux dans l'un des espaces colorimétriques adaptation sans adaptation chromatique, réglez illuminant sur « identique à la chaîne de traitement (D50) ».

Remarque : Les couleurs réelles des couleurs primaires CAT ou RVB utilisées pour le mixage de canaux, projetées sur l'espace d'affichage sRVB, sont peintes à l'arrière-plan des curseurs RVB, afin que vous puissiez avoir une idée du décalage de couleur qui résultera de la modification de vos paramètres.

Le mixage des canaux est un processus qui définit un facteur d'amplification/réduction pour chaque canal comme la combinaison des ratios de chaque canal d'origine. Au lieu d'entrer une simple correction qui lie la valeur de sortie d'un canal à sa valeur d'entrée (par exemple, R_sortie = R_entrée × correction), la correction de chaque canal dépend de l'entrée de tous les canaux pour chaque pixel (par exemple, R_sortie = R_entrée × R_correction + V_entrée × V_correction + B_entrée × B_correction). Ainsi, chaque canal d'un pixel contribue aux autres (un processus connu sous le nom de « diaphonie » ou « cross-talk ») qui équivaut à faire tourner les couleurs primaires de l'espace colorimétrique en 3D. Il s'agit en fait d'une simulation numérique de filtres de couleurs matériels.

Bien que la rotation des couleurs primaires en 3D équivaille finalement à appliquer une rotation générale de teinte, la connexion entre les corrections RVB et la rotation de teinte perceptive qui en résulte n'est pas directement prévisible, ce qui rend le processus non intuitif. « R », « V » et « B » doivent être considérés comme trois lumières que nous composons, et non comme un ensemble de couleurs ou de teintes. De plus, puisque la trichromie RVB ne découple pas la luminance et la chromaticité mais est une configuration d'éclairage additive, le canal « V » étant plus fortement lié à la perception de la luminance humaine que les canaux « R » et « B » ; tous les pixels ont un canal « V » différent de zéro, ce qui implique que toute correction du canal « V » affectera probablement tous les pixels.

Le processus de mixage des canaux est donc lié à une interprétation physique du tristimulus RVB (en tant que lumières additives) qui le rend bien adapté à la calibration des couleurs primaires et aux corrections d'illuminant. De plus il fusionne les changements de couleur sans cassure. Cependant, essayer de le comprendre et de le prédire d'un point de vue perceptif (luminance, teinte et saturation) va échouer et est découragé.

Remarque : Les étiquettes « R », « V » et « B » des canaux des espaces colorimétriques de ce module ne sont que des conventions formées par habitude. Ces canaux ne sont pas nécessairement « rouge », « vert » et « bleu », et il est déconseillé d'essayer de leur donner un sens en se basant sur leurs noms. Il s'agit d'un principe général qui s'applique à tout espace RVB utilisé dans n'importe quelle application.

onglets R, V et B

Au niveau le plus élémentaire, vous pouvez considérer les onglets R, V et B du module calibration des couleurs comme un type de multiplication matricielle entre une matrice 3x3 et les valeurs d'entrée [R V B]. Ceci est en fait très similaire à ce que fait un profil de couleur ICC basé sur une matrice, sauf que l'utilisateur peut entrer les coefficients de la matrice via l'interface graphique de darktable plutôt que de lire les coefficients à partir d'un fichier de profil ICC.

┌ R_sortie ┐     ┌ Rr  Rv  Rb ┐      ┌ R_entrée ┐
│ V_sortie │  =  │ Vr  Vv  Vb │   X  │ V_entrée │
└ B_sortie ┘     └ Br  Bv  Bb ┘      └ B_entrée ┘

Si, par exemple, une matrice vous a été fournie pour passer d'un espace colorimétrique à un autre, vous pouvez entrer les coefficients de la matrice dans le mixeur de canaux comme suit :

sélectionnez l'onglet R puis définissez les valeurs Rr, Rv et Rb à l'aide des curseurs d'entrée R, V et B

sélectionnez l'onglet V puis définissez les valeurs Vr, Vv et Vb à l'aide des curseurs d'entrée R, V et B

sélectionnez l'onglet B puis définissez les valeurs Br, Bv et Bb à l'aide des curseurs d'entrée R, V et B

Par défaut, la fonction de mixage du module calibration des couleurs copie simplement les canaux d'entrée [R V B] directement sur les canaux de sortie correspondants. Cela équivaut à multiplier par la matrice identité :

┌ R_sortie ┐     ┌ 1  0  0 ┐      ┌ R_entrée ┐
│ V_sortie │  =  │ 0  1  0 │   X  │ V_entrée │
└ B_sortie ┘     └ 0  0  1 ┘      └ B_entrée ┘

Pour avoir une compréhension plus intuitive du comportement des curseurs de mixage des onglets R, V et B, considérez les points suivants :

pour le canal de destination R, le réglage des curseurs vers la droite rendra les zones R, V ou B de l'image plus « rouges ». Déplacer le curseur vers la gauche rendra ces zones plus « cyan ».

pour le canal de destination V, le réglage des curseurs vers la droite rendra les zones R, V ou B de l'image plus « vertes ». Déplacer le curseur vers la gauche rendra ces zones plus « magenta ».

pour le canal de destination B, le réglage des curseurs vers la droite rendra les zones R, V ou B de l'image plus « bleues ». Déplacer le curseur vers la gauche rendra ces zones plus « jaunes ».

contrôles des onglets R, V et B

Les contrôles suivants sont affichés pour chacun des onglets R, V et B :

entrée R/V/B

Choisissez dans quelle mesure les canaux d'entrée R, V et B influencent le canal de sortie relatif à l'onglet concerné.

normaliser les canaux

Cochez cette case pour normaliser les coefficients afin d'essayer de préserver la luminosité globale de ce canal dans l'image finale par rapport à l'image d'entrée.

onglets luminosité et saturation

La luminosité et la saturation (saturation des couleurs) des pixels d'une image peuvent également être ajustées en fonction des canaux d'entrée R, V et B. L'algorithme de base utilisé est le même que celui qu'utilise le module filmique rvb pour le mappage des tonalités (qui préserve les ratios RVB) et pour la saturation des tons moyens (qu'il manipule).

algorithme de saturation

Ce contrôle vous permet de mettre à niveau l'algorithme de saturation vers la nouvelle version 2021, pour les développements effectués avant darktable 3.6 -- il n'apparaîtra pas pour les développements qui utilisent déjà la dernière version.

contrôles de l'onglet saturation

entrée R/V/B

Ajuste la saturation des couleurs en fonction des canaux R, V et B de ces couleurs. Par exemple, le réglage du curseur rouge (entrée) affectera la saturation des couleurs contenant beaucoup de canal R bien plus que celle des couleurs contenant seulement une petite quantité de canal « R ».

normaliser les canaux

Cochez cette case pour essayer de maintenir constante la saturation globale entre les images d'entrée et de sortie.

contrôles de l'onglet luminosité

entrée R/V/B

Ajuste la luminosité de certaines couleurs de l'image, en fonction des canaux R, V et B de ces couleurs. Par exemple, le réglage du curseur rouge (entrée) affectera la luminosité des couleurs contenant beaucoup de canal R bien plus que celle des couleurs contenant seulement une petite quantité de canal R. Lors de l'assombrissement/éclaircissement d'un pixel, le rapport des canaux R, V et B pour ce pixel est conservé, afin de préserver la teinte.

normaliser les canaux

Cochez cette case pour essayer de maintenir la luminosité globale constante entre les images d'entrée et de sortie.

onglet gris

Une autre application très utile de calibration des couleurs est la possibilité de mélanger les canaux pour produire une sortie en niveaux de gris -- une image monochrome. Sélectionnez l'onglet gris et réglez les curseurs R, V et B pour contrôler la contribution de chaque canal à la luminosité de la sortie. Cela équivaut à la multiplication matricielle suivante :

Gris_sortie  =   [ r  v  b ]  X  ┌ R_entrée ┐
                                 │ V_entrée │
                                 └ B_entrée ┘

Lorsqu'il s'agit des tons chair, les poids relatifs des trois canaux affecteront le niveau de détail de l'image. Mettre plus de poids sur R (par exemple [0,9, 0,3, -0,3]) donnera des tons de peau lisses, tandis que l'accentuation de V (par exemple [0,4, 0,75, -0,15]) fera ressortir plus de détails. Dans les deux cas, le canal B est réduit pour éviter d'accentuer le grain de peau indésirable.

contrôles de l'onglet gris

entrée R/V/B

Choisissez dans quelle mesure chacun des canaux R, V et B contribue au niveau de gris de la sortie. L'image ne sera convertie en monochrome que si les trois curseurs totalisent une valeur non nulle. Ajouter plus de B aura tendance à faire ressortir plus de détails, ajouter plus de R aura tendance à lisser les tons chair.

normaliser les canaux

Cochez cette case pour essayer de maintenir la luminosité globale constante au fur et à mesure que les curseurs sont ajustés.

extraction de paramètres à l'aide d'une charte de couleurs

Étant donné que le mixeur de canaux est essentiellement une matrice RVB (similaire au profil de couleur d'entrée utilisé pour les images RAW), il peut être utilisé pour améliorer la précision des couleurs du profil de couleur d'entrée en calculant les paramètres ad hoc de calibration des couleurs.

Ces paramètres calculés visent à minimiser, dans une situation d'éclairage donnée, les différences observées entre les couleurs de la scène et celles de l'enregistrement fourni par le boîtier. Cela équivaut à créer un profil de couleur ICC générique, mais ici, le profil est plutôt stocké en tant que paramètres de module qui peuvent être enregistrés sous forme de préréglages ou de styles, pour être partagés et réutilisés entre les images. Ces profils sont censés compléter et affiner le profil d'entrée générique mais ne le remplacent pas.

Cette fonctionnalité peut vous aider à :

gérer des illuminants difficiles, tels que des ampoules à faible IRC, pour lesquels un simple équilibrage des blancs ne suffira jamais,

numériser des œuvres d'art ou des produits commerciaux où une restitution fidèle des couleurs d'origine est requise,

neutraliser plusieurs boîtiers différents à la même référence, lors de séances de photos avec plusieurs caméras, afin d'obtenir un aspect de base cohérent et de partager les paramètres d'édition des couleurs pour obtenir un aspect final cohérent,

obtenir un pipeline graphique sain dès le début, une optimisation de la balance des blancs et une suppression de toute dominante de couleur due à la lumière réfléchie, avec un minimum d'effort et de temps.

chartes de couleurs prises en charge

Les utilisateurs ne sont pas actuellement autorisés à utiliser des cibles personnalisées, mais un nombre limité de chartes couleur vérifiées (de fabricants réputés) sont supportées :

X-Rite / Gretag MacBeth Color Checker 24 (avant et après 2014),

Datacolor SpyderCheckr 24,

Datacolor SpyderCheckr 48.

Les utilisateurs ne sont pas encouragés à acheter des chartes de couleurs bon marché, sans marque, car la constance des couleurs ne peut pas être assurée à de tels prix. Des chartes de couleurs imprécises ne permettront pas d'atteindre l'objectif de calibration des couleurs et aggraveront peut-être les choses.

Les chartes IT7 et IT8 ne sont pas prises en charge car elles ne sont guère portables et ne sont pas pratiques pour une utilisation sur place pour les profils ad hoc. Ces chartes conviennent mieux à la création de profils de couleurs génériques, réalisés à l'aide d'un illuminant standard, par exemple avec Argyll CMS.

Remarque : X-Rite a changé la formule de ses pigments en 2014, ce qui a légèrement modifié la couleur des pastilles. Les deux formules sont prises en charge dans darktable, mais vous devez faire attention et choisir la bonne référence pour votre cible. En cas de doute, essayez les deux et choisissez celui qui donne le delta E moyen le plus bas après la calibration.

prérequis

Pour utiliser cette fonctionnalité, vous devrez prendre une photo test d'une charte de couleurs prise en charge, sur place, dans des conditions d'éclairage appropriées :

cadrer la charte au centre à 50% du champ du boîtier, pour vous assurer que l'image est exempte de vignettage,

assurez-vous que la source lumineuse principale est suffisamment éloignée de la charte pour donner un champ d'éclairement uniforme sur la surface de la charte,

ajustez l'angle entre la lumière, la charte et l'objectif pour éviter les reflets et la brillance sur les pastilles de couleur,

pour un profil de la meilleure qualité, vous devez capturer une image avec la luminosité appropriée. Pour ce faire, prenez quelques images bracketées (entre -1 et +1 IL) de votre charte de couleurs et chargez-les dans darktable, en vous assurant que tous les modules entre calibration des couleurs et profil de couleurs de sortie sont désactivés. Choisissez l'image où la tache blanche a une clarté L de 94-96% dans l'espace CIE Lab ou une luminance Y de 83-88% dans l'espace CIE XYZ (utilisez la pipette de couleur globale). Cette étape n'est pas strictement nécessaire. Vous pouvez également prendre une seule image et appliquer la compensation d'exposition recommandée dans le rapport de profil.

Si les conditions d'éclairage sont proches d'un illuminant standard D50 à D65 (lumière naturelle directe, pas de lumière réfléchie colorée), la photo de la charte de couleurs peut être utilisée pour produire un profil générique qui conviendra à tout éclairage de lumière du jour avec seulement un léger ajustement de la balance des blancs.

Si les conditions d'éclairage sont particulières et éloignées des illuminants standard, la photo de la charte de couleurs ne sera utilisable que comme profil ad-hoc pour des photos prises dans les mêmes conditions d'éclairage.

utilisation

Les paramètres utilisés dans le calibrage des couleurs dépendent de l'espace CAT choisi et de tous les paramètres de couleur définis précédemment dans le pipeline graphique dans les modules balance des blancs et profil de couleur d'entrée. En tant que tels, les résultats du profilage (par exemple, les coefficients de mixage des canaux RVB) ne sont valides que pour un ensemble précis de paramètres espace CAT, balance des blancs et profil de couleur d'entrée. Si vous souhaitez créer un style générique avec votre profil, n'oubliez pas que vous devrez également inclure les paramètres de ces modules.

Utilisez le processus suivant pour créer votre profil/style prédéfini :

Activez le module correction des objectifs pour corriger tout vignettage qui pourrait induire en erreur la calibration,

En bas du module calibration des couleurs, cliquez sur la flèche à côté du label calibrer avec une charte de couleurs, pour afficher les contrôles,

Choisissez le bon modèle et le fabricant de votre charte couleur dans la liste déroulante charte,

Dans l'aperçu de l'image, une superposition des pastilles de la charte apparaîtra. Faites glisser les coins de la charte afin qu'ils correspondent aux références visuelles (points ou croix) autour de la cible, pour compenser toute distorsion de perspective,

Cliquez sur le bouton rafraîchir pour calculer le profil,

Vérifiez le rapport de qualité du profil. S'il est "bon", vous pouvez cliquer sur le bouton valider. Sinon, essayez de modifier la stratégie d'optimisation et actualisez à nouveau le profil.

Enregistrez le profil dans un préréglage ou un style, ou, à partir de la vue table lumineuse ou à partir de la pellicule, copiez et collez simplement les paramètres du module sur toutes les photos prises dans les mêmes conditions d'éclairage.

Remarque : Il n'est pas nécessaire d'utiliser la matrice standard dans le module profil de couleur d'entrée lors d'un calibrage, mais sachez que la balance des blancs par défaut "boîtier" ne fonctionnera pas correctement avec tout autre profil, et que vous devrez toujours utiliser le même profil d'entrée chaque fois que vous réutilisez ces paramètres de calibration.

lire le rapport de profil

Le rapport de profil vous aide à évaluer la qualité de la calibration. Les paramètres de la calibration des couleurs ne sont qu'une optimisation de la "meilleure correspondance" et ne seront jamais précis à 100% pour l'ensemble du spectre de couleurs. Nous devons donc déterminer "à quel point il est inexact" afin de savoir si nous pouvons ou non faire confiance à ce profil.

De mauvais profils peuvent se produire et feront plus de mal que de bien s'ils sont utilisés.

delta E et le rapport de qualité

Le CIE delta E 2000 (ΔE), ou écart de couleur, est utilisé comme une mesure perceptive de l'erreur entre la couleur de référence des pastilles et la couleur obtenue après chaque étape de calibration :

ΔE = 0 signifie qu'il n'y a pas d'erreur -- la couleur obtenue est exactement la couleur de référence. Malheureusement, cela ne se produira jamais dans la pratique.

ΔE = 2,3 est défini comme la différence juste perceptible (JND en anglais pour Just Noticeable Difference).

ΔE < 2,3 signifie que l'observateur moyen ne sera pas en mesure de faire la différence entre la couleur de référence attendue et la couleur obtenue. C'est un résultat satisfaisant.

ΔE > 2,3 signifie que la différence de couleur entre la valeur attendue et la couleur obtenue est perceptible pour l'observateur moyen. C'est insatisfaisant mais parfois inévitable.

Le rapport qualité monitore le ΔE moyen et maximum à l'entrée du module (avant que quoi que ce soit ne soit fait), après l'étape d'adaptation chromatique (balance des blancs uniquement) et à la sortie du module (balance des blancs et mixage des canaux). A chaque étape, le ΔE doit être inférieur à celui de l'étape précédente, si tout se passe comme prévu.

données du profil

Les données générées par le processus de profilage comprennent la matrice 3x3 RVB et l'illuminant détecté. Ceux-ci sont exprimés dans l'espace adaptation CAT défini dans l'onglet CAT et sont fournis au cas où vous souhaiteriez exporter ces coefficients vers d'autres logiciels. Si l'illuminant détecté est lumière du jour ou corps noir, la matrice doit être assez générique et réutilisable pour d'autres illuminants lumière du jour et corps noir avec l'ajout d'un petit ajustement de la balance des blancs.

valeurs de normalisation

Ce sont les paramètres que vous devez définir, tels quels, pour les paramètres exposition et correction du niveau du noir dans le module exposition, afin d'obtenir le moins d'erreur possible dans votre profil. Cette étape est facultative et n'est utile que lorsque la plus grande précision est requise, mais sachez qu'elle peut produire des valeurs RVB négatives qui seront écrêtées à divers points du pipeline.

superposition

Le graphique en superposition affiche un disque au centre de chaque pastille de couleur, qui représente la valeur de référence attendue de cette pastille, projetée dans l'espace d'affichage RVB. Cela vous aide à évaluer visuellement la différence entre la référence et la couleur réelle sans avoir à vous soucier des valeurs ΔE. Cet indice visuel ne sera fiable que si vous définissez le module exposition comme indiqué dans les valeurs de normalisation du rapport de profil.

Une fois le profil calibré, certaines des pastilles carrées seront barrées en arrière-plan par une ou deux diagonales :

les pastilles qui ne sont pas barrées ont un ΔE < 2,3 (JND), ce qui signifie qu'elles sont suffisamment précises pour que l'observateur moyen ne puisse pas remarquer la déviation,

les pastilles barrées d'une diagonale ont 2,3 < ΔE < 4,6, ce qui signifie qu'elles sont légèrement inexactes,

les pastilles barrées de deux diagonales ont un ΔE > 4,6 (2 × JND), ce qui signifie qu'elles sont très imprécises.

Ce retour visuel vous aidera à mettre en place le compromis d'optimisation pour vérifier quelles couleurs sont plus ou moins précises.

amélioration du profil

Étant donné que toute calibration n'est que la recherche du « meilleur ajustement » (en utilisant une méthode des moindres carrés pondérés), il est impossible d'avoir toutes les pastilles dans notre tolérance ΔE < 2,3. Certains compromis seront donc nécessaires.

Le paramètre optimisé pour vous permet de définir une stratégie d'optimisation qui tente d'augmenter la précision du profil dans certaines couleurs au détriment des autres. Les options suivantes sont disponibles :

sans : n'utilise pas de stratégie explicite mais repose sur la stratégie implicite définie par le fabricant de la charte de couleurs. Par exemple, si la charte de couleurs comporte principalement des pastilles à faible saturation, le profil sera plus précis pour les couleurs moins saturées.

couleurs neutres : privilégie les gris et les couleurs moins saturées. Ceci est utile pour les cas désespérés impliquant des éclairages fluorescents et LED bon marché, ayant un faible IRC. Cependant, cela peut augmenter davantage l'erreur dans les couleurs hautement saturées qu'une absence de profil.

couleurs saturées : privilégie les couleurs primaires et les couleurs très saturées. Ceci est utile dans la photographie de produits et commerciale, pour obtenir les couleurs correctes de la marque.

couleurs de la peau et de terre, couleurs du feuillage, couleurs du ciel et de l'eau : Donne la priorité à la gamme de teintes choisie. Ceci est utile si le sujet de vos photos est clairement défini et a une couleur typique.

delta E moyen : essaye d'uniformiser l'erreur de couleur sur toute la gamme de couleurs et de minimiser l'erreur de perception moyenne. Ceci est utile pour les profils génériques.

delta E maximum : essaye de minimiser les valeurs aberrantes et les erreurs importantes, au détriment de l'erreur moyenne. Cela peut être utile pour faire rentrer les bleus très saturés dans le rang.

Quoi que vous fassiez, les stratégies qui favorisent un ΔE moyen faible auront généralement un ΔE maximum plus élevé, et vice versa. De plus, les bleus sont toujours la gamme de couleurs la plus difficile à corriger, de sorte que le calibrage revient généralement à protéger les bleus au détriment de tout le reste, ou de tout le reste au détriment des bleus.

La facilité d'obtention d'un bon calibrage dépend de la qualité de l'illuminant de la scène (les illuminants lumière du jour et IRC élevé doivent toujours être préférés), de la qualité du profil de couleur d'entrée original, de la correction du niveau du noir définie dans le module exposition, mais avant tout des propriétés mathématiques de la grille de filtres du capteur de l'appareil photo.

vérification de profil

Il est possible d'utiliser le bouton vérifier le delta E de sortie (en bas à gauche du module) pour effectuer un seul calcul ΔE de la référence de la charte de couleurs par rapport à la sortie du module calibration des couleurs. Cela peut être utilisé des manières suivantes :

Pour vérifier l'exactitude d'un profil calculé dans des conditions particulières par rapport à une charte de couleurs photographiée dans différentes conditions.

Pour évaluer les performances de toute correction de couleur effectuée plus tôt dans le pipeline, en définissant les paramètres calibration des couleurs sur des valeurs qui la désactivent effectivement (adaptation dans CAT à aucun (contourner), tout le reste est défini par défaut), et utiliser simplement le ΔE moyen comme mesure de performance.

mises en garde

La possibilité d'utiliser des illuminants CIE standard et des interfaces basées sur CCT pour définir la couleur de l'illuminant dépend de choix raisonnable des valeurs pour la matrice standard dans le module profil de couleur d'entrée ainsi que pour les coefficients RVB dans le module balance des blancs.

Certains appareils photo, notamment ceux d'Olympus et de Sony, ont des coefficients de balance des blancs inattendus qui rendront toujours le CCT détecté invalide, même pour les illuminants de la scène réellement de type lumière du jour. Cette erreur provient très probablement de problèmes avec la matrice d'entrée standard, qui provient d'Adobe DNG Converter.

Il est possible de pallier ce problème, si vous disposez d'un écran d'ordinateur calibré pour un illuminant D65, en utilisant le processus suivant :

Affichez une surface blanche sur votre écran, par exemple en affichant un fond blanc dans n'importe quel logiciel de retouche photo que vous aimez

Prenez une photo floue (hors mise au point) de cette surface avec votre appareil photo, en vous assurant qu'il n'y a pas de lumière "parasite" dans le cadre, que vous n'avez pas d'écrêtage et que vous utilisez une ouverture entre f/5,6 et f/8 ,

Ouvrez l'image dans darktable et extrayez la balance des blancs en utilisant l'outil spot dans le module balance des blancs sur la zone centrale de l'image (les régions non centrales peuvent être sujettes à des aberrations chromatiques). Cela générera un ensemble de 3 coefficients RVB.

Créer un nouveau préréglage pour le module balance des blancs avec ces coefficients et l'appliquer automatiquement à toute image RAW couleur créée par le même appareil photo.

censurer

Dégrade des parties de l'image d'une façon esthétique, pour anonymiser des gens, des objets et des parties du corps.

Censurer opère dans un espace RVB linéaire pour appliquer un flou gaussien et un bruit gaussien physiquement réalistes.

À part l'anonymisation, ce module peut aussi être utilisé pour une large gamme d'effets créatifs, par exemple :

Combiner un simple flou avec un mode de fusion multiplier pour créer un effet Orton réaliste.

Combiner un simple flou avec un mode de fusion soustraire et une opacité faible pour créer un masque flou, similaire au module netteté mais dans un espace RVB relatif à la scène.

Ajouter du bruit pour créer du grain artificiel.

Note : La méthode d'anonymisation fournie par ce module n'est pas résistante aux techniques d'analyse scientifique mais favorise l'esthétique. Certaines techniques d'analyse scientifique peuvent être capable de reconstruire le contenu anonymisé, en particulier pour des formes simples et du texte (ex : plaques d'immatriculation, numéros de rue).

Si une anonymisation résistante à l'analyse est requise, la seule façon d'y parvenir est de peindre les surfaces avec une couleur opaque.

L'équipe de darktable décline toute responsabilité dans des images mal anonymisées qui mèneraient à l'identification d'individus ou de propriété privée.

flux de travail

Il est conseillé de laisser les contrôles du module à leur valeur par défaut pendant que vous masquez les surfaces de l'image que vous souhaitez anonymiser, de sorte que les détails de l'image restent visibles.

contrôles du module

rayon du flou d'entrée

La force de la première passe de flou gaussien.

rayon de pixélisation

La taille des « gros pixels » créés par la première passe de flou gaussien.

rayon du flou de sortie

La force de la seconde passe de flou gaussien, appliquée après la pixélisation.

niveau de bruit

La force (l'écart-type) du bruit gaussien de luminance appliqué après la seconde passe de flou gaussien. Ajouter du bruit peut contrefaire des détails dans les région flous et rendre la détection de contenu plus difficile pour les algorithmes d'intelligence artificielle.

coloriser

Ajouter un calque d'une couleur unie à l'image.

contrôles du module

teinte

Teinte de la couleur du calque.

saturation

Saturation des tons d'ombre.

clarté

Clarté de la couleur du calque.

mélange des sources

Contrôle la manière dont la clarté de l'image d'entrée est mélangée avec le calque de couleur. Mettre à zéro se traduira par un plan uniformément coloré.

contraste de couleur

Un contrôle simplifié pour modifier le contraste ou la séparation des couleurs entre les axes vert/magenta et bleu/jaune dans l'espace colorimétrique Lab. Des valeurs plus élevées augmentent le contraste des couleurs, des valeurs plus faibles le diminuent.

contrôles du module

contraste vert-magenta

Modifier le contraste des couleurs vert-magenta. Cela équivaut à augmenter ou à diminuer la pente de la courbe a* dans l'espace couleur Lab. Des valeurs plus faibles désaturent le vert et le magenta, tandis que des valeurs plus élevées augmentent leur saturation.

contraste bleu-jaune

Modifier le contraste des couleurs bleu-jaune. Cela équivaut à augmenter ou à diminuer la pente de la courbe b* dans Lab. Des valeurs plus faibles désaturent les bleus et les jaunes, tandis que des valeurs plus élevées augmentent leur saturation.

contraste local

Améliore le contraste local de l'image.

Ceci est réalisé à l'aide d'un filtre laplacien local (par défaut) ou grille bilatérale. Les deux modes fonctionnent exclusivement sur le canal L de Lab. Le filtre local laplacien a été conçu pour être robuste contre les effets de halo indésirables et les inversions de gradient le long des bords.

contrôles du module

mode

Choix du filtre laplacien local ou de la grille bilatérale. Les sections suivantes définissent les commandes disponibles pour chacun de ces modes.

grille bilatérale

granularité

Rend plus fins ou plus grossiers les détails que vous désirez ajuster.

contraste

Contrôle la force avec laquelle l'algorithme distingue les niveaux de luminosité. Augmentez ce paramètre pour un aspect plus contrasté.

détail

Ajoute ou supprime des détails. Des valeurs plus élevées augmentent le contraste local.

laplacien local

Pour comprendre les paramètres du filtre laplacien local, on peut le considérer comme l'application à l'image d'une courbe semblable à celle de ce dessin :

Elle sera appliquée à l'image à l'aide d'une méthode qui agit localement et évite les artefacts de type halo.

Le mode laplacien local prend également en charge l'amélioration des ombres et la compression des hautes lumières, de la même manière que le module ombres et hautes lumières.

détail

Ajoute ou supprime des détails. Des valeurs plus élevées augmentent le contraste local. Cela insère une forme en S au centre de la courbe, pour augmenter ou diminuer le contraste local.

hautes lumières

Cela affecte l'une des extrémités de la courbe en S, augmentant ou compressant effectivement le contraste dans les hautes lumières. Une faible valeur réduit les hautes lumières.

ombres

Similaire au paramètre des hautes lumières, celui-ci affecte l'autre extrémité de la courbe et augmente ou diminue le contraste dans les ombres. Une valeur élevée donne plus de contraste dans les ombres. Une valeur faible rehausse les ombres et peut simuler efficacement une lumière d'appoint. Notez cependant que ceci se fait via une manipulation locale de l'image : cela signifie qu'une image complètement sombre ne peut pas être éclaircie de cette manière -- seules les zones sombres devant des zones lumineuses sont affectées.

étendue tons moyens

Ceci contrôle l'étendue de la partie centrale du S de la courbe de contraste. Une valeur plus élevée rend le S plus large et classe ainsi plus de valeurs dans la plage des tons moyens et moins de valeurs dans la zone des hautes lumières et des ombres. Dans des réglages à plus grande plage dynamique, il peut être utile de réduire cette valeur pour obtenir une compression de plage plus forte, en réduisant le contraste dans les hautes lumières et dans les ombres. Notez cependant que dans des scénarios HDR vraiment importants, ceci peut mieux fonctionner en combinaison avec une courbe de base qui pré-compresse la plage, peut-être avec une courbe approximativement logarithmique. La fonction de fusion d'exposition dans le module courbe de base peut parfois donner des résultats plus satisfaisants, mais elle est aussi plus sensible aux effets de halo.

S'il est poussé à des valeurs extrêmes, ce paramètre peut provoquer dans l'image des artefacts de type bandes. Ceci est dû à la façon dont darktable calcule l'approximation rapide du filtre laplacien local.

contraste luminosité saturation

Un outil très basique pour ajuster le contraste, la luminosité et la saturation d'une image. Veuillez noter qu'un certain nombre d'autres modules offrent des méthodes beaucoup plus polyvalentes pour ajuster ces paramètres.

Toutes les contrôles du module sont par défaut en position neutre (zéro) et offrent la possibilité d'augmenter ou de diminuer le paramètre approprié.

Remarque : Ce module travaille dans l'espace colorimétrique Lab et est sujet aux halos. À la place, utilisez le module balance couleurs rvb.

contrôles du module

contraste

Modifier le contraste.

luminosité

Modifier la luminosité.

saturation

Modifier la saturation.

correction des couleurs

Modifier la saturation globale de l'image pour lui donner une teinte. C'est aussi une méthode alternative pour diviser une image en utilisant deux tons.

Remarque : Utilisez le module couleur balance rvb pour les modifications de couleur.

contrôles du module

planche de couleur

Pour un partage en deux teintes, déplacez le point blanc sur la teinte souhaitée pour les hautes lumières, puis sélectionnez une teinte pour les ombres avec le point sombre. Pour une teinte globale, placez les deux points sur la même couleur.

saturation

Réglez la saturation globale.

correction des objectifs

Corrige automatiquement (et simule) la distorsion de l'objectif, les aberrations chromatiques transversales (TCA) et le vignettage.

Ce module identifie la combinaison boîtier/objectif à partir des données Exif de l'image et utilise la bibliothèque externe lensfun pour fournir des paramètres de correction.

Si la bibliothèque lensfun de votre système n'a pas de profil de correction pour la combinaison boîtier/objectif identifiée automatiquement, les commandes des trois paramètres photométriques (ci-dessous) sont remplacées par un message d'avertissement. Vous pouvez essayer de trouver vous-même le bon profil en le recherchant dans le menu.

Si votre objectif est présent dans la liste mais n'a pas été correctement identifié, cela peut nécessiter quelques ajustements dans le programme exiv2 (voir cette publication pour des détails). Notez que vous devrez peut-être réimporter les images une fois ces réglages effectués, car le nom de l'objectif est récupéré dans le cadre du processus d'importation.

Si vous ne trouvez pas votre objectif, vérifiez s'il figure dans la liste des objectifs actuellement pris en charge, et essayez d'exécuter lensfun-update-data. S'il n'y a toujours pas de profil correspondant pour votre objectif, un service d'étalonnage de l'objectif est proposé par Torsten Bronger, l'un des utilisateurs. Vous pouvez également visiter le projet lensfun pour apprendre à générer votre propre ensemble de paramètres de correction. N'oubliez pas de partager votre profil avec l'équipe lensfun !

contrôles du module

caméra

La marque et le modèle de l'appareil photo déterminés par les données Exif de l'image. Vous pouvez annuler cela manuellement et sélectionner votre caméra dans un menu hiérarchique. Seuls les objectifs avec des profils de correction correspondant au boîtier sélectionné seront affichés.

objectif

La marque et le modèle de l'objectif tels que déterminés par les données Exif de l'image. Vous pouvez annuler cela manuellement et sélectionner votre objectif dans un menu hiérarchique. Ceci est notamment requis pour les objectifs purement mécaniques, mais peut également être nécessaire pour les objectifs hors marque / tiers.

paramètres photométriques (longueur focale, ouverture, distance au sujet)

Les corrections d'objectif dépendent de certains paramètres photométriques qui sont lus à partir des données Exif de l'image : longueur focale (pour la distorsion, TCA, vignettage), ouverture (pour TCA, vignettage) et distance au sujet (pour le vignettage). De nombreux appareils photo n'enregistrent pas la distance au sujet dans leurs données Exif, auquel cas vous devrez la définir manuellement.

Vous pouvez remplacer manuellement tous les paramètres sélectionnés automatiquement. Prenez l'une des valeurs prédéfinies dans le menu déroulant ou, avec le menu déroulant toujours ouvert, saisissez simplement votre propre valeur.

corrections

Choisissez les corrections (distorsion, chromatisme, vignettage) que darktable doit appliquer. Modifiez cette valeur par défaut "tout", si votre appareil photo a déjà effectué des corrections internes (par exemple, le vignettage), ou si vous envisagez d'effectuer certaines corrections avec un programme séparé.

géométrie

En plus de corriger les défauts de l'objectif, ce module peut changer le type de projection de votre image. Réglez cette liste déroulante sur le type de projection souhaité (par exemple "rectilinéaire", "fish-eye", "panoramique", "équi-rectangulaire", "orthographique", "stéréographique", "angle solide constant", "thoby fish-eye"). Pour corriger le rapport hauteur/largeur d'un objectif anamorphique, utilisez le module rotation et perspective.

échelle

Ajustez le facteur d'échelle de votre image pour éviter les coins noirs. Appuyez sur le bouton de mise à l'échelle automatique (à droite du curseur) pour que darktable trouve automatiquement le meilleur ajustement.

mode

Le comportement par défaut de ce module est de retouche les défauts de l'objectif. Basculez cette liste déroulante sur "déforme" afin de simuler au contraire les défauts/distorsions d'un objectif spécifique (effet inversé).

remplacer AC

Cochez cette case pour remplacer les paramètres de correction automatique des aberrations chromatiques. Cela exposera en dessous les paramètres AC rouge et AC bleu. Décochez la case pour revenir aux corrections automatiques.

AC rouge ; AC bleu

Remplace les paramètres de correction pour les AC. Vous pouvez également utiliser ces curseurs pour définir manuellement les paramètres si le profil de l'objectif n'inclut pas la correction des AC. Recherchez les franges colorées sur les éléments avec des bords à contraste élevé et ajustez les paramètres AC pour minimiser ces franges.

corrections effectuées

Parfois, pour une combinaison appareil photo/objectif donnée, seules certaines des corrections possibles sont prises en charge par les profils de lensfun. Cette boîte de message vous indiquera quelles corrections ont réellement été appliquées à l'image.

Remarque : Les corrections des AC ne seront pas appliquées aux images identifiées comme monochromes (voir développement d'images monochromes pour plus d'informations).

Remarque : Le module de correction de l'objectif comblera les données manquantes au niveau des bordures en répétant les pixels des bordures. Pour des corrections fortes, ce remplissage peut être visible (surtout sur les images bruitées). Recadrez l'image si nécessaire.

montrer les guides

Cochez la case pour afficher les superpositions de guides chaque fois que le module est activé. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides et superpositions pour plus de détails.

correction des taches (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.6 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le module retouche à la place.

Corrige des zones d'une image (la cible) en utilisant des détails d'une autre zone de l'image (la source).

Ce module utilise certaines des formes disponibles pour masques dessinés (cercles, ellipses et chemins), et l'interface utilisateur est similaire.

Pour utiliser ce module, sélectionnez d'abord la forme souhaitée en cliquant sur l'icône de forme correspondante (Ctrl+clic pour activer le mode de création de forme continue). Ensuite, vous pouvez éventuellement choisir la source de la correction en utilisant Maj+Ctrl+clic ou Maj+clic sur le canevas de l'image pour choisir respectivement le mode absolu ou relatif (voir ci-dessous). Cliquez enfin sur le canevas pour choisir la zone à corriger (la zone cible). Une croix s'affiche à l'endroit où la zone source sera positionnée.

Il y a deux modes pour positionner la source

mode absolu

Avant de placer une forme sur le canevas de l'image, Maj+Ctrl+clic sur la position souhaitée pour la source. A partir de ce point, toutes les nouvelles formes auront leur source créée à la même position absolue (en coordonnées d'image).

mode relatif

Avant de placer une forme sur le canevas de l'image, Maj+clic sur la position souhaitée pour la source. La forme actuelle aura la source créée à cette position et les formes suivantes auront leur source créée à la même position, par rapport à la forme cible.

Après la création, les zones source et cible de chaque forme peuvent être déplacées indépendamment jusqu'à ce que le résultat corresponde à vos attentes. Une flèche pointe de la zone source de chaque forme vers sa cible.

Pour chaque forme utilisez ses contrôles spécifiques pour ajuster sa taille, la largeur de sa bordure et d'autres de ses attributs.

Faites un clic-droit sur une forme pour la supprimer.

Ce module est équivalent à l'outil "copie" du module retouche ; voir la description de l'outil copie pour plus de détails et d'exemples. Si le module correction des taches ne donne pas de résultats satisfaisants, vous pouvez essayer l'outil "correction" du module retouche.

correction du profil d'entrée

Ajoute une courbe de correction aux données de l'image. Ceci est nécessaire si vous avez sélectionné certains profils d'entrée dans le module profil de couleur d'entrée.

Si vous décidez d'utiliser un profil ICC du fabricant de la caméra dans le module profil du couleur d'entrée, l'application aux donnés de l'image d'une courbe de correction est souvent nécessaire pour que la sortie finale ne soit pas trop sombre. Ce traitement supplémentaire n'est pas nécessaire si vous utilisez les matrices de couleurs standard ou améliorées de darktable.

La courbe de correction se compose d'une partie linéaire s'étendant des ombres à une certaine limite supérieure et d'une courbe gamma couvrant les tons moyens et les hautes lumières. Pour plus d'informations, veuillez consulter le projet voisin de darktable UFRaw.

linéaire

La limite supérieure pour la région considérée comme ombres et où aucune correction gamma n'est effectuée. Généralement, des valeurs comprises entre 0,0 et 0,1 sont requises par le profil.

gamma

La valeur gamma requise pour compenser le profil d'entrée. Souvent, la valeur requise est de 0,45 (l'inverse du gamma de 2,2 utilisé par certains profils de fabricants).

courbe de base

Simuler le JPEG intégré au boîtier en appliquant à l'image une courbe de base caractéristique.

darktable est livré avec un certain nombre de préréglages de courbe de base qui tentent d'imiter les courbes de divers fabricants d'appareils photo. Ces préréglages sont automatiquement appliqués en fonction de l'ID du fabricant trouvé dans les données Exif de l'image. Pour certains modèles de boîtier des préréglages de courbe de base spécifiques sont également disponibles.

Ce module sera activé par défaut si préférences> traitement> flux de travail par défaut est défini sur « relatif à l'affichage ». Une deuxième option dans la boîte de dialogue des préférences vous permet de choisir si darktable doit essayer d'appliquer la courbe de base spécifique au boîtier (si elle est trouvée) ou la courbe générique du fabricant.

contrôles du module

Veuillez vous référer à la section courbes pour plus de détails sur la façon de modifier les courbes, y compris aux contrôles échelle du graphe et préserver les couleurs.

fusion

Déclenchez la fusion d'exposition (voir cet article Wikipedia). Cette fonction vous permet de fusionner l'image avec un ou deux ses clones, après avoir appliqué à ceux-ci la courbe de base actuelle et après avoir augmenté l'exposition de chacun d'eux d'un nombre sélectionnable d'unités IL. L'image résultante est ainsi une combinaison de deux ou trois images ayant des expositions différentes.

Utilisez cette fonction pour compresser la plage dynamique d'images extrêmement sous-exposées ou pour une véritable entrée HDR. Pour de meilleurs résultats, utilisez le module exposition pour appliquer un réglage approprié à des hautes lumières correctement exposées.

décalage d'exposition (fusion)

La différence d'exposition entre deux images fusionnées en unités IL (par défaut 1). Ce curseur n'est visible que si la fonction fusion d'exposition est activée.

biais d'exposition (fusion)

Détermine comment les diverses expositions sont calculées. Avec un biais égal à 1 (valeur par défaut), l'image est fusionnée avec des clones surexposées. Avec un biais égal à -1, elle est fusionnée avec des clones sous-exposées. Un biais égal à 0 tente de préserver la clarté globale de l'image en combinant des clones surexposés et sous-exposés. Ce curseur n'est visible que si la fonction fusion d'exposition est activée.

courbe des tonalités

Un outil classique de photographie numérique pour modifier les tons d'une image à l'aide de courbes.

Ce module est très similaire au module courbe rvb mais travaille dans l'espace colorimétrique Lab.

Activez la pipette de couleur pour montrer les valeurs sélectionnées sur l'histogramme affiché (Ctrl+clic ou clic-droit pour utiliser la pipette en mode zone). Les valeurs numériques (Lab) de l'entrée et de la sortie (voir ci-dessous) au point ou dans la zone sélectionnée sont affichées en haut à gauche du graphique.

contrôles du module

Veuillez vous référer à la section courbes pour avoir plus de détails sur la façon de modifier les courbes et pour obtenir des détails sur les contrôles interpolation, échelle du graphe et préserver couleur.

espaces couleur

Selon l'intention de rendu souhaitée, la courbe des tons peut être appliquée dans l'un des trois espaces couleur suivants :

Lab (canaux liés ou indépendants) : Lab est un espace colorimétrique perceptif conçu pour être proche de la façon dont les humains perçoivent les couleurs et la clarté. Il représente les informations de couleur indépendamment de la clarté. En mode "Lab, canaux indépendants", vous disposez d'un contrôle totalement indépendant sur la luminance (canal L) et la chrominance (canaux a/b). En mode « Lab, canaux liés », seul le contrôle de luminance (canal L) est disponible. La correction de saturation des couleurs est calculée automatiquement, pour chaque pixel, à partir de la correction de contraste appliquée au canal de luminance. Cela fonctionne mieux dans les cas où une petite correction de contraste est appliquée, mais donne une correction de saturation de plus en plus imprécise à mesure que le contraste est plus fortement modifié.

XYZ (canaux liés) : XYZ est un espace colorimétrique technique linéaire conçu pour relier la réponse lumineuse physiologique de l'œil humain aux espaces colorimétriques RVB. Comme avec Lab, il sépare la clarté des informations de couleur, mais le fait d'une manière qui ne tient pas compte du rôle de la correction apportée par le cerveau dans la perception humaine. Le mode "XYZ, canaux liés" offre une alternative au mode "Lab, canaux liés" et travaille en appliquant la courbe du canal L aux trois canaux de l'espace colorimétrique XYZ. Regardez modes de fusion « réglage des couleurs » si vous souhaitez régler la force de la mise à l'échelle automatique de la chroma. Ce mode est connu pour produire un léger décalage de teinte vers le jaune.

RVB (canaux liés) : RVB est un espace colorimétrique linéaire conçu pour capturer et afficher des images en synthèse additive. Il est lié à la capture et à l'affichage des supports et n'isole pas les informations de couleur et de clarté. Le mode « RVB, canaux liés » fonctionne dans ProPhoto RVB et applique la courbe du canal L aux trois canaux de l'espace colorimétrique RVB. L'ajout de contraste dans l'espace RVB est connu pour désaturer les hautes lumières et augmenter la saturation dans les ombres, mais cela s'est avéré être le moyen le plus fiable de modifier le contraste et c'est la méthode standard utilisée dans la plupart des logiciels. Ce mode fait en sorte que le module courbe des tonalités se comporte de la même manière que le module courbe de base, sauf que ce dernier travaille dans l'espace RVB du boîtier.

À noter que dans tous les cas le module travaille dans l'espace colorimétrique Lab. Cela signifie que la coordonnée du gris moyen est toujours à 50 % dans le graphique, quel que soit l'espace colorimétrique utilisé. Il en va de même pour l'histogramme affiché en arrière-plan de la courbe. Les contrôles sont convertis dans l'espace colorimétrique approprié avant que les corrections ne soient appliquées -- en RVB et XYZ, le gris moyen passe donc alors de 50 % à 18 %.

courbe du canal L

La courbe de tonalité dans le canal L travaille sur la clarté. Pour offrir une meilleure vue d'ensemble, un histogramme de clarté est affiché dans le module. Lorsque vous travaillez dans l'un des modes « canaux liés », la courbe du canal L est la seule disponible.

L'axe horizontal représente la clarté des pixels de l'image d'entrée. L'axe vertical représente la clarté des pixels de l'image de sortie. La ligne diagonale droite par défaut ne change rien. Une courbe au-dessus de la diagonale par défaut augmente la clarté, tandis qu'une courbe en dessous la diminue. Une courbe en S améliorera le contraste de l'image. Vous pouvez déplacer les extrémités de la diagonale par défaut pour modifier les points noirs et blancs et donc modifier le contraste global -- cela a le même effet que changer les points noirs et blancs dans le module niveaux.

courbes des canaux a/b

Les courbes des canaux a et b travaillent sur des valeurs de couleur et ne sont disponibles qu'en mode « Lab, canaux indépendants ». L'axe horizontal représente la valeur du canal de couleur des pixels de l'image d'entrée. L'axe vertical représente la valeur du canal de couleur des pixels de l'image de sortie. Les valeurs a positives correspondent à des couleurs plus magenta ; les valeurs a négatives correspondent à des couleurs plus verdâtres. Les valeurs b positives correspondent à des couleurs plus jaunâtres ; les valeurs b négatives correspondent à des couleurs plus bleuâtres.

La ligne droite diagonale par défaut ne change rien. Le déplacement du centre de la courbe donnera à l'image une teinte de couleur : le déplacement du canal a vers le haut donne une teinte magenta ; déplacer le canal b vers le haut donne une teinte jaune ; déplacer le canal a vers le bas donne une teinte verte ; décaler le canal b vers le bas donne une teinte bleue.

Augmenter/diminuer la pente d'une courbe, sans déplacer son centre, augmentera/diminuera la saturation des couleurs du canal concerné. Avec des courbes correctement définies, vous pouvez exercer un contrôle précis sur la saturation des couleurs, en fonction des couleurs du pixel d'entrée.

courbe rvb

Un outil numérique classique pour modifier les tons d'une image à l'aide de courbes.

Ce module est très similaire au module courbe des tonalités mais travaille dans l'espace colorimétrique RVB.

Activez la pipette de couleur à gauche pour afficher les valeurs sélectionnées dans le graphique (Ctrl+clic ou clic droit pour utiliser le sélecteur en mode zone). Les valeurs numériques (Lab) de l'entrée et de la sortie (voir ci-dessous) à l'endroit ou à dans la zone sélectionnée sont affichées en haut à gauche du widget.

Une seconde pipette de couleur à droite de la précédente peut être utilisée pour créer automatiquement de nouveaux nœuds en fonction de la zone échantillonnée. Ctrl+clic+glisser pour modifier les nœuds créés afin d'avoir une courbe positive pour la zone sélectionnée ; Maj+clic+glisser pour créer une courbe négative.

contrôles du module

Veuillez vous référer à la section courbes pour plus de détails sur la façon de modifier les courbes, y compris en utilisant les contrôles interpolation et préserver couleurs.

mode

RVB est un espace colorimétrique linéaire conçu pour capturer et afficher des images en synthèse additive. Il est lié au support de capture et d'affichage et n'isole pas les informations de couleur et de clarté de la même manière que les espaces colorimétriques Lab et XYZ. Ce module fonctionne en ProPhoto RVB. L'ajout de contraste dans l'espace RVB est connu pour désaturer les hautes lumières et augmenter la saturation dans les ombres, mais cela s'est avéré être le moyen le plus fiable de modifier le contraste, et c'est la méthode standard dans la plupart des logiciels.

Selon l'intention de rendu souhaitée, vous pouvez appliquer la courbe RVB avec deux modes différents

RVB, canaux liés : appliquez la courbe du canal L aux trois canaux de l'espace colorimétrique RVB.

RVB, canaux indépendants : les courbes R, V et B peuvent être ajustées indépendamment.

compenser le gris moyen

Sélectionnez cette option pour modifier l'affichage de l'histogramme dans le module. Cette option ne modifie pas le traitement mais peut aider lors de l'édition de la courbe.

dématriçage

Contrôler comment sont dématricés les fichiers RAW

filtres de Bayer

Les cellules du capteur d'un appareil photo numérique ne sont pas sensibles aux couleurs -- elles ne peuvent enregistrer que différents niveaux de clarté. Afin d'obtenir une image en couleur, chaque cellule est recouverte d'un filtre de couleur (rouge, vert ou bleu) qui laisse passer principalement la lumière de cette couleur. Cela signifie que chaque pixel de l'image RAW ne contient que des informations sur un seul canal de couleur.

Les filtres de couleur sont généralement disposés selon un motif en mosaïque connu sous le nom de matrice de filtres Bayer. Un algorithme de dématriçage reconstitue les canaux de couleur manquants par interpolation avec les données des pixels voisins. Pour en savoir plus, consultez les articles suivants de Wikipédia Dématriçage et Matrice de filtres colorés.

darktable propose plusieurs algorithmes de dématriçage, chacun ayant ses propres caractéristiques. Les différences entre eux sont souvent très subtiles et peuvent n'être visibles que lors de l'observation des pixels. Cependant, comme l'algorithme de dématriçage opère pixel par pixel et qu'il génère des données fondamentales pour les autres modules, son choix peut avoir un effet visuellement important sur la qualité des détails très fins de l'image. Cela peut entraîner l'apparition de faux motifs de labyrinthe et avoir un impact négatif sur la qualité du rendu des bords colorés.

Les algorithmes de dématriçage peuvent souvent produire des artefacts, généralement visibles sous forme de moirés lors d'un zoom sur l'image. L'algorithme choisi peut gérer, en mieux ou en pire, les effets de moiré ou de labyrinthe préexistants dans les données RAW. Dans ces circonstances les algorithmes VNG4 et LMMSE sont souvent plus stables.

Les algorithmes de dématriçage suivants sont disponibles pour les capteurs avec filtres Bayer :

PPG était l'algorithme de dématriçage par défaut de darktable. Il est rapide, mais d'autres algorithmes donnent généralement de meilleurs résultats.

AMaZE et RCD offrent une meilleure reconstruction des zones à hautes fréquences (détails plus fins, bords, étoiles) mais peuvent être mises en échec avec des dépassements dans la reconstruction des couleurs ou un ajout de bruit dans des zones à faible contraste. Alors que AMaZE conserve souvent plus de détails à hautes fréquences, il est également plus sujet aux dépassements de couleur que RCD. Étant donné que RCD offre désormais des performances de calcul similaires à PPG, mais avec de meilleurs résultats, il s'agit désormais de l'algorithme par défaut.

LMMSE est mieux adapté pour une utilisation sur des images ISO élevées et bruitées que AMaZE ou RCD, qui ont tous deux tendance à générer des artefacts de dépassement lorsqu'ils sont appliqués à de telles images. Il peut également être utile pour traiter les images qui présentent des motifs de moiré avec d'autres algorithmes.

VNG4 est mieux adapté pour une utilisation pour des images avec un contenu à basse fréquence (par exemple, des régions à faible contraste comme le ciel) mais, par rapport à AMaZE et RCD, il provoque souvent la perte de certains détails à haute fréquence et peut parfois ajouter des décalages de couleur locaux. VNG n'est plus vraiment recommandé -- pour la plupart des images, d'autres algorithmes disponibles fournissent généralement de meilleurs résultats.

Remarque : Les performances des algorithmes de dématriçage diffèrent considérablement, AMaZE étant de loin le plus lent.

capteurs sans filtres bayer

Il y a quelques appareils dont les capteurs n'utilisent pas un filtre de Bayer. Les appareils avec un capteur "X-Trans" ont leur propre ensemble d'algorithmes de dématriçage. L'algorithme par défaut pour les capteurs X-Trans est Markesteijn 1-passe, qui produit d'assez bons résultats. Pour une qualité un peu meilleure (au prix d'un processus beaucoup plus lent), choisissez l'algorithme _Markesteijn 3-passe. Sur certains ordinateurs l'algorithme VNG est plus rapide que l'algorithme Markesteijn 1-passe, mais il est plus sujet à des artefacts.

algorithmes spéciaux

passer (monochrome) n'est utile que pour les boîtiers dont la matrice de filtres de couleur a été physiquement retirée du capteur (par exemple, rayée). Les algorithmes de dématriçage reconstruisent généralement les canaux de couleur manquants par interpolation avec les données des pixels voisins. Cependant, si le réseau de filtres de couleur n'est pas présent, il n'y a rien à interpoler, donc cet algorithme définit simplement tous les canaux de couleur sur la même valeur, résultant en une image monochrome. Cette méthode évite les artefacts d'interpolation que les algorithmes de dématriçage standards pourraient introduire.

couleur photosite n'est pas destiné à être utilisé pour le traitement d'images. Il prend les données RAW du photosite et les présente sous forme de pixels rouges, bleus ou verts. Ceci est conçu à des fins de débogage afin de voir les données RAW et peut aider à l'analyse des erreurs produites par les autres algorithmes de dématriçage.

algorithmes de dématriçage double

Certaines images ont des zones mieux dématriçées à l'aide d'un algorithme qui préserve les informations des hautes fréquences (comme AMaZE ou RCD) et d'autres zones pourraient bénéficier d'un algorithme plus adapté au contenu à basses fréquences (comme VNG4).

Dans les algorithmes de dématriçage double (par exemple RCD + VNG4), les données du capteur sont dématriçées deux fois, d'abord par RCD, AMaZE ou Markesteijn 3-passe, puis par VNG4. Les deux ensembles de données dématriçées sont conservés pour un traitement ultérieur.

Les données de l'algorithme hautes fréquences sont ensuite analysées pour une modification locale des données, et, en utilisant un seuil (il y a un peu plus de mathématiques impliquées ici), l'image de sortie est écrite pixel par pixel pour chaque canal de couleur en utilisant les données de chaque algorithme de dématriçage pondérées par la modification locale des données.

En général, les zones plus détaillées sont dématriçées par l'algorithme le mieux adapté à cet effet (RCD, AMaZe, Markesteijn 3-pass) et toutes les zones à couleur unie (comme le ciel bleu) sont dématriçées à l'aide du second algorithme (VNG4).

La « modification des données locales » est techniquement implémentée sous la forme d'un masque de sélection, calculé sur un unique canal et avec un flou gaussien, à partir d'une combinaison du seuil et de la luminance des pixels.

choisir le seuil

Un seuil calculé automatiquement est difficile à mettre en œuvre. Au lieu de cela, le bouton "affiche masque de fusion" peut être utilisé pour afficher le masque de sélection afin que vous puissiez contrôler la sélection de l'algorithme manuellement. Plus le pixel du masque affiché est lumineux, plus la sortie est extraite de l'algorithme hautes fréquences.

contrôles du module

méthode de dématriçage

L'algorithme de dématriçage à utiliser (voir ci-dessus).

seuil des bords (PPG uniquement)

Le seuil pour une passe médiane supplémentaire. La valeur par défaut est « 0 », elle désactive le filtrage médian.

raffinement lmmse (LMMSE uniquement)

Pas de raffinement à utiliser avec l'algorithme de dématriçage LMMSE. Le pas médian fait la moyenne de la sortie. Le pas raffinement ajoute un nouveau calcul des canaux rouges et bleus. Bien que les options raffinement fonctionnent bien pour le bruit de luminance, elles peuvent diminuer la qualité des images avec un bruit de chrominance important.

lissage des couleurs

Activez un certain nombre de passes de lissage des couleurs supplémentaires. La valeur par défaut est « désactivée ».

correction des verts

Dans certains boîtiers, les filtres verts ont des propriétés légèrement différentes. Ce paramètre ajoute une étape d'égalisation supplémentaire pour supprimer les artefacts. Les options disponibles sont « désactivé », « moyenne locale », « moyenne globale » et « moyenne globale et locale ». Cette option n'est pas affichée pour les capteurs X-Trans.

affiche le seuil double (mode de dématriçage double uniquement)

Définissez le seuil de contraste pour les modes de dématriçage double. Des valeurs plus faibles favorisent l'algorithme de dématriçage hautes fréquences et des valeurs plus élevées favorisent l'algorithme basses fréquences.

affiche masque de fusion (modes de dématriçage double uniquement)

Affiche le masque de fusion qui est utilisé pour différencier les zones de hautes et basses fréquences (ajusté par le paramètre « active le seuil double »). Pour chaque pixel, plus le masque est lumineux, plus la sortie du module est extraite de l'algorithme de dématriçage des hautes fréquences.

diffusion ou netteté

La diffusion est une famille de processus physiques par lesquels des particules se déplacent et se propagent progressivement avec le temps, depuis une source qui les génère. En traitement d'image, la diffusion se produit principalement à deux endroits :

la diffusion des photons à travers le verre des lentilles (flou) ou l'air humide (brume),

la diffusion des pigments dans les encres liquides ou dans les aquarelles.

Dans les deux cas, la diffusion rend l'image moins nette en laissant "fuir" des particules et en lissant les variations locales.

Le module diffusion ou netteté utilise un modèle physique généralisé pour décrire plusieurs sortes de diffusion, et peut être utilisé par les créateurs d'images soit pour simuler soit pour inverser des processus de diffusion.

Comme il s'agit d'un module hautement technique, plusieurs préréglages sont fournis pour montrer son utilité pour divers usages.

La diffusion peut être éliminée pour :

reconstruire l'image originale venant de capteurs munis de filtre passe-bas ou réduire le flou créé par la plupart des algorithmes de dématriçage (utilisez l'un des préréglages netteté du dématriçage et déplacez le module avant le module profil de couleur d'entrée dans le pipeline graphique),

inverser le flou statique d'objectif et le bokeh (utiliser l'un des préréglages correction de flou d'objectif),

supprimer le voile atmosphérique (utiliser le préréglage suppression de la brume),

ajouter une netteté perceptuelle supplémentaire (piqué) pour une meilleur lisibilité (utilisez le préréglage contraste local).

Notez que les flous de mouvement ne peuvent pas être éliminés en annulant le processus de diffusion, car ils ne sont pas créés par un phénomène de diffusion.

La diffusion peut être ajoutée pour :

créer un effet Orton (utilisez le préréglage lumière d'arrière-plan),

remplir des portions manquantes ou endommagées de l'image (utilisez le préréglage remplir les hautes lumières),

débruiter d'une manière qui respecte les bords (utilisez l'un des préréglages débruitage)

appliquer un flou de surface (utilisez le préréglage flou de surface).

Comme le procédé est physique, même ses effets indésirables peuvent être utilisés à des fins créatives. Par exemple, vous pouvez :

simuler le dessin au trait ou l'aquarelle (utilisez les préréglages simuler le dessin au trait ou simuler l'aquarelle),

créer des motifs aléatoires et des textures en augmentant le bruit (peu à peu, avec des itérations, le bruit se connectera avec ses voisins pour créer des taches aléatoires).

Remarque : Ce module est très gourmand en ressources, car il s'agit d'un solveur d'équations différentielles aux dérivées partielles, anisotropique et multi-échelles. Le temps d'exécution du module augmente avec le nombre d'itérations et OpenCL est fortement recommandé. Quelques préréglages « rapides » sont fournis pour l'utilisation sur des systèmes sans OpenCL (les préréglages avec la mention rapide).

concepts

temps

La diffusion est un processus dépendant du temps : plus il dure, plus loin les particules peuvent se propager. Dans ce module, le temps est simulé en utilisant le nombre d'itérations (le nombre de fois que l'algorithme s'exécute sur lui-même). D'avantage d'itérations peuvent rendre la reconstruction (correction de flou, débruitage, suppression de la brume) plus précise si elle est correctement définie mais peuvent aussi la faire dégénérer.

direction

La diffusion naturelle se produit habituellement depuis les points à haut potentiel (haute énergie ou haute concentration de particules) vers les points à bas potentiel (basse énergie ou basse concentration de particules). Dans une image, cela signifie que la diffusion se produit toujours des pixels les plus clairs vers les pixels les plus sombres.

Cette implémentation particulière peut simuler la diffusion naturelle, en utilisant ce qu'on appelle une diffusion isotrope (toutes les directions ont la même priorité, comme pour la diffusion de chaleur), mais il est aussi possible de forcer une direction de diffusion prioritaire, parallèle aux gradients (forçant à diffuser à travers les bords des objets et créant des bords fantômes), ou perpendiculaire aux gradients, dans une direction nommée isophote (forçant une diffusion contenues dans les bords, comme dans une goutte d'aquarelle). La pondération relative de chaque direction est définie par l'utilisateur et peut être trouvée dans la section direction de la diffusion du module.

vitesse

En fonction de la fluidité de l'environnement, les particules peuvent se déplacer plus ou moins librement et donc plus ou moins vite. La vitesse de diffusion peut être définie dans la section vitesse de diffusion du module.

Lors d'une reconstruction (débruitage, correction de flou, suppression de la brume), il est conseillé d'utiliser des vitesses faibles pour une meilleure précision. Cela empêche les dépassements numériques (et donc la détérioration de la solution) et peut requérir d'avantage d'itérations. Pour de petits nombres d'itérations, des vitesses plus importantes peuvent être utilisées. Notez que des flous larges ont besoin de beaucoup d'itérations pour une reconstruction correcte, et la vitesse doit être ajustée en conséquence pour éviter de dégénérer la solution.

Toutes les vitesses sont additionnées (premier au quatrième ordre), et les sommes "premier ordre + second ordre" et "troisième ordre + quatrième ordre" ne devraient jamais dépasser ± 100%, sauf si vous voulez produire du glitch art.

échelle

La diffusion naturelle est censée se produire uniquement aux coordonnées voisines les plus proches. C'est à dire que, à chaque itération, chaque pixel ne devrait interagir qu'avec ses 9 voisins les plus proches.

Ici, nous accélérons un peu les choses pour gagner du temps et réutiliser le schéma d'ondelettes multi-échelles du module égaliseur de contraste, afin que nous puissions diffuser à différentes échelles. L'échelle maximale de diffusion est définie par le paramètre étendue de rayon.

Indépendamment de la diffusion, un paramètre netteté permet d'augmenter ou de diminuer les détails à chaque échelle, un peu comme les contrôles spline de l'égaliseur de contraste. Avec le curseur sensibilité aux bords, cela offre les mêmes fonctionnalités que le module égaliseur de contraste (onglet luma et contour), mais dans un espace RVB relatif à la scène.

contrôles du module

paramètres de diffusion

itérations

Le nombre de fois que l'algorithme doit être exécuté par dessus lui-même. Des valeurs élevées ralentissent le module mais permettent des reconstructions plus précises, à condition que les vitesses de diffusion soient suffisamment faibles.

rayon central

L'échelle principale de la diffusion. La valeur zéro agit plus fortement sur les détails fins (utilisée pour la correction de flou et le débruitage). Les valeurs non nulles définissent la taille des détails à diffuser fortement (utilisées pour augmenter le contraste local).

étendue de rayon

Cela vous permet de sélectionner la bande de rayons de détails sur laquelle agir, autour du rayon central. L'étendue de diffusion définit une plage d'échelles de détail (entre centre - étendue et centre + étendue ) à l'intérieur de laquelle la diffusion est confinée. Les valeurs élevées diffusent sur une large bande de rayons, au détriment du temps de calcul. Les valeurs faibles diffusent plus proche autour du rayon central. Si vous envisagez de corriger un flou, la portée du rayon doit être approximativement égale à la largeur du flou de votre objectif et le rayon central doit être égal à zéro. Si vous prévoyez d'augmenter le contraste local, mais que vous ne voulez pas affecter la netteté ou le bruit, la portée du rayon doit être de 3/4 de votre rayon central maximum.

Les rayons sont exprimés en pixels de l'image en pleine résolution, donc copier-coller les réglages entre images de résolution différente peut conduire à des résultats légèrement différents, à l'exception de la netteté au niveau des pixels.

Pour les ingénieurs électriciens, ce qui est défini ici est un filtre passe-bande dans l'espace des ondelettes, utilisant une fenêtre fréquentielle gaussienne centrée sur le rayon central avec une atténuation (écart type) de l'étendue du rayon. Les échelles d'ondelettes sont analogues aux fréquences harmoniques et chaque échelle d'ondelettes définit le rayon des détails sur lesquels agir.

vitesse de diffusion

vitesse 1er ordre (gradient)

La vitesse de diffusion des couches d'ondelettes basse fréquence dans la direction définie par le paramètre anisotropie 1er ordre. Les valeurs positives appliquent la diffusion, les valeurs négatives annulent la diffusion, zéro ne fait rien.

vitesse 2ème ordre (laplacien)

La vitesse de diffusion des couches d'ondelette basse fréquence dans la direction définie par le paramètre anisotropie 2ème ordre. Les valeurs positives appliquent la diffusion, les valeurs négatives annulent la diffusion, zéro ne fait rien.

vitesse 3ème ordre (gradient de laplacien)

La vitesse de diffusion des couches d'ondelette haute fréquence dans la direction définie par le paramètre anisotropie 3ème ordre. Les valeurs positives appliquent la diffusion, les valeurs négatives annulent la diffusion, zéro ne fait rien.

vitesse du 4ème ordre (laplacien de laplacien)

La vitesse de diffusion des couches d'ondelettes haute fréquence dans la direction définie par le paramètre anisotropie 4ème ordre. Les valeurs positives appliquent la diffusion, les valeurs négatives annulent la diffusion, zéro ne fait rien.

direction de la diffusion

anisotropie 1er ordre

La direction de diffusion des couches d'ondelettes basse fréquence par rapport à l'orientation du gradient de basse fréquence. Zéro est isotrope, les valeurs négatives font que la diffusion suit de plus près les gradients, les valeurs positives font que la diffusion suit de plus près les isophotes.

anisotropie 2ème ordre

La direction de diffusion des couches d'ondelettes basse fréquence par rapport à l'orientation du gradient de hautes fréquence. Zéro est isotrope, les valeurs négatives font que la diffusion suit de plus près les gradients, les valeurs positives font que la diffusion suit de plus près les isophotes.

anisotropie 3ème ordre

La direction de diffusion des couches d'ondelettes haute fréquence par rapport à l'orientation du gradient de basse fréquence. Zéro est isotrope, les valeurs négatives font que la diffusion suit de plus près les gradients, les valeurs positives font que la diffusion suit de plus près les isophotes.

anisotropie 4ème ordre

La direction de diffusion des couches d'ondelettes haute fréquence par rapport à l'orientation du gradient haute fréquence. Zéro est isotrope, les valeurs négatives font que la diffusion suit de plus près les gradients, les valeurs positives font que la diffusion suit de plus près les isophotes.

gestion des bords

netteté

Applique un gain sur les détails des ondelettes, indépendamment des propriétés de diffusion. Zéro ne fait rien, les valeurs positives accentuent la netteté, les valeurs négatives floutent. C'est principalement utile comme variable d'ajustement lors du blooming ou du flou, pour conserver une certaine netteté tout en ajoutant une lueur autour des bords. Il n'est pas conseillé de l'utiliser pour la netteté seule, puisque rien n'empêche les halos ou les franges avec ce réglage.

sensibilité aux bords

Applique une pénalité sur les vitesses de diffusion lorsque des bords sont détectés. Cette détection utilise la variance locale autour de chaque pixel. Zéro désactive la pénalité, des valeurs plus élevées rendent la pénalité plus forte et plus sensible aux bords. Augmentez si vous remarquez des artefacts de bord comme des franges et des halos.

seuil des bords

Définit un seuil de variance, qui affecte principalement les zones à faible variance (zones sombres ou floues, ou surfaces planes). Des valeurs positives augmenteront la pénalité pour les zones à faible variance, ce qui est bon pour accentuer ou augmenter le contraste local sans écraser les noirs. Des valeurs négatives diminueront la pénalité pour les zones à faible variance, ce qui est bon pour le débruiter ou flouter avec un effet maximal sur les régions noires et floues.

spatialité de la diffusion

seuil du masque de luminance

Ce contrôle est utile si vous souhaitez remplir les très hautes lumières en propageant le contenu voisin (inpainting). Pour des valeurs supérieures à 0 %, la diffusion ne se produira que dans les régions avec une luminance supérieure à ce réglage. Notez que du bruit gaussien sera ajouté dans ces régions pour simuler les particules et initialiser l'inpainting.

flux de travail

La principale difficulté de ce module est que si le résultat peut varier considérablement en fonction de ses paramètres d'entrée, ces paramètres n'ont aucun lien intuitif avec la vie quotidienne. Les utilisateurs risquent d'être dépassés, à moins qu'ils ne soient déjà familiarisés avec les équations aux dérivées partielles de Fourier. Cette section propose quelques façons d'aborder ce module sans avoir à comprendre la théorie sous-jacente.

conseils généraux

Si vous prévoyez de corriger le flou de votre image avec ce module, commencez toujours par corriger adéquatement les aberrations chromatiques et le bruit dans l'image, car cette correction risque d'amplifier ces défauts. Il est important de ne pas avoir de pixels noirs écrêtés/bouchés dans l'image. Ceux-ci peuvent être corrigés avec la correction du niveau de noir du module exposition.

Puisqu'il fonctionne sur les canaux RVB séparés, il est préférable d'appliquer ce module après le module calibration couleur, de sorte que vous commenciez avec une image d'entrée entièrement neutre et corrigée pour la balance des blancs. Notez qu'augmenter le contraste local ou la netteté va aussi induire un léger renforcement du contraste de couleur et de la saturation, ce qui est habituellement une bonne chose. Comme il utilise une régularisation basée sur la variance pour détecter les bords, il est également préférable de placer ce module avant toute opération non-linéaire.

démarrer avec des préréglages

Les préréglages fournis ont été ajustés par le développeur et testés sur une gamme d'images pour des usages typiques. Le moyen le plus simple consiste simplement à partir des préréglages, puis à les modifier au besoin :

si l'effet semble trop fort, diminuez le nombre d'itérations,

si des artefacts apparaissent aux bords, augmentez la sensibilité aux bords,

si la correction du flou commence à affecter des parties légitimement floues (le bokeh), réduisez le rayon,

si la correction du flou paraît correct dans les zones claires mais excessif dans les zones sombres, augmentez le seuil des bords,

si la correction du flou bouche et écrête des pixels noirs, diminuez la correction du niveau de noir dans le module exposition,

ajustez finement la netteté à votre goût.

partir de zéro

Les réglages par défaut du module sont entièrement neutres et ne feront rien à votre image. L'esprit du module est que chaque ordre affecte la texture de l'image d'une façon particulière.

Commencez par régler les paramètres du premier ordre (vitesse et anisotropie) pour avoir une base initiale. Ensuite, ajustez le rayon. Ceci va affecter les textures les plus grossières (les flouter ou les rendre plus nettes). Souvenez vous que le premier ordre agit sur les basses fréquences des échelles d'ondelettes et suit une direction parallèle ou perpendiculaire au gradient des basses fréquences.

Ensuite, commencez les ajustements sur les paramètres du deuxième ordre (vitesse et anisotropie). Le deuxième ordre agit également sur les basses fréquences des échelles d'ondelettes mais suit cette fois une direction parallèle ou perpendiculaire au gradient des hautes fréquences, qui peut être soit la direction de la netteté maximale soit celle du bruit. Ceci peut être utilisé pour réduire le bruit (en utilisant le deuxième ordre en mode diffusion, avec des valeurs positives) quand vous avez utilisé le premier ordre en mode netteté (avec des valeurs négatives).

Ces deux étapes peuvent être effectuées sur l'image dézoomée. Souvenez-vous que, même si l'on a pris grand soin de rendre le résultat visuel de l'algorithme assez invariant à l'échelle, l'aperçu ne sera exact qu'en cas de zoom 1:1. Dans tous les cas, tout ce qui se passe au niveau du pixel (rayon < 2px) ne sera pas visible pour les niveaux de zoom inférieurs à 50 %.

À ce stade, vous souhaiterez peut-être modifier la sensibilité aux bords pour pour vous occuper des artefacts aux bords. En théorie, diffuser dans la direction isophote garantit que la diffusion est contenue à l'intérieur des bords, mais cela ne suffit pas lorsque des coins et des formes convexes pointues sont présents dans l'image.

Quand le contrôle de la sensibilité aux bords a été ajusté pour produire des résultats satisfaisants, l'image va habituellement devenir bien plus douce. Dans la plupart des cas, à cette étape, il est nécessaire d'augmenter le nombre d'itérations pour compenser. Ceci se fait au prix d'une pénalité de performance, donc pilotez soigneusement le compromis performance/qualité en fonction de votre matériel informatique. Si vous ne pouvez pas augmenter le nombre d'itérations, vous devrez augmenter la vitesse de diffusion.

La dernière étape consiste à affiner les troisième et quatrième ordres, qui s'occupe les hautes fréquences de chaque échelle d'ondelettes. Vous devrez être beaucoup plus léger avec ces paramètres que pour les premier et deuxième ordre car ils peuvent faire exploser le bruit très vite.

Le troisième ordre suit la direction du gradient ou de l'isophote de la couche basse fréquence, il peut donc être utilisé pour guider la diffusion haute fréquence dans une direction qui est plus susceptible d'être légitime en ce qui concerne les bords réels (et moins susceptible de capter du bruit).

Le quatrième ordre suit la direction du gradient ou de l'isophote de la couche haute fréquence et est plus susceptible de capter le bruit. La diffusion sur le quatrième ordre est le meilleur moyen de réduire le bruit sans trop affecter la netteté, soit en tant que débruitage autonome, soit en tant qu'étape de régularisation dans un processus de suppression du flou.

utiliser plusieurs instances pour la reconstruction d'image

Le post-filtrage du bruit peut bénéficier de l'ajout d'un processus de diffusion ; ceci peut être appliqué comme une étape supplémentaire après le module réduction du bruit (profil).

À l'inverse, les problèmes optiques suivant peuvent bénéficier d'une reconstruction par inversion du processus de diffusion :

le flou introduit par le filtre passe-bas du capteur (LPF) et/ou l'anti-crénelage appliqué par le module dématriçage,

le flou d'objectif statique,

le voile atmosphérique et la brume,

la diffusion de la source de lumière (utilisant un diffuseur trop large), conduisant à un éclairage trop uniforme et manquant de contraste local sur le sujet.

Bien que plus d'un de ces problèmes puissent affecter la même image au même moment, il est préférable d'essayer de les résoudre séparément en utilisant plusieurs instances du module. Ce faisant, assurez-vous que les problèmes sont corrigés de l'échelle la plus grossière à l'échelle la plus fine, et que le débruitage se produit toujours en premier. Autrement dit, vos instances devraient apparaître dans l'ordre de pipeline suivant :

débruitage,

amélioration du contraste local,

suppression du voile atmosphérique,

correction du flou de l'objectif,

correction du capteur et du dématriçage.

Commencer par les reconstructions sur les échelles les plus grossières réduit la probabilité d'introduire et d'augmenter le bruit en effectuant les reconstructions sur les échelles les plus fines. Ceci est contre-intuitif car ces processus n'arrivent pas dans cet ordre pendant la formation de l'image. Pour la même raison, le débruitage devrait toujours être effectué avant toute tentative d'augmenter la netteté ou le piqué.

remarques et avertissements

Bien que ce module ait été conçu pour être indépendant de l'échelle, sa sortie ne peut être garantie qu'à un zoom de 100 % et sur les exportations en haute qualité ou à pleine résolution. Les résultats à des niveaux de zoom plus bas ou à des dimensions d'exportations plus basses peuvent ne pas correspondre à vos attentes.

En réglant un algorithme de défloutage, essayez de garder à l'esprit que beaucoup des plus belles images de l'histoire de la photographie ont été prises avec des objectifs qui étaient très loin d'offrir la netteté de ceux disponibles aujourd'hui. Bien que la mode actuelle soit de construire et de vendre des objectifs de plus en plus nets, et d'avoir des logiciels qui appliquent des niveaux insensés d'accentuation de la netteté par dessus, cette vague ne conduit pas à de meilleures images et rend le processus de retouche plus pénible. Un léger flou a aussi un intérêt poétique dont les images HD aseptisées et chirurgicales peuvent manquer.

Il doit être noté que le contraste global (utilisant une simple courbe de tonalité ou les niveaux de blanc et de noir) affecte aussi notre perception de netteté, ce qui est très différent d'une netteté optique (la résolution optique). Les yeux humains ne sont sensibles qu'au contraste local, qui peut venir d'une vraie netteté optique (i.e. d'une absence de diffusion -- des bords fins) mais aussi de transitions tonales amplifiées. Si un mappage global de tonalité est en place pour augmenter le contraste, l'image va paraître plus nette. Si un mappage de tonalité est utilisé pour diminuer le contraste, l'image va paraître plus floue. Dans aucun de ces cas, les bords réels des objets ne sont affectés d'une quelconque façon, et les conséquences perceptuelles ne sont que pure illusion.

Une partie du processus de vieillissement est la perte de la vue. Le niveau d'accentuation de la netteté que des gens de plus de 50 ans vont trouver plaisant risque de ne pas être le même que pour des gens dans la vingtaine. Cela mérite de chercher à augmenter la netteté pour obtenir un résultat plausible (correspondant à votre perception habituelle) plutôt qu'un résultat plaisant (qui risque de ne paraître beau que pour les gens qui ont la même vue que vous).

Finalement, juger de la netteté des images, zoomé à 1:1 (100 %) ou plus est une tâche insensée. Dans les musées, les expositions, et même à l'écran, le grand public regarde les images comme un ensemble, pas avec une loupe. De plus, dans la plupart des usages courants, les photographies dépassent rarement une résolution de 3000×2000 pixels (environ un tirage aux dimension A4/lettre à 300 PPP), ce qui, pour des capteurs de 24 Mpx, signifie sous-échantillonner par un facteur de 4. Quand vous examinez un fichier de 24 Mpx à 1:1, vous êtes en fait en train de regarder une image qui n'existera jamais. Augmenter la netteté au niveau du pixel, dans ce contexte, est un gaspillage de temps et de cycles processeur.

docteur néga

Traite les négatifs de films numérisés.

Vous pouvez obtenir l'image d'un négatif à l'aide d'un scanner de film, ou en le photographiant contre une lumière blanche (par exemple une table lumineuse ou un écran d'ordinateur) ou un flash externe.

préparation

Si l'image du négatif a été obtenue à l'aide d'un appareil photo numérique, afin d'obtenir des couleurs précises dans l'image finale, vous devait alors considérer les points suivants :

Lorsque vous prenez la photo, ajustez l'exposition pour utiliser toute la plage dynamique du capteur de votre appareil photo -- c'est-à-dire « exposez à droite », de sorte que l'histogramme de votre appareil photo touche le côté droit mais sans surexposer l'image.

Assurez-vous que la balance des blancs configurée correspond à la source lumineuse utilisée pour éclairer le négatif. Vous pouvez prendre au préalable une photo de la source lumineuse sans négatif devant elle, et utiliser la fonction "depuis une zone d'image" du module balance des blancs pour obtenir un réglage de la balance des blancs. Ce réglage peut ensuite être transformé en style ou simplement collé sur les images de vos négatifs de film.

Appliquez la matrice couleur standard ou améliorée dans le module profil de couleur d'entrée.

Lorsque vous numérisez ou photographiez votre négatif de film, assurez-vous d'inclure une partie non exposée du film dans l'image capturée. Ceci est nécessaire pour définir le paramètre D min (voir ci-dessous). Si cela n'est pas possible (par exemple, si votre support de film masque les parties non exposées du film), vous pouvez prendre une autre image d'une partie non exposée du film, en mesurer le paramètre D min, puis utiliser la valeur obtenue pour le reste des images de ce film.

Lors du développement des négatifs de films numérisés ou photographiés, il est recommandé de désactiver tous les modules de mappage de tons tels que filmique rgb et courbe de base.

Le paramètre profil de travail dans le module profil de couleur d'entrée de darktable doit être linear RVB Rec2020 linéaire, ou un profil ICC représentant l'espace colorimétrique réel de votre émulsion de film. Quelques exemples de tels profils ICC peuvent être trouvés dans les messages de forum suivants :

https://discuss.pixls.us/t/any-interest-in-a-film-negative-feature-in-rt/12569/177

https://discuss.pixls.us/t/input-color-profile-to-use-for-negatives/20271/13

Remarque : si vous souhaitez utiliser l'égaliseur de ton avec docteur néga, vous devez placer l'égaliseur de ton après docteur néga dans le [pipeline]pixelpipe, car il n'est pas conçu pour fonctionner avec des négatifs.

contrôles du module

Il est fortement recommandé de définir les paramètres en suivant l'ordre dans lequel ils sont présentés dans l'interface graphique. Commencez par définir le type de film, puis parcourez chacun des onglets (film, corrections et impression) dans l'ordre, de haut en bas dans chaque onglet.

Lorsque vous utilisez la pipette de couleur, évitez d'inclure des poussières ou des rayures, ce qui pourrait fausser le résultat.

film

La première étape consiste à choisir "film couleur" ou "film noir & blanc" dans la liste déroulante film. Si vous sélectionnez "film noir & blanc", les curseurs relatifs à la couleur sont masqués.

onglet film

Cet onglet contient un certain nombre de paramètres de base. Si, après avoir ajusté ces paramètres, votre image n'est toujours pas tout à fait comme vous le souhaiteriez, vous pouvez effectuer d'autres ajustements dans l'onglet corrections. Ce sont des paramètres techniques et ont un objectif similaire à ceux de l'onglet scène du module filmique rgb, en ce sens qu'ils ajustent les points noir et blanc et définissent ainsi la plage dynamique du négatif.

couleur du film

Échantillonnez une zone de la base du film. C'est la zone juste à l'extérieur de l'image (une partie non exposée du film). Si vous travaillez avec des négatifs en noir et blanc, vous pouvez laisser la valeur par défaut (blanc). Si vous travaillez sur un film couleur, cliquez sur la pipette de couleur à droite de la barre colorée, ce qui crée un cadre de sélection couvrant environ 98% de votre image. Ensuite, régler ce cadre sur une zone de votre négatif qui ne contient que du film non exposé. Cela calcule automatiquement la(les) valeur(s) de D min. Il est probable qu'à ce stade votre image semble encore trop sombre, mais vous pourrez corriger cela plus tard.

D min

Si le film est réglé sur "film noir & blanc", ce paramètre indique la valeur minimale correspondant au film non exposé. Si le film est réglé sur "film couleur", ce contrôle comporte 3 valeurs distinctes, une pour chacun des canaux rouge, vert et bleu.

D max

Ce curseur représente la plage dynamique de votre film et définit efficacement le point blanc du film. Faire glisser ce curseur vers la gauche éclaircit le négatif. Le faire glisser vers la droite l'assombrit. Lorsque vous ajustez ce curseur manuellement, il est conseillé de surveiller de près votre histogramme pour vous assurer de ne pas écrêter les hautes lumières (si l'histogramme est poussé trop loin vers la droite). Si vous cliquez sur l'icône de la pipette de couleur (à droite), docteur néga calcule automatiquement cette valeur pour garantir une utilisation maximale de l'histogramme sans écrêtage. Pour utiliser la pipette de couleur, placer le rectangle uniquement les parties exposées du négatif. N'incluez pas la partie non exposée, car cela fausserait le résultat.

biais d'exposition du scan

Ce curseur vous permet de définir le point noir. C'est un réglage technique qui assure une origine correcte des valeurs RVB et un étalement de l'histogramme entre les valeurs [0, 1] pour la robustesse des opérations qui suivent. Le faire glisser vers la gauche éclaircit le négatif. Le faire glisser vers la droite l'assombrit. Lorsque vous ajustez ce curseur manuellement, c'est une bonne idée de surveiller de près votre histogramme pour vous assurer que vous ne noyez pas les ombres (si l'histogramme est poussé trop loin à gauche). Si vous cliquez sur la pipette de couleurs docteur néga calcule automatiquement le décalage requis. Pour utiliser la pipette de couleur, sélectionnez une région parmi les plus sombres ou sélectionnez l'image entière sans inclure de pellicule non exposée. Vérifiez que la partie gauche de l'histogramme ne soit pas tronquée.

corrections

Cet onglet contient des réglages qui vous permettent de corriger une dominante de couleur dans les ombres comme dans les hautes lumières.

Les paramètres de cet onglet ne devraient pas être nécessaires pour la plupart des négatifs bien conservés. Il est surtout utile pour les négatifs anciens et mal conservés avec une base de film détériorée qui introduit des dominantes de couleur indésirables. Notez que les réglages de dominante dans les ombres n'ont pas d'effet si le paramètre biais d'exposition du scan de l'onglet film est différent de zéro.

L'autre cas où ces corrections de dominante de couleur peuvent être nécessaires est si les propriétés de balance des blancs de la lumière utilisée pour numériser le négatif sont très différentes de celles de la source lumineuse sous laquelle l'appareil photo a pris la photo d'origine. Par exemple, si vous éclairez le négatif avec une lumière LED, mais que la photo d'origine a été prise à la lumière du jour, cela peut nécessiter des corrections de dominante de couleur supplémentaires.

dérive couleur des ombres

Ces trois curseurs vous permettent de corriger les dominantes de couleur dans les ombres en ajustant individuellement les canaux rouge, vert et bleu. Utilisez la pipette de couleur pour régler les curseurs automatiquement en sélectionnant une zone d'ombre gris neutre nécessitant une correction. Étant donné que ces réglages peuvent aussi affecter les hautes lumières, il est important de terminer le réglage des ombres avant de passer aux hautes lumières.

balance des blancs des hautes lumières

Ces trois curseurs permettent de corriger la balance des blancs dans les hautes lumières en ajustant individuellement les canaux rouge, vert et bleu. Utilisez la pipette de couleur pour régler les curseurs automatiquement en sélectionnant une zone de gris neutre qui n'est pas correctement équilibrée dans les hautes lumières.

onglet impression

Cet onglet contient des paramètres qui imitent l'effet tonal des papiers photochimiques qui auraient été utilisés pour créer l'image papier si vous n'étiez pas en train de développer la photo numériquement. Il s'agit de paramètres créatifs qui ont un objectif similaire aux paramètres de l'onglet look du module filmique rgb.

L'ajustement exposition, le noir (correction densité) et le grade (gamma) sont analogues aux paramètres pente, décalage et puissance du module balance des couleurs (qui à son tour est basé sur la norme ASC CDL). Ces paramètres définissent une courbe de tonalité créative qui traduit votre intention de contraste après l'inversion à la fin du module. L'équation régissant ce comportement pente/décalage/puissance est :

RVB_sortie = ( RVB_entrée × exposition + noir ) ᵍʳᵃᵈᵉ

noir (correction densité)

Pour ce réglage, utilisez la pipette de couleur et sélectionnez une région qui englobe uniquement une partie exposée du négatif de film. S'il y a une partie de film non exposée sur les bords de votre image, assurez-vous que cette zone est exclue du rectangle de sélection. Le noir du papier représente la densité du cristal aux halogénures d'argent le plus noir disponible sur le papier virtuel. En développement analogique, cette densité de noir entraîne toujours une luminance non nulle, mais le pipeline numérique s'attend à ce que le noir soit codé avec une valeur RVB nulle. Ce paramètre de curseur vous permet de remapper le noir du papier sur le noir du pipeline via un décalage. Utilisez la pipette de couleur pour sélectionner une région de l'image qui doit être mappée au noir dans l'image finale.

grade (gamma)

Ce réglage est votre contrôle du gamma (contraste), et sa valeur par défaut est 4. Si tout s'est bien passé, cette valeur (4) moins la valeur de D max (de l'onglet "film") devrait normalement vous donner une valeur comprise entre 2 et 3.

brillance (hautes lumières spéculaires)

Ce réglage est essentiellement un outil de compression des hautes lumières. Lorsque vous faites glisser ce curseur vers la gauche, vous voyez dans l'histogramme que les hautes lumières sont compressées (poussées à gauche). Ajustez cela de façon à ce que vos hautes lumières ne soient pas écrêtées dans l'histogramme. Vous pouvez également l'utiliser pour simuler l'impression d'une photo mate avec des hautes lumières à faible contraste.

ajustement exposition

Ce réglage offre une dernière possibilité de corriger tout écrêtage des hautes lumières. Si vous avez suivi attentivement toutes les instructions précédentes, vous ne devriez pas avoir besoin d'ajuster ce paramètre. Notez que vous pouvez augmenter l'exposition de l'impression tout en diminuant la brillance du papier, ce qui vous permet d'éclaircir les demi-tons sans perdre les hautes lumières. Vous pouvez utiliser la pipette de couleur pour sélectionner les hautes lumières les plus lumineuses ou sélectionner l'intégralité de l'image, sans y inclure de pellicule non exposée. Cela règle l'exposition pour que la partie la plus lumineuse de la région sélectionnée ne soit pas écrêtée. Vérifiez l'histogramme pour vous assurer que la partie droite de l'histogramme n'est pas écrêtée.

égaliseur de contraste

Ajuste le contraste de luminance et de chroma dans le domaine des ondelettes.

Ce module polyvalent peut être utilisé pour obtenir une variété d'effets, notamment le flou lumineux, la réduction du bruit, la clarté et l'amélioration du contraste local.

Il fonctionne dans le domaine ondelettes et ses paramètres peuvent être ajustés indépendamment pour chaque bande de fréquences. Le module fonctionne dans l'espace colorimétrique CIE LCh et est capable de traiter indépendamment la luminosité et la chromaticité.

Un certain nombre de préréglages sont fournis, ce qui devrait vous aider à comprendre les capacités du module.

contrôles du module

Le module égaliseur de contraste décompose l'image en différentes échelles de détails. Sur chaque échelle de détail, vous pouvez ajuster indépendamment les courbes de contraste et de réduction de bruit pour la clarté ("luma") et pour la chromaticité ("chroma", ou saturation des couleurs), ainsi qu'ajuster la prise en compte des contours ("contours") de la transformation en ondelettes . Les courbes de luminance, de chroma et de contours sont traitées dans des onglets séparés, et quelques exemples de leur utilisation sont donnés dans les sections suivantes.

Sous le graphiques courbes se trouve un curseur fusion, qui peut être utilisé pour ajuster la force de l'effet, et même pour inverser le graphique (avec des valeurs négatives). Tant que la souris survole le graphique, la courbe est affichée comme si le curseur fusion était réglé sur 1.0 pour permettre une édition plus facile. Lorsque vous éloignez la souris, le graphique est réajusté pour tenir compte du curseur fusion.

À l'arrière-plan de la courbe, vous pouvez voir des bandes claires et sombres alternées. Elles représentent les niveaux de détail qui sont visibles à votre échelle de zoom -- les détails à droite de ces bandes sont trop petits pour être vus. Les ajustements apportés aux points de contrôle dans les bandes peuvent produire un effet visible (selon la force de l'ajustement). Les ajustements en dehors des bandes n'en produisent pas. Effectuez un zoom avant pour voir plus de détails et ajuster les zones correspondantes de l'image.

Conseil : Si vous rencontrez des difficultés pour visualiser quelles parties de la courbe affecteront quels détails de l'image, vous pouvez mettre le [mode de fusion](../../darkroom/masking-and-blending/blend- modes.md) à "différence". Cela rendra l'image noire, sauf pour les zones où la sortie du module diffère de l'entrée. En élevant la courbe à l'un des points de contrôle, vous pourrez voir quels détails de l'image sont concernés par ce point.

onglet luma

L'onglet luminance vous permet de régler le contraste local de la luminance (luminosité) de l'image. Les ajustements sont représentés par une courbe blanche qui est au début une ligne horizontale au centre du graphique (indiquant qu'aucun changement ne sera effectué). Relevez ou abaissez cette courbe à son extrémité gauche pour augmenter ou diminuer le contraste local des détails grossiers de l'image. Effectuez les mêmes actions à son extrémité droite pour ajuster le contraste local des détails fins de l'image.

Lorsque vous passez le pointeur de la souris sur le graphique, un cercle blanc montre son rayon d'influence -- la taille de ce cercle peut être ajustée en faisant défiler avec la molette de la souris. Plus le cercle est grand, plus nombreux sont les points de contrôle affectés lorsque vous ajustez la courbe. Une région en surbrillance en arrière-plan montre à quoi ressemblerait la courbe si vous poussiez le point de contrôle actuellement survolé jusqu'en haut ou en bas du graphique - voir la capture d'écran ci-dessous pour des exemples de ces fonctionnalités. Pour plus d'informations, consultez la section ondelettes.

L'image suivante montre l'état par défaut du module d'égaliseur de contraste avant tout réglage :

Relever les deux points de contrôle à l'extrémité droite du graphique augmente la netteté des détails fins (l'œil et les plumes de l'oiseau) tout en laissant les détails plus grossiers (les rochers en arrière-plan) largement inchangés. L'exemple ci-dessous a été exagéré pour illustrer l'effet.

L'augmentation du contraste local peut amplifier le bruit de luminance dans l'image. Une seconde courbe située en bas du graphique peut être utilisée pour réduire le bruit aux échelles de détail sélectionnées. Relevez cette courbe (en cliquant juste au-dessus de l'un des triangles en bas du graphique et en faisant glisser la ligne vers le haut) pour réduire le bruit à l'échelle d'ondelettes donnée. Dans l'exemple ci-dessus, la courbe de réduction de bruit (sombre) a été augmentée à l'extrémité des détails fins du graphique.

onglet chroma

L'onglet chroma permet d'ajuster le contraste ou la saturation des couleurs aux échelles d'ondelettes sélectionnées. Par exemple :

Supposons que vous vouliez faire ressortir la couleur verte des anthères au bout de l'étamine. Les pétales roses des fleurs sont déjà assez saturés, mais en utilisant un égaliseur de contraste, vous pouvez augmenter sélectivement la saturation sur les détails des anthères sans affecter la saturation des pétales. En relevant le troisième point de contrôle en partant de la droite, vous pouvez cibler la saturation des anthères uniquement :

Comme dans l'onglet luminance, l'onglet chroma a également une courbe de réduction de bruit en bas du graphique. Cela peut être utilisé pour gérer le bruit de chroma à différentes échelles dans l'image. La réduction de bruit de chroma peut généralement être plus agressif sur les bases fréquences et a moins d'effet les hautes fréquences.

onglet contours

La transformation en ondelettes à trous de base a été améliorée dans l'égaliseur de contraste pour être "sensible aux contours", ce qui peut aider à réduire les inversions de gradient et les artefacts de halo que l'algorithme de base peut produire. L'onglet contours n'agit pas directement sur les contours d'une image ; il ajuste plutôt la fonction de prise en compte des contours de la transformée en ondelettes. Si vous n'avez pas ajusté les courbes de luminance ni de chroma, l'ajustement de la courbe de détection des contours n'aura aucun effet.

Pour voir les types d'artefacts que la courbe contours essaie de combattre, voici un exemple tiré de l'article original "Edge-Optimized À-Trous Wavelets for Local Contrast Enhancement with Robust Denoising" (Hanika, Damertz et Lensch 2011) :

Dans l'image de gauche, les bords de la courbe ont été réduits au minimum, réduisant efficacement la prise en compte des contours ce qui entraînent des halos. Dans l'image du milieu, les bords de la courbe ont été trop relevés, ce qui entraîne des inversions de gradient. Dans l'image de droite, les bords de la courbe ont été placés quelque part entre les deux extrêmes, ce qui donne des contours bien nets.

Généralement, la position centrale par défaut de la courbe est un bon point de départ, mais s'il y a des artefacts ennuyeux sur les contours, ce contrôle peut être utile pour les atténuer. Une certaine expérimentation est nécessaire.

égaliseur de ton

Assombrir/éclaircir en préservant le contraste local.

Lorsqu'il est utilisé avec filmique rgb, ce module remplace d'autres modules de mappage de tons tels que courbe de base, ombres et hautes lumières ou courbe de tonalité. Il fonctionne dans un espace RVB linéaire et utilise un masque défini par l'utilisateur pour guider les ajustements de dodge and burn, pour préserver le contraste local dans l'image.

Le schéma suivant décrit le fonctionnement de l'égaliseur de tons :

Crée un masque guidé monochrome qui divise l'image d'entrée en régions de luminosité similaire. Le masque résultant doit brouiller les détails fins de l'image afin que les pixels de chaque région soient tous traités de la même manière, en préservant le contraste local.

Ajustez les curseurs dans l'onglet simple ou le graphique de l'égaliseur dans l'onglet avancé pour modifier la luminosité de l'image sous-jacente, en fonction de la luminosité du masque. L'exposition de la zone de l'image sous le curseur de la souris peut être ajustée également en utilisant la molette (voir curseur indicateur/contrôle pour plus de détails).

Dans l'onglet simple, chaque curseur correspond à une seule zone de luminosité (IL) dans le masque, qui peut être augmentée ou diminuée pour ajuster l'exposition de l'image où la luminosité du masque correspond à cette zone. De même, dans l'onglet égaliseur, l'axe horizontal du graphique correspond aux niveaux de luminosité du masque, et l'axe vertical spécifie l'ajustement d'exposition requis aux pixels où le masque correspond à ce niveau de luminosité.

L'exposition de chaque pixel de l'image d'entrée est ajustée à l'aide du masque et du graphique de l'égaliseur. Pour chaque pixel, le module recherche la luminosité du masque à ce point, trouve la luminosité correspondante sur l'axe horizontal du graphique de l'égaliseur et augmente ou diminue l'exposition en conséquence (en utilisant l'axe vertical du graphique).

Il est important que le masque sépare l'image en régions de luminosité similaire et qu'une quantité appropriée de flou soit appliquée dans ces régions. Cela signifie que tous les pixels de chaque région verront leur exposition ajustée de la même manière, sans affecter négativement le contraste local. Examinez votre image au préalable pour identifier les régions que vous souhaitez assombrir/éclaircir, et utilisez les commandes de l'onglet masque pour vous assurer que ces zones sont raisonnablement séparées en tons dans le masque final. Cela permettra à ces régions d'être ajustées indépendamment.

contrôles du module

Les commandes du module égaliseur de ton sont réparties entre trois onglets.

afficher le masque d'exposition

Cliquez sur l'icône à droite de ce libellé pour afficher/masquer le masque guidé du module au dessus de l'image. Ce contrôle est disponible dans les trois onglets.

onglet simple

Cet onglet divise la luminosité du masque guidé en neuf zones (de --8 à 0 IL) et vous permet de modifier chaque zone indépendamment. Il s'agit d'une interface simplifiée qui est utilisée pour générer la même courbe de réglage de tonalité que celle affichée dans l'onglet avancé.

--8 IL ... 0 IL

Chaque curseur ajuste l'exposition de tous les pixels où le masque guidé a la luminosité donnée. Si l'histogramme du masque est uniformément réparti sur toute la plage tonale, les curseurs vers le haut affectent généralement les ombres, tandis que les curseurs vers le bas affectent généralement les hautes lumières. Vous pouvez vérifier la propagation de l'histogramme dans l'onglet avancé.

onglet avancé

Cet onglet vous permet de contrôler les mêmes niveaux d'intensité que dans l'onglet simple, bien qu'ici ils soient représentés sous forme de points de contrôle sur une courbe. Derrière la courbe se trouve un histogramme représentant les niveaux d'intensité du masque guidé (pas l'image sous-jacente). Si l'histogramme est trop étroit, cela signifie que votre masque n'a pas une bonne répartition des niveaux d'intensité, ce qui rend plus difficile le contrôle indépendant de la luminosité des différentes parties de votre image. Il est donc recommandé d'ajuster l'histogramme de manière à l'étendre sur toute la plage, en couvrant le plus de points de contrôle possible pour une flexibilité maximale. Vous pouvez ajuster le masque à l'aide des commandes de l'onglet masque.

Cliquez et glissez les points de contrôle sur la courbe pour ajuster la luminosité de tous les pixels où le masque a l'intensité correspondante. Si l'histogramme du masque est uniformément réparti sur toute la plage tonale, les points de contrôle à gauche affecteront généralement les ombres et les points de contrôle à droite affecteront généralement les hautes lumières. Le déplacement d'un seul point de contrôle affectera également les points de contrôle de chaque côté pour garantir que la courbe reste lisse. Ce comportement peut être ajusté à l'aide du contrôle lissage de la courbe.

lissage de courbe

Contrôle la façon dont la courbe est interpolée entre les points de contrôle. Déplacez le curseur vers la droite pour rendre les transitions entre les points de contrôle plus progressives, mais attention, dépasser 0,6 environ peut introduire une certaine instabilité (oscillations) dans la courbe en raison de contraintes mathématiques. Déplacez le curseur vers la gauche pour une courbe plus harmonieuse, mais sachez que cela peut entraîner des transitions tonales plus dures qui peuvent endommager le contraste local.

onglet masque

Cet onglet contient des commandes pour ajuster le masque guidé.

L'objectif du masque guidé est de séparer les zones avec différentes plages de tons afin qu'elles puissent être indépendamment éclaircies ou assombries par l'égaliseur de tonalité. Les filtres de masquage sont conçus pour permettre de préserver les bords nets entre ces zones, tout en brouillant les détails dans une plage de tons donnée, de sorte que la luminosité puisse être ajustée sans nuire au contraste local. Idéalement, l'histogramme du masque affiché dans l'onglet avancé doit être réparti sur tous les points de contrôle.

Pour éviter d'avoir à basculer entre les onglets avancé et masquage, une barre grise sous l'étiquette "post-traitement masque" affiche une représentation des 80 % du milieu de l'histogramme. En utilisant les commandes de cet onglet pour centrer et étaler cette barre grise, vous pouvez vous attendre à avoir un histogramme bien formé lorsque vous revenez à l'onglet "avancé". Si vous voyez de l'orange à chaque extrémité de la barre grise, cela signifie qu'une partie de l'histogramme est en dehors de la plage de 9 IL du masque et doit être ajustée davantage.

Lors de la configuration du masque guidé, vous devrez trouver un équilibre entre l'obtention d'un flou lisse dans les régions tonales (pour préserver le contraste local) et la préservation des limites entre ces régions. Quelques expérimentations seront nécessaires pour trouver les meilleurs réglages. Souvent, les commandes clés à ajuster sont les curseurs compensation exposition/contraste en bas du module.

Afficher le masque guidé lors de ces réglages vous aidera à comprendre ces commandes et à mieux juger de la qualité du masque.

estimateur de luminance

Choisit la méthode par laquelle la luminance d'un pixel sera estimée lors de son mappage à une valeur d'intensité de masque (par défaut norme euclidienne RVB).

préserver les détails

Choisit l'algorithme de lissage utilisé pour flouter le masque :

non : ne pas lisser le masque (l'effet est le même que l'utilisation de courbes de tons normales). Lorsque le module est utilisé pour compresser la plage dynamique, cette option peut provoquer une compression du contraste local. Cela peut être utile pour augmenter le contraste (local et global).

filtre guidé : utiliser l'algorithme de filtre guidé d'origine pour flouter le masque tout en essayant de préserver les bords. L'une des limitations de cet algorithme est que le filtre guidé est sensible à l'exposition, ce qui signifie que les ombres ont tendance à être plus floues que les hautes lumières. A noter que cette limitation peut parfois être un atout : si l'on veut beaucoup éclaircir les ombres, le filtre guidé peut apporter une très bonne conservation du contraste local.

filtre guidé moyen : utiliser cette option dans les cas où l'effet du filtre guidé est trop fort. Dans ce mode, une moyenne géométrique est prise entre la sortie de l'algorithme filtre guidé d'origine et la sortie donnée par l'option non.

eigf (par défaut) : le filtre guidé indépendant de l'exposition résout le problème du filtre guidé d'origine, en ce sens qu'il rend le degré de flou indépendant de l'exposition. Cela signifie que le degré de flou appliqué aux hautes lumières et aux zones d'ombre doit être à peu près le même. Cet algorithme amélioré est désormais l'option par défaut.

eigf moyen: cette option prend la moyenne géométrique entre le masque eigf et le masque généré par l'option non, et est utile dans les cas où le degré de flou dans le masque doit être atténué.

filtre de diffusion

Par défaut, cette valeur est à 1, ce qui signifie que l'algorithme de filtrage est exécuté une fois sur l'image d'entrée pour produire le masque flou monochrome.

Si vous augmentez ce nombre à 2, l'algorithme de filtrage sera exécuté une fois sur l'image d'entrée pour produire un masque intermédiaire, puis une deuxième fois sur le masque intermédiaire. En conséquence, le masque final sera plus flou que lors de l'utilisation d'une seule itération. Des valeurs progressivement plus élevées diffuseront encore plus le masque. Cependant, étant donné que l'algorithme de filtrage de masque est exécuté plusieurs fois, chaque itération augmentera le temps de traitement.

diamètre lissage

Ceci contrôle la quantité d'image environnante à prendre en compte lors du calcul du flou du masque à un point particulier, définie comme un pourcentage de la longueur du côté le plus long de l'image (par défaut 5%). Avec des valeurs plus faibles, la transition entre les zones plus sombres et plus claires du masque sera plus prononcée. Au fur et à mesure que la valeur augmente, les transitions deviennent plus douces. Pour le filtre guidé indépendant de l'exposition (eigf) par défaut, vous devez généralement utiliser des rayons de flou d'environ 1 à 10 %. Avec le filtre guidé d'origine, des rayons de flou d'environ 1 à 25 % donneront généralement de meilleurs résultats.

raffinement des bords

Des valeurs plus élevées forcent le masque à suivre de plus près les bords à contraste élevé. Des valeurs plus faibles donnent des dégradés plus doux, mais peuvent introduire des halos. Si nécessaire, l'adoucissement peut être réglé sur des valeurs allant jusqu'à 10 000.

post-traitement masque

Cette barre fournit une représentation de l'étendue courante de l'histogramme du masque. Il couvre les 80 % du milieu de l'histogramme, laissant tomber le premier et le dernier décile pour éviter que les valeurs aberrantes ne faussent trop l'indicateur. Des indicateurs orange à chaque extrémité signifient que l'histogramme dépasse les limites supérieure ou inférieure de sa plage de 9 IL.

quantification de masque

Appliquer un degré de postérisation au masque, de manière à ce qu'il tende à se centrer autour de quelques niveaux discrets. Dans certains cas, cela peut être utile pour séparer les zones de votre image en niveaux de masquage distincts.

compensation d'exposition masque

Ajuste l'histogramme du masque vers la gauche ou la droite. Si vous avez utilisé le module exposition pour régler la luminosité de l'image, vous devrez peut-être décaler ce réglage en utilisant ce curseur pour recentrer l'histogramme du masque. Cliquez sur l'icône de baguette à droite du curseur pour régler la compensation d'exposition de sorte que la moyenne de l'histogramme du masque coïncide avec le point de contrôle central --4IL. Le curseur peut ensuite être affiné selon les besoins.

compensation de contraste masque

Dilater (étaler) ou compresser l'histogramme du masque. L'icône de baguette à droite du curseur proposera un point de départ raisonnable, qui peut ensuite être affiné pour optimiser la diffusion de l'histogramme sous les points de contrôle de l'égaliseur de ton.

curseur indicateur/contrôle

Lorsque le module égaliseur de ton est activé et développé, vous pouvez déplacer le pointeur de la souris sur l'image d'aperçu pour afficher un curseur et des informations sur le pixel sous le pointeur. Lorsque ce curseur est affiché, la molette de la souris peut être utilisée pour éclaircir ou assombrir les zones de votre image qui correspondent au niveau d'intensité du masque à cet endroit. Cela fournit un moyen pratique d'éclaircir ou d'assombrir rapidement des parties spécifiques de l'image.

le réticule indique la position du pixel sous le curseur

l'étiquette donne l'intensité du masque guidé à ce point, en IL

le ton du cercle extérieur montre l'intensité du masque à ce point

si l'égaliseur de ton a des pixels éclaircis ou assombris correspondant à cette intensité de masque, l'amplitude du réglage est indiquée par un arc sur le côté gauche. Plus l'arc est long, plus le réglage de la luminosité est important,

s'il y a eu un réglage de l'exposition, la teinte du cercle intérieur montre l'éclaircissement ou l'assombrissement par rapport à l'intensité du masque à ce point (cercle gris extérieur). C'est-à-dire que si le pixel sous le réticule a été éclairci, le cercle intérieur sera d'une nuance de gris plus claire que le cercle extérieur ; si le pixel a été assombri, le cercle intérieur sera d'une nuance de gris plus foncée que le cercle extérieur.

préréglages

L'égaliseur de ton est livré avec plusieurs préréglages qui peuvent être utilisés pour compresser les ombres et les hautes lumières. Chacun se décline en deux variantes, utilisant soit le filtre guidé (gf) soit le filtre guidé indépendant de l'exposition (eigf). Les variantes utilisant le filtre guidé ont tendance à mieux préserver le contraste local dans les ombres que celles utilisant le filtre guidé indépendant de l'exposition, mais au prix d'une diminution du contraste local dans les hautes lumières. L'une ou l'autre de ces variantes peut conduire à de meilleurs résultats, selon l'image. Dans les deux cas, les préréglages préservent le gris moyen, vous ne devriez donc pas avoir besoin d'ajuster l'exposition globale après avoir activé l'égaliseur de ton.

exposition

Augmente ou diminue la luminosité globale de l'image.

Ce module a deux modes d'opération :

Manuel

Règle l'exposition manuellement, le niveau de noir et le seuil d'écrêtage

automatique (images RAW uniquement)

Analyse l'histogramme de l'image pour régler automatiquement l'exposition. darktable sélectionne automatiquement la compensation d'exposition requise pour déplacer le percentile sélectionné vers le niveau cible sélectionné (voir les définitions ci-dessous). Ce mode est particulièrement utile pour modifier automatiquement un grand nombre d'images afin d'avoir la même exposition. Un cas d'utilisation typique du mode automatique est le scintillement des photographies en accéléré.

contrôles du module

mode

Sélectionne le mode de fonctionnement (automatique/manuel).

compense l'exposition de l'appareil photo (mode manuel)

Compense automatiquement le biais d'exposition de l'appareil photo (fourni par les données Exif de l'image).

exposition (mode manuel)

Augmente (vers la droite) ou diminue (vers la gauche) la valeur d'exposition (IL).

seuil d'écrêtage (mode manuel)

Définit le pourcentage de valeurs lumineuses à écrêter dans le calcul de l'exposition et de la correction du niveau du noir. Utilisez la pipette de couleur pour échantillonner la partie de l'image à utiliser pour ce calcul.

centile (mode automatique)

Définit l'emplacement dans l'histogramme à utiliser pour la correction automatique de l'exposition. Un centile de 50 % indique une position dans l'histogramme où 50 % des valeurs de pixels sont au-dessus et 50 % des valeurs de pixels sont en dessous de cette exposition.

niveau cible (mode automatique)

Définit le niveau cible de la correction d'exposition automatique (IL) par rapport au point blanc de l'appareil photo.

correction du niveau du noir (modes manuel et automatique)

Ajuste le point de niveau de noir pour éliminer les valeurs RVB négatives.

Remarque : N'utilisez pas la correction du niveau du noir pour ajouter plus de densité dans les noirs, car cela peut supprimer les couleurs presque noires de la gamme en générant des valeurs RVB négatives. Cela peut causer des problèmes avec certains modules plus tard dans le pipeline. Au lieu de cela, utilisez une courbe de mappage des tons pour ajouter de la densité aux noirs. Par exemple, vous pouvez utiliser le curseur exposition relative du noir dans l'onglet scène du module filmique rvb ou établir un orteil plus profond dans la courbe de base module.

faible lumière

Simule la vision humaine par faible luminosité. Ce module peut également être utilisé pour effectuer une conversion jour-nuit.

L'idée est de calculer une image vision scotopique qui est perçue par les bâtonnets plutôt que les cônes des yeux sous une faible luminosité. La clarté scotopique est ensuite mélangée à la valeur photopique (pixel d'image couleur régulier) à l'aide d'une fonction de mélange. Ce module peut également simuler l'effet Purkinje en ajoutant un peu de bleu aux parties sombres de l'image.

Ce module est livré avec plusieurs préréglages, qui peuvent être utilisés pour avoir une meilleure idée de la façon dont le module fonctionne.

contrôles du module

courbe

L'axe horizontal représente la clarté des pixels de sombre (gauche) à clair (droite). L'axe vertical représente le type de vision de la vision nocturne (en bas) à la vision diurne (en haut).

bleu

Contrôle la touche de bleu dans les ombres (effet Purkinje).

filigrane

Effectue le rendu d'une incrustation d'une image vectorisée sur votre image. Les filigranes sont des documents SVG standard et peuvent être crées en utilisant Inkscape.

Vous pouvez également utiliser des images bitmap (PNG).

Le processeur SVG de darktable peut également substituer des chaînes de caractères dans un document SVG, permettant d'inclure des informations associées à l'image dans le filigrane.

Les filigranes conçus par l'utilisateur doivent être placés dans le répertoire $HOME/.config/darktable/watermarks. Une fois en place, utilisez le bouton de rechargement pour mettre à jour la liste des filigranes disponibles.

Ce qui suit est la liste de variables texte qui sont prises en charge pour la substitution dans un document SVG.

En plus de cette liste, vous pouvez aussi utiliser les variables texte définies dans la section variables.

$(DARKTABLE.NAME)             Le nom de l'application
$(DARKTABLE.VERSION)          La version de darktable
$(WATERMARK_TEXT)             Un court texte libre (max. 63 caractères)
$(WATERMARK_COLOR)            La couleur à utiliser pour $WATERMARK_TEXT
$(WATERMARK_FONT_FAMILY)      La police à utiliser pour $WATERMARK_TEXT
$(WATERMARK_FONT_STYLE)       Le style de la police (normal, oblique, italique)
$(WATERMARK_FONT_WEIGHT)      Le poids de la police (gras)
$(IMAGE.ID)                   L'identifiant de l'image dans la bibliothèque
$(IMAGE.FILENAME)             Le nom du fichier image
$(IMAGE.BASENAME)             Le nom de base du fichier image
$(IMAGE.EXIF)                 La chaîne de caractères Exif de l'image
$(EXIF.DATE)                  La date de l'image
$(EXIF.DATE.SECOND)           Secondes des Données Exif de l'image
$(EXIF.DATE.MINUTE)           Minutes des Données Exif de l'image
$(EXIF.DATE.HOUR)             Heures des Données Exif de l'image (24h)
$(EXIF.DATE.HOUR_AMPM)        Heures des Données Exif de l'image (12h, AM/PM)
$(EXIF.DATE.DAY)              Jour des Données Exif de l'image(01 .. 31)
$(EXIF.DATE.MONTH)            Mois des Données Exif de l'image (01 .. 12)
$(EXIF.DATE.SHORT_MONTH)      Mois localisé abrégé des Données Exif de l'image (Jan, Fév, .. Déc)
$(EXIF.DATE.LONG_MONTH)       Mois localisé des Données Exif de l'image (Janvier, Février, .. Décembre)
$(EXIF.DATE.SHORT_YEAR)       Année abrégée à partir des données Exif de l'image (2013 est "13")
$(EXIF.DATE.LONG_YEAR)        Année complète à partir des données Exif de l'image
$(DATE)                       Date système
$(DATE.SECOND)                Secondes de l'heure système
$(DATE.MINUTE)                Minutes de l'heure système
$(DATE.HOUR)                  Heure système (24h)
$(DATE.HOUR_AMPM)             Heure système (12, AP/PM)
$(DATE.DAY)                   Jour système (01 .. 31)
$(DATE.MONTH)                 Mois système (01 .. 12)
$(DATE.SHORT_MONTH)           Mois localisé abrégé système (Jan, Fév, .. Déc)
$(DATE.LONG_MONTH)            Mois localisé système(Janvier, Février, .. Décembre)
$(DATE.SHORT_YEAR)            Année système abrégée
$(DATE.LONG_YEAR)             Année système
$(EXIF.MAKER)                 Le fabricant de l'appareil photo
$(EXIF.MODEL)                 Le modèle d'appareil photo
$(EXIF.LENS)                  L'objectif utilisé
$(Xmp.dc.creator)             Le créateur
$(Xmp.dc.publisher)           Le diffuseur
$(Xmp.dc.title)               Le titre
$(Xmp.dc.description)         La description de l'image
                              Certains appareils photo l'utilisent pour stocker le texte fourni par l'utilisateur à la prise de vue (également appelé « Exif.Photo.UserComment »).
$(Xmp.dc.rights)              Les droits de l'image
$(GPS.LATITUDE)               La latitude (N/S 0 .. 90)
$(GPS.LONGITUDE)              La longitude (E/W 0 .. 180)
$(GPS.ELEVATION)              L'élévation (mètres)
$(GPS.LOCATION)               Les trois coordonnées (latitude, longitude, altitude)

contrôles du module

fichier

Choisit le filigrane à appliquer. Utilisez le bouton de rechargement pour mettre à jour la liste afin d'inclure les derniers filigranes ajoutés. L'extension du fichier (png/svg) est indiquée entre parenthèses.

texte

Un champ de texte libre dans lequel vous pouvez saisir jusqu'à 63 caractères à placer à l'endroit défini par le filigrane. Un exemple est fourni sous la forme simple-text.svg.

couleur

La couleur du texte. Cliquez sur le champ coloré pour ouvrir une boîte de dialogue de sélection de couleurs qui vous propose un choix de couleurs couramment utilisées ou vous permet de définir une couleur dans l'espace colorimétrique RVB.

police

La police à utiliser (par défaut "DejaVu Sans Book"). Cliquez sur le champ pour ouvrir une boîte de dialogue affichant les polices disponibles sur votre système. Les polices peuvent être recherchées par nom et un aperçu est affiché à côté du nom de la police. Vous pouvez entrer votre propre texte.

opacité

L'opacité du filigrane.

échelle

L'échelle du filigrane, par rapport à l'option sélectionnée dans le paramètre "échelle sur".

rotation

La rotation du filigrane.

échelle sur

La référence pour le paramètre d'échelle. La valeur par défaut "image" met le filigrane à l'échelle par rapport à la taille horizontale de l'image. Vous pouvez également mettre le filigrane à l'échelle par rapport au "grand côté" ou au "petit côté".

alignement

Utilisez ces contrôles pour aligner le filigrane sur l'un des bords ou au centre de l'image.

décalage x

Décalage, indépendant des pixels, relatif à l'alignement choisi, sur l'axe des x.

décalage y

Décalage, indépendant des pixels, relatif à l'alignement choisi, sur l'axe des y.

filmique rvb

Remappe la gamme tonale d'une image en reproduisant la réponse tonale et colorée d'un film classique.

Ce module peut être utilisé soit pour élargir soit pour contracter la plage dynamique d'une scène pour rentrer dans la plage dynamique de l'affichage. Il protège les couleurs et le contraste dans les tons moyens, récupère les ombres et comprime les hautes lumières très brillantes et les ombres très sombres. Les hautes lumières auront besoin d'une attention particulière quand des détails doivent être préservés (comme des nuages).

Ce module est dérivé d'un autre module du même nom dans le modeleur 3D Blender by T. J. Sobotka. Bien qu'il soit principalement prévu pour récupérer les images à haute plage dynamique à partir des données brutes de capteur, il peut être utilisé pour toute image à la place du module courbe de base. La vidéo suivante (en anglais, par le développeur du module) fournit une introduction utile : filmic rgb : remap any dynamic range in darktable 3.

filmique rvb est le successeur du module filmique de darktable 2.6. Bien que les principes de base n'aient pas beaucoup changé, les réglages par défaut et leurs hypothèses de base ne sont plus exactement les mêmes, de sortie que les utilisateurs de la version précédente ne devraient pas attendre une traduction 1:1 de leur flux de travail avec la nouvelle version.

Note : Malgré l'apparence technique de ce module, la meilleure façon de l'ajuster est d'évaluer la qualité du résultat visuel. Ne réfléchissez pas trop aux nombres qui sont présentés dans l'interface pour quantifier la force des effets.

prérequis

Pour obtenir le meilleur de ce module, vos images ont besoin d'un minimum de préparation :

capture (exposer à droite)

À la prise de vue, dans l'appareil photo, il est recommandé d'utiliser une technique connue sous le nom "d'exposition à droite" (ETTR, en anglais). Ceci signifie exposer la capture de sorte que l'image soit la plus lumineuse possible sans pour autant écrêter les hautes lumières. La technique est appelée "exposition à droite" car l'histogramme sur l'appareil photo devrait tout juste toucher le bord droit du graphique sans montrer de pic directement sur le bord (qui indiquerait un écrêtage). Cette technique assure que vous tirez le maximum de la plage dynamique du capteur de votre appareil.

Le mode par défaut du posemètre de l'appareil photo va normalement exposer l'image de sorte que la luminosité moyenne dans l'image tende vers un gris moyen. Parfois, pour des scènes dominées par des tons clairs, l'appareil va sous-exposer l'image pour forcer ces tons clairs à converger vers le gris moyen. Pour des scènes dominées par des tons sombres, il peut sur-exposer l'image et finir par écrêter les hautes lumières. Dans ce type de cas, vous pouvez utiliser la compensation d'exposition de votre appareil pour augmenter au diminuer l'exposition -- le module exposition de darktable peut automatiquement tenir compte de cette compensation en traitant l'image.

Dans certains cas (par exemple, des lumières spéculaires qui se réfléchissent sur des objets brillants), il peut être acceptable d'avoir un peu d'écrêtage, mais prenez en compte que tout donnée écrêtée dans votre image est irrémédiablement perdue. Là où les données ont été écrêtées, filmique rvb propose une "reconstruction des hautes lumières" qui aide à mitiger ce problème et à fondre ces régions dans le reste de l'image. Les réglages des cette fonctionnalité sont dans l'onglet reconstruire. Certains appareils photo propose un mode de posemètre "priorité hautes lumières" qui peut vous aider à maximiser l'exposition tout en protégeant les hautes lumières, et beaucoup offrent une fonction "zebras" ou clignotement dans la visée écran pour alerter le photographe que certaines parties de l'image sont écrêtées.

ajuster pour les tons moyens

Dans le module exposition, ajustez l'exposition jusqu'à ce que les tons moyens sont assez clairs. Ne vous préoccupez pas de perdre les hautes lumières à cette étape -- elles seront récupérées lors du traitement par filmique. Cependant, il est important d'éviter les pixels ayant des valeurs négatives dans les zones noires, autrement les calculs réalisés par filmique rvb peuvent produire des résultats imprévisibles. Pour certains modèles de caméras (principalement Canon), rawspeed (la librairie de décodage de darktable) peut définir un niveau de noir exagéré, résultant en des noirs bouchés et des pixels négatifs. Dans ce cas, éclaircissez les noirs en réglant une valeur de compensation du niveau de noir négative dans le module exposition.

balance des blancs, débruitage, dématriçage

Si vous planifiez utiliser les réglages automatisés de filmique rvb, utilisez le module balance des blancs pour corriger toute déviation de couleur et obtenir des couleurs neutres. Dans les espaces de couleur RVB, la luminance et la chrominance sont liés, et la détection de luminance de filmique rvb repose sur une mesure précise des deux. Si votre image est très bruitée, ajoutez une étape initiale de débruitage pour améliorer la lecture des noirs, et utilisez un algorithme de dématriçage de haute qualité. Vous n'avez pas à vous soucier du bruit si vous planifiez régler filmique à la main, sans utiliser les optimiseurs automatiques.

désactiver les modules de mappage tonal

Si vous prévoyez utiliser l'un des modes de préservation de chrominance de filmique rvb, évitez d'utiliser la courbe de base et les divers modules de mappage de tonalités. Ceci peut produire des virages de couleur imprévisibles qui rendraient la préservation de chrominance sans objet. Aucun de ces modules n'est requis en utilisant filmique rvb.

utilisation

Le module filmique rvb est conçu pour mapper la plage dynamique de la scène photographiée (image RAW) vers la plage dynamique du moniteur.

Ce mappage est défini en trois étapes, chacune traitée dans un onglet séparé dans l'interface.

L'onglet scène contient les paramètres "entrée" de la scène, définissant ce qui constitue le blanc et le noir dans la scène photographiée.

L'onglet reconstruire offre les outils pour gérer les hautes lumières brûlées.

L'onglet look contient l'intention artistique du traitement appliqué aux paramètres d'entrée (tels que définis dans l'onglet scène). Cette partie du module applique un courbe paramétrique en "S" pour améliorer le contraste des tons moyens et recaler la valeur du gris sur le gris moyen du moniteur. C'est similaire à ce que font les modules courbe de base et courbe des tonalités. La ligne directrice générale est ici d'augmenter la latitude autant que possible sans couper les extrêmes de la courbe.

L'onglet affichage définit les réglages de sortie requis pour mapper l'image transformée vers l'écran. Dans les cas typiques d'utilisation, les paramètres dans cet onglet ont rarement besoin d'être ajustés.

L'onglet options inclut quelques paramètres et réglages avancés optionnels

filmique rvb tend à compresser le contraste local, ainsi, après avoir fini d'y ajuster les réglages, vous voudrez peut-être les compenser en utilisant le module contraste local. Il se peut aussi que vous vouliez augmenter la saturation dans le module balance couleur rvb, et peut-être ajuster plus précisément les tons en utilisant égaliseur de ton.

Les étendues des curseurs de filmique rvb sont limitées au valeurs typiques et sécuritaires, mais vous pouvez entrer des valeurs hors limites en faisant un clic doit puis en saisissant les valeurs au clavier.

Note : filmique rvb ne peut pas définir les réglages entièrement neutres (résultat en une « non-opération ») -- dès que le module est activé, l'image est toujours au moins légèrement affectée. Vous pouvez en revanche arriver proche de réglages neutres avec les paramètres suivants :

dans l'onglet look, réglez le contraste à 1,0, la latitude à 99 % et la saturation des tons moyens à 0 %,

dans l'onglet options, réglez le contraste des ombres et des hautes lumières à doux.

Dans cette configuration, filmique va seulement appliquer un mappage de tonalités logarithmique dans les limites définies à l'onglet scène.

affichage graphique

L'affichage graphique en haut du module filmique rvb offre plusieurs vues pour vous aider à comprendre ses fonctionnalités. Vous pouvez parcourir ces vues en utilisant l'icône icône-vue à droite de l'affichage graphique. Vous pouvez également activer et désactiver les étiquettes sur les axes à l'aide de l'icône icône-légende .

Les vues suivantes sont disponibles :

look uniquement

Il s'agit de la vue par défaut. La courbe principale claire montre comme la plage dynamique de la scène (en IL) est compressée dans la plage de sortie relative à l'affichage. Le point orange montre le point gris moyen, les points blancs de chaque côté délimitent la plage latitude et la partie orange de la courbe en bas indique un problème de dépassement avec la spline (l'onglet look a quelques contrôles pour y faire face). La courbe la plus sombre montre comment la saturation des couleurs diminue dans les ombres et les hautes lumières extrêmes.

look + mappage (linéaire)

Cette vue montre le mappage des valeurs d'entrée [0, 1] vers les valeurs de sortie dans l'espace linéaire. Elle montre aussi le mappage de la plage dynamique et la fonction de transfert de sortie. Notez que dans un flux de travail relatif à la scène, les valeurs d'entrée sont autorisées à dépasser 1. Cependant le graphique n'affiche que les valeurs d'entrée/sortie dans l'intervalle [0, 1] afin de rendre la forme du graphique comparable à celle obtenue par d'autres outils de mappage de courbe de tonalité tels que courbe de base ou courbe des tonalités. La valeur réelle du point blanc de la scène est indiquée entre parenthèses sur l'axe X (exprimée en pourcentage d'une valeur d'entrée égale à 1).

look + mappage (log)

Identique à la vue précédente, mais tracée avec une échelle logarithmique.

mappage plage dynamique

Cette vue est inspirée du Zone System d'Ansel Adams, montrant comment les zones de la scène en entrée (IL) sont mappées vers les zones en sortie. Le gris moyen de la scène est toujours mappé à 18% dans l'espace de sortie (linéaire). La vue montre aussi comment les plages de tons aux extrêmes de la plage d'exposition de la scène sont compressées en un plus petit nombre de zones dans l'espace d'affichage, laissant ainsi plus de place aux demi-tons répartis sur les zones restantes. La plage latitude est représentée par la partie grise plus foncée au milieu.

Remarque : Lorsque certains paramètres sont trop extrêmes, entraînant une courbe irréalisable, filmique rvb les assainit en interne. Cela est illustré de deux manières différentes sur les vues look :

Un point devenant rouge indique que la partie linéaire de la courbe est poussée trop loin vers le haut ou le bas. Dans l'onglet look, réduisez la latitude ou recentrez la partie linéaire à l'aide du paramètre balance ↔ hautes lumières.

Un point devenant un demi-cercle indique que le contraste est trop faible compte tenu de la plage dynamique de l'image. Augmentez le contraste dans l'onglet look ou la échelle de la plage dynamique dans l'onglet scène.

contrôles du module

scène

Les contrôles de l'onglet scène sont similaires dans leur principe à ceux du module niveaux (noir, gris, blanc). La différence est que le module niveaux suppose des valeurs de pixels relatives à l'affichage (entre 0 et 100 %), alors que le module filmique vous permet de travailler avec des pixels relatifs à la scène (entre --infinity IL et +infinity IL), ce qui contraint à l'utilisation d'une interface différente.

luminance gris moyen (masquée par défaut)

Ce paramètre vous permet de décider quelle luminance dans la scène doit être considérée comme le gris moyen de référence (qui sera remappé à 18% à l'affichage). Utilisez la pipette de couleur pour lire la luminance moyenne de la zone dessinée. Si vous avez une photographie d'une carte grise ou d'un nuancier (nuancier IT8 ou colorchecker) prise dans les conditions d'éclairage de la scène, la pipette de couleur grise peut être utilisée pour échantillonner rapidement la luminance de la tache grise sur cette image. Dans d'autres situations, la pipette de couleur peut être utilisée pour échantillonner la luminance moyenne du sujet.

Cela a un effet sur l'image qui est analogue à une correction de luminosité. Les valeurs proches de 100 % ne compressent pas les hautes lumières mais ne récupèrent pas les ombres. Des valeurs proches de 0% récupèrent considérablement les ombres mais compressent les hautes lumières plus durement et entraînent des pertes de contraste local.

Lors de la modification de la luminance du gris moyen, les expositions du blanc et du noir sont automatiquement ajustées en conséquence, pour éviter l'écrêtage de la plage dynamique et pour vous aider à définir le bon paramètre plus rapidement. Si vous n'êtes pas satisfait du réglage automatique effectué par le curseur gris, vous pourrez corriger les paramètres d'exposition du blanc et du noir par la suite.

Remarque : Il n'est pas conseillé d'utiliser ce contrôle pour définir le gris moyen, il est donc désormais masqué par défaut. Vous devriez plutôt utiliser le module exposition pour définir le niveau de gris moyen (voir utilisation, ci-dessus). Cependant, si vous souhaitez rendre ce curseur visible, vous pouvez l'activer avec la case à cocher utiliser un gris moyen spécifique dans l'onglet options.

exposition relative du blanc

Le nombre de stops (IL) entre la luminance du gris moyen de la scène et la luminance maximale de la scène à remapper vers le blanc de l'affichage. Il s'agit de la limite droite de la plage dynamique de luminance de la scène qui sera représentée à l'affichage -- n'importe quoi de plus clair sur la scène que cette valeur sera écrêté et sortira en blanc pur à l'affichage. La pipette de couleur lit la luminance maximale à l'intérieur de la zone dessinée, suppose qu'il s'agit d'un blanc pur, et règle l'exposition du blanc de manière à remapper le maximum vers une luminance de 100 %.

exposition relative du noir

Le nombre de stops (IL) entre la luminance du gris moyen de la scène et la luminance de la scène à remapper vers le noir de l'affichage (densité maximale). Il s'agit de la limite gauche de la plage dynamique de luminance de la scène qui sera représentée à l'affichage -- n'importe quoi de plus sombre dans la scène sera représenté en noir pur à l'affichage. La pipette de couleur lit le minimum de luminance à l'intérieur de la zone dessinée, suppose que c'est celle d'un noir pur, et règle le paramètre d'exposition du noir pour le remapper vers une luminance de 0 %. La mesure du minimum de luminance par la pipette de couleur, quand il est proche de zéro, ne permet pas de déterminer si le minimum détecté est un noir pur (donnée réelle) ou simplement du bruit. Cela fonctionne mieux sur des images à bas ISO et des méthodes de dématriçage de haute qualité. Quand la pipette de couleur place l'exposition du noir à -16 IL, c'est un signe que la mesure a échoué et que vous devrez l'ajuster à la main.

L'exposition relative du noir vous permet de choisir jusqu'où vous souhaitez récupérer les basses lumières.

mise à l'échelle de la plage dynamique et réglage automatique

La pipette de couleur à réglage automatique combine les pipettes de couleur ci-dessus et vous permet de définir simultanément les expositions du blanc pur et du noir pur, en utilisant le maximum de la région dessinée pour le blanc et le minimum pour le noir. Cela donne de bons résultats en photographie de paysage, mais échoue généralement pour les portraits et les scènes d'intérieur.

Lorsque ni un vrai blanc pur, ni un vrai noir pur ne sont disponibles dans la scène, les valeurs RVB maximales et minimales lues dans l'image ne sont plus des hypothèses valides. La mise à l'échelle de la plage dynamique réduit ou agrandit symétriquement la plage dynamique détectée et les paramètres actuels. Cela fonctionne avec les deux pipettes de couleur et ajuste les valeurs actuelles des expositions relatives du blanc et du noir.

Remarque : il n'y a pas de relation directe entre la plage dynamique du capteur de votre boîtier (à trouver dans les mesures DxoMark.com ou PhotonsToPhotos.org) et la plage dynamique dans filmique dont les extrémités sont noir pur et blanc pur exprimées en IL. Beaucoup de choses se produisent avant filmique dans le pipeline graphique (par exemple un décalage du noir RAW qui pourrait mapper le noir à 0) de sorte que filmique voie dans son entrée une plage dynamique qui peut théoriquement être infinie. Cela concerne uniquement la manipulation de l'encodage des pixels dans le logiciel, et non les capacités réelles du capteur.

Dans le module exposition, le flux de travail relatif à la scène force une correction du niveau du noir à --0.0002, ce qui garantit que la plupart du temps, la plage dynamique vue par l'entrée de filmique est d'environ 12,3 IL. Diminuez encore plus cette valeur si le réglage de l'exposition relative du noir dans filmique à --16 IL ne parvient pas à récupérer les noirs.

reconstruire

Cet onglet fournit des contrôles qui fusionnent les transitions entre les zones non écrêtées et les zones écrêtées et qui peuvent également aider à reconstruire les couleurs à partir des pixels adjacents. Il est conçu pour gérer les projecteurs impossibles à décrocher lors de la prise de vue (comme les ampoules nues ou le disque solaire dans le champ de l'appareil) et il vise à diffuser leurs bords comme le ferait un film. Il n'est pas conçu pour récupérer de grandes zones de pixels tronqués ou des parties manquantes de l'image.

Il peut parfois être utile de désactiver le module reconstruire hautes lumières afin de fournir des données supplémentaires à l'algorithme de reconstruction (reconstruire hautes lumières écrête les données hautes lumières par défaut). Vous devez noter que cela peut conduire à des reflets magenta, qui devront être gérés avec le curseur détails gris <-> colorés.

Tout d'abord, un masque doit être mis en place pour identifier les parties de l'image qui seront affectées par la reconstruction des hautes lumières. Il y a ensuite quelques contrôles supplémentaires pour affiner certains des compromis faits par l'algorithme de reconstruction.

hautes lumières tronquées

Ces contrôles vous permettent de choisir quelles zones de l'image sont impactées par les algorithmes de reconstruction des hautes lumières.

seuil

Tout pixel plus lumineux que ce seuil sera affecté par l'algorithme de reconstruction. Les unités sont en IL, par rapport au point blanc défini dans l'onglet scène. Par défaut, ce contrôle est défini sur +3 IL, ce qui signifie que les pixels doivent être au moins +3 IL plus lumineux que le point blanc défini dans l'onglet scène pour que la reconstruction des hautes lumières ait un effet. En pratique, cela signifie que la reconstruction des hautes lumières est effectivement désactivée par défaut (pour des raisons de performances -- elle ne doit être activée que lorsque cela est nécessaire). Par conséquent, pour utiliser la fonction reconstruire hautes lumières, cliquez d'abord sur l'icône afficher masque de reconstruction pour afficher le masque, et abaissez ce seuil jusqu'à ce que les zones de surbrillance que vous souhaitez reconstruire soient sélectionnées en blanc par le masque. Il peut être utile d'examiner d'abord l'image à l'aide de l'avertissement de surexposition raw pour vous montrer quels pixels dans le fichier RAW ont été écrêtés, et si ces pixels sont écrêtés sur un seul canal RVB ou sur tous.

transition

Utilisez ce contrôle pour adoucir la transition entre les pixels écrêtés et valides. Déplacer ce contrôle vers la droite augmentera la quantité de flou dans le masque, de sorte que la transition entre les zones écrêtées et non écrêtées soit plus douce. Cela permet une fusion plus fluide entre ces régions. Déplacer ce contrôle vers la gauche réduira le flou dans le masque, rendant la transition dans le masque beaucoup plus nette et réduisant ainsi la quantité de flou entre les zones écrêtées et non écrêtées.

afficher masque de reconstruction

Cliquez sur l'icône à droite de cette étiquette pour basculer l'affichage du masque de reconstruction des hautes lumière. Il est recommandé d'activer cette fonction tout en ajustant les contrôles ci-dessus.

répartition

Ces contrôles vous permettent d'équilibrer les compromis entre les différents algorithmes de reconstruction.

structure ↔ texture

Utilisez ce curseur pour contrôler si l'algorithme de reconstruction doit privilégier la peinture dans un dégradé de couleurs lisse (structure), ou essayer de reconstruire la texture à l'aide de détails précis extraits de données de pixels non écrêtées (texture). Par défaut, le contrôle est au milieu à 0%, ce qui ne privilégie aucune des deux stratégies. Si vous avez beaucoup de zones où les trois canaux sont écrêtés, il n'y a pas de détail de texture disponible à reconstruire, il est donc préférable de déplacer le curseur vers la gauche pour favoriser la reconstruction des couleurs. Si vous avez beaucoup de zones où seulement un ou deux canaux sont écrêtés, il peut y avoir des détails de texture dans le ou les canaux non écrêtés, et déplacer le curseur vers la droite mettra davantage l'accent sur la tentative de reconstruction de la texture à l'aide de ces données non écrêtées .

rayonnement ↔ reconstruction

Utilisez ce curseur pour contrôler si l'algorithme doit essayer de reconstruire des détails nets dans les zones écrêtées (reconstruire), ou s'il doit appliquer un flou qui se rapproche de l'effet flamboyant que vous obtenez avec un film traditionnel (bloom). Par défaut, ce curseur est défini sur 100 %, ce qui essaie de maximiser la netteté des détails dans les zones écrêtées. Déplacez ce curseur vers la gauche si vous souhaitez introduire plus de flou dans ces zones. Comme effet secondaire, l'introduction de plus de flou aura généralement tendance à assombrir les hautes lumières, ce qui peut conduire à une reconstruction plus colorée.

détails gris ↔ colorés

Utilisez ce curseur pour contrôler si l'algorithme doit favoriser la récupération des hautes lumières monochromatiques (gris) ou la récupération des détails colorés. Déplacez le curseur vers la droite si vous souhaitez plus de couleur dans les hautes lumières. Déplacez-le vers la gauche si vous souhaitez réduire la saturation des hautes lumières. Il peut être utile de réduire leur saturation si vous commencer à voir des couleurs magenta ou hors gamut.

look

Lorsque vous travaillez sur l'onglet look, il est recommandé de surveiller la spline de la courbe en S sur le graphique look uniquement. Cette courbe part des niveaux de noir de la scène/de l'affichage en bas à gauche du graphique et devrait augmenter progressivement jusqu'aux niveaux de blanc de la scène/de l'affichage en haut à droite. Parfois, si les contraintes sur la courbe en S sont trop serrées, les splines dans les zones d'ombre et/ou de hautes lumières peuvent « dépasser » les limites de l'affichage, et un avertissement orange s'affiche sur ces parties de la spline.

Si vous voyez l'indicateur d'avertissement orange à chaque extrémité de la courbe en S, des actions correctives doivent être effectuées pour ramener la courbe en S à une courbe lisse et monotone croissante. Cela peut impliquer :

réduire la latitude et/ou le contraste,

ajuster le curseur ombres/hautes lumières pour décaler la latitude et laisser plus de place à la spline,

s'assurer que les curseurs d'exposition relative du noir et du blanc, relatifs à la scène, de l'onglet scène ont été correctement réglés pour les caractéristiques de la scène,

dans l'onglet options, définir contraste hautes lumières ou contraste des ombres ou les deux à dur ou à sûr.

Si le paramètre luminance du noir cible dans l'onglet affichage a une valeur différente de zéro, il peut également être difficile pour filmique rvb de trouver une spline monotone lisse. Réduire cette valeur peut aider à assouplir les contraintes. Voir la section affichage pour comprendre ce que cela implique.

contraste

La courbe en S de filmique est créée en calculant la position des nœuds virtuels à partir des paramètres du module et en les interpolant. Ceci est similaire au fonctionnement du module courbe des tonalités, mais ici, les nœuds ne peuvent pas être déplacés manuellement. La courbe est divisée en trois parties. La partie médiane est un segment de droite. Les deux parties extrêmes se raccordent de façon lisse (sans pointe) à la partie médiane. Les abscisses de la courbe en S couvrent toute la plage d'exposition.

Le curseur contraste contrôle la pente de la partie médiane de la courbe, comme illustré dans l'affichage graphique. Plus la plage dynamique est grande, plus le contraste doit être élevé, afin de préserver une image d'aspect naturel. Ce paramètre affecte principalement les tons moyens. Notez que le contraste global a un impact sur la netteté perçue de l'image -- une image à faible contraste semblera floue même si elle est optiquement nette au sens de la Fonction de transfert optique (OTF).

Le réglage du contraste sur 1 désactive presque complètement la courbe en S, bien qu'il y ait un très petit effet résiduel des splines dans les hautes lumières et les ombres.

dureté (auparavant fonction du facteur de puissance cible)

Connu sous le nom de curseur fonction de facteur de puissance cible dans les anciennes versions de filmique rvb, ce curseur est masqué par défaut et est ajusté automatiquement en fonction des valeurs de l'onglet scène. Pour rendre ce curseur visible, vous devez décocher ajustement automatique de la dureté dans l'onglet options.

Ce paramètre est la fonction de puissance appliquée à la fonction de transfert de sortie, et il est souvent appelé à tort le gamma (ce qui peut signifier trop de choses dans les applications d'imagerie, nous devrions donc arrêter d'utiliser ce terme). Il est utilisé pour augmenter ou compresser les tons moyens pour tenir compte des non-linéarités d'affichage ou pour éviter les artefacts de quantification lors de l'encodage dans des formats de fichier 8 bits. Il s'agit d'une opération courante lors de l'application de profils de couleurs ICC (sauf pour les espaces RVB linéaires, comme REC 709 ou REC 2020, qui ont un « gamma » linéaire de 1,0). Cependant, à la sortie de filmique rvb, le signal est codé de manière logarithmique, ce que les profils de couleurs ICC ne savent pas gérer. En conséquence, si, à la fin du traitement, nous les laissons appliquer un gamma de 1/2,2, il en résulterait un doublement des valeurs qui donnerait un gris moyen égal à 76 % au lieu d'égal à 45 %, comme il se doit dans un espace relatif à l'affichage.

latitude

La latitude est la plage exprimée en pourcentage de la plage dynamique de luminances délimitée par les contrôles exposition relative du noir et exposition relative du blanc de l'onglet scène. C'est cette plage de luminances qui est remappée en priorité, et elle est remappée sur l'intervalle de luminances défini par le paramètre contraste. Il est généralement conseillé de garder la latitude la plus large possible, tout en évitant l'écrêtage. Si un écrêtage est observé, vous pouvez compenser en diminuant la latitude, en décalant l'intervalle latitude avec le paramètre balance ombres ↔ hautes lumières, ou en diminuant le paramètre contraste.

La latitude définit également la plage des luminances qui ne sont pas désaturées aux extrémités de la plage de luminances (Voir le contrôle saturation tons moyens).

balance ombres ↔ hautes lumières

Par défaut, la latitude est centrée au milieu de la plage dynamique. Si cela produit un écrêtage à une extrémité de la courbe, le paramètre balance permet de faire glisser la latitude le long de la pente, vers les ombres ou vers les hautes lumières. Cela permet de donner plus de place à une extrémité de la plage dynamique qu'à l'autre, si les propriétés de l'image l'exigent.

saturation tons moyens (auparavant saturation extrême de la luminance)

À des luminances extrêmes, les pixels tendront vers le blanc ou le noir. Étant donné que ni le blanc ni le noir n'ont de couleur associée, la saturation de ces pixels doit être de 0 %. Afin d'effectuer une transition agréable vers ce point de saturation 0 %, les pixels situés en dehors de la plage latitude des tons moyens sont progressivement désaturés à mesure qu'ils approchent des extrêmes. La courbe plus sombre du graphique filmique rvb indique la quantité de désaturation appliquée aux pixels en dehors de la plage latitude. Déplacer le curseur vers la droite pousse le point où la désaturation commencera à être appliquée vers les extrêmes, ce qui entraîne une courbe de désaturation plus raide. Si vous le poussez trop loin, cela peut entraîner des franges dans les hautes lumières. Déplacer le curseur vers la gauche rapproche le point auquel la désaturation des couleurs commencera d'être appliquée plus près du centre, résultant en une courbe de désaturation plus douce. Si vous souhaitez voir plus de saturation des couleurs dans les hautes lumières et que vous avez vérifié que l'exposition relative du blanc dans l'onglet scène n'écrête pas encore ces hautes lumières, déplacez le curseur de saturation des tons moyens vers la droite pour augmenter la saturation.

Veuillez noter que cette stratégie de désaturation a changé par rapport aux versions précédentes de filmique rvb (qui fournissait une curseur de contrôle différent intitulé saturation de luminance extrême). Vous pouvez revenir au comportement de désaturation précédent en sélectionnant « v3 (2019) » dans le contrôle science de couleur de l'onglet options.

Ce contrôle est défini à 0 par défaut et il est désormais recommandé de gérer la saturation plus tôt dans le pipeline graphique. Un préréglage « ajoute saturation de base » a été ajouté au module balance couleur rvb à cet effet.

affichage

Les paramètres de cet onglet devraient rarement nécessiter un ajustement.

luminance du noir cible

Les paramètres de destination définissent les valeurs de luminance cible utilisées pour remapper les tons. Les paramètres par défaut doivent fonctionner 99 % du temps, les 1 % restants étant lorsque vous sortez dans l'espace RVB linéaire (REC709, REC2020) pour le traitement des données encodées en mode logarithme. Ces paramètres doivent donc être utilisés avec prudence car darktable n'autorise pas de pipelines séparés pour l'aperçu de l'affichage et la sortie du fichier.

Le paramètre de luminance du noir cible définit le noir de niveau de base du média cible. Par défaut, il est défini à la valeur minimale non nulle pouvant être encodée par le nombre de bits disponibles dans l'espace colorimétrique de sortie. Le réduire à zéro signifie que certaines luminances non nulles seront mappées à 0 dans la sortie, perdant potentiellement certains détails dans les parties les plus sombres des ombres. L'augmentation de ce curseur produira des noirs profonds et fades qui peuvent donner un aspect "rétro".

gris moyen cible

Il s'agit du gris moyen du support de sortie qui est utilisé comme cible pour le nœud central de la courbe en S. Sur les média à correction gamma, le gris réel est calculé avec la correction gamma (gris-moyen^(1/gamma)), donc un paramètre de gris moyen de 18 % avec un gamma de 2,2 donne une cible réelle de gris moyen de 45,87 %.

luminance du blanc cible

Ce paramètre vous permet de définir le niveau de blanc plafond du média cible. Réglez-le à une valeur inférieure à 100 % si vous voulez des blancs tamisés et atténués pour obtenir un look rétro.

Pour éviter les images délavées filmique rvb applique une compression « gamma » remplaçant la correction gamma ICC de sortie, de sorte que le gris moyen soit, à la fin, correctement remappé. Pour supprimer cette compression, définissez le facteur de puissance de destination sur 1,0 et la destination gris moyen sur 45 %.

options

science de couleur

Ce paramètre prend par défaut la valeur v5 (2021) pour les nouvelles images, et définit les algorithmes utilisés par le module filmique rvb (comme la stratégie de désaturation extrême en luminance). Pour revenir au comportement des versions précédentes de filmique rvb, définissez ce paramètre à v3 (2019) ou v4 (2020). Si vous avez déjà apporté des modifications à une image à l'aide d'anciennes versions de filmique rvb, ce paramètre sera déjà défini à l'une de ces versions afin de fournir une compatibilité descendante pour ces modifications.

préserver chrominance

Définissez comment la chrominance doit être gérée par filmique rvb -- soit pas du tout, soit en utilisant l'une des trois normes fournies.

En appliquant la transformation de courbe en S indépendamment sur chaque couleur, les proportions des couleurs sont modifiées, ce qui modifie les propriétés du spectre sous-jacent, et finalement la chrominance de l'image. C'est ce qui se passe si vous choisissez « non » dans le contrôle préserver chrominance. Cette valeur peut donner des résultats apparemment « meilleurs » que les autres valeurs, mais elle peut avoir un impact négatif sur les parties ultérieures du pipeline, par exemple, en ce qui concerne la saturation globale.

Les autres valeurs de ce paramètre fonctionnent toutes de la même manière. Au lieu d'appliquer la courbe en S aux canaux R, V et B indépendamment, filmique rvb, divise les trois composantes par une norme (N) puis applique la courbe en S. De cette façon, la relation entre les canaux est conservée.

La valeur du contrôle préserver chrominance indique quelle norme est utilisée (la valeur utilisée pour N) :

non signifie que les ratios entre les canaux RVB ne sont pas conservés. Cela aura tendance à saturer les ombres et à désaturer les hautes lumières, et peut être utile lorsqu'il y a des bleus ou des rouges hors gamut.

max RVGB est la valeur maximale des canaux R, V et B. C'est le même comportement que la version originale du module filmique rvb. Il a tendance à assombrir les bleus, en particulier le ciel, et à produire des halos ou des franges, surtout si certains canaux sont écrêtés. Cela peut également diminuer quelque peu le contraste local.

luminance Y est une combinaison linéaire des canaux R, V et B. Il a tendance à assombrir et à augmenter le contraste local dans les rouges, et à se comporter moins bien avec les bleus saturés et hors gamut.

norme puissance RVB est la somme des cubes des canaux R, G et B, divisée par la somme de leurs carrés (R³ + G³ + B³)/(R² + G² + B²). C'est généralement un bon compromis entre les valeurs max RVB et luminance Y.

La norme euclidienne RVB a la propriété d'être indépendante de l'espace RVB, elle produira donc les mêmes résultats quel que soit le profil de couleur de travail utilisé. Elle pèse plus sur les hautes lumières que la norme de puissance et donne plus de désaturation des hautes lumières, et renvoie probablement un résultat le plus proche d'un aspect de film couleur.

Il n'y a pas de « bon » choix pour la norme, et le choix approprié dépend fortement de l'image à laquelle elle est appliquée. Il est conseillé d'expérimenter et de décider par vous-même quel réglage donne le résultat le plus agréable avec le moins d'artefacts.

contraste hautes lumières

Ce contrôle sélectionne la forme souhaitée pour l'extrémité droite (hautes lumières) de la spline de filmique rvb. Le réglage par défaut (sûr) garantit qu'il n'y aura pas de dépassement, mais donne un contraste assez faible près du blanc. Sélectionner dur place une contrainte plus stricte sur la pente de la spline qui rend la courbe plus « pointue » et qui introduit donc plus de compression tonale dans les hautes lumières. Sélectionner doux relâche cette contrainte et donne une courbe plus douce avec moins de compression tonale dans les hautes lumières.

contraste des ombres

Ce contrôle sélectionne la forme souhaitée pour l'extrémité gauche (ombres) de la spline de filmique rvb. Le réglage par défaut (sûr) garantit qu'il n'y aura pas de dépassement, mais donne un contraste assez faible près du noir. Sélectionner dur place une contrainte plus stricte sur la pente de la spline qui rend la courbe plus « pointue » et qui introduit donc plus de compression tonale dans les ombres. Sélectionner doux relâche cette contrainte et donne une courbe plus douce avec moins de compression tonale dans les ombres.

utiliser un gris moyen spécifique

Activer ce paramètre rend le curseur luminance du gris moyen visible dans l'onglet scène. Avec la version actuelle de filmique rvb, il est conseillé d'utiliser le module exposition pour définir le niveau du gris moyen, ce paramètre est donc désactivé par défaut (et le curseur luminance du gris moyen est masqué).

ajustement automatique de la dureté

Par défaut, ce paramètre est activé, et filmique rvb calculera automatiquement la fonction puissance (alias « gamma ») à appliquer à la courbe de transfert de sortie. Si ce paramètre est désactivé, un curseur dureté apparaîtra dans l'onglet look afin que cette valeur puisse être définie manuellement.

itérations pour reconstruction haute qualité

Utilisez ce paramètre pour augmenter le nombre de passes de l'algorithme de reconstruction des hautes lumières. Plus d'itérations signifie plus de propagation de couleur vers les zones écrêtées depuis les pixels voisins. Cela peut produire des hautes lumières plus neutres, mais est aussi plus coûteux en termes de puissance de traitement. Cela peut être utile dans les cas difficiles où il y a des hautes lumières magenta en raison de l'écrêtage de canal.

La reconstruction par défaut fonctionne sur des canaux RVB séparés et n'applique qu'une seule itération, par contre la reconstruction haute qualité utilise un algorithme différent. Il travaille sur les rapports RVB (ce qui est un moyen de séparer la chromaticité de la luminance). Il peut utiliser plusieurs itérations pour propager progressivement dans les zones écrêtées des couleurs provenant des pixels voisins. Cependant, si trop d'itérations sont utilisées, la reconstruction peut dégénérer, ce qui entraînera des couleurs tranchées mal rendues sur des objets écrêtés (couleurs qui bavent) -- par exemple des nuages blancs remplis avec un ciel bleu, ou le disque solaire photographié au travers d'arbres peint en vert-feuille.

ajouter du bruit dans les hautes lumières

Cela introduit artificiellement du bruit dans les hautes lumières reconstruites pour éviter qu'elles ne paraissent trop lisses par rapport aux zones environnantes qui peuvent déjà contenir du bruit. Cela peut aider à fondre plus naturellement les zones reconstruites avec les zones non écrêtées environnantes.

type de bruit

Ceci spécifie la distribution statistique du bruit ajouté. Il peut être utile de faire correspondre l'apparence du bruit généré artificiellement avec le bruit naturel dans les zones environnantes provenant du capteur de la caméra. Le bruit poissonien est le plus proche du bruit naturel du capteur mais est moins agréable visuellement que le gaussien, qui est probablement plus proche du grain du film. Notez également que la plupart des modules de débruitage transformeront le bruit du capteur de poissonien en légèrement gaussien, vous devez donc choisir la variante qui se fond mieux dans le bruit réel de votre image.

filtre dégradé

Simule un filtre de densité gradué afin de corriger l'exposition et la couleur de manière progressive.

Une ligne apparaît à l'écran permettant de modifier à la souris la position et l'orientation du dégradé.

Ce module est connu pour provoquer des artefacts de bandes dans certaines conditions. Vous devriez envisager d'activer le module homogénéisation pour résoudre ces problèmes.

contrôles du module

densité

Règle la densité du filtre (IL). Une valeur faible sous-expose légèrement alors qu'une valeur élevée crée un filtre puissant.

dureté

La progressivité du gradient. Une valeur faible crée une transition douce, tandis qu'une valeur élevée rend la transition plus abrupte.

rotation

L'orientation du filtre. Les valeurs négatives tournent dans le sens des aiguilles d'une montre. La rotation peut également être effectuée en faisant glisser l'extrémité de la ligne de dégradé avec la souris.

teinte

Choisir une teinte pour ajouter une dominante de couleur au dégradé.

saturation

La saturation de la dominante de couleur à ajouter au dégradé (par défaut pas de dominante de couleur)

filtre passe-bas

Applique un filtre passe-bas (par exemple, un flou gaussien) à l'image, tout en contrôlant le contraste et la saturation de sortie.

Ce module est principalement utilisé en combinaison avec un mode de fusion. Essayez le préréglage masque de contraste local avec le mode de fusion superposer.

Remarque : Ce module effectue des flous dans l'espace colorimétrique Lab, ce qui peut produire des effets indésirables et n'est plus recommandé. Au contraire, utilisez le module égaliseur de contraste pour le floutage ou le module égaliseur de ton pour la compression de la plage dynamique.

contrôles du module

rayon

Le rayon du flou

adoucir avec

L'algorithme de flou à utiliser :

flou gaussien : flouter tous les canaux d'image (L, a, b)

filtre bilatéral : flouter uniquement le canal L en préservant les contours

contraste

Des valeurs absolues plus élevées augmentent le contraste. Des valeurs absolues inférieures réduisent le contraste. Les valeurs négatives donnent une image négative inversée. Une valeur de zéro produit un plan neutre.

luminosité

Des valeurs négatives assombrissent l'image. Des valeurs positives éclaircissent l'image.

saturation

La saturation des couleurs. Les valeurs négatives donnent des couleurs complémentaires en inversant les canaux a/b. Des valeurs absolues plus élevées augmentent la saturation des couleurs. Des valeurs absolues inférieures réduisent la saturation des couleurs. Une valeur de zéro désature complètement l'image.

filtre passe-haut

Un filtre passe-haut.

Ce module est principalement utilisé en combinaison avec un mode de fusion. Essayez d'utiliser le module avec un mode de fusion « lumière douce » pour une accentuation passe-haut.

Remarque : Ce module effectue des flous dans l'espace colorimétrique Lab, ce qui peut entraîner des effets indésirables, et n'est plus recommandé. Utilisez plutôt le module égaliseur de contraste pour une fine accentuation ou le module contraste local pour une accentuation générale.

Contrôles d'un Module

netteté

La netteté du filtre.

renforcer le contraste

Définit l’accentuation du contraste.

flou de surface

Lisse les surfaces de l'image tout en préservant les bords nets à l'aide d'un filtre bilatéral.

Ce module peut être utilisé pour réduire le bruit des images, cependant vous devez savoir que les filtres bilatéraux sont sensibles aux dépassements et darktable offre de bien meilleures alternatives. Par exemple, le module réduction du bruit photo astro utilise un algorithme de réduction de bruit de moyennes non locales, et le module réduction du bruit (profil) offre le choix entre le mode moyennes non locales et le mode ondelettes.

Le module flou de surface réduit le bruit dans les surfaces d'une image en faisant la moyenne des pixels avec leurs voisins, en tenant compte non seulement de leur distance géométrique mais aussi de leur distance en terme de couleurs (c'est-à-dire des différences de leurs valeurs RVB). Cela peut être particulièrement utile si un canal RVB est plus bruyant ou a besoin de plus de lissage que les autres. Dans ce cas, utilisez le module calibration des couleurs pour examiner les canaux un par un, afin de régler les intensités de flou en conséquence.

Le module peut également être utilisé comme filtre créatif pour fournir des effets intéressants, par exemple pour donner à une image un aspect de dessin animé. Lorsqu'il est utilisé avec la fusion de chrominance, il peut également uniformiser la couleur d'une surface (par exemple, pour éliminer les rougeurs de la peau).

Ce module est gourmand en ressources et ralentit considérablement le traitement du pipeline. Vous devriez envisager de l'activer tardivement dans votre flux de travail.

contrôles du module

rayon

L'étendue spatiale du flou gaussien.

rouge, vert, bleu

L'intensité du flou pour chacun des canaux RVB.

flous

Simule des flous physiquement réalistes dans un espace RVB relatif à la scène.

types de flous

Trois types de flous sont fournis :

flou d'objectif : Simule un diaphragme d'objectif avec un nombre et une courbure de lamelles configurables pour créer du bokeh synthétique.

flou de mouvement : Simule l'effet d'un mouvement d'appareil photo avec une trajectoire configurable.

flou gaussien : Ceci n'est pas vraiment un flou optique mais peut être utilisé pour débruiter et pour des effets créatifs en utilisant des modes de fusion

Un graphe en haut du module montre la forme de l'opérateur de flou (connu sous le nom de fonction d'étalement du point). Le module va transformer chaque point lumineux de la scène en une tache de la même forme que l'opérateur de flou, de la taille définie par le rayon du flou.

contrôles du module

général

rayon de flou

La taille d'étalement du flou.

type de flou

Choisissez parmi les différentes variantes de flou (ci-dessus).

contrôles spécifiques au flou d'objectif

lamelles diaphragme

Le nombre de lamelles qui composent le diaphragme. Les lentilles plus anciennes utilisent généralement 5 ou 7 lamelles, les lentilles plus récentes utilisent généralement 9 ou 11 lamelles. Dans tous les cas, les lentilles réelles ont un nombre impair de lamelles et tout nombre supérieur à 11 lamelles est très proche de produire un disque parfait. Si vous dégradez les paramètres du diaphragme avec la concavité pour créer une étoile ou un astérisque, ce contrôle définit le nombre de branches dont il dispose.

concavité

une concavité de 1 assure que le diaphragme est un polygone convexe régulier (triangle, carré, hexagone, etc.).

une concavité supérieure à 1 mais inférieure à nombre de lamelles - 1 créée une forme d'étoile.

une concavité supérieure à nombre de lamelles - 1 mais inférieure à nombre de lamelles créée une forme d'astérisque, en diminuant la linéarité sous 1.

une concavité supérieure ou égales au nombre de lamelles dégénère la forme en un « motif d'explosion ».

linéarité

une linéarité de 0 créée un disque, peu importe le nombre de lamelles ou la concavité.

une linéarité de 1 rend les bords extérieurs de la forme droits.

une linéarité entre 0 et 1 rend les bords extérieurs de la forme plus ou moins courbes.

rotation

Permet de tourner la forme autour de son centre -- principalement utile avec un petit nombre de lamelles, quand une orientation particulière est requise.

contrôles spécifiques au flou de mouvement

direction

L'orientation de la trajectoire du mouvement en degrés d'angle. 0° est un mouvement horizontal.

courbure

La courbure du mouvement. Zéro produit une ligne droite, une valeur négative produit une courbure concave, une valeur positive produit une courbure convexe.

décalage

Déplace la trajectoire du mouvement en suivant sa courbe. Ceci est utile pour sélectionner une portion symétrique de la trajectoire courbe, qui produit une forme de virgule (exemple 1 : direction = -45°, courbure = +2, décalage =  +0.5 ; exemple 2 : direction -45°, courbure = +1, décalage = +1).

mises en garde

Ce module est implémenté en utilisant une convolution "naïve", ce qui est un algorithme lent. Des approches plus rapides sont disponibles (utilisant la FFT) mais pas encore implémentées. L'implémentation GPU, via OpenCL, devrait masquer partiellement ce problème. Dans tous les cas, le temps d'exécution du module augmentera avec la carré du rayon du flou.

Le processus de floutage ne prend pas en compte la profondeur de la scène ni la profondeur de champ, mais floute toute l'image comme un objet plat. Il n'est donc pas adapté à la simulation de profondeur de champ. L'utilisation des masques généraux de darktable va fonctionner seulement partiellement pour isoler le premier plan de l'image, car il sera tout de même flouté dans l'arrière plan.

trucs et astuces

Toutes les images sont habituellement (même un tout petit peu) bruitées. Si vous floutez seulement une partie de l'image, la région floutée va paraître suspicieusement propre comparée au reste de l'image. C'est donc souvent une bonne idée d'ajouter un peu de bruit par dessus la région floutée pour la fondre avec le reste, en utilisant soit le module grain ou censurer.

grain

Simule le grain du film argentique. Le grain est traité sur le canal L de l'espace de couleur Lab.

contrôles du module

rugosité

La taille du grain, dimensionné pour simuler une valeur ISO.

Force

La force de l'effet.

homogénéisation

Ce module élimine une partie des artefacts typiques d’effet de bandes qui peuvent se produire lorsque les données internes en arithmétique flottante 32 bits sont transférées, pour l’affichage ou pour l’exportation, vers un format de sortie discret en entier 8 ou 16 bits .

Bien que l'effet de bandes ne soit pas un problème inhérent à tous les modules de darktable, quelques opérations peuvent le provoquer en produisant dans l'image un dégradé de clarté. Pour atténuer les artefacts possibles vous devriez envisager d'activer l'homogénéisation quand vous utilisez les modules vignettage et filtre dégradé. Ceci est spécialement indiqué pour les images contenant des zones homogènes étendues comme un ciel sans nuage. Quand vous utilisez l'outil dégradé d''un masque dessiné vous devriez aussi vous méfier des possibles artefacts d'effet de bandes.

L’observation depuis une certaine distance d’une image homogénéisée avec une très petite profondeur de bits (comme « floyd-steinberg 1-bit N&B ») donnera l’impression d’une image homogène en nuances de gris. darktable essaye de simuler cette impression lorsque vous regardez des images dé-zoomées sur la vue centrale, sur la fenêtre de navigation ou sur les miniatures. Ceci est réalisé en homogénéisant ces images en un nombre de nuances de gris plus important. Vous remarquerez qu'en conséquence, le module scopes -- dont l'affichage dérive de la fenêtre de navigation – affichera ce nombre de niveaux plus important et ne correspondra plus parfaitement à l’image de sortie.

contrôles du module

méthode

Choisir la méthode d'homogénéisation.

:floyd-steinberg: distribue systématiquement les erreurs de quantification sur les pixels voisins. Cette méthode peut être sélectionnée avec quelques profondeurs de bits typiques en sortie. Alternativement, vous pouvez sélectionner floyd-steinberg auto, qui s’adapte automatiquement au format de sortie désiré.

:aléatoire: cette méthode ajoute simplement un certain degré d’aléatoire pour rompre la netteté des bandes de valeurs tonales.

amortissement (méthode « aléatoire » seulement)

Contrôle le niveau de bruit aléatoire ajouté, exprimé comme facteur d’amortissement dans une base 10*log2. La valeur -80 est bien adaptée aux formats de sortie 8 bits et la valeur -160 à ceux de sortie 16 bits.

inverser (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.6 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le module docteur néga à la place..**

Inverser des négatifs numérisés

contrôles du module

couleur du matériau du film

En cliquant sur le champ coloré, vous ouvrez une boîte de dialogue de sélection de couleur qui vous offre un choix parmi les couleurs couramment utilisées, ou qui vous permet de définir une couleur dans l’espace colorimétrique RVB. Vous pouvez aussi activer la pipette de couleur pour prélever un échantillon de votre image -- de préférence sur une bordure non exposée de votre négatif.

liquéfier

Déplace les pixels en appliquant des distorsions de style libre à des parties de l'image à l'aide de points, de lignes et de courbes.

nœuds

Chacun des outils de liquéfier est basé sur des nœuds. Un point se compose d'un seul nœud et une ligne ou une courbe se compose d'une séquence de nœuds liés définissant un chemin.

Chaque instance du module liquéfier est limitée à un maximum de 100 nœuds -- pour plus de nœuds, utilisez des instances supplémentaires. Cependant, veuillez noter que le module liquéfier consomme beaucoup de ressources système.

Faites glisser le point central d'un nœud pour déplacer le nœud. Le rayon décrit la zone de l'effet (la distorsion ne se produit que dans ce rayon). Pour modifier le rayon, faites glisser la poignée sur la circonférence. Un vecteur de force partant du centre décrit la direction de la distorsion, et sa force est représentée par la longueur du vecteur. Modifiez le vecteur en faisant glisser sa pointe de flèche.

points

Un point se compose d'un seul nœud et d'un vecteur de force.

Cliquez sur l'icône de point pour activer l'outil de point, puis cliquez sur l'image pour le placer. Maintenez la touche Ctrl enfoncée tout en cliquant sur l'icône du point pour ajouter plusieurs points sans avoir à cliquer à nouveau sur l'icône. Faites un clic droit pour quitter le mode de création.

modes point

Le vecteur de force d'un point a trois modes différents. Ceux-ci peuvent être basculés en maintenant la touche Ctrl enfoncée et en cliquant sur la pointe de flèche du vecteur de force.

linéaire

Une distorsion linéaire à l'intérieur du cercle, partant du côté opposé du vecteur de force et suivant la direction du vecteur. C'est le mode par défaut.

augmente

L'effet du vecteur de force est radial, commençant avec une force de 0% au centre et augmentant en s'éloignant du centre. Ce mode est représenté par un cercle supplémentaire avec la flèche pointant vers l'extérieur.

diminue

L'effet du vecteur de force est radial, commençant par une force de 100 % au centre et diminuant en s'éloignant du centre. Ce mode est représenté par un cercle supplémentaire avec la flèche pointant vers l'intérieur.

progressif

mode par défaut

Par défaut la force varie linéairement de 0% à 100% entre le centre et le rayon du point de contrôle. Il est possible de modifier l'effet d'adoucissement en cliquant sur le centre du cercle.

mode progressif

En mode « progressif », deux cercles de contrôle sont affichés, qui peuvent être modifiés indépendamment pour modifier la force de l'effet. Notez que cliquer à nouveau sur le centre du cercle masque les cercles de contrôle mais ne revient pas au mode par défaut.

suppression de points

Un point peut être supprimé avec un clic droit sur le centre du nœud.

lignes et courbes

Les lignes et les courbes sont des séquences de points reliés entre eux par des lignes droites ou des courbes. L'effet est interpolé par un ensemble de vecteurs de force associés.

Cliquez sur l'icône appropriée pour activer l'outil ligne ou courbe, puis cliquez sur l'image pour placer une séquence de points formant le chemin. Faites un clic droit n'importe où lorsque le dernier point a été placé afin de terminer le tracé de la ligne ou courbe.

Maintenez la touche Ctrl enfoncée tout en cliquant sur l'icône de ligne ou courbe pour ajouter plusieurs lignes ou courbes sans avoir à cliquer à nouveau sur l'icône. Cliquez avec le bouton droit une deuxième fois pour quitter le mode de création quand la ligne ou la courbe finale terminée.

lignes

courbes

Ctrl+clic sur une ligne ou un segment de courbe pour ajouter un nouveau point de contrôle. Ctrl+clic droit sur le centre d'un nœud pour supprimer un point de contrôle.

Clic-droit sur un segment pour supprimer complètement la forme. Ctrl+Alt+clic sur un segment pour changer ce segment d'une ligne en une courbe et vice versa.

modes de liaison

Ctrl+clic sur le centre d'un nœud pour modifier la façon dont les points d'une courbe sont liés entre eux. Il existe quatre modes, qui correspondent à différentes manières de gérer la pente de la courbe de Bézier à l'aide des poignées de contrôle :

lissage automatique

C'est le mode par défaut, dans lequel les poignées de contrôle ne sont pas affichées -- les contrôles sont automatiquement calculés pour donner une courbe lisse.

parabolique

Les poignées de commande peuvent être déplacées indépendamment. Ce mode est représenté par un symbole triangulaire au centre du nœud.

lissé

Les poignées de contrôle donnent toujours une courbe lisse. Ce mode est représenté par un losange au centre du nœud.

symétrique

Les poignées de contrôle sont toujours déplacées ensemble. Ce mode est représenté par un symbole carré au centre du nœud.

édition des nœuds

Cliquez sur l'icône outil de nœud pour activer ou désactiver l'outil d'édition de nœud. Cela affiche tous les objets de distorsion actuellement définis et leurs commandes. Alternativement, vous pouvez cliquer avec le bouton droit sur l'image à tout moment pour le même effet.

nombre formes|points

Ce champ affiche le nombre de formes (objets de distorsion individuels) et de nœuds actuellement utilisés.

montrer les guides

Cochez la case pour afficher en superposition les guides. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides & superpositions pour plus de détails.

lumière d'appoint (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.4 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le moduleégaliseur de ton ou encore le module exposition avec un masque dessiné à la place.

Modifie localement l'exposition en fonction de la clarté des pixels.

Ce module pousse l'exposition en augmentant la clarté avec une courbe gaussienne d'une largeur déterminée, centrée sur une clarté donnée.

contrôles du module

exposition

Définit l'exposition d'appoint en (IL)

centre

La clarté médiane impactée par la lumière d'appoint. La clarté doit être réglée manuellement, mais une pipette de couleur peut être utilisée pour fournir un guide basé sur un échantillon de l'image. La clarté du point/de la zone sélectionné est affichée dans la barre de dégradé.

largeur

La largeur de la courbe de Gauss. Ce nombre est exprimé en zones, la plage complète étant de 10 zones.

lumière d'arrière plan

Créez un éclairage d'arrière plan doux.

Ce module floute les hautes lumières, puis fusionne le résultat avec l'image d'origine.

Remarque : Ce module effectue des flous dans l'espace colorimétrique Lab, et n'est plus recommandé. Utilisez plutôt le module égaliseur de tons ou le module exposition avec un masque paramétrique.

contrôles du module

taille

L'étendue spatiale de l'effet lumière d'arrière plan.

seuil

Le seuil pour l'augmentation de la luminosité.

force

La force du sur-éclairage.

lut 3D

Transforme les valeurs RVB grâce à un fichier 3D LUT.

Une LUT 3D est une table tridimensionnelle utilisée pour transformer une valeur RVB donnée en une autre valeur RVB. C'est normalement utilisé pour la simulation de film et la gradation de couleurs.

Ce module accepte les fichiers .cube, .3dl, .png (haldclut) et .gmz. Les données 3D LUT non compressées ne sont pas enregistrées dans la base de données ni dans le fichier XMP mais restent stockées dans les fichiers d'origine organisés sous le dossier racine 3D LUT (voir preferences > traitement > répertoire 3D lut racine). Il est donc important de sauvegarder correctement votre dossier LUT 3D -- partager une image avec son XMP est inutile si le destinataire n'a pas également le même fichier LUT 3D dans son propre dossier LUT 3D.

Le format compressé .gmz n'est disponible que lorsque GMIC est installé. Ce format peut contenir une bibliothèque complète de LUTs, et les données LUT chargées à partir de ce type de fichier peuvent être enregistrées dans la base de données et les fichiers XMP.

Remarque : le module écrête toutes les valeurs en dehors de la plage [0,1]. Vous devrez peut-être réduire la plage des valeurs d'entrée avant d'appliquer la LUT.

utilisation

Les LUTs sont le plus souvent utilisées dans darktable pour la gradation de couleurs ou la simulation de film. Pour cette raison, par défaut, le module est placé après le module filmique rvb dans le pipeline graphique et doit être appliqué à une image neutre (sans appliquer au préalable un look spécifique). Bien que vous puissiez trouver des centaines de LUT gratuites sur Internet, notez que toutes ne sont pas compatibles avec l'environnement et le flux de travail de darktable - les LUTs incompatibles ne produiront pas l'apparence annoncée. Pour limiter le risque, une LUT doit avoir être créée pour fonctionner avec l'un des « espaces colorimétriques » disponibles (voir ci-dessous), à la fois pour l'entrée et la sortie du module.

Les LUTs log de caméra (comme F-log ou S-Log3) sont différentes des LUTs de gradation de couleurs et de simulation de film, et sont destinées à convertir les données logarithmiques brutes de la caméra en quelque chose (données brutes linéaires ou autre espace colorimétrique) que darktable est capable de comprendre. Dans ce cas, le module lut 3D doit être placé manuellement entre les modules dématriçage et profil de couleur d'entrée. Une fois cela fait, vous ne pouvez plus choisir l'« espace de couleur » (dans lut 3D). Le « profil d'entrée » du module de profil de couleur d'entrée doit être aligné avec la sortie de la LUT. Veuillez noter que ce cas d'utilisation n'a pas encore été testé.

contrôles du module

sélection du fichier

Choisit le fichier LUT 3D à utiliser. La sélection de fichier est inactive si le dossier racine 3D LUT n'a pas été défini dans préférences > traitement.

espace de couleur

Une LUT 3D est définie par rapport à un espace de couleur spécifique. Choisissez l'espace de couleur pour lequel le fichier LUT 3D sélectionné a été créé. Les fichiers Cube sont généralement liés à REC.709 tandis que la plupart des autres sont liés à sRGB.

interpolation

Définit comment calculer les couleurs de sortie lorsque les couleurs d'entrée ne sont pas exactement sur un nœud du cube RVB décrit par la LUT 3D. Trois méthodes d'interpolation sont disponibles : tétraédrique (par défaut), trilinéaire et pyramidale. Habituellement, vous ne verrez aucune différence entre les méthodes d'interpolation, sauf avec des LUT de petite taille.

mappage des couleurs

Transfert l'apparence d'une image à une autre

Ce module analyse statistiquement les caractéristiques de couleur d'une image source et d'une cible. Les couleurs de l'image source sont ensuite mappées aux couleurs correspondantes sur l'image cible.

Deux étapes sont nécessaires pour utiliser ce module :

Ouvrir l'image source dans la vue de la chambre noire et acquérir ses caractéristiques de couleur en appuyant sur le bouton « acquérir source ». Un ensemble de groupes de couleurs est généré et affiché dans la zone « groupes sources ». Chaque groupe présente un ensemble de nuances de couleur entourant leur valeur moyenne. Les groupes sont triés par ordre croissant de leur poids (par le nombre de pixels qui contribuent à chacun d'eux).

Ouvrir l'image cible dans la vue de la chambre noire. Les groupes source doivent être déjà enregistrés ; s'ils ne sont pas encore affichés, réinitialisez le module. Appuyez maintenant sur le bouton « acquérir cible » pour générer un ensemble correspondant de groupes de couleurs pour votre image cible, qui sont affichés dans la zone « groupes cibles ».

Lorsque les groupes source et cible sont collectés, un mappage de couleurs automatique est appliqué à l'image cible. Avec les paramètres par défaut, l'effet global est assez exagéré. Un ensemble de curseurs vous permet de contrôler la force de l'effet. Vous pouvez également doser l'effet avec le curseur opacité en mode de fusion normal. Comme le module de mappage des couleurs arrive tôt dans le pipeline, vous pouvez également affiner les couleurs avec les modules suivants.

contrôles du module

acquérir source/cible

Appuyez sur ces boutons pour générer des groupes de couleurs pour l'image source et l'image cible, respectivement. Le traitement prend quelques secondes pendant lesquelles l'interface graphique ne répond pas.

nombre de groupes

Nombre de groupes de couleurs à utiliser. Cela devrait correspondre à peu près au nombre de couleurs dominantes dans l'image. Les groupes sont construits par un processus d'échantillonnage statistique pour représenter les couleurs qui apparaissent le plus souvent dans l'image. La nature aléatoire du processus d'échantillonnage signifie que vous pourriez obtenir des résultats différents à chaque fois que vous acquérez les groupes, surtout si vous avez un plus grand nombre de groupes et/ou une palette de couleurs complexe dans l'image. Si vous modifiez ce paramètre, les groupes de couleurs collectés sont réinitialisés et doivent être reconstruits.

dominante couleur

Ce paramètre contrôle le mappage entre les clusters source et cible. À la valeur minimale, le mappage est basé sur la proximité des couleurs. Cela conduit généralement à des effets très subtils sur l'image cible. À la valeur maximale, le mappage est basé sur le poids relatif des groupes de couleurs - les couleurs dominantes de l'image source sont mappées sur les couleurs dominantes de l'image cible. Cela conduit généralement à un effet très fort. Les valeurs intermédiaires modifient le résultat progressivement entre ces extrêmes.

égalisation d'histogramme

Modifie le contraste de l'image cible en faisant correspondre son histogramme avec l'histogramme de l'image source. Ce curseur contrôle l'étendue de cet effet.

mappage des tonalités (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.6 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le module égaliseur de tons à la place.

Compresse la plage tonale des images HDR afin qu'elles s'intègrent dans les limites d'une image LDR, à l'aide de l'algorithme 2002 de Durand.

L'algorithme sous-jacent utilise un filtre bilatéral pour décomposer une image en une couche de base grossière et une couche de détails. Le contraste de la couche de base est compressé, tandis que la couche de détails est préservée, puis les deux couches sont recombinées.

contrôles du module

compression du contraste

Le niveau de compression du contraste de la couche de base. Une compression plus élevée fera que l'image s'adaptera à une plage dynamique plus petite.

étendue spatiale

L'étendue spatiale du filtre bilatéral. Des valeurs plus faibles font que la compression du contraste a des effets plus forts sur les détails de l'image.

mappage global des tonalités (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.4 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le module filmique rvb à la place.

Compresse la plage de tons d'une image HDR dans la plage de tons limitée d'un fichier de sortie LDR typique.

Le mappage global des tonalités traite chaque pixel d'une image HDR, sans tenir compte de l'environnement local. C'est généralement plus rapide que le mappage des tonalités (déprécié) local, mais peut conduire à des résultats moins convaincants avec des scènes à plage dynamique très élevée.

contrôles du module

opérateur

L'opérateur à utiliser. Les opérateurs de mappage global des tonalités de Reinhard, Filmic et Drago sont disponibles. Selon l'opérateur sélectionné, différents paramètres peuvent être ajustés.

Certains opérateurs sont entièrement auto-réglables et ne nécessitent pas de contrôles spécifiques.

biais (opérateur Drago uniquement)

Ce paramètre influence le contraste de l'image de sortie. C'est un paramètre essentiel pour ajuster la compression des valeurs élevées et la visibilité des détails dans les zones sombres. Une valeur de 0,85 est recommandée comme point de départ.

cible (opérateur Drago uniquement)

Un facteur d'échelle pour ajuster la luminosité globale de l'image à la luminosité de l'écran prévu. Il est mesuré en cd/m² et doit correspondre à la luminosité de votre périphérique de sortie. Des valeurs plus élevées conduisent à une image plus lumineuse, tandis que des valeurs plus faibles conduisent à une image plus sombre.

détail (tous les opérateurs)

Ce paramètre contrôle la quantité de détails préservés de l'image d'entrée d'origine et transférés dans l'image de sortie après le mappage de tons.

mise à l'échelle des pixels

Quelques boîtiers (comme le Nikon D1X) ont des cellules de capteur rectangulaires au lieu des cellules carrées habituelles. L'absence d'une correction conduirait à des images déformées. Ce module applique la mise à l'échelle requise.

darktable détecte les images nécessitant cette correction grâce à leurs données EXIF et active automatiquement ce module. Pour les autres images le module reste toujours désactivé.

Ce module n'a pas de réglages.

mixeur de canaux (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.4 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le module calibration des couleurs à la place.

Un outil simple pourtant puissant pour gérer les canaux de couleurs.

Ce module accepte en entrée les canaux rouge, vert et bleu et fournit en sortie les canaux rouge, vert, bleu, gris, teinte, saturation et clarté. Il vous permet de contrôler indépendamment la contribution de chaque canal d'entrée à chaque canal de sortie.

multiplication de matrice RVB

Vous pouvez voir le mixeur de canaux comme un type de matrice de multiplication entre une matrice 3x3 et les valeurs d'entrée [R V B].

┌ R_sortie ┐     ┌ Rr  Rv  Rb ┐      ┌ R_entrée ┐
│ V_sortie │  =  │ Vr  Vv  Vb │   X  │ V_entrée │
└ B_sortie ┘     └ Br  Bv  Bb ┘      └ B_entrée ┘

Si, par exemple, une matrice vous a été fournie pour passer d'un espace colorimétrique à un autre, vous pouvez entrer les coefficients de la matrice dans le mixeur de canaux comme suit :

Définissez la destination en rouge puis définissez les valeurs Rr, Rv & Rb en utilisant les curseurs rouge, vert et bleu.

Définissez la destination en vert puis définissez les valeurs Vr, Vv & Vb en utilisant les curseurs rouge, vert et bleu.

Définissez la destination en bleu puis définissez les valeurs Br, Bv & Bb en utilisant les curseurs rouge, vert et bleu.

Par défaut, le mixeur de canaux copie les canaux d'entrée [R G B] directement sur les canaux de sortie correspondants. Ceci est équivalent à une multiplication par la matrice d'identité :

┌ R_sortie ┐     ┌ 1  0  0 ┐      ┌ R_entrée ┐
│ V_sortie │  =  │ 0  1  0 │   X  │ V_entrée │
└ B_sortie ┘     └ 0  0  1 ┘      └ B_entrée ┘

À titre d'exemple d'un cas d'utilisation, la matrice suivante permet de dompter les affreuses lumières LED bleues hors gamut en les rendant plus magenta :

┌  1.00  -0.18  0.18 ┐
│ -0.20   1.00  0.20 │
└  0.05  -0.05  1.00 ┘

Dans ce cas, il est utile d'utiliser un masque paramétrique pour circonscrire l'effet du mixeur de canaux aux seules couleurs problématiques.

Une approche plus intuitive de l'action des curseurs du mixeur de canaux :

pour la destination rouge, le réglage des curseurs vers la droite rendra les zones R, V ou B de l'image plus rouges. Déplacer le curseur vers la gauche rendra ces zones plus cyan.

pour la destination vert, le réglage des curseurs vers la droite rendra les zones R, V ou B de l'image plus vertes. Déplacer le curseur vers la gauche rendra ces zones plus magenta.

pour la destination bleu, le réglage des curseurs vers la droite rendra les zones R, V ou B de l'image plus bleues. Déplacer le curseur vers la gauche rendra ces zones plus jaunes.

monochrome

Une autre application très utile du mixeur de canaux est la possibilité de mélanger les canaux ensemble pour produire une sortie en niveaux de gris -- une image monochrome. Utilisez la destination gris et réglez les curseurs rouge, vert et bleu pour contrôler la contribution de chaque canal à la luminosité de la sortie. Cela équivaut à la multiplication matricielle suivante :

Gris_sortie  =   [ r  v  b ]  X  ┌ R_entrée ┐
                                 │ V_entrée │
                                 └ B_entrée ┘

Lorsqu'il s'agit des tons chair, les poids relatifs des trois canaux affecteront le niveau de détail de l'image. Mettre plus de poids sur le rouge (par exemple [0,9, 0,3, -0,3]) donnera des tons de peau lisses, tandis que l'accentuation du vert (par exemple [0,4, 0,75, -0,15]) fera ressortir plus de détails. Dans les deux cas, le canal bleu est réduit pour éviter d'accentuer le grain de peau indésirable.

Différents types de films noir et blanc traditionnels ont des sensibilités différentes aux couleurs rouge, verte et bleue, et cela peut être simulé en définissant les coefficients de destination gris de manière appropriée. Le module mixeur de canaux possède un certain nombre de préréglages intégrés qui peuvent être utilisés pour y parvenir.

contrôles du module

destination

Sélectionnez le canal de destination qui sera affecté par les réglages du curseur immédiatement en dessous. Les canaux de destination rouge, vert et bleu sont utilisés pour le mélange des couleurs comme décrit dans la section multiplication de matrice ci-dessus. Le canal de gris est utilisé pour créer des images en niveaux de gris comme décrit dans la section monochrome ci-dessus. Il est également possible de définir les canaux d'entrée R, V et B pour produire des valeurs TSL (teinte, saturation et clarté) en sortie, bien qu'il s'agisse ici d'une application très spécialisée.

rouge

Définit la contribution du canal d'entrée rouge au canal de destination sélectionné.

vert

Définit la contribution du canal d'entrée vert au canal de destination sélectionné.

bleu

Définit la contribution du canal d'entrée bleu au canal de destination sélectionné.

monochrome

Convertit rapidement une image en noir et blanc à l'aide d'un filtre de couleur variable.

Pour utiliser ce module, réduisez d'abord la taille du filtre (pour concentrer son effet) et déplacez-le sur la palette de teintes pour trouver la meilleure valeur de filtre pour le rendu d'image souhaité. Ensuite, étendez progressivement le filtre pour inclure plus de teintes et obtenir une tonalité plus naturelle.

Bien que ce module soit facile à utiliser, de meilleurs résultats peuvent généralement être obtenus en utilisant les préréglages d'émulation de film dans le module calibration des couleurs.

Remarque : Dans certaines conditions, en particulier avec des sources de lumière bleue très saturées dans l'image, ce module peut produire des artefacts de pixels noirs. Utilisez l'option troncature gamut du module profil de couleur d'entrée pour atténuer ce problème.

contrôles du module

taille/position du filtre

L'emplacement central par défaut du filtre a un effet neutre, mais le faire glisser vers une autre position simule l'effet d'un filtre de couleur conventionnel lors de la prise d'une photo en noir et blanc.

La pipette de couleur peut être utilisée pour définir la position et la taille du filtre en fonction de la partie sélectionnée de l'image. Faites défiler la molette de la souris pour modifier la taille du filtre, rendant le filtrage des teintes plus ou moins sélectif.

hautes lumières

Contrôle la quantité à retenir des hautes lumières.

niveaux

Ajuste les points noir, blanc et gris moyen.

L'outil niveaux offre deux modes opératoires :

manuel

L’outil niveaux affiche un histogramme de l’image et trois barres dotées de poignées. Glisser les poignées permet de modifier les points noir, gris moyen et blanc en valeur absolue de la clarté de l'image (la valeur L de Lab),

Déplacer les barres noire et blanche pour qu'elles correspondent aux bords gauche et droit de l’histogramme étale l’image de sortie sur toute la plage tonale disponible, accentuant ainsi son contraste.

En déplaçant la barre du milieu, vous modifiez les tons gris moyens. Déplacez-la vers la gauche pour rendre l'image plus claire et vers la droite pour la rendre plus sombre. On appelle souvent cette opération la modification du gamma de l'image.

Trois pipettes de couleur sont disponibles pour échantillonner les points noirs, blancs et gris de l'image. Le bouton « auto » ajuste automatiquement les points noir et blanc ; et place le point gris entre-eux exactement à mi-distance.

automatique

Dans ce mode, le module analyse automatiquement l'histogramme de l'image, détecte ses bords gauche et droit, et vous laisse définir les points noir, gris et blanc en termes de centiles relativement à ces bords.

Remarque : sous certaines conditions, particulièrement en cas de présence dans le champ de l'appareil de sources lumineuses bleues fortement saturées, le module niveaux peut produire des artefacts sous forme de pixels noirs. Voyez l'option « troncature du gamut » du module profil de couleur d’entrée pour voir comment atténuer ces problèmes.

contrôles du module

mode

Le mode opératoire, automatique ou manuel (par défaut).

noir (mode automatique seulement)

Le point noir exprimé en centiles relativement au bord gauche de l'histogramme.

gris

Le point gris exprimé en centiles relativement aux bords gauche et droit de l'histogramme après avoir appliqué les corrections du points noir et du point blanc.

blanc

Le point blanc exprimé en centiles relativement au bord droit de l'histogramme.

niveaux rvb

Ajuste les points noir, blanc et gris moyen dans l'espace couleur RVB. Ce module est similaire au module niveaux, qui fonctionne dans l'espace de couleur Lab.

L'outil niveau rvb présente un histogramme de l'image et affiche trois barres. Déplacez ces barres pour modifier les points noir, gris moyen et blanc en clarté avec le mode « RVB canaux liés » ou alors, indépendamment pour chacun des canaux R, V et B avec le mode « RVB, canaux indépendants ».

Déplacer les barres noire et blanche pour qu'elles correspondent aux bords gauche et droit de l’histogramme, étale l’image de sortie sur toute la plage tonale disponible, accentuant ainsi son contraste.

En déplaçant la barre du milieu, vous modifiez les tons gris moyens. Déplacez-la vers la gauche pour rendre l'image plus claire et vers la droite pour la rendre plus sombre. On appelle souvent cette opération la modification du gamma de l'image.

Trois pipettes de couleur sont disponibles pour échantillonner les points noirs, blancs et gris de l'image.

Remarque : sous certaines conditions, particulièrement en cas de présence dans le champ de l'appareil de sources lumineuses bleues fortement saturées, le module niveaux peut produire des artefacts sous forme de pixels noirs. Voyez l'option « troncature du gamut » du module profil de couleur d’entrée pour voir comment atténuer ces problèmes.

contrôles du module

mode

Définit le mode opératoire. « RVB, canaux liés » (par défaut) fournit un unique outil niveaux qui ajuste tous les canaux en tenant compte de la méthode de préservation des couleurs choisie (voir « préserver couleur »)

auto

Ajuste automatiquement les points noir et blanc ; et place le point gris entre-eux exactement à mi-distance. Utilisez la pipette de couleur pour effectuer un ajustement automatique en fonction d'une région sélectionnée de l'image.

préserver couleurs

Choisir une méthode de préservation des couleurs lors de l'utilisation du mode « RVB, canaux liés » (« luminance » par défaut).

ombres et hautes lumières

Modifie la gamme de tons des ombres et des hautes lumières d'une image en améliorant le contraste local.

Remarque : Ce module utilise des flous dans l'espace colorimétrique Lab, ce qui peut entraîner des problèmes tels que des halos, un contraste local élevé dans les hautes lumières et des décalages de teinte vers le bleu dans les ombres. Utilisez plutôt le module égaliseur de ton

contrôles du module

ombres

Contrôle l'effet sur les ombres. Des valeurs positives éclaircissent les ombres tandis que des valeurs négatives les assombrissent.

hautes lumières

Contrôle l'effet sur les hautes lumières. Les valeurs positives éclaircissent les hautes lumières tandis que les valeurs négatives les assombrissent.

réglage du point blanc

Par défaut, l'algorithme de ce module ne touche pas aux points noirs et blancs. Dans certains cas, une image peut contenir des variations tonales au-delà du point blanc, c'est-à-dire au-dessus d'une valeur de luminance de 100. Un décalage négatif dans l'ajustement du point blanc peut ramener ces valeurs dans la plage appropriée, de sorte que des détails supplémentaires dans les hautes lumières deviennent visibles.

adoucir avec

Le filtre de flou sous-jacent : gaussien ou bilatéral. Essayez le filtre bilatéral si le flou gaussien génère des halos.

rayon

Le rayon du filtre de flou utilisé par l'algorithme. Des valeurs plus élevées donnent des transitions plus douces entre les ombres et les hautes lumières, mais peuvent introduire des halos. Des valeurs inférieures réduiront la taille des halos mais peuvent donner un aspect artificiel. Le filtre bilatéral est beaucoup moins sujet aux artefacts de halo.

seuil

Contrôle la force avec laquelle l'effet s'étend aux tons moyens. Des valeurs élevées limitent l'effet aux seules ombres et hautes lumières extrêmes. Des valeurs plus faibles entraînent également des ajustements des tons moyens. A 100 %, l'effet n'est plus visible car seuls le noir et le blanc absolus sont affectés.

saturation des ombres

Contrôle la saturation des couleurs appliquée aux ombres. Des valeurs élevées saturent les ombres éclaircies. Des valeurs faibles désaturent les ombres éclaircies. Il est normalement prudent de laisser la valeur par défaut de 100 %. Cela donne un coup de pouce naturel à la saturation des ombres, similaire à ce à quoi vous vous attendriez dans la nature si les ombres recevaient plus de lumière.

met en évidence le réglage des couleurs

Contrôle la saturation des hautes lumières. Des valeurs élevées saturent les hautes lumières assombries. Des valeurs faibles désaturent les hautes lumières assombries. Souvent, les hautes lumières ne contiennent pas suffisamment d'informations sur les couleurs pour donner des couleurs convaincantes lorsqu'elles sont assombries. Vous devrez peut-être ajuster ce paramètre pour trouver la meilleure valeur d'ajustement en fonction de votre image, mais sachez que les résultats peuvent ne pas être entièrement satisfaisants.

orientation

Tourner l'image par pas de 90 degrés ou la retourner horizontalement et/ou verticalement.

Le module est actif par défaut et l'orientation (rotation) est fixée automatiquement d'après les données Exif de l'image.

L'orientation peut également être fixée avec le module images sélectionnées dans la vue table lumineuse.

contrôles du module

transformer

Double-cliquez sur l'étiquette pour réinitialiser les transformations par défaut.

rotate counter-clockwise tourner dans le sens inverse des aiguilles d'une montre

Tourne l'image de 90 degrés dans le sens inverse des aiguilles d'une montre.

rotate clockwise tourner dans le sens des aiguilles d'une montre

Tourne l'image de 90 degrés dans le sens des aiguilles d'une montre.

retournement horizontal retournement horizontal

Retourne l'image horizontalement

retournement vertical retournement vertical

Retourne l'image verticalement

montrer les guides

Cochez la case pour afficher les superpositions de guides chaque fois que le module est activé. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides et superpositions pour plus de détails.

pixels chauds

Détecte et élimine les pixels chauds automatiquement.

Les pixels chauds sont des pixels pour lesquels un enregistrement correct d'un niveau de lumière a échoué. Les pixels chauds détectés sont remplacés par une valeur moyenne de leurs voisins.

contrôles du module

seuil

Seuil de déviation, c.-à-d. de combien la valeur d'un pixel doit-elle dévier de celles de ses voisins pour qu'il soit considéré comme un pixel chaud.

force

La force de la fusion appliquée aux pixels chauds pour les fondre dans leur environnement .

détection par 3 voisins

Étend la détection des pixels chaud en considérant le pixel comme chaud lorsque 3 pixels voisins (au lieu de 4) dévient au delà du seuil fixé.

montrer

Marque visuellement sur l'image les pixels corrigés et affiche leur nombre.

point noir/blanc raw

Définis les points noir et blanc spécifique de l'appareil photo.

Ce module est automatiquement activé sur toutes les images RAW. Les paramètres par défaut sont appliqués pour tous les appareils supportés. Il n'est normalement pas nécessaire de changer ces valeurs par défaut.

contrôles du module

niveau du noir 0-3

Le niveau de noir spécifique à l'appareil pour les quatre pixels dans le motif Bayer RGGB. Les pixels avec des valeurs inférieures à ce niveau ne sont pas considérées contenir des données valide.

point blanc

Le niveau de blanc spécifique à l'appareil photo. Tous les pixels avec une valeur supérieur à celle ci seront coupés et par conséquent manipulés par le module reconstruire hautes lumières

profil de couleur d'entrée

Définit comment darktable interpréte les couleurs de l'image.

Ce module prend l'espace colorimétrique utilisé par la source d'image (par exemple, appareil photo, scanner) et convertit l'encodage des pixels en un espace colorimétrique de travail standardisé. Cela signifie que les modules suivants dans le pipeline n'ont pas besoin de se préoccuper des spécificités du périphérique d'entrée et peuvent fonctionner avec et convertir vers/depuis un espace colorimétrique de travail commun.

Lorsqu'une image a été capturée dans un fichier brut, le module profil de couleur d'entrée applique normalement une matrice de couleurs standard ou améliorée spécifique à ce modèle de caméra pour mapper les couleurs vers l'espace colorimétrique du profil de travail. Si des informations sur l'espace colorimétrique sont intégrées à l'image, le module profil de couleur d'entrée utilise ces informations lors du mappage des couleurs vers l'espace colorimétrique du profil de travail. L'utilisateur peut également spécifier un espace colorimétrique pour l'image entrante et peut même fournir un profil de couleur ICC personnalisé spécialement conçu pour le périphérique d'entrée.

Dans le cadre du mappage de l'espace colorimétrique d'entrée vers l'espace du profil de travail, les couleurs peuvent être confinées dans un certain gamut à l'aide de l'option troncature gamut, ce qui peut aider à atténuer certains artefacts de couleur (peu fréquents). Ceci est également influencé par l'intention de rendu choisie.

À noter que le profil de couleur final qui sera utilisé lors de l'exportation de l'image est contrôlé par le module profil de couleur de sortie.

contrôles du module

profil d'entrée

Le profil ou la matrice de couleurs à appliquer. Un certain nombre de matrices sont fournies avec une matrice de couleurs améliorée pour certains modèles d'appareils photo. Les matrices améliorées sont conçues pour offrir une apparence similaire à celle du fabricant de l'appareil photo.

Vous pouvez également fournir vos propres profils d'entrée ICC et les mettre dans $DARKTABLE/share/darktable/color/in ou $HOME/.config/darktable/color/in (où $DARKTABLE est le répertoire d'installation de darktable et $HOME votre répertoire personnel). Une source courante de profils ICC est le logiciel fourni avec votre appareil photo, qui contient souvent des profils spécifiques à votre modèle d'appareil photo. Vous devrez peut-être activer le module correction du profil d'entrée pour utiliser vos propres profils.

Si votre image d'entrée est un fichier à faible plage dynamique comme un JPEG, ou un fichier brut au format DNG, il se peut qu'elle contienne déjà un profil ICC intégré, que darktable utilisera par défaut. Vous pouvez restaurer cette valeur par défaut en sélectionnant « profil icc intégré ».

profil de travail

Le profil de travail utilisé par les modules de traitement de darktable. Chaque module peut spécifier l'espace dans lequel il fonctionne, ce qui déclenche une conversion. Par défaut, darktable utilise « Rec2020 RVB linéaire », ce qui est un bon choix dans la plupart des cas.

troncature gamut

Active un mécanisme d'écrêtage des couleurs. Dans la plupart des cas, vous pouvez laisser ce contrôle dans son état « désactivé » par défaut. Cependant, si votre image montre des caractéristiques spécifiques telles que des sources de lumière bleue très saturées, l'option troncature gamut peut être utile pour éviter les artefacts de pixels noirs. Voir artefacts de couleur possibles pour plus d'informations.

Choisir parmi une liste de profils RVB. Les couleurs d'entrée dont la saturation dépasse la plage autorisée du profil sélectionné sont automatiquement écrêtées à une valeur maximale. « RVB Rec2020 linéaire » et « Adobe RVB (compatible) » permettent une gamme plus large de couleurs non écrêtées, tandis que « sRGB » et « RVB Rec709 linéaire » produisent un écrêtage plus serré. Sélectionner le profil qui empêche les artefacts tout en conservant la dynamique de couleur la plus élevée.

profil de couleur de sortie

Gère le profil de sortie pour l'exportation et l'intention de rendu à utiliser lors du mappage entre les espaces colorimétriques.

darktable est livré avec des profils prédéfinis sRGB, Adobe RVB, XYZ et RVB linéaire. Vous pouvez fournir des profils supplémentaires en les plaçant dans $DARKTABLE/share/darktable/color/out et $HOME/.config/darktable/color/out (où $DARKTABLE est le répertoire d'installation de darktable et $HOME est votre répertoire personnel).

Le profil de couleur de sortie peut également être défini dans le module exporter.

contrôles du module

intention de sortie

L'intention de rendu pour la sortie/l'exportation. L'intention de rendu ne peut être sélectionnée que lors de l'utilisation de LittleCMS2 pour appliquer le profil de couleur de sortie (cela peut être modifié dans préférences > traitement). Si les routines de rendu internes de darktable sont utilisées, cette option est masquée. Pour plus de détails, voir intention de rendu.

profil de sortie

Le profil utilisé pour rendre les couleurs pour l'exportation. Les données de profil seront intégrées dans le fichier de sortie (si pris en charge par le format de fichier) permettant à d'autres applications d'interpréter correctement ses couleurs. Comme toutes les applications ne connaissent pas les profils de couleurs, la recommandation générale est de s'en tenir au sRGB à moins que vous ne sachiez ce que vous faites et que vous ayez une bonne raison de faire autrement.

recadrer

Recadrer une image à l'aide des guides à l'écran.

Ce module apparaît plus tard dans le pipeline graphique que le module déprécié recadrer et pivoter, ce qui signifie que l'image complète peut rester disponible pour les points source dans le module retouche . Pour de meilleurs résultats, il est conseillé d'utiliser le module rotation et perspective pour effectuer la rotation et la correction de la perspective (si nécessaire), puis d'effectuer le recadrage créatif final avec ce module.

Chaque fois que ce module est actif, l'image complète non recadrée est affichée, avec en surimpression des poignées de recadrage et des lignes de guidage facultatives.

Redimensionner le recadrage en faisant glisser les bords et les coins de l'image.

Déplacez le rectangle de recadrage en cliquant à l'intérieur de la zone de recadrage et en faisant glisser. Contraindre le mouvement à l'axe horizontal/vertical en maintenant Ctrl/Maj, respectivement tout en faisant glisser. Validez les changements en donnant le focus à un autre module.

contrôles du module

Les contrôles du module recadrer sont répartis comme suit en deux sections :

paramètres de recadrage

aspect

Définissez la proportion du recadrage, en contraignant la proportion largeur:hauteur du rectangle de recadrage à l'aspect choisi. De nombreuses proportions numériques courantes sont prédéfinies. Quelques proportions spéciales méritent une explication :

libre : recadrer sans aucune restriction

image : proportion de l'image d'origine

carré : proportion à 1:1

nombre d'or : proportion égale au nombre d'or (1,62:1)

Vous pouvez également saisir tout autre rapport après avoir ouvert la liste déroulante en le tapant sous la forme « x:y » ou sous forme décimale (par exemple, « 0,5 » pour appliquer un ratio de 2:1).

Si vous souhaitez ajouter un rapport hauteur/largeur à la liste déroulante prédéfinie, vous pouvez le faire en incluant une ligne de la forme « plugins/darkroom/clipping/extra_aspect_ratios/foo=x:y » dans le fichier de configuration de darktable $HOME/.config/darktable/darktablerc. Ici, « foo » définit le nom du nouveau rapport hauteur/largeur et « x » et « y » les valeurs numériques correspondantes (x et y doivent être des entiers). Notez que vous ne pouvez ajouter de nouvelles entrées que pour les ratios qui ne sont pas déjà présents dans la liste déroulante.

Enfin, si vous avez sélectionné un rapport d'aspect rectangulaire, le bouton à côté de la liste déroulante aspect vous permet de basculer entre les orientations portrait et paysage.

Remarque : Lors du redimensionnement d'une image en mode libre, vous pouvez conserver le rapport hauteur/largeur actuellement défini en maintenant la touche Maj enfoncée tout en faisant glisser l'une des commandes de redimensionnement.

marges

Ces curseurs vous permettent de définir les proportions de l'image à réserver aux marges. Ils sont automatiquement mis à jour si vous déplacez ou redimensionnez la zone de recadrage sur l'image à l'aide de la souris.

Cette section est repliée par défaut, car elle est rarement utilisée

gauche

La proportion de l'image réservée à la marge gauche.

droite

La proportion de l'image réservée à la marge droite.

haut

La proportion de l'image réservée à la marge du haut.

bas

La proportion de l'image réservée à la marge du bas.

guides

Cochez la case pour afficher en superposition les guides. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides & superpositions pour plus de détails.

recadrer et pivoter (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.8 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser les modules recadrer pour recadrer l'image, rotation et perspective pour effectuer une rotation ou pour corriger la distorsion trapézoïdale, et orientation pour retourner l'image sur les axes horizontal/vertical.

Recadre, fait pivoter et corrige les distorsions de perspective à l'aide des guides à l'écran.

Chaque fois que l'interface utilisateur de ce module est active, l'image complète non recadrée sera affichée, recouverte de poignées de recadrage et de lignes de guidage facultatives.

Redimensionner le recadrage en faisant glisser les bords et les coins de l'image.

Déplacez le rectangle de recadrage en cliquant à l'intérieur de la zone de recadrage et en faisant glisser. Contraindre le mouvement à l'axe horizontal/vertical en maintenant Ctrl/Maj, respectivement tout en faisant glisser. Validez les changements en donnant le focus à un autre module.

Si vous avez l'intention d'utiliser le module retouche, il est recommandé d'utiliser le module rotation et perspective pour faire une rotation et/ou une correction trapézoïdale, et d'effectuer ensuite un recadrage créatif dans le module recadrer. Avec ce processus l'image entière sera encore disponible et donc les sources ponctuelles lumineuses seront toujours présentes quand vous activerez le module retouche, puisque le module recadrer est placé après le module retouche dans le pipeline graphique.

Remarque : Certains des outils de ce module (réglage de l'angle et correction de la distorsion de la perspective) nécessitent une interpolation des données de l'image originale. Pour de meilleurs résultats de netteté, définissez « lanczos3 » comme interpolateur de pixels dans préférences> traitement.

contrôles du module

Les contrôles du module recadrer et pivoter sont répartis entre deux onglets comme suit :

onglet principal

retourner

Retournez l'image sur l'axe horizontal, vertical ou les deux.

angle

L'angle de la rotation pour mettre de niveau une image en définissant une valeur numérique en degrés ou en utilisant la souris. Pour utiliser la souris, cliquez avec le bouton droit et faites glisser pour tracer une ligne le long d'un élément horizontal ou vertical approprié. Dès que vous relâchez le bouton de la souris, l'image est tournée de sorte que la ligne que vous avez dessinée corresponde à l'axe horizontal ou vertical.

keystone

Corrige les distorsions de perspective. Cet outil est utile, par exemple, lorsque vous photographiez un bâtiment élevé depuis le sol avec une courte focale, en visant vers le haut avec votre appareil photo. La liste déroulante vous permet de sélectionner le type de correction que vous souhaitez utiliser :

vertical : Limiter la correction aux lignes verticales

horizontal : Limite la correction aux lignes horizontales

les deux : Corrige les lignes horizontales et verticales en même temps

Selon le type de correction sélectionné vous pourrez voir deux ou quatre lignes droites de réglage superposées à votre image. Deux cercles rouges sur chaque ligne vous permettent de modifier la position des lignes avec votre souris. Chaque ligne comporte en outre un bouton de « symétrie ». S’il est activé (et mis en surbrillance rouge), tous les mouvements de la ligne affectée seront recopiés par symétrie miroir sur la ligne opposée.

Afin de corriger les distorsions de perspective, vous devrez trouver dans votre image un élément vertical et/ou horizontal adapté et aligner les lignes d’ajustement avec cet élément. Une fois ceci réalisé, pressez le bouton « ok » situé près du centre de votre image. L’image sera corrigée immédiatement. Vous pouvez à tout moment revenir en arrière et affiner votre correction en sélectionnant « correction appliquée » dans la zone de liste déroulante.

recadrage automatique

Utilisez cette option pour éviter les contours noirs sur les bordures des images. Utile lorsque vous pivoter l’image.

aspect

Définissez la proportion du recadrage, en contraignant la proportion largeur:hauteur du rectangle de recadrage à l'aspect choisi. De nombreuses proportions numériques courantes sont prédéfinies. Quelques proportions spéciales méritent une explication :

libre : recadrer sans aucune restriction

image : proportion de l'image d'origine

carré : proportion à 1:1

nombre d'or : proportion égale au nombre d'or (1,62:1)

Vous pouvez également saisir tout autre rapport après avoir ouvert la liste déroulante en le tapant sous la forme « x:y » ou sous forme décimale (par exemple, « 0,5 » pour appliquer un ratio de 2:1).

Si vous souhaitez ajouter un rapport hauteur/largeur à la liste déroulante prédéfinie, vous pouvez le faire en incluant une ligne de la forme « plugins/darkroom/clipping/extra_aspect_ratios/foo=x:y » dans le fichier de configuration de darktable $HOME/.config/darktable/darktablerc. Ici, « foo » définit le nom du nouveau rapport hauteur/largeur et « x » et « y » les valeurs numériques correspondantes (x et y doivent être des entiers). Notez que vous ne pouvez ajouter de nouvelles entrées que pour les ratios qui ne sont pas déjà présents dans la liste déroulante.

Enfin, si vous avez sélectionné un rapport d'aspect rectangulaire, le bouton à côté de la liste déroulante aspect vous permet de basculer entre les orientations portrait et paysage.

Remarque : Lors du redimensionnement d'une image en mode libre, vous pouvez conserver le rapport hauteur/largeur actuellement défini en maintenant la touche Maj enfoncée tout en faisant glisser l'une des commandes de redimensionnement.

montrer les guides

Cochez la case pour afficher les superpositions de guides chaque fois que le module est activé. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides et superpositions pour plus de détails.

onglet marges

Ces curseurs vous permettent de définir les proportions de l'image à réserver aux marges. Ils sont automatiquement mis à jour si vous déplacez ou redimensionnez la zone de recadrage sur l'image à l'aide de la souris.

gauche

La proportion de l'image réservée à la marge gauche.

droite

La proportion de l'image réservée à la marge droite.

haut

La proportion de l'image réservée à la marge du haut.

bas

La proportion de l'image réservée à la marge du bas.

reconstruction des couleurs

Récupère les informations des couleurs dans les hautes lumières brulées.

En raison de la nature des capteurs numériques, les hautes lumières surexposées manquent d'informations de couleur valides. Le plus souvent, ils apparaissent en blanc neutre ou présentent une certaine dominante de couleur, selon les autres étapes de traitement d'image impliquées. Ce module peut être utilisé pour « récupérer » les hautes lumières surexposées en remplaçant leurs couleurs par des couleurs mieux adaptées. Le module agit sur les pixels dont la luminance dépasse un seuil défini par l'utilisateur. Les couleurs de remplacement sont extraites des pixels voisins. La distance spatiale et la distance de luminance (plage) sont prises en compte pour la sélection des couleurs.

En raison d'une limitation de l'algorithme sous-jacent, les couleurs reconstruites peuvent parfois s'afficher de manière incorrecte si vous zoomez l'image dans la vue de la chambre noire. Si cela se produit, vous pourriez observer un décalage magenta dans les hautes lumières proches de bords à haut contraste, ou vous pourriez voir des hautes lumières incolores en cas d'utilisation simultanée avec la méthode « reconstruire les couleurs » du module reconstruire hautes lumières . Ces artefacts n'influencent que l'affichage de l'image à l'écran -- la sortie finale n'est pas affectée. Il est recommandé d'affiner les paramètres de ce module avec l'image entièrement visible à l'écran.

Notez qu'une fonctionnalité similaire est aussi disponible dans l'onglet reconstruire du module filmique rvb

contrôles du module

seuil

Le module reconstruction des couleurs remplace la couleur de tous les pixels cibles ayant une luminance supérieures à ce seuil. Seuls les pixels dont la luminance est inférieure au seuil sont considérés comme source valide pour les couleurs de remplacement. Si vous définissez ce paramètre trop haut, le module ne trouve aucun pixel cible. Un réglage trop bas réduit l'ensemble de couleurs de remplacement -- si aucune couleur appropriée n'est disponible, les couleurs d'origine sont conservées. Ce paramètre présente donc un « réglage idéal » spécifique à chaque image.

étendue spatiale

La distance spatiale que les pixels source peuvent avoir des pixels cible pour contribuer au remplacement des couleurs. Des valeurs élevées entraînent la contribution de pixels plus éloignés. Cela augmente les chances de trouver une couleur de remplacement, mais peut rendre la couleur de remplacement moins bien adaptée à la reconstruction.

étendue de luminance

La différence de plage (en luminance) que les pixels source peuvent avoir par rapport aux pixels cible afin qu'ils contribuent au remplacement des couleurs. Des valeurs plus élevées entraînent la contribution d'un plus grand nombre de pixels même si leur luminance diffère plus fortement des pixels cibles. Cela augmente à nouveau les chances de trouver une couleur de remplacement, mais augmente en même temps le risque d'apparition de couleurs inappropriées.

priorité

Cette liste déroulante définit si certaines couleurs de remplacement doivent prévaloir sur d'autres comme suit :

sans (par défaut) : tous les pixels contribuent de manière égale

couleurs saturées : les pixels contribuent en fonction de leur chromaticité -- plus une couleur est saturée, plus elle contribue

teinte : donne la priorité à une teinte spécifique (voir ci-dessous)

teinte

Ce curseur n'est visible que si vous définissez la priorité à « teinte ». Il vous permet de sélectionner une teinte préférée pour les couleurs de remplacement. Cela n'a d'effet que si la teinte préférée est réellement présente dans les étendues spatiale et de luminance sélectionnées des pixels cibles (voir ci-dessus). Un cas d'utilisation typique consiste à réparer les reflets sur la peau humaine dans des situations où des couleurs divergentes sont très proches (par exemple, des textiles ou des cheveux avec une luminance proche de celle de la peau). Définir une préférence de teinte sur les tons chair empêche ces autres couleurs de s'infiltrer.

reconstruire hautes lumières

Essaye de reconstruire les informations de couleur pour les pixels qui sont écrêtés sur un ou plusieurs des canaux RVB.

Si des pixels restent partiellement écrêtés, des couleurs irréalistes peuvent apparaître dans l'image. Par exemple, les pixels avec les canaux vert et bleu écrêtés apparaissent rouges et les hautes lumières ne sont pas reconstruites.

Trois méthodes de reconstruction sont disponibles :

tronquer les hautes lumières

Limite tous les pixels au niveau de blanc (c'est-à-dire tronque les canaux de couleur restants). Cette méthode est particulièrement utile quand les hautes lumières écrêtées se produisent dans des objets naturellement désaturés (des nuages par exemple).

reconstruire dans LCh

Analyse chaque pixel ayant au moins un canal écrêté et essaye de le corriger (dans l'espace colorimétrique LCh) en utilisant les valeurs des autres pixels (3 pour Bayer ou 8 pour X-Trans) du bloc concerné du capteur. Les hautes lumières reconstruites sont toujours monochromes, mais plus lumineuses et avec plus de détails qu'avec tronquer les hautes lumières. Cette méthode fonctionne assez bien avec une courbe de base à contraste élevé qui désature les hautes lumières. Comme avec tronquer les hautes lumières cette méthode est une bonne option pour les objets naturellement désaturés.

reconstruire les couleurs

utilise un algorithme qui transfère les informations de couleur d'un environnement non écrêté dans les hautes lumières écrêtées. Cette méthode fonctionne très bien sur les zones aux couleurs homogènes et est particulièrement utile sur les tons chair avec des hautes lumières qui s'estompent en douceur. Veuillez noter que cette méthode peut produire des artefacts de type labyrinthe sur les hautes lumières derrière des bords à fort contraste, par exemple des structures fines bien exposées sur un arrière-plan surexposé.

Pour que la reconstruction des hautes lumières soit efficace, vous devez également appliquer une correction IL négative dans le module exposition

Remarque : Lorsque vous utilisez la reconstruction des hautes lumières du module filmique rvb, il peut être utile de désactiver le module reconstruire hautes lumières afin que filmique ait plus d'informations avec lesquelles travailler.

contrôles du module

méthode

La méthode utilisée pour reconstruire les hautes lumières (voir ci-dessus).

seuil de troncature

Ajustez manuellement le seuil de troncature pour éviter des hautes lumières magenta. Vous ne devriez pas avoir besoin d'ajuster cela.

réduction du bruit (profil)

Un module de débruitage facile à utiliser et très efficace, adapté aux profils de bruit individuels d'une large gamme de capteurs de boîtier.

Un problème avec beaucoup d'algorithmes de débruitage est qu'ils supposent que la variance du bruit est indépendante de la luminosité du signal. En profilant les caractéristiques de bruit du capteur d'un boîtier à différents réglages ISO, la variance à différentes luminosités peut être évaluée et l'algorithme de débruitage peut être ajusté pour lisser plus uniformément le bruit.

Actuellement, darktable propose des profils de bruit de capteur pour plus de 300 modèles d'appareils photo populaires de tous les principaux fabricants. Si vous générez votre propre profil de bruit pour une boîtier qui n'est pas encore pris en charge par darktable, assurez-vous de le partager avec l'équipe de développement de darktable afin qu'elle puisse l'inclure dans la prochaine version ! Veuillez consulter la page support caméra de darktable pour plus d'informations.

modes

Le module réduction du bruit (profil) implémente deux algorithmes, chacun étant disponible soit dans un mode « auto » facile à utiliser, soit dans un mode manuel plus avancé avec des commandes supplémentaires :

moyennes non locales

Cet algorithme fonctionne dans le domaine spatial de la même manière que le module réduction du bruit photo astro. Il modifie chaque pixel de l'image en prenant en compte les pixels de son voisinage. Ces voisinages sont définis en utilisant le contrôle taille du module.

Notez que cet algorithme est assez gourmand en ressources.

ondelettes (par défaut)

Cet algorithme fonctionne dans le domaine des ondelettes et fournit une interface utilisateur simplifiée. La décomposition en ondelettes vous permet d'ajuster la force de débruitage en fonction de la grossièreté du bruit dans l'image. Ce mode peut être utilisé en mode couleur Y0U0V0 (qui vous permet de contrôler indépendamment les bruits de la luminance et de la chroma) ou en mode couleur RVB (qui vous permet de contrôler indépendamment le bruit pour chaque canal RVB).

L'algorithme ondelettes est moins gourmand en ressources que l'algorithme moyennes non locales.

bruit de luma contre bruit de chroma

Les algorithmes « moyennes non locales » et « ondelettes » peuvent tous les deux lutter efficacement contre le bruit de luma (clarté) et le bruit de chroma (couleur).

Dans le passé, il a été suggéré que vous utilisiez deux instances distinctes de ce module pour traiter indépendamment les bruits de chroma et de luma (en utilisant les modes de fusion chroma et clarté). Ce n'est plus recommandé, car le module réduction du bruit (profil) est placé avant le module profil de couleur d'entrée dans le pipeline graphique (afin que les paramètres du profil soient précis) et les modes de fusion des couleurs ne doivent être utilisés qu'après l'application du profil de couleur d'entrée.

Les nouveaux algorithmes de ce module fournissent désormais leurs propres méthodes pour gérer séparément les bruits de luma et de chroma. Dans les deux cas, cela peut être géré avec une seule instance de module.

contrôles du module

Le module réduction du bruit (profil) fournit des contrôles indépendants de l'algorithme utilisé. Ceux-ci sont décrits en premier, avant de passer aux contrôles spécifiques à chaque algorithme.

Lors de la description des contrôles spécifiques à un algorithme, nous allons d'abord couvrir l'interface simplifiée, puis passer aux contrôles plus avancés pour cet algorithme.

Notez que les curseurs sont fournis avec des valeurs minimales et maximales par défaut. Cependant, ce ne sont que des limites souples et, si nécessaire, des valeurs plus élevées peuvent être saisies en cliquant avec le bouton droit sur le curseur et en tapant une nouvelle valeur.

contrôles communs

profil

darktable détermine automatiquement le modèle de boîtier et l'ISO en fonction des données Exif de votre fichier RAW, et recherche un profil correspondant dans sa base de données. Si votre image a une valeur ISO intermédiaire, les paramètres seront interpolés entre les deux ensembles de données les plus proches dans la base de données, et ce paramètre interpolé apparaîtra comme la première ligne de la zone de liste déroulante. Vous pouvez également remplacer manuellement cette sélection si nécessaire. Re-sélectionner l'entrée la plus élevée dans la zone de liste déroulante vous ramènera au profil par défaut.

mode

Choisissez l'algorithme de débruitage à utiliser (voir ci-dessus) et choisissez son interface simplifiée (« auto ») ou son interface manuelle complète.

balance des blancs adaptative

Comme la balance des blancs amplifie différemment chacun des canaux RVB, chaque canal présente des niveaux de bruit différents. Cette case à cocher permet à l'algorithme sélectionné de s'adapter aux réglages de la balance des blancs. Cette option doit être désactivée sur la seconde instance si vous avez appliqué une première instance avec un mode de fusion des couleurs.

ajuster paramètres auto (modes auto uniquement)

Ajustez automatiquement tous les autres paramètres de l'algorithme de débruitage actuel à l'aide d'un seul curseur. Ceci est particulièrement utile lorsque vous avez dû augmenter l'exposition sur une image sous-exposée, ce qui introduit normalement un bruit supplémentaire (comme si vous aviez pris la photo avec un ISO plus élevé). Ce contrôle compense cela en utilisant des paramètres similaires à ceux utilisés pour une image ISO plus élevée. L'« ISO effectif » utilisé par l'algorithme de réduction du bruit est l'ISO réel utilisé, multiplié par la valeur de ce curseur.

force

Affinez la force du débruitage. La valeur par défaut a été choisie pour maximiser le rapport signal/bruit de crête. C'est surtout une question de goût -- soit vous préférez un faible niveau de bruit au détriment des détails fins, ou soit vous acceptez plus de bruit pour mieux préserver les détails fins.

préserver les ombres (mode avancé uniquement)

Diminuez la valeur de ce contrôle pour débruiter les ombres de manière plus agressive. Généralement, à mesure que le bruit augmente, vous devrez diminuer ce paramètre.

correction du biais (mode avancé uniquement)

Corrigez toute dominante de couleur qui peut apparaître dans les ombres. Augmentez cette valeur si les ombres sombres apparaissent trop vertes, diminuez-la si elles apparaissent trop violettes.

curseurs moyennes non locales (mode auto)

poids du point central (détails)

Contrôle la quantité de détails qui doivent être préservés par l'algorithme de débruitage. Par défaut, ce poids aura une faible valeur ce qui signifie que l'algorithme traitera à la fois, et de la même façon, le bruit de la luma et de la chroma. Déplacez ce curseur vers la droite pour réduire la quantité de débruitage de la luma, de sorte que l'algorithme affecte principalement le bruit de la chroma. En ajustant ce curseur avec le curseur force, vous pouvez trouver un bon équilibre entre le débruitage de la luma et de la chroma.

curseurs moyennes non locales (mode avancé)

Dans ce mode avancé vous ne disposez plus du curseur ajuster paramètres auto. Rien ne vous empêche de commencer par utiliser le mode moyennes non locales auto pour initialiser automatiquement certains paramètres, puis de passer dans le mode moyenne non locales (avancé) pour les affiner. Dans le mode avancé vous trouverez les curseurs suivants.

taille

Contrôle la taille des voisinages des pixels -- voir réduction du bruit photo astro pour plus d'informations. Augmentez cette valeur pour les images plus bruitées, mais sachez que des valeurs élevées peuvent lisser les bords fins. L'effet de ce curseur sur le temps de traitement est minime.

rayon

Contrôle jusqu'à quelle distance d'un pixel l'algorithme essaiera de trouver des patches similaires au patch contenant ce pixel. Le temps d'exécution est fortement impacté par ce paramètre : il dépend du carré du paramètre. Plus petite la valeur plus rapide l'exécution, plus grande la valeur plus lente l'exécution. Augmenter la valeur peut donner de meilleurs résultats pour des images fortement bruitées lorsque du grain grossier est visible.

dispersion (bruit à grain large)

Comme le rayon, ce curseur contrôle à quelle distance d'un pixel l'algorithme va tenter de trouver des patches similaires au patch contenant ce pixel. Cependant, il le fait sans augmenter le nombre de patches considérés. Le temps de traitement reste donc à peu près le même. Augmenter cette valeur réduira le bruit à grain grossier, mais peut atténuer le contraste local. Ce curseur est particulièrement efficace pour réduire le bruit chromatique,

courbes ondelettes

Les courbes des ondelettes sont affichées lorsque l'un des modes ondelettes ou ondelettes auto est sélectionné.

Généralement, le bruit d'une image se compose de divers degrés de bruit à grain fin et de bruit à grain plus grossier. Ces courbes permettent de réduire plus ou moins le bruit en fonction de la granularité du bruit visible. La partie gauche de la courbe agira sur le bruit à très gros grain, alors que sa partie droite agira sur le bruit à grain très fin. Pousser la courbe vers le haut donnera plus de lissage, la tirer vers le bas en donnera moins.

Par exemple, vous pouvez préserver le bruit à grains très fins en tirant vers le bas le point à l'extrême droite de la courbe. Autre exemple, si vous vous attaquez au bruit de la chroma (c.-à-d. avec la courbe U0V0, ou avec une autre instance du module en mode fusion couleur), vous pouvez pousser vers le haut la partie droite de la courbe, car les couleurs ne sont pas censées changer beaucoup dans les échelles à grains fins : cela vous aidera surtout si vous voyez quelques pixels isolés laissés non débruités.

ondelettes, mode couleur Y0U0V0

Le mode Y0U0V0 est la meilleure manière d'utiliser les ondelettes. Ce mode sépare les courbes de débruitage en composants de luminance (Y0) et de couleur (U0V0). Vous pouvez ensuite utiliser la courbe Y0 pour contrôler le niveau de débruitage de la luminosité et la courbe U0V0 pour celui de la couleur.

ondelettes, mode couleur RVB

Avant l'introduction du mode Y0U0V0 , le débruitage par ondelettes ne pouvait être réalisé que sur les canaux R, V et B pris ensemble ou individuellement.

Si vous voulez débruiter les canaux RVB individuellement, la meilleure façon de le faire est de procéder comme suit. Placez une instance du module calibration des couleurs immédiatement avant le module réduction du bruit (profil). Régler le module _calibration des couleurs_afin qu'il produise un canal gris basé uniquement sur le canal R. Puis débruitez cette image monochrome à l'aide de la courbe d'ondelettes R du module réduction du bruit profil. Procédez de même pour les canaux V et B. Cette procédure prend du temps, mais donne le meilleur résultat car examiner la couleur d'un pixel bruité n'est pas un moyen fiable pour déterminer quel canal est bruité. Par exemple, un pixel rouge bruité pourrait être provoqué par un pic de bruit sur le canal R, mais pourrait également être dû à un manque de bruit sur les canaux V et B.

Le problème avec le débruitage individuel des canaux RVB est qu'il peut subsister un bruit de chroma résiduel requérant un lissage excessif afin de l'éliminer. En fait, ce fut l'une des motivations clés ayant conduit à l'implémentation du mode couleur Y0U0V0.

curseurs des ondelettes (mode avancé)

Lorsque vous activez le mode ondelettes (non auto), le curseur ajuster paramètres auto est remplacé par les contrôles préserver les ombres et correction_du_biais énumérés plus haut dans la section contrôles communs.

réduction du bruit photo astro

Supprime le bruit de l'image tout en préservant la structure.

Ce module modifie chaque pixel de l'image en prenant en compte les pixels de son voisinage. Ces voisinages sont définis en utilisant le contrôle taille du module.

Comme la réduction de bruit est un processus consommateur de ressources, il ralentit de manière significative le traitement du pipeline graphique. Il est donc préférable d’activer tardivement ce module dans votre flux de travail.

contrôles du module

taille

Le rayon du voisinage des pixels.

force

La force du débruitage.

luma

La force du débruitage à appliquer à la luminance. La sélectionnez avec soin afin de ne pas perdre trop de structure.

chroma

La force du débruitage à appliquer à la chroma. Vous pouvez être beaucoup plus agressif avec ce paramètre.

réduction du bruit RAW

Effectue une réduction du bruit sur les données de l'image RAW avant leur dématriçage.

Ce module a été porté à partir de dcraw.

contrôles du module

seuil de bruit

Le seuil de détection du bruit. Des valeurs plus élevées entraînent une suppression du bruit plus importante et une plus grande perte de détails dans l'image.

courbes grossières/fines

Le bruit d'une image est généralement une combinaison de bruit à grains fins et à grains grossiers. Ces courbes permettent de réduire plus ou moins le bruit de l'image selon la « grossièreté » des grains du bruit visible. La gauche de la courbe agira sur un bruit à grains très grossiers, tandis que la droite de la courbe agira sur un bruit à grains très fins.

Tirer la courbe vers le haut entraînera plus de lissage, tandis que la tirer vers le bas entraînera moins de lissage. Par exemple, vous pouvez conserver un bruit à grains très fins en tirant vers le bas le point le plus à droite de la courbe jusqu'à la valeur minimale.

Si vous traitez le bruit de chroma avec un mode de fusion, vous pouvez tirer vers le haut la partie la plus à droite de la courbe tant que les couleurs ne changent pas trop dans la série des grains fins. Cela vous aidera surtout si vous voyez des pixels isolés laissés non débruités.

La meilleure façon d'utiliser les courbes R, V et B est d'examiner chacun des canaux à tour de rôle à l'aide du module calibration des couleurs en mode gris, de débruiter ce canal, puis de répéter pour les autres canaux. De cette façon, vous pouvez prendre en compte le fait que certains canaux peuvent être plus bruités que d'autres. Attention, deviner quel canal est bruité sans réellement voir les canaux individuellement n'est pas simple et peut être contre-intuitif. Un pixel qui est complètement rouge peut ne pas être causé par du bruit sur le canal R, mais en fait par du bruit sur les canaux V et B.

Voir la section ondelettes pour plus de détails.

renforcer la netteté

Accentue les détails de l'image à l'aide d'un masque de flou standard.

Ce module fonctionne en augmentant le contraste autour des bords et en améliorant ainsi l'impression de netteté d'une image. Ce module modifie le canal L dans l'espace colorimétrique Lab.

Remarque: L'algorithme USM (UnSharp Mask) utilisé dans ce module opère dans l'espace colorimétrique Lab. Il peut produire des effets indésirables et n'est plus recommandé. Utilisez à la place les préréglages fournis par le module égaliseur de contraste pour atténuer le flou, ou par le module contraste local pour une netteté générale.

contrôles du module

rayon

L'algorithme applique un flou gaussien à l'image. Ce paramètre contrôle le rayon de du flou qui, à son tour, définit l'étendue spatiale de l'amélioration des contours. Des valeurs très élevées conduisent à une accentuation excessive.

quantité

L'intensité de l'accentuation de la netteté.

seuil

Les différences de contraste inférieures à ce seuil sont exclues du traitement. Permet d'éviter l'amplification du bruit.

retouche

Supprime les éléments indésirables de votre image en copiant, corrigeant, floutant et remplissant à l'aide de formes dessinées.

Ce module étend les capacités du module déprécié correction des tâches (équivalent à l'outil "copie") de ce module) en incluant un outil "correcteur" (basé sur l'outil correcteur de GIMP), comme ainsi que les modes "remplir" et "flou". Il peut également tirer parti de la [décomposition en ondelettes] (../../darkroom/processing-modules/wavelets.md), permettant à l'image d'être séparée en couches de détails progressifs (de grossier à fin) qui peuvent être retouchées sélectivement avant d'être recombinées pour produire l'image de sortie.

copie et correction

La copie permet de masquer une partie de l'image (la cible) en la remplaçant par une zone copiée d'ailleurs dans l'image (la source). Par exemple, vous pouvez supprimer un petit nuage d'un ciel bleu :

La façon la plus simple de le faire est d'utiliser l'outil de copie (clonage) retouch-clone-icon . L'exemple suivant supprime le nuage en copiant le cercle de ciel bleu d'à côté :

Dans de nombreux cas, les bords de la forme source ne correspondent pas précisément à l'environnement de la cible, conduisant à des résultats peu naturels. Dans cet exemple, l'échantillon de ciel que nous avons choisi comme source est légèrement plus sombre que la cible, laissant un léger contour de la forme circulaire utilisée pour la copie :

Dans de tels cas, l'outil de correction retouch-heal-icon est plus approprié. Avec cet outil, la couleur et la luminance de l'échantillon sont mélangées pour mieux s'adapter au contexte. Dans cet exemple, l'outil de correction produit un résultat bien plus agréable que la copie :

formes de la source et de la cible

Une fois que vous avez choisi le mode correction ou copie, vous devez choisir la forme que vous souhaitez utiliser (cercle, ellipse, chemin ou brosse -- voir les masques dessinés pour plus de détails). Les formes de la source et de la cible sont identiques.

Lorsque vous survolez l'image avec votre souris, un symbole plus (+) apparaît pour indiquer où la forme source sera placée. Le curseur normal de souris indique la position de la forme cible :

Il est recommandé de choisir d'abord la position de la source suivie de la position de la cible comme suit :

Maj+clic pour définir la position de la forme source en "mode relatif". Le symbole "plus" (+) se place à l'emplacement cliqué et y reste jusqu'à ce que vous cliquiez sur l'image pour placer votre forme cible mémorisant ainsi la position relative de la source. Tant que vous ne modifiez pas l'emplacement de la source, le décalage de la source par rapport à la cible reste identique.

Ctrl+Maj+clic pour définir la position de la forme source en mode "absolu". Comme ci-dessus, le symbole "plus" (+) se place sur l'emplacement cliqué mais cette fois mémorise la position absolue de la source. Vous pouvez ensuite cliquer sur l'image pour placer la forme cible. Si vous placez des formes suivantes sans modifier l'emplacement source, la même position source est utilisée.

Une fois les formes source et cible placées sur l'image, elles peuvent être ajustées manuellement avec votre souris.

Remarque : Pour les formes cercle et ellipse uniquement, vous pouvez placer à la fois les formes source et cible d'un simple clic-glisser : cliquez sur l'emplacement cible souhaité, puis faites glisser, en relâchant le bouton de la souris lorsque vous atteignez le emplacement de la source souhaitée. Cette opération n'affecte pas le placement des formes suivantes.

remplissage et flou

Les outils de copie et de correction nécessitent tous deux l'utilisation d'une autre partie de l'image pour "remplir" la région masquée. Parfois, il n'y a pas d'échantillon approprié dans l'image pour cela. Dans de tels cas, le module retouche propose deux autres options :

retouche-icone-remplissage outil de remplissage

Remplit la région dessinée avec une couleur sélectionnée.

retouche-icone-flou outil de flou

Applique un flou à la région dessinée, en lissant tous les détails.

Ces deux options sont particulièrement utiles lorsqu'elles sont utilisées avec la décomposition en ondelettes, où elles peuvent être utilisées pour lisser les entités au sein d'une couche de détails déterminée.

la décomposition en ondelettes

Les ondelettes décomposent une image en un certain nombre de couches contenant chacune un niveau différent de détail, de sorte que vous pouvez travailler sur chaque couche indépendamment, puis les recombiner à la fin. Ceci est particulièrement utile dans la photographie de portrait, où vous pouvez traiter les tâches et les imperfections de la peau sur une couche de détails grossiers, en laissant la texture plus fine de la peau intacte. La section ondelettes fournit plus d'informations sur le processus de décomposition.

Cette méthode peut être utilisée avec l'outil de correction, par exemple, pour peindre sur une tache qui apparaît dans l'une des couches de détails grossiers, tout en laissant les poils dans les couches de détails fins intacts :

Il peut également être utilisé avec l'outil de flou pour réduire de grosse tâches sur la peau, encore une fois sans affecter les détails les plus fins (voir la section ondelettes pour plus de détails sur cette technique).

contrôles du module

outils de retouche

La section outils de retouche se compose de deux éléments :

formes

Ce nombre indique combien de formes ont été placées sur l'image, soit directement, soit dans une couche d'ondelettes.

Cliquez sur l'une des icônes de forme pour dessiner une nouvelle forme sur l'image (voir masques dessinés pour plus de détails).

Ctrl+clic sur une icône de forme pour dessiner plusieurs formes de suite (clic droit pour annuler).

Cliquez sur le bouton montre et édite les formes de l'échelle actuelle retouch-shapes-icon pour afficher et modifier toutes les formes présentes pour l'échelle d'ondelettes sélectionnée.

algorithmes

Choisissez un algorithme de retouche (copie, correction, remplissage ou flou). Ctrl+clic pour modifier l'algorithme utilisé pour la forme sélectionnée. Maj+clic pour définir l'algorithme par défaut (utilisé pour les nouvelles images ou lorsque vous réinitialisez les paramètres du module).

décomposition par ondelettes

La section décomposition en ondelettes s'organise autour d'un graphique à barres qui montre comment l'image a été décomposée en couches de détails (échelle). Les principales caractéristiques du graphique à barres sont :

Le carré noir à gauche représente l'image entière avant décomposition.

Les carrés gris montrent les différentes couches de détails, avec les détails fins à gauche et les détails grossiers à droite.

Le carré blanc à l'extrême droite représente l'image résiduelle (le reste de l'image après extraction des couches de détails).

Un point gris clair dans un carré montre la couche sélectionnée. Cliquez sur un autre carré pour sélectionner une couche différente.

La barre gris clair en haut indique les niveaux de détail visibles au niveau de zoom actuel. Zoomez pour voir des détails plus fins.

Le triangle en bas montre en combien de couches l'image a été décomposée. Faites glisser le triangle vers la droite pour créer plus de couches. Faites-le glisser vers la gauche pour diminuer le nombre de couches. Par défaut, aucune décomposition en ondelettes n'est effectuée.

Le triangle en haut indique la valeur du paramètre "fusion depuis" (voir ci-dessous).

Les lignes orange sous les carrés indiquent les calques auxquels des retouches ont été appliquées.

Les autres éléments de cette section sont :

échelles

Affiche le nombre de couches de détails dans lesquelles l'image a été décomposée. Zéro indique qu'aucune décomposition en ondelettes n'a été effectuée.

actuelle

Affiche la couche sélectionnée (également marquée par le point gris clair sur le graphique à barres).

fusion depuis

Ce paramètre permet d'appliquer une même modification à plusieurs échelles consécutives au sein d'un groupe en partant de l'échelle la plus grossière (à l'exclusion de l'image résiduelle) jusqu'à l'échelle sélectionnée. Par exemple, si fusion depuis est défini sur 3 et que l'échelle maximale est de 5, toutes les modifications ajoutées à l'échelle 5 seront appliquées aux échelles 3, 4 et 5. Les modifications ajoutées à l'échelle 4 seront appliquées aux échelles 3 et 4, et les modifications ajoutées à l'échelle 3 seront appliquées à l'échelle 3 uniquement. Si vous définissez fusion depuis sur 0, la fusion est désactivée et toutes les modifications s'appliquent uniquement à l'échelle dans laquelle elles sont définies. La définition de fusion depuis à l'échelle la plus élevée disponible (dans cet exemple, 5) désactive également la fusion.

           fusion depuis
               v
   0   1   2   3   4   5    échelle
               <-------o    édition à l'échelle 5
               <---o        édition à l'échelle 4
               o            édition à l'échelle 3
           o                édition à l'échelle 2
       o                    édition à l'échelle 1

retouche-icone-affiche affiche une seule échelle de décomposition

Affiche la couche d'ondelettes sélectionnée sur l'image centrale. La sélection de cette option fait apparaître un contrôle supplémentaire : pré-visualisation d'une seule échelle.

pré-visualisation d'une seule échelle

Ce contrôle qui permet d'ajuster les points noirs, blancs et gris de l'aperçu de l'échelle d'ondelettes pour le rendre plus visible. Cliquez sur l'icône icone-niveaux-auto-levels-icone pour définir ces valeurs automatiquement. Cela n'affecte pas le fonctionnement du module mais seulement l'aperçu de l'échelle d'ondelettes.

retouche-icone-couper couper

Coupe toutes les formes de la couche sélectionnée et les place dans le presse-papiers.

retouche-icone-coller coller

Colle les formes du presse-papiers vers la couche sélectionnée.

retouche-icone-cacher désactive les formes temporairement

Active ou désactive toutes les formes (sur la couche actuelle ou non) en supprimant temporairement l'effet du module.

retouche-icone-masque affiche les masques

Affiche les formes cible associées à la couche sélectionnée en superposition jaune.

formes

Cette section vous permet de modifier les paramètres liés à la forme sélectionnée :

forme sélectionnée

Indique quelle forme est sélectionnée et de quel type il s'agit.

mode de remplissage

Si l'algorithme remplissage a été choisi pour la forme sélectionnée, choisit d'"effacer" la forme ou de la remplir avec une "couleur".

couleur

Si le mode de remplissage "couleur" a été choisi, sélectionne la couleur avec laquelle remplir la forme. Vous pouvez cliquer pour sélectionner ou saisir une valeur RVB personnalisée ou utiliser la pipette de couleur pour prélever un échantillon de l'image.

luminosité

Si l'algorithme remplissage a été choisi pour la forme sélectionnée, affine la luminosité de la couleur. Ce curseur fonctionne également en mode "effacer".

type de flou

Si l'algorithme flou a été choisi pour la forme sélectionnée, applique un flou "gaussien" ou "bilatéral".

rayon de flou

Si l'algorithme flou a été choisi pour la forme sélectionnée, définit le rayon du flou.

opacité du masque

Modifie l'opacité du masque associé à la forme sélectionnée. Une opacité de 1,0 indique que la forme est complètement opaque et que l'effet du module est entièrement appliqué, tandis qu'une valeur inférieure à 1,0 indique que l'effet appliqué par la forme est mélangé avec l'image sous-jacente au degré indiqué par le curseur.

montrer les guides

Cochez la case pour afficher en superposition les guides. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides & superpositions pour plus de détails.

rotation des pixels

Les capteurs de certains appareils photographiques, comme Fujifilm FinePix S2Pro, F700, et E550, ont un modèle Bayer orienté diagonalement au lieu de la disposition orthogonale habituelle.

Sans correction cela conduirait à une image basculée, avec des coins noirs. Ce module applique la rotation nécessaire.

darktable détecte les images nécessitant cette correction grâce à leurs données EXIF et active automatiquement ce module. Pour les autres images le module reste toujours désactivé.

Ce module n'a pas de réglages.

rotation et perspective

Corrige automatiquement les lignes convergentes, une forme de distorsion de perspective. Le mécanisme sous-jacent est inspiré du programme ShiftN de Markus Hebel. Ce module permet également de régler la rotation de l'image.

Les distorsions de perspective sont un effet naturel lors de la projection d'une scène en trois dimensions sur un plan en deux dimensions et font apparaître les objets proches du spectateur plus grands que les objets éloignés. Les lignes convergentes sont un cas particulier de distorsions de perspective fréquemment observées dans les photographies d'architecture -- les lignes parallèles, lorsque photographiées sous un certain angle, sont transformées en lignes convergentes qui se rencontrent en un point à l'intérieur ou à l'extérieur du cadre de l'image.

Ce module est capable de corriger les lignes convergentes en déformant l'image de telle sorte que ces lignes deviennent parallèles au cadre de l'image. Les corrections peuvent être appliquées dans le sens vertical ou horizontal, ou les deux à la fois. Afin d'effectuer une correction automatique, le module recherche dans l'image les caractéristiques structurelles appropriées constituées de segments de ligne. Vous pouvez aussi définir les structures de lignes en dessinant un « rectangle de perspective » ou en dessinant plusieurs lignes horizontales et verticales sur l'image. Sur la base de ces segments (automatiques ou manuels), un calcul d'ajustement détermine les meilleures valeurs pour les paramètres du module.

Comme le cas d'utilisation le plus courant est la rotation, la correction de perspective est masquée par défaut. Cliquez sur l'en-tête "perspective" pour en afficher les contrôles.

Pendant que le module est actif (et qu'aucun des boutons de structure n'est sélectionné), vous pouvez faire un clic-droit et un glisser n'importe où sur l'image pour définir une ligne horizontale ou verticale. Cela entraîne la rotation de l'image pour rendre la ligne tracée horizontale ou verticale par rapport au cadre.

flux de travail pour la correction de la perspective

structure

La première étape consiste à obtenir des détails sur les structures horizontales et/ou verticales de l'image. Pour ce faire, trois méthodes sont proposées :

dessiner manuellement les lignes de structure

Cliquez sur l'icône draw-structure-lines-icon pour activer le mode de dessin au trait, puis cliquez et glissez sur l'image pour dessiner les lignes que vous souhaitez devenir horizontales ou verticales. Le module les détecte automatiquement et les colore respectivement en vert ou en bleu. Dessinez autant de lignes que souhaité (plus il y a de lignes mieux le mécanisme d'ajustement fonctionne), puis cliquez sur l'une des icônes de "correction" pour terminer. Vous pouvez revenir à tout moment à ce mode pour modifier les lignes. Modifiez une ligne en cliquant dessus ou sur les nœuds d'extrémité et en faisant glisser, cliquez avec le bouton droit sur une ligne pour la supprimer. Une fois satisfait, sélectionnez une icône de "correction" pour terminer.

définir manuellement un rectangle de perspective

Cliquez sur l'icône draw-structure-rectangle-icon pour activer le mode dessin du rectangle en perspective. Cela dessine un rectangle dont vous pouvez saisir et déplacer les coins de sorte que les côtés gauche et droit correspondent aux verticales, haut et bas aux horizontales. Puis cliquez sur une icône "correction" pour terminer. Vous pouvez revenir à tout moment à ce mode pour modifier le rectangle. Une fois satisfait, cliquez sur une icône "correction" pour terminer.

Cette méthode est similaire à la correction "perspective" du module recadrer et pivoter.

analyse automatiquement la structure

Cliquez sur l'icône get-structure-icon pour analyser les éléments structurels de l'image -- darktable détecte et évalue automatiquement les éléments de ligne. Maj+clic pour renforcer le contraste avant d'effectuer l'analyse. Ctrl+clic pour renforcer les bords. Ces deux variantes peuvent être utilisées seules ou en combinaison si l'analyse par défaut n'est pas en mesure de détecter un nombre suffisant de lignes.

Seules les lignes qui forment un ensemble de lignes convergentes verticales ou horizontales sont utilisées pour les étapes de traitement ultérieures. Les segments sont affichés en superposition à l'image, avec le type de ligne identifié par la couleur comme suit :

vert

Lignes verticales convergentes

rouge

Lignes verticales qui ne convergent pas

bleu

Lignes horizontales convergentes

jaune

Lignes horizontales qui ne convergent pas

gris

Autres lignes qui n'intéressent pas ce module

Les lignes rouge ou jaune sont considérées comme aberrantes et ne sont pas prises en compte pour l'ajustement automatique. Cette élimination utilise un processus statistique d'échantillonnage aléatoire, ce qui signifie qu'à chaque "analyse automatique", le motif de couleur des lignes est légèrement différent.

Vous pouvez modifier l'état des segments : cliquez avec le bouton gauche sur une ligne pour la sélectionner (la couleur vire au vert ou au bleu) ou cliquez avec le bouton droit pour la désélectionner (la couleur vire au rouge ou au jaune). Si vous maintenez le bouton de la souris enfoncé, vous pouvez balayer pour sélectionner/désélectionner plusieurs lignes à la fois. La taille du pinceau de sélection/désélection peut être modifiée avec la molette de la souris. Ou maintenez la touche Maj enfoncée ainsi que le bouton gauche ou droit de la souris tout en faisant glisser pour sélectionner ou désélectionner toutes les lignes de la zone rectangulaire dessinée.

Une fois satisfait des lignes retenues, cliquez sur une icône "correction" pour terminer.

ajustement

Une fois satisfait des lignes horizontales et verticales identifiées, en utilisant l'une des méthodes ci-dessus, cliquez sur l'une des icônes "correction" pour définir automatiquement les paramètres de correction. L'image corrigée avec les lignes en superposition sont alors affichées.

Vous pouvez n'appliquer que les corrections verticales vertical-icon , juste les corrections horizontales horizontal-icon , ou les deux ensemble both-icon . Ctrl+clic sur l'icône pour appliquer la rotation sans décalage de l'objectif. Maj+clic pour appliquer le décalage de l'objectif sans rotation.

rotation

Une fois les corrections de perspective appliquées, vous pouvez faire une dernière correction de rotation en ajustant le paramètre de rotation ou en cliquant avec le bouton droit et en faisant un glisser sur l'image pour définir une ligne horizontale ou verticale.

contrôles du module

rotation

Tourne l'image autour de son centre pour corriger l'horizon.

recadrage

Lorsqu'elle est activée, cette fonction recadre l'image pour supprimer les zones noires sur les bords causées par la correction de la distorsion. Vous pouvez recadrer pour obtenir le "plus grand côté" ou le plus grand rectangle qui conserve le rapport hauteur/largeur d'origine ("format d'origine"). Dans ce dernier cas, vous pouvez ajuster le recadrage automatique en cliquant dans la région découpée et en la déplaçant. La taille de la région est modifiée automatiquement pour exclure toute zone noire.

correction d'objectif (horizontale)

Corrige les lignes horizontales convergentes (rend les lignes bleues parallèles).

correction d'objectif (verticale)

Corrige les lignes verticales convergentes (rend les lignes vertes parallèles). Dans certains cas, vous pouvez obtenir une image plus naturelle si vous corrigez les distorsions verticales à 80 ou 90% plutôt qu'au maximum. Pour cela, réduisez le curseur après avoir appliqué la correction automatique.

cisaillement

Cisaille l'image le long d'une de ses diagonales. Ceci est lié à la correction simultanée des distorsions verticales et horizontales.

montrer guides

Lorsqu'elle est activé, une grille est superposée à l'image pour vous aider à juger la correction.

modèle d'objectif

Ce paramètre définit la longueur focale de l'objectif, le facteur de recadrage du boîtier et le rapport hauteur/largeur utilisés par l'algorithme de correction. Si "générique", une longueur focale de 28 mm et boîtier plein format 35 mm sont utilisés. Si "spécifique", la distance focale et le facteur de recadrage peuvent être réglés à l'aide des curseurs fournis.

focale

Si le modèle d'objectif est "spécifique", définit la longueur focale de l'objectif. La valeur par défaut est extraite des données Exif de l'image et peut être modifiée en ajustant le curseur.

facteur de cadrage

Si le modèle d'objectif est "spécifique", définit le facteur de recadrage du boîtier. Vous devrez normalement définir cette valeur.

ajustement aspect

Si le modèle d'objectif est "spécifique", ce paramètre définit le rapport hauteur/largeur de l'image. Ceci est utile pour "décompresser" les images prises avec un objectif anamorphique (qui modifie le rapport hauteur/largeur de l'image).

structure

Définit les lignes horizontales et verticales de l'image à l'aide d'une méthode manuelle ou automatique (voir la section sur le flux de travail pour plus de détails).

correction

Règle les curseurs de correction de distorsion automatiquement en fonction de la structure identifiée (voir la section sur le flux de travail pour plus de détails).

montrer les guides

Cochez la case pour afficher les superpositions de guides chaque fois que le module est activé. Cliquez sur l'icône à droite pour contrôler les propriétés des guides. Voir guides et superpositions pour plus de détails.

exemples

Voici une image avec un horizon penché et des lignes convergentes causées par la direction de l'appareil photo vers le haut :

L'image après avoir corrigé les distorsions de perspective verticales et horizontales à l'aide de la détection automatique de la structure. Notez l'ajustement du cadrage effectué automatiquement et la superposition toujours visible des lignes structurelles :

suppression de la brume

Automatiquement réduit l'effet de la poussière et de la brume dans l'air. Ce module peut aussi être employé pour renforcer la couleur spécifiquement dans les régions de faible contraste de l'image.

La brume absorbe la lumière des objets de la scène, mais c'est aussi une source de lumière de fond diffuse. Le module de suppression de brume estime d'abord pour chaque région de l'image la quantité de brume. Il supprime ensuite la lumière diffuse de fond en fonction de son niveau force local et restaure la lumière d'origine de l'objet.

Régler les deux commandes du module à un maximise l'élimination de la brume, mais est également susceptible de produire des artefacts. La suppression complète de la lumière atmosphérique peut rendre l'image plate et donner un style peu naturel. Les valeurs optimales sont généralement inférieures à l'unité et dépendent plutôt de l'image, mais aussi des préférences esthétiques personnelles.

contrôles du module

force

La quantité d'élimination de la brume. À un, le module supprime 100% de la brume détectée jusqu'à la distance spécifiée. Les valeurs négatives augmentent la quantité de brume dans l'image.

distance

Limite la distance jusqu'à laquelle la brume est supprimée. Pour de petites valeurs, la suppression de la brume est limitée au premier plan de l'image. La brume est supprimée de toute l'image si la distance est égale à un. Si la force est négative, la distance n'a aucun effet.

suppression des franges (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.6 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le module aberrations chromatiques à la place.

Ce module est conçu pour supprimer les franges de couleur pourpre ou autre qui proviennent des aberrations chromatiques longitudinales, aussi connues sous le nom d'aberrations chromatiques axiales.

Ce module utilise la détection des bords. Lorsque des pixels sont détectés comme appartenant à des franges, leur couleur est reconstruite à partir des pixels voisins moins saturés.

contrôles du module

mode opératoire

moyenne globale : ce mode est le plus rapide mais peut donner des aperçus assez incorrects en cas de fort grossissement. Comparativement à la moyenne locale , il peut aussi trop ou pas assez protéger certaines zones de couleur.

moyenne locale : ce mode est plus lent car il calcule des références de couleur locales pour chaque pixel, ce qui peut mieux protéger la couleur que la moyenne globale et permet une reconstruction de la couleur là où elle est réellement nécessaire.

seuil statique : ce mode n'utilise pas de références de couleur mais directement le seuil fourni par l'utilisateur.

rayon détection contours

L'algorithme utilise la différence entre l'image originale et sa version altérée par un flou gaussien pour détecter les bords. Essayer d'accroître cette valeur si vous souhaitez une détection plus forte des franges ou si l'épaisseur des bords des franges est trop grande.

seuil

Définit le seuil au delà duquel le bord d'un pixel est considéré comme étant une « frange ». Essayez de diminuer cette valeur s'il n'y a pas assez de franges détectées ou de l’accroître si trop de pixels sont désaturés.

table correspondance couleurs

Une table générique de correspondance couleurs implémentée dans l'espace colorimétrique Lab.

L'entrée de ce module est une liste de points sources et cibles et la correspondance complète est obtenue par des interpolations à l'aide de splines. Les tables de correspondance (LUTs) résultantes sont éditables à la main et peuvent être créées en utilisant l'utilitaire darktable-chart pour correspondre à une entrée donnée (telle que les tables de correspondance couleurs HALD et les paires d'images RAW/JPEG générées par le boîtier). Voyez Utilisation de darktable-chart pour des détails.

contrôles du module

palette de couleurs

La grille montre un ensemble de pastilles de couleur. Ces couleurs sont les points sources. La couleur cible de la pastille sélectionnée est affichée sous forme de décalages contrôlés par des curseurs sous la palette de couleurs. Un contour est dessiné sur les pastilles qui ont été modifiées (là où les couleurs source et cible diffèrent).

Cliquez sur une pastille pour la sélectionner, ou alors utilisez la zone de liste déroulante pastille ou la pipette de couleur. La pastille actuellement sélectionnée est marquée d'un carré blanc et son numéro est affiché dans la zone de liste déroulante.

Par défaut, le module charge les 24 pastilles d'un color checker classique et initialise la correspondance à l'identité (aucune modification de l'image). Les configurations avec plus de 24 pastilles sont affichées dans une grille 7x7.

interaction

Pour modifier la correspondance couleur, vous pouvez changer les couleurs source et cible, bien que le principal cas d'utilisation soit la modification des couleurs cible.

Commencez avec une palette appropriée de couleurs source (soit à partir du menu des préréglages, soit à partir d'un style que vous avez téléchargé). Vous pouvez ensuite modifier à l'aide des curseurs la clarté (L), le vert-rouge (a), le bleu-jaune (b) ou la saturation (c) des valeurs cibles des pastilles.

Pour changer la couleur source d'une pastille, vous pouvez sélectionner une nouvelle couleur à partir de votre image en utilisant la pipette de couleur et Maj+clic sur la pastille que vous souhaitez remplacer.

Double-cliquez sur une pastille pour la réinitialiser ; cliquez-droit sur une pastille pour la supprimer ; faites un Maj+clic sur un espace vide pour ajouter une nouvelle pastille (avec la couleur actuellement choisie comme source).

velvia

Sature les pixels en donnant plus d'effet aux noirs, aux blancs et aux pixels les moins saturés.

Remarque : Ce module provoque des changements de teinte et de luminosité qui peuvent être difficiles à gérer. À la place, utilisez le module balance couleur rvb pour le traitement de la couleur.

contrôles du module

force

La force de l'effet.

biais tons moyens

Réduit l'effet sur les tons moyens afin d'éviter les tons chair non naturels. La réduction du biais des tons moyens diminue la protection des tons moyens et renforce l'effet velvia global.

vibrance (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.4 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser le réglage de vibrance du module balance couleur rvb à la place.

Sature et réduit la clarté des pixels les plus saturés pour rendre les couleurs plus vives.

contrôles du module

vibrance

La quantité de vibrance à appliquer à l'image.

vignetage

Applique un effet de vignetage à l'image.

Le vignetage est une modification de la luminosité et de la saturation aux bords de l'image dans une forme spécifiée. Plusieurs des paramètres répertoriés ci-dessous peuvent également être modifiés à l'aide du contrôle graphique qui se superpose l'image lorsque le module a le focus, montrant la forme et l'étendue de l'effet.

Remarque : Ce module est connu pour provoquer des artefacts de bandes dans certaines conditions. Vous pouvez utiliser le module homogénéisation pour résoudre ce problème.

Remarquez aussi : Ce module peut produire des résultats non naturels et doit être utilisé avec précaution. Utilisez plutôt le module exposition avec un masque elliptique avec une grande zone de transition et, si nécessaire, utilisez le module balance couleur rvb avec le même masque pour réduire la saturation sur les bords.

contrôles du module

échelle

Le rayon de la zone de vignetage.

dégradé

La progressivité de l'effet. Des valeurs plus élevées provoquent une transition plus raide.

luminosité

L'intensité de l'éclaircissement (valeurs positives) ou de l'assombrissement (valeurs négatives).

saturation

Contrôle la saturation des couleurs lorsqu'elles sont désaturées/saturées dans la zone de vignettage assombrie/éclaircie.

centre horizontal/vertical

Décale le centre de la zone de vignetage horizontalement/verticalement.

forme

La forme de l'effet de vignetage. La valeur par défaut de 1 crée une zone circulaire ou elliptique. Des valeurs plus petites rendent la forme plus carrée ; des valeurs plus élevées la transforment en croix.

ratio automatique

Ajuste automatiquement le rapport largeur/hauteur de la zone de vignetage pour qu'il corresponde au rapport hauteur/largeur de l'image. Cela fait généralement que la zone de vignetage devient elliptique.

largeur/hauteur

Ajuste le rapport largeur/hauteur de la zone de vignetage.

homogénéisation

Active l'homogénéisation à l'aide d'un bruit aléatoire pour atténuer les artefacts de bandes dus aux dégradés du vignetage. Sélectionnez "sortie 8-bits" pour éviter les bandes à l'écran et pour les JPEG. Lorsqu'il est réglé sur "sortie 16-bits", seule une petite quantité d’homogénéisation est appliquée, juste assez forte pour compenser les bandes sur le niveau le plus fin des valeurs 16 bits. Il est maintenant recommandé d'utiliser à la place le module homogénéisation pour atténuer les artefacts de bande.

virage partiel

Crée un effet de virage linéaire bicolore où les ombres et les hautes lumières sont représentées par deux couleurs différentes.

Le module virage partiel ne convertit pas les images en noir et blanc et présente des avantages limités sur des images couleur. Afin d'effectuer un virage partiel traditionnel, l'entrée de ce module doit donc être monochrome.

contrôles du module

couleur des ombres et des hautes lumières

Définit la teinte et la saturation souhaitées pour les ombres et les hautes lumières. En cliquant sur les carrés de couleur, vous ouvrez une boîte de dialogue de sélection de couleurs qui vous propose des couleurs couramment utilisées ou vous permet d'en définir une dans l'espace colorimétrique RVB.

répartition

La répartition entre les ombres et les hautes lumières. Lorsqu'il est réglé sur 50 %, la moitié de la plage de clarté de l'image est utilisée pour le virage des ombres et l'autre moitié pour le virage des hautes lumières.

seuil

Pourcentage de la plage de clarté totale (tons moyens) qui n'est pas affectée par le virage de couleurs. Cela limite l'effet sur les ombres et les hautes lumières tout en préservant les tons moyens.

zones (déprécié)

Veuillez noter que ce module est déprécié depuis darktable 3.4 et ne devrait plus être utilisé pour de nouveaux développements. Veuillez utiliser l'égaliseur de tons ou plusieurs instances du module exposition avec des masques paramétriques pour affiner le ciblage d'une zone.

Ajuste la clarté d'une image à l'aide du zone system d'Ansel Adams.

La clarté de l'image (le canal L dans l'espace colorimétrique Lab) est divisée en un certain nombre de zones allant du noir pur au blanc pur. Ces zones sont affichées dans une barre de zones sous une image d'aperçu. Le nombre de zones peut être modifié en faisant défiler la souris sur cette barre (10 zones par défaut).

La barre de zones est divisée horizontalement avec la partie inférieure montrant les zones d'entrée du module et la partie supérieure les zones de sortie du module. Dans son état par défaut, les deux parties sont entièrement alignées. Alors que les zones de sortie sont statiques, vous pouvez cliquer avec le bouton gauche de la souris et faire glisser un point de contrôle dans les zones d'entrée pour modifier le mappage entre l'entrée et la sortie.

Le déplacement d'un point de contrôle étend proportionnellement les zones d'un côté et compresse les zones de l'autre côté de ce point. Tous les points de contrôle préexistants restent en place, empêchant efficacement les modifications des zones au-delà du point de contrôle suivant. Utilisez un clic droit pour supprimer un point de contrôle.

L'image d'aperçu au-dessus de la barre de zone montre comment les zones de l'image sont décomposées. Lors du survol d'une zone, cette zone, que ce soit à partir de l'entrée ou de la sortie, est surlignée en jaune sur l'image d'aperçu.

zones de couleurs

Ajuste sélectivement la clarté, la saturation et la teinte des pixels en fonction de leur clarté, saturation et teinte actuelles.

Ce module travaille dans l'espace colorimétrique CIE LCh, qui décompose les pixels en clarté, chroma (saturation) et teinte. Il vous permet de manipuler la clarté, la saturation et la teinte de groupes ciblés de pixels en utilisant des courbes.

Vous devez d'abord choisir si vous souhaitez ajuster (sélectionner) les pixels en fonction de leur clarté, de leur saturation ou de leur teinte. Vous pouvez ensuite utiliser trois courbes, sur leurs onglets respectifs, pour ajuster la clarté, la saturation et la teinte des plages de pixels sélectionnées via cette méthode.

Remarque : Ce module doit être utilisé avec précaution, car les transitions entre les couleurs peuvent ne pas être gracieuses. À la place, utilisez le module balance couleur rvb avec un masque paramétrique.

méthode de sélection de pixels

Le module zones de couleurs propose trois méthodes différentes pour sélectionner les pixels que vous souhaitez ajuster. Ce sont :

sélection par teinte (par défaut)

Sélectionne les pixels à manipuler en fonction de leur teinte. Par exemple, vous voudrez peut-être assombrir un ciel bleu ou changer une voiture rouge en une jaune. L'image suivante montre la gamme complète de teintes sur lesquelles vous pouvez choisir d'opérer :

sélection par clarté

Sélectionne les pixels à manipuler en fonction de leur clarté. Par exemple, vous voudrez peut-être rendre vos ombres plus lumineuses ou rendre vos hautes lumières plus jaunes. L'image suivante montre la gamme de niveaux de clarté sur lesquels vous pouvez choisir d'opérer, du sombre au clair :

sélection par saturation

Sélectionnez les pixels à manipuler en fonction de leur saturation. Par exemple, vous souhaiterez peut-être atténuer la saturation de certains pixels déjà très saturés ou modifier leur teinte. L'image suivante montre la gamme de niveaux de saturation sur lesquels vous pouvez choisir d'opérer, d'un gris monochrome complètement insaturé à la couleur la plus saturée :

courbes de manipulation de pixels

Une fois que vous avez choisi une méthode de sélection de pixels, la plage sélectionnée de niveaux de clarté, de saturation ou de teinte apparaîtra le long de l'axe horizontal des trois courbes de manipulation de pixels, qui peuvent être visualisées et ajustées en choisissant l'onglet approprié (clarté, saturation, teinte) .

Si, par exemple, vous choisissez la sélection par teinte (valeur par défaut), l'axe horizontal (sous les courbes de manipulation) affichera la gamme de teintes avec lesquelles vous pouvez travailler, et les trois courbes de manipulation de pixels apparaîtraient comme suit :

clarté

En déplaçant la courbe de clarté vers le haut ou vers le bas à un endroit (teinte) donné, vous pouvez éclaircir ou assombrir les pixels correspondant aux teintes où la courbe a été respectivement élevée ou abaissée. Dans l'exemple ci-dessous, le ciel bleu d'une image a été assombri pour un effet dramatique :

saturation

En déplaçant la courbe de saturation vers le haut ou vers le bas dans un endroit (teinte) donné, vous pouvez désaturer (rendre moins coloré) ou resaturer (rendre plus coloré) les pixels correspondant aux teintes où la courbe a été, respectivement, élevée ou abaissée. Dans l'exemple ci-dessous, un objet rouge en arrière-plan a été désaturé, il est donc moins gênant pour le sujet principal de la photo :

teinte

En déplaçant la courbe de teinte vers le haut ou vers le bas dans un emplacement (teinte) donné, vous pouvez décaler la teinte des pixels correspondant aux teintes où la courbe a été élevée ou abaissée, vous permettant de remplacer une couleur par une autre. Dans l'exemple ci-dessous, un jouet rose dans une image a été changé en bleu :

Les courbes travaillent de la même manière dans les modes de sélection basés sur la clarté et la saturation. Voir la section sur les courbes pour voir comment les courbes splines travaillent en général.

Notez que ces exemples sont quelque peu artificiels afin d'illustrer l'utilisation du module. Dans la pratique, ils devraient probablement être combinés avec des masques dessinés et/ou [des masques paramétriques](../../darkroom /masking-and-blending/masks/parametric.md) pour isoler davantage leur effet.

sélection de plage

Lors du réglage des courbes de manipulation de pixels, il peut parfois être difficile de déterminer exactement où les pixels tomberont sur l'axe horizontal. À droite des commandes d'onglet se trouvent une paire de pipette de couleur qui peuvent être utilisés pour vous aider.

Si vous cliquez sur la pipette de couleur de gauche et choisissez un pixel dans l'image, vous verrez une ligne verticale sombre indiquant où ce pixel tombe sur l'axe horizontal. Si vous faites un Ctrl+clic ou un clic-droit sur la même pipette de couleur, vous pouvez choisir une zone rectangulaire dans l'image -- la plage de valeurs représentée dans le rectangle sélectionné sera ombrée verticalement, avec une ligne sombre similaire indiquant la valeur médiane.

Si vous cliquez sur la pipette de couleur de droite, vous pouvez également choisir une zone rectangulaire sur l'image et l'affichage apparaîtra comme décrit ci-dessus (une zone ombrée avec une ligne verticale sombre). Cependant, dans ce cas, la pipette de couleur ajoutera également automatiquement des points de contrôle à la courbe, représentant la plage en surbrillance (voir ci-dessous). Faites simplement glisser le nœud central pour élever ou abaisser la courbe dans la plage sélectionnée. Sinon, maintenez la touche Ctrl enfoncée tout en sélectionnant une plage pour créer automatiquement une courbe positive (poussez la plage sélectionnée vers le haut) ou maintenez la touche Maj enfoncée tout en sélectionnant pour créer une courbe négative (appuyez vers le bas).

contrôles du module

Les contrôles suivants sont disponibles dans le module zones de couleurs :

onglets clarté, saturation et teinte

Chaque onglet affiche une courbe de manipulation des pixels pour vous permettre de modifier la « clarté », la « saturation » ou la « teinte » en fonction de la méthode de sélection des pixels.

éditer par zone

Choisissez comment interagir avec la courbe. Ce paramètre est désactivé par défaut, ce qui permet de placer librement les points de contrôle de la courbe. Cochez la case pour revenir au mode originel « éditer par zone »", dont les contrôles sont identiques aux contrôles utilisés pour définir la spline dans le module ondelettes.

mask-icon afficher le masque

Active l'affichage du masque pour mettre en évidence en jaune les pixels qui ont été affectés par les ajustements du module zones de couleurs.

sélectionner par

Définir l'axe horizontal (la plage de valeurs sur laquelle travailler). Vous pouvez choisir entre « clarté », « saturation » et « teinte » (par défaut). La modification de ce paramètre réinitialise toutes les courbes de manipulation de pixels à leur état par défaut (lignes droites horizontales). Si vous souhaitez travailler sur plusieurs plages, vous devez créer des instances supplémentaires du module.

mode

Choisissez entre un mode de traitement « doux » (par défaut) ou « prononcé ». Le mode par défaut est moins susceptible de provoquer des artefacts.

fusion

Utilisez ce paramètre pour régler la force de l'effet global.

interpolation

Définissez comment la courbe est interpolée à l'aide des points de contrôle définis par l'utilisateur. Voir la section courbes pour plus de détails.

modules utilitaires

capture

carte

chambre noire

impression

partagé

table lumineuse

capture

paramètres de la capture

session

visée directe

paramètres de la capture

Configurer une opération de capture d'image

Celle-ci peut comporter une séquence, un bracketing ou une prise de vue retardée. Vous pouvez aussi contrôler d’autres paramètres de l’appareil comme le mode de mise au point, l’ouverture, la vitesse d’obturation, la sensibilité ISO et la balance des blancs.

session

Définit un code de session pour permettre la création d'une nouvelle pellicule.

Dans la vue capture une session est une séquence de prises de vues qui vont être mises dans une même pellicule. Une nouvelle session signifie une nouvelle pellicule.

Le module session vous permet de définir un numéro de tâche, qui peut être utilisé pour créer votre nouvelle pellicule. Voir préférences > importer > options de session pour plus de détails sur la création de nouvelles pellicules en utilisant la variable $(JOBCODE) dans le module session.

visée directe

Contrôle le mode visée directe de votre appareil photo.

Les fonctionnalités telles que le réglage de la mise au point, la rotation, l'ajout de guides et de superpositions sont pris en charge.

carte

emplacements

paramètres de carte

trouver un lieu

emplacements

Créez des zones ou des emplacements et organisez-les sous forme de balises hiérarchiques.

Un emplacement est affiché sur la carte quand il est sélectionné. Initialement chaque emplacement est représenté par un carré ou un cercle, qui peut être changé en rectangle ou en ellipse en ajustant sa largeur et/ou sa hauteur.

Un emplacement peut aussi être créé à partir d'un polygone représentant une région OpenStreetMap (ville/pays). Pour ce faire, assurez-vous que le paramètre max points polygone est suffisamment grand (certains polygones de pays comptent plus de 150.000 points). Ensuite sélectionnez le lieu désiré dans le module trouver un lieu.

Chaque emplacement est mémorisé en temps que mot-clé et peut être retrouvé dans la collection géolocalisation du module collections. Le caractère tuyau "|" peut être utilisé pour insérer un niveau supplémentaire (un groupe d'emplacements).

contrôles du module

forme

Sélectionner le symbole cercle ou rectangle pour choisir la forme par défaut des nouveaux emplacements. Un symbole polygone est disponible quand une forme (polygone) est affichée par le module trouver un lieu.

nouvel emplacement / nouveau sous-emplacement

Quand aucun emplacement n'est sélectionné vous pouvez utiliser le bouton nouvel emplacement pour créer un emplacement au niveau racine. Quand un emplacement est sélectionné utilisez le bouton sous-emplacement pour créer un sous-emplacement.

tout montrer

Affiche ou cache tous les emplacements dans la zone visible de la carte.

actions sur la liste des emplacements

clic

Sélectionne ou désélectionne un emplacement. Si l'emplacement n'est pas visible sur la carte, la carte est automatiquement centrée sur cet emplacement.

Ctrl+clic

Édite le nom de l'emplacement. Presser Entrée pour enregistrer les changements ou Echap pour fermer la fenêtre d'édition sans enregistrer.

clic droit

Ouvre un sous menu qui vous permet de :

Éditer le nom de l'emplacement

Supprimer l'emplacement

Mettre à jour la pellicule -- la pellicule est alors remplie de toutes les images de l'emplacement sélectionné.

Basculer vers la vue table lumineuse et afficher la collection des images de l'emplacement sélectionné.

actions sur les emplacements sur la carte

Note : Les actions suivantes n'ont pas d'effet sur les emplacements polygone.

clic et déplacer

Déplace la forme de la localisation vers une nouvelle position sur la carte.

Ctrl+clic ou Ctrl+Maj+clic

Déplace une image ou un groupe d'images à l'intérieur de la forme d'un emplacement.

défilement souris

À l'intérieur d'un emplacement (mais pas au dessus d'une vignette), augmente ou diminue la taille de cette forme.

Au dessus d'une miniature, fait défiler les miniatures des images à cette position sur la carte.

En dehors d'un emplacement (et non au dessus d'une vignette) effectue zoom avant ou arrière de la carte.

Maj+défilement

Augmente ou diminue la largeur de l'emplacement.

Ctrl+défilement

Augmente ou diminue la hauteur de l'emplacement.

clic sur une localisation

Sélectionne un emplacement différent lorsque tout montrer est actif.

paramètres de carte

Permet de sélectionner les données cartographiques préférées parmi divers fournisseurs. Certains fournissent des couches supplémentaires (vue satellite, etc...).

contrôles du module

source cartographique

Choisir le fournisseur d'informations cartographiques.

max points polygone

Le module trouver un lieu n'affiche pas les polygones avec plus de points que cette limite pour des raisons de performance. Habituellement un polygone de pays compte entre 50.000 et 150.000 points.

afficher contrôles

Permet d'afficher les contrôles en haut à gauche de la vue centrale.

images filtrées

Lorsque cette option est sélectionnée, seules les images de la pellicule (collection courante) s'affichent dans la vue centrale. Si elle n'est pas sélectionnée, toutes les images de la bibliothèque actuelle sont affichées si les images correspondantes sont associées à des données GPS. Vous pouvez aussi changer cette option en pressant Ctrl+S.

max images

Le nombre maximum de miniatures affichées sur la carte.

facteur de taille d'un groupe

Augmente ou diminue la zone d'influence du regroupement d'images.

nombre minimum d'images par groupe

Le nombre minimum d'images pour créer un groupe d'images.

affichage miniatures

Définit quelle information est affichée sur la carte

aperçu : Affiche la miniature des images ainsi qu'un compteur.

nombre : Affiche seulement le nombre d'images (pour libérer de l'espace sur la carte). Survoler le nombre d'images pour faire apparaître la (les) miniature(s) correspondante(s). Ce compteur se comporte de la même façon qu'un aperçu en termes de codage couleur, défilement, glisser déplacer, etc...

aucun : N'affiche rien.

Vous pouvez également changer en boucle ces options en appuyant sur Maj+S.

trouver un lieu

Trouver un lieu sur la carte. Vous devez être connecté à Internet pour utiliser cette fonction.

Pour utiliser ce module, tapez un nom de lieu ou une adresse, appuyez sur Entrée et une liste de résultats s'affichera. Cliquez sur un élément de la liste et la carte s'agrandira jusqu'à ce lieu. Un contour couvrant ce lieu ou une épingle pointant vers ce lieu s'affiche.

Un contour (polygone) peut être utilisé pour créer un emplacement utilisateur. Vérifiez le paramètre max points polygone dans le module paramètres de carte pour vous assurer que suffisamment de points sont disponibles pour qu'un polygone soit affiché.

chambre noire

avertissement d'écrêtage

avertissement de surexposition raw

épreuvage écran

évaluation des couleurs

gestion des clones

gestion des masques

guides et superpositions

historique

instantanés

ligne d'informations de l'image

navigation

ordre des modules

pipette de couleur globale

vérification du gamut

avertissement d'écrêtage

Il met en évidence les zones de l'image qui peuvent présenter un écrêtage de la luminance ou du gamut.

Lorsqu'une image est envoyée à un périphérique d'affichage, chaque pixel est normalement représenté par un ensemble de trois nombres, représentant l'intensité des couleurs primaires rouge, vert et bleu dans l'espace colorimétrique de sortie. Étant donné que l'espace colorimétrique de sortie est généralement étroitement lié au matériel avec des limitations physiques, il existe une valeur maximale autorisée pour les canaux [R, V, B], représentant l'intensité maximale disponible pour cet espace colorimétrique. De même, il existe également une valeur minimale en dessous de laquelle les valeurs de pixel seront mises à zéro. Lorsque nous essayons de convertir d'un espace colorimétrique plus grand à l'espace colorimétrique de sortie final, toute valeur dépassant ce maximum sera limitée à la valeur maximale et toute valeur inférieure au minimum sera limitée à zéro. Ce processus est appelé "écrêtage" et il entraînera une perte de détails ou des couleurs "incorrectes" pour tous les pixels avec des canaux tronqués.

Cliquez sur l'icône avertissement d'écrêtage pour activer l'avertissement d'écrêtage.

Un pixel peut être tronqué de deux manières lorsqu'il est représenté dans l'espace colorimétrique de sortie.

écrêtage de luminance : cela peut se produire lorsqu'un pixel est trop lumineux pour être représenté dans l'espace couleur de sortie. La luminance des pixels est calculée comme une moyenne pondérée des canaux [R, V, B]. Si cette moyenne dépasse la valeur maximale autorisée, c'est une indication de surexposition. La luminance globale d'un pixel peut également être trop sombre pour être représentée par une valeur [R, V, B] dans l'espace colorimétrique de sortie, auquel cas elle sera simplement affichée en noir. Nous traitons normalement l'écrêtage de la luminance en ajustant soigneusement les mappages de tons et les niveaux d'exposition.

écrêtage du gamut : l'espace colorimétrique de sortie définit un ensemble de couleurs primaires qui, mélangées entre elles dans certains rapports, produisent la couleur de sortie finale. Cependant, il n'y a qu'un nombre limité de couleurs qui peuvent être produites en mélangeant une combinaison de ces trois couleurs primaires. Les couleurs très saturées en particulier peuvent être difficiles à représenter, en particulier pour les pixels très lumineux ou très sombres. S'il n'y a pas d'ensemble de valeurs positives [R, V, B] pouvant représenter une couleur donnée à un niveau de luminosité donné, nous disons que la couleur est "hors gamut", et, à la place, nous devons nous contenter d'une autre couleur qui peut être représentée par les valeurs [R, V, B] autorisées dans l'espace colorimétrique. Nous pouvons gérer l'écrêtage du gamut en faisant attention à ne pas trop saturer les couleurs dans les hautes lumières et les ombres, et éventuellement en utilisant certaines techniques d'étalonnage/mappage des couleurs.

Le module «avertissement d'écrêtage» est utilisé pour mettre en évidence les pixels qui ne peuvent pas être représentés avec précision dans l'espace couleur de sortie, en raison de l'écrêtage de la luminance ou du gamut. Avant darktable 3.4, l'écrêtage mettait en évidence tous les pixels qui dépassaient la valeur maximale autorisée sur l'un des canaux [R, V, B], ou qui avaient été complètement noircis. À partir de darktable 3.4, l'indicateur d'avertissement d'écrêtage propose des modes supplémentaires pour vous aider à faire la différence entre l'écrêtage de la luminance et l'écrêtage du gamut, afin que vous puissiez prendre de meilleures décisions sur la façon de résoudre les problèmes.

Comme l'avertissement d'écrêtage a lieu à la fin du pipeline graphique de l'aperçu, il reçoit des données dans l'espace colorimétrique d'affichage puis les convertit dans l'espace colorimétrique de l'histogramme. Si vous utilisez un espace colorimétrique d'affichage qui ne se "comporte pas bien" (cela est courant pour un profil de périphérique), alors les couleurs qui sont en dehors du gamut du profil d'affichage seront écrêtées ou déformées.

Le module avertissement d'écrêtage, décrit ici, vous signale l'écrêtage causé par le traitement de l'image et les limitations de l'espace colorimétrique de sortie. Il ne faut pas le confondre avec les outils similaires suivants :

L'avertissement de surexposition raw indique les endroits où les pixels du fichier RAW d'origine sont tronqués en raison des limitations physiques de la plage dynamique du capteur de la caméra. Ce module met en évidence les informations qui ont été définitivement perdues au moment de la capture d'image, et vous devez les traiter du mieux que vous pouvez en utilisant des techniques de récupération des hautes lumières.

Le module vérification du gamut fournit également des informations sur l'écrêtage résultant du traitement de l'image. Il est basé sur la bibliothèque externe littleCMS et il est plus ou moins équivalent au mode gamut complet du module avertissement d'écrêtage. Le module vérification du gamut a des inconvénients car il ne vous permet pas de faire la distinction entre l'écrêtage causé par la luminance et celui causé par le mappage du gamut, de plus, il est beaucoup plus lent que l'indicateur d'avertissement d'écrêtage.

contrôles du module

Cliquez-droit sur l'icône d'écrêtage pour afficher les options suivantes :

seuil de troncature

Choisissez le type d'écrêtage que vous souhaitez mettre en évidence :

un canal RVB : Fournit une indication de sur-écrêtage si l'un des trois canaux [R,V,B] dépasse la valeur maximale autorisée pour l'espace colorimétrique de l'histogramme, ou une indication de sous-écrêtage si les trois canaux [R, V, B] sont trop sombres et sont tous forcés au noir. C'était le mode par défaut avant la version 3.4 de darktable.

luminance seulement : Indique les pixels écrêtés car leur luminance se situe en dehors de la plage définie par les curseurs «seuil bas» et «seuil haut». Si cela se produit, cela signifie généralement que le mappage des tons ou les paramètres d'exposition ont été mal définis.

saturation seulement : Indique où les couleurs sursaturées ont poussé un ou plusieurs des canaux [R,V,B] vers une valeur en dehors de la plage autorisée de l'espace colorimétrique de l'histogramme, même si la luminance globale du pixel peut se situer dans des limites acceptables. Cela signifie que la couleur du pixel est impossible à représenter dans l'espace colorimétrique de l'histogramme et peut provenir d'un mappage du gamut ou de paramètres de saturation mal définis.

gamut complet : Affiche une combinaison des trois options précédentes. C'est le mode par défaut à partir de darktable 3.4. C'est celui qui signale le mieux les pixels potentiellement problématiques.

schéma de couleur

Par défaut, l'indicateur marque en rouge les pixels où le seuil supérieur est dépassé (sur-écrêtage) et en bleu ceux où le seuil inférieur est dépassé (sous-écrêtage). Ce schéma de couleurs peut être modifié en noir et blanc ou violet et vert pour les indicateurs "sur et sous", ce qui peut être utile pour améliorer la visibilité de certaines images.

seuil bas

Exprimé en IL par rapport au point blanc (qui est nominalement IL = 0). Si les canaux [R, V ,B] tombent tous en dessous de cette valeur, un indicateur de sous-écrêtage s'affiche pour vous avertir que le pixel peut finir par être coloré en noir. Utilisez la référence suivante pour définir ce seuil, en fonction du support de sortie souhaité :

sRVB 8 bits tronque les noirs à -12,69 IL

Adobe RVB 8-bits tronque les noirs à -19,79 IL

sRVB 16 bits tronque les noirs à -20,69 IL

un papier mat fine-art produit généralement du noir à -5,30 IL

un papier couleur brillant produit généralement du noir à -8.00 IL

un papier noir et blanc brillant produit généralement du noir à -9,00 IL

seuil haut

À quelle proximité de la limite supérieure doit être un pixel avant d'être signalé par l'avertissement d'écrêtage, exprimé en pourcentage (par défaut 98%). Dans le cas des vérifications de gamut, cela contrôle à quel point la saturation du pixel est autorisée à atteindre les limites du gamut de l'espace colorimétrique avant qu'une indication d'écrêtage ne soit signalée.

avertissement de surexposition raw

Les zones de l'image mises en évidence sont celles où les canaux de couleur du fichier d'entrée RAW sont écrêtés.

Les canaux de couleur écrêtés résultent d'une image surexposée avec une perte d'informations dans les zones affectées. Certaines de ces informations peuvent être récupérées à l'aide des modules reconstruire hautes lumières, reconstruction des couleurs ou filmique rvb.

Cliquez sur l'icône surexposition RAW pour afficher/masquer la superposition d'avertissement. Cliquez avec le bouton droit sur l'icône pour ouvrir une boîte de dialogue contenant les paramètres de configuration suivants.

mode

Choisissez comment marquer les zones écrêtées :

marquer avec les couleurs CFA : Pour indiquer quels canaux de couleur sont écrêtés, affiche un motif avec les couleurs primaires respectives (rouge, vert et bleu).

marquer avec une couleur unie : Marquer les zones écrêtées avec une couleur unie définie par l'utilisateur (voir ci-dessous), indépendamment des canaux de couleur affectés.

fausse couleur : Définir les canaux de couleur écrêtés à zéro dans les zones affectées.

schéma de couleur

Choisissez la couleur unie du mode marque avec couleur unie.

seuil de troncature

Fixez le seuil définissant les valeurs considérées comme surexposées. Dans la plupart des cas vous pouvez laisser ce curseur en toute sécurité à sa valeur par défaut de 1,0 (niveau de blanc).

épreuvage écran

Affichez votre image rendue à l'aide d'un profil de couleur sélectionné.

Cliquez sur l'icône épreuvage-écran pour activer le mode d'affichage épreuvage écran pour votre image. Cela vous permet de prévisualiser votre image rendue à l'aide d'un profil d'imprimante. Vous pourrez voir ainsi quelles seront les couleurs sur l'impression finale. Vous pouvez également activer l'épreuvage écran avec le raccourci clavier Ctrl+S. Un message «épreuvage» en bas à gauche de votre image vous indique que vous êtes en mode d'affichage épreuvage écran.

Cliquez-droit sur l'icône pour ouvrir une boîte de dialogue contenant les paramètres de configuration suivants. Pour chacun de ces paramètres, la liste des profils disponibles est lue dans $DARKTABLE/share/darktable/color/out et $HOME/.config/darktable/color/out (où $DARKTABLE représente le répertoire d'installation de darktable et $HOME votre répertoire personnel).

profil écran

Définissez le profil couleur de l'écran. L'option «profil écran du système» est le paramètre qui doit être préféré lorsqu'on travaille avec un écran calibré. Le profil est extrait soit du gestionnaire de couleurs de votre système, soit de votre serveur d'affichage X. La méthode utilisée par darktable pour détecter le profil d'affichage de votre système peut être modifiée dans préférences > divers. Pour plus d'informations, consultez la section profil écran.

profil de l'écran de prévisualisation

Définissez le profil couleur de l'image de prévisualisation si un second écran est utilisé.

intention de rendu

Définissez l'intention de rendu pour votre écran -- uniquement disponible si le rendu avec LittleCMS2 est activé. Voyez intention de rendu pour une liste des options disponibles. Cette option apparaît deux fois -- une fois pour le "profil écran" et une fois pour le "profil écran de prévisualisation".

épreuvage écran

Définissez le profil couleur pour l'épreuvage écran. Généralement, ces profils sont fournis par votre imprimante ou générés lors du profilage de l'imprimante.

profil de l'histogramme

Définissez le profil couleur de l'histogramme. Aucune des options disponibles n'est idéale, cependant, "profil écran du système" est probablement le paramètre le moins mauvais, car tous les autres profils sont dérivés de l'espace colorimétrique de l'écran et les valeurs seront au moins conformes à ce que vous voyez à l'écran.

évaluation des couleurs

Évaluez les couleurs et la luminosité de votre image à l'aide des conditions d'affichage recommandées par ISO 12646:2008.

Lors du développement d'une image, la façon dont nous percevons la luminosité, le contraste et la saturation est influencée par les conditions ambiantes. Si une image est affichée sur un fond sombre, comme avec le thème par défaut dans darktable, cela peut avoir un certain nombre d'effets négatifs sur notre perception de cette image :

L'exagération de l'exposition perçue fait que l'image semble plus lumineuse qu'elle ne l'est en réalité. Ceci est joliment illustré par l'effet d'ombre du damier d'Adelson.

Une diminution de la saturation perçue dans l'image fait que les couleurs semblent moins riches qu'elles le sont réellement (effet Hunt).

Une diminution du contraste perçu dans l'image fait que les tonalités semblent plus plates qu'elles le sont réellement (effet Bartleson-Breneman 3)

Il en résulte que l'image finale peut être trop sombre et mal développée en termes de contraste et de saturation des couleurs. Pour éviter cela, la norme "ISO 12646:2008" fait quelques recommandations sur les conditions dans lesquelles les couleurs d'une image doivent être évaluées. Le module évaluation des couleurs de la chambre noire place un cadre autour de l'image pour aider l'utilisateur à mieux évaluer les couleurs de l'image dans le sens de ces recommandations.

Lorsque dans le panneau inférieur, le bouton évaluation des couleurs icône-ampoule est sélectionné, l'image est dézoomée et une large bordure gris moyen apparaît autour de l'image. Elle va servir de référence pour comparer les tons de l'image. Une bordure blanche plus fine est placée immédiatement autour de l'image pour donner aux yeux une base de comparaison lorsqu'ils regardent des parties de l'image qui sont censées être d'un blanc éclatant.

Le mode évaluation des couleurs fournit à l'image un environnement gris moyen mais il est de plus recommandé de choisir, pour votre interface utilisateur, l'un des thèmes "gris" dans préférences > général). Ces thèmes sont conçus pour fournir une interface proche du gris moyen (elle est en fait légèrement plus foncée pour permettre un meilleur contraste avec le texte qu'elle contient). Si l'un de ces thèmes est utilisé en même temps que le mode évaluation des couleurs, les problèmes de perception évoqués ci-dessus seront plus facilement évités.

Le mode évaluation des couleurs peut également être activé/désactivé en appuyant sur Ctrl+B.

gestion des clones

Afficher et créer plusieurs versions de l'image actuelle. Chaque version peut être modifiée indépendamment sans affecter les autres versions -- toutes les versions utilisent le même fichier image sous-jacent, mais l'historique des modifications de chaque version est stocké dans un fichier annexe XMP indépendant.

Le module gestion des clones liste, sous forme de miniatures, les différentes versions de l'image actuellement en développement dans la chambre noire. Maintenez le bouton gauche de la souris enfoncé sur une miniature pour afficher temporairement cette version dans la vue centrale. Double-cliquez pour basculer vers cette version et la modifier.

Les boutons en bas du module vous permettent de créer de nouveaux clones de l'image actuelle. Vous pouvez soit créer une version 'vierge' (avec un historique vide) en utilisant le bouton «original» ou une copie exacte de l'édition actuelle en utilisant le bouton «cloner».

Un numéro de version s'affiche à droite de chaque miniature. Cliquez dans la zone de saisie située sous ce numéro pour saisir une description de cette version de l'image. Cette description est stockée dans la balise nom de version du module informations de l'image. Elle peut aussi être modifiée dans le module éditeur de métadonnées de la vue table lumineuse.

gestion des masques

Il gère tous les masques et toutes les formes définis pour l'image actuelle.

Ce module peut être utilisé pour créer, renommer, éditer et supprimer des formes. Vous pouvez ajouter et supprimer des formes d'un masque, regrouper des formes et les combiner à l'aide d'opérateurs définis.

La ligne supérieure du panneau du module gestion des masques contient des boutons qui peuvent être utilisés pour créer de nouvelles formes. Ce sont les mêmes que dans l'interface masque dessiné des modules de traitement.

Le panneau sous ces boutons affiche une liste de tous les masques et formes individuelles définis pour l'image actuelle.

Chaque groupe de formes intervenant dans la constitution d'un masque est affiché avec un titre "grp <nom_module>" indiquant le module dans lequel il est utilisé. Les formes le composant sont listées en-dessous de ce titre. La liste des groupes du masque est suivie d'une liste de toutes les formes individuelles qui ont été générées dans le contexte de l'image actuelle. Si une forme est utilisée par des masques, cela est indiqué par un symbole à droite du nom de la forme.

formes

Par défaut, chaque forme reçoit un nom généré automatiquement, composé du type de forme ("pinceau", "cercle", "ellipse", "chemin", "dégradé") et d'un entier incrémenté automatiquement. Vous pouvez renommer une forme en double-cliquant sur son nom actuel. C'est une bonne habitude de donner aux formes et aux groupes des noms significatifs, surtout si vous avez l'intention de réutiliser la même sélection dans différents masques.

Cliquez sur le nom d'une forme pour afficher la forme sélectionnée sur le canevas de l'image avec tous ses contrôles, vous permettant de modifier les propriétés de cette forme uniquement. Ceci est particulièrement utile lorsqu'il y a de nombreuses formes qui se chevauchent dans un masque, ce qui rend difficile la sélection de la bonne avec la souris. De même, si vous sélectionnez une forme à l'écran à l'aide d'un contrôle du masque d'un module de traitement, cette forme sera sélectionnée dans le gestionnaire de masques.

Cliquez-droit sur le nom d'une forme pour afficher un menu contenant des options permettant de dupliquer, de supprimer la forme actuelle ou de supprimer toutes les formes non utilisées actuellement.

Remarque : darktable conserve toutes les formes qui ont déjà été définies pour l'image actuelle, sauf si vous les supprimez explicitement. Si vous choisissez d'inclure l'historique de développement lors de l'exportation d'une image, toutes les formes définies seront exportées avec l'image. Attention, si la liste des formes est très longue, l'espace requis pour stocker ces formes peut dépasser la taille limite de certains formats de fichiers. Cela peut entraîner l'échec de la création d'étiquettes dans le fichiers XMP lors de l'exportation.

masques & groupes

Les masques sont construits en ajoutant à l'image un groupe de formes dans l'ordre où elles sont listées (de haut en bas). Chaque forme ajuste le masque existant à l'aide de l'un des quatre opérateurs d'ensemble logique (voir ci-dessous). L'ordre étant important, il est également possible de déplacer les formes vers le haut et vers le bas dans la liste.

Cliquer sur le nom d'un groupe dans gestion des masques développe ce groupe en affichant la liste de ses formes constituantes. Les formes correspondantes sont affichées sur l'image centrale. Alternativement, lorsque la gestion des masques est active, vous pouvez développer ce groupe en montrant les formes du masque dans le module de traitement correspondant.

Cliquez-droit sur le nom d'un groupe pour afficher un menu contenant des options permettant d'ajouter des formes nouvelles ou existantes au groupe. Ce menu propose aussi de supprimer les formes non utilisées ou le groupe.

Cliquez-droit sur l'une des formes utilisées dans le groupe pour examiner la part que prend cette forme dans la création, par ce groupe, du masque global :

enlever du groupe

Enlève la forme du masque actuel.

inverser forme

Inverse la polarité de la forme sélectionnée.

mode

Choisissez comment cette forme va interagir avec le masque précédent en sélectionnant l'un des quatre opérateurs d'ensemble définis ci-dessous.

monter/descendre

Monte ou descend la forme dans la liste.

Vous pouvez également créer vos propres groupes avec des formes existantes en sélectionnant celles que vous souhaitez regrouper, en cliquant-droit dessus et en choisissant «regrouper les formes».

opérateurs d'ensemble

Les opérateurs d'ensemble sont utilisés pour définir la manière dont les formes groupées sont combinées. Dans les exemples suivants, nous utiliserons un masque qui combine un dégradé suivi d'un chemin, pour démontrer l'effet de chaque opérateur lorsqu'il est appliqué à la forme chemin.

Par convention, nous disons qu'un pixel est "sélectionné" dans un masque ou une forme s'il a une opacité strictement supérieure à zéro.

union

Il s'agit de l'opérateur défini par défaut et est représenté par le symbole icône-union à gauche du nom de la forme. La forme s'ajoute au masque existant de telle sorte que le masque résultant contienne les pixels qui sont sélectionnés dans le masque existant ou dans la forme ajoutée. Dans les zones qui se chevauchent, la valeur maximale est prise :

intersection

Cet opérateur d'ensemble est représenté par le symbole icône-intersection à gauche du nom de la forme. La forme s'ajoute au masque existant de telle sorte que le masque résultant ne contienne que des pixels sélectionnés dans le masque existant et dans la forme ajoutée. Dans les zones qui se chevauchent, la valeur minimale est utilisée. Dans l'exemple donné, nous utilisons cet opérateur pour «imprimer» le chemin avec un dégradé :

différence

Cet opérateur d'ensemble est représenté par le symbole icône-difference à gauche du nom de la forme. Dans la zone sans chevauchement, le masque existant est inchangé. Dans le masque résultant, les pixels sont sélectionnés uniquement s'ils sont sélectionnés dans le masque existant mais pas dans la forme ajoutée. Cet opérateur d'ensemble peut être choisi si vous souhaitez « découper » une région dans une sélection existante :

exclusion

Cet opérateur d'ensemble est représenté par le symbole icône-exclusion à gauche du nom de la forme. Le masque résultant sélectionne tous les pixels sélectionnés dans le masque existant et non dans la forme ajoutée et vice versa. Cela équivaut à un «ou exclusif» :

guides et superpositions

Un certain nombre de guides de composition couramment utilisés peuvent être superposés à votre image pendant que vous l'éditez. Ceux-ci peuvent être activés soit globalement (tout le temps) soit localement (lorsque certains modules sont actifs).

D'autres fonctionnalités de la chambre noire dessinent également des lignes de superposition colorées sur l'image (par exemple, les masques dessinés). Une option est également fournie pour changer la couleur de ces superpositions (voir ci-dessous).

guides globaux

Cliquez sur l'icône icône-superposition-guides dans la barre inférieure pour afficher globalement les superpositions de guides. Les superpositions resteront activées jusqu'à ce que vous cliquiez une deuxième fois sur le bouton pour les désactiver.

Cliquez-droit sur l'icône pour afficher la boîte de dialogue des paramètres (voir ci-dessous).

guides locaux

Une utilisation plus courante consiste à activer les guides uniquement lorsqu'un module spécifique est activé. Le contrôle suivant est ajouté par défaut à tous les modules qui recadrent/déforment l'image (actuellement recadrer, recadrer et pivoter, orientation, cadre décoratif, liquéfier , correction des objectifs, retouche et rotation et perspective) :

Cochez la case pour afficher les superpositions de guides chaque fois que le module est actif. Cliquez sur l'icône à droite pour afficher la boîte de dialogue des paramètres (voir ci-dessous).

paramètres de superposition des guides globaux

Veuillez noter que, bien que vous puissiez choisir d'activer et de désactiver les superpositions de guides globalement ou localement, les paramètres suivants sont stockés globalement et ne peuvent pas être définis indépendamment pour chaque module.

type

Le type de ligne des guides de composition à afficher.

retourner

Certains guides sont asymétriques. Cette option vous permet de retourner ces guides horizontalement/verticalement.

lignes horizontales, lignes verticales, subdivisions

Lorsque le type de superposition grille est sélectionné, définissez les paramètres de la grille.

couleur de superposition

La couleur des lignes de superposition. Notez que cela a un impact sur toutes les lignes tracées directement sur l'image, par exemple les masques dessinés.

historique

Affiche et modifie l'historique de l'image actuelle de la chambre noire.

Ce module liste chaque changement d'état (activer/désactiver/déplacer/changer les paramètres) pour tous les modules de traitement qui ont été modifiés pour l'image courante. Sélectionnez un point dans l'historique pour revenir à l'étape correspondante de développement de l'image. Maj+clic sur un élément de l'historique pour déplier le module correspondant dans le panneau des modules, à droite, sans modifier le développement actuel.

Attention : Si vous sélectionnez un module de l'historique, puis apportez d'autres modifications à l'image, toutes les modifications au-dessus de l'étape actuellement sélectionnée seront ignorées. Il est facile de perdre ainsi un travail de développement sur une image ! Vous pouvez généralement utiliser Ctrl+Z pour annuler de telles modifications.

Vous pouvez, en toute sécurité, quitter le programme, quitter la vue chambre noire ou passer à une autre image après avoir sélectionné un élément de l'historique. Lorsque vous revenez à cette image, vous trouverez le panneau de l'historique dans l'état où vous l'avez laissé.

Passez la souris sur un élément de l'historique pour afficher une info-bulle avec les détails de toutes les modifications apportées à ce module par rapport à son état précédent ou à son état par défaut. Cela peut vous aider à traquer les ajustements qui ont été faits par inadvertance.

Cliquez sur «compresser l'historique» pour générer l'historique le plus court qui reproduit l'image actuelle. Cela entraîne la suppression de toutes les modifications au-dessus de l'étape actuellement sélectionnée. Si un module apparaît plusieurs fois dans le reste de l'historique, il sera compressé en une seule étape de l'historique.

Cliquez sur "compresser l'historique" tout en maintenant la touche Ctrl enfoncée pour tronquer l'historique sans le compresser, c'est-à-dire supprimer tous les modules au-dessus de celui actuellement sélectionné, mais en laissant le reste de l'historique inchangé.

Cliquez le bouton «réinitialiser» dans l'en-tête du module pour supprimer l'intégralité de l'historique et réactiver les modules par défaut. Cela peut également être réalisé en sélectionnant l'élément «original» de l'historique et en cliquant sur «compresser l'historique».

Le bouton à droite du bouton "compresser l'historique" permet de créer un nouveau style à partir de l'historique de l'image actuelle, style qui pourra ensuite être appliqué à d'autres images. Utilisez la première ligne de la fenêtre de dialogue contextuelle pour nommer votre style et la seconde pour ajouter une description qui pourra être recherchée. Vous serez invité à choisir les modules de l'historique actuel qui seront inclus dans le style.

Une fois créés, les styles peuvent être gérés et appliqués à d'autres images avec le module styles de la table lumineuse. Vous pouvez également affecter des touches de raccourci à vos styles (voir préférences > raccourcis) et appliquer le style associé à toutes les images sélectionnées en appuyant sur la touche de raccourci chaque fois que vous êtes dans les vues table lumineuse ou chambre noire.

instantanés

Stocke les instantanés de développement et les compare avec la modification actuelle.

Un instantané est une image bitmap stockée de l'image centrale de la vue chambre noire. Des instantanés peuvent être pris à n'importe quel moment du processus de développement et être ensuite superposés à la vue centrale actuelle. Cela vous permet d'effectuer une comparaison côte à côte (par défaut gauche=instantané, droite=édition active) pendant que vous réglez les paramètres d'un module. Cela peut également être combiné avec le module historique pour comparer un instantané avec différentes étapes de développement.

Pour prendre un instantané, cliquez sur le bouton prendre un instantané. Au-dessus du bouton, vous verrez une liste des instantanés qui ont été pris pour cette session de développement. Le nom de chaque instantané reflète le nom du module sélectionné dans l'historique et sa position au moment où il a été pris.

Cliquez sur le nom d'un instantané pour l'afficher -- cela active une vue fractionnée entre l'image instantanée enregistrée et l'image traitée dans son état actuel. Vous pouvez contrôler la vue fractionnée en déplaçant, avec votre souris, la ligne de séparation d'avant en arrière sur l'image. Si vous survolez la ligne de séparation avec votre souris, une petite icône de rotation apparaîtra au centre de la ligne. Cliquez sur cette icône pour basculer entre les vues fractionnées verticale et horizontale.

À tout moment, une flèche contenant la lettre "S" est affichée pour indiquer de quel côté de l'image se trouve l'instantané et de quel côté se trouve le développement actuel.

Cliquez à nouveau sur le nom de l'instantané pour désactiver la superposition et revenir à votre session de développement. Cliquez sur le bouton de réinitialisation du module pour supprimer tous les instantanés existants.

Remarque : Les instantanés sont conservés pendant toute la durée de votre session darktable. Cela signifie que vous pouvez également utiliser des instantanés pour les comparer avec un développement dupliqué de la même image. Accédez simplement à cette image et activez la vue instantanée comme d'habitude.

ligne d'informations de l'image

Afficher des informations sur l'image actuelle dans un panneau de chambre noire.

Le contenu de cette ligne peut être défini dans préférences > chambre noire. Voir la section variables pour plus d'informations sur les variables qui peuvent être utilisées ici. Vous pouvez également insérer une nouvelle ligne avec $(NL).

La ligne d'informations de l'image peut être affichée dans le panneau supérieur, inférieur, gauche ou droit en fonction d'un élément de configuration supplémentaire dans préférences > chambre noire.

navigation

Faire un zoom et un panoramique de l'image actuellement en développement.

En haut à gauche de la chambre noire, le panneau navigation affiche un aperçu complet de l'image actuelle. Un rectangle indique la zone actuellement visible dans le panneau central. Faites glisser le rectangle pour effectuer un panoramique de la vue agrandie. L'échelle de zoom actuelle est affichée à droite de l'image d'aperçu. Cliquez sur cette figure pour accéder rapidement à certains niveaux de zoom courants.

Le panneau navigation peut être activé/désactivé avec un raccourci clavier (Ctrl+Maj+N par défaut).

ordre des modules

Changer l'ordre des modules de traitement dans la chambre noire à l'aide des préréglages.

Lors du traitement d'une image, les modules actifs sont appliqués dans un ordre précis affiché dans le panneau de droite de la vue chambre noire. Le module ordre des modules, situé au bas du panneau de droite, fournit des informations sur l'ordre actuel des modules de traitement dans le pipeline graphique. Le nom du préréglage actif apparaît dans l'en-tête du module (ou "personnalisé" si l'utilisateur a modifié manuellement cet ordre). Les préréglages suivants peuvent être sélectionnés.

v3.0 RAW

C'est l'ordre des modules par défaut du flux de travail relatif à la scène pour le développement des images RAW.

v3.0 JPEG

C'est l'ordre des modules par défaut pour le développement des images JPEG.

originel

C'est l'ordre des modules utilisé pour le flux de travail originel relatif à l'affichage. Vous verrez également ce nom affiché pour toutes les images que vous avez précédemment éditées dans darktable avant la version 3.0.

Remarque : changer l'ordre des modules dans le pipeline graphique n'est pas un simple changement de la présentation de l'interface graphique -- cela a de réelles conséquences sur la façon dont l'image sera traitée. Veuillez ne pas modifier l'ordre des modules, sauf si vous avez une raison technique spécifique de le faire et comprenez que, pour des raisons de traitement d'image, il ne faut pas le faire.

Pour plus de détails sur les ordres des modules par défaut originel et v3.0, veuillez vous référer à la section ordre des modules par défaut. Pour plus de détails sur la modification de l'ordre des modules, veuillez vous référer à la section le pipeline graphique & l’ordre des modules.

pipette de couleur globale

Prendre des échantillons de couleurs de l'image actuellement dans le panneau central de la chambre noire, afficher leurs valeurs de plusieurs manières et comparer les couleurs de différents emplacements.

La pipette de couleur est activée en cliquant son icône. Les paramètres du module resteront en vigueur jusqu'à ce que vous quittiez le mode chambre noire.

Outre la pipette de couleur globale décrite ici, de nombreux modules de darktable (par exemple courbe des tonalités) contiennent également des pipettes de couleur locales utilisées pour définir les paramètres de certains modules. Vous devez savoir que ces deux formes de pipette de couleur ne fonctionnent pas toujours dans le même espace colorimétrique. La pipette de couleur globale fonctionne dans l'espace colorimétrique de l'histogramme et prélève ses échantillons une fois que le pipeline graphique complet a été traité. Les pipettes de couleur locales s'exécutent dans l'espace colorimétrique du module dans lequel elles sont activées et reflètent les données d'entrée ou de sortie de ce module dans le pipeline graphique.

Vous pouvez cliquer-droit sur les valeurs de couleur échantillonnées pour les copier dans le presse-papier.

Comme la pipette de couleur globale s'exécute à la fin du pipeline graphique d'aperçu, elle reçoit des données dans l'espace colorimétrique d'affichage, puis les convertit dans l'espace colorimétrique d'histogramme. Si vous utilisez un espace colorimétrique d'affichage qui ne s'est pas «bien comporté» (cela est courant pour un profil de périphérique), alors les couleurs qui sont en dehors du gamut du profil d'affichage seront écrêtées ou déformées.

contrôles du module

mode point/zone

La pipette de couleur globale est activée en mode point en cliquant sur son icône. Elle sera activée en mode zone si vous faites un Ctrl-clic ou un clic-droit sur son icône. En mode point, seul un petit point sous votre curseur est pris comme échantillon. En mode zone, darktable échantillonne un rectangle dessiné.

moyenne/min/max

Si les échantillons sont prélevés en mode zone, darktable calculera les valeurs moyennes, minimales et maximales des canaux de couleur. Cette liste déroulante vous permet de sélectionner lesquels de ceux-ci sont affichés. Pour des raisons statistiques évidentes, la moyenne, le min et le max sont identiques pour l'échantillon unique du mode ponctuel.

pastille de couleur / valeurs de couleur

Une pastille de couleur représentant le point ou la zone échantillonné s'affiche à côté des valeurs numériques. Cliquer sur la pastille activera/désactivera une pastille beaucoup plus grande pour une visualisation plus facile.

La pipette de couleur globale fonctionne dans l'espace colorimétrique d'affichage RVB, bien que vous puissiez choisir (en sélectionnant dans la liste déroulante) de convertir ces valeurs numériques dans un autre espace colorimétrique. Attention, les valeurs dans d'autres espaces colorimétriques sont approximées -- en fonction du profil de couleur d'affichage, il peut y avoir des écarts par rapport aux valeurs réelles.

échantillons en temps réel

Les couleurs échantillonnées (en mode zone ou point) peuvent être stockées en tant qu'échantillons en temps réel en cliquant sur le bouton «plus». Un échantillon de couleur et des valeurs numériques sont affichés pour chaque échantillon stocké. Vous pouvez modifier la valeur numérique (moyenne, min, max) et l'espace colorimétrique à afficher.

Les échantillons en temps réel nouvellement créés ne sont pas verrouillés. Si vous modifiez votre traitement d'image, ces changements seront reflétés dans les échantillons en temps réel. Cela peut être utilisé pour voir comment la modification d'un paramètre affecte différentes parties de l'image. Cliquer sur l'échantillon de couleur d'un échantillon en temps réel le verrouille et un symbole de verrouillage s'affiche. D'autres modifications de l'image n'affecteront plus l'échantillon. Vous pouvez utiliser ceci pour comparer deux échantillons en temps réel en verrouillant un seul d'entre eux, fournissant ainsi une comparaison avant et après.

Si vous passez la souris sur le bouton «supprimer» (X) de l'une des entrées d'échantillons en temps réel, la région sélectionnée pour cet échantillon sera mise en surbrillance dans l'aperçu de l'image.

afficher les zones sur image/scope

Lorsque cette case est cochée, les emplacements des échantillons en temps réel sont marqués visuellement sur l'image et le vectorscope du module scopes.

restreindre portée sur sélection

Lorsque cette case est cochée, seules les valeurs de la zone ou du point sélectionné sont prises en compte par les vues du module scopes. Cela vous permet de voir quelles valeurs de tonalité sont présentes dans la zone sélectionnée. Lors de l'utilisation d'une pipette de couleur dans un module de traitement, cette option restreint la portée à la zone sélectionnée par la pipette locale du module de traitement et non à celle sélectionnée par la pipette de couleur globale.

vérification du gamut

Il met en évidence les zones de l'image qui peuvent présenter un écrêtage du gamut.

Cliquez sur l'icône icône-gamut pour activer le mode d'affichage vérification de gamut de votre image. Cette fonction met en évidence, en cyan, tous les pixels hors gamut par rapport au profil d'épreuvage écran sélectionné. Vous pouvez également activer la vérification de gamut avec le raccourci clavier Ctrl+G. Un message «vérification de gamut» en bas à gauche de votre image vous indique que vous êtes en mode d'affichage vérification de gamut. La vérification de gamut et l'épreuvage écran sont des modes qui s'excluent mutuellement.

Cliquez-droit sur l'icône pour ouvrir une boîte de dialogue avec les paramètres de configuration -- ce sont les mêmes que ceux de l'option épreuvage écran.

Vous pouvez également envisager d'utiliser l'avertissement d'écrêtage, qui fournit aussi des avertissements de sous-exposition et de sur-exposition ainsi qu'une vérification du gamut similaire à celle offerte par ce module.

impression

paramètres d'impression

paramètres d'impression

Gérer les paramètre de la vue impression et lancer l'impression.

contrôles du module

imprimante

imprimante

Sélectionner l'une des imprimantes installées.

type de papier

Le type de papier de l'imprimante (papier ordinaire, papier photo lustré, etc.).

profil

Le profil ICC de l'imprimante pour le papier chargé. C'est le profil spécifique à l'imprimante et au papier de l'imprimante. L'application de ce profil est la dernière transformation d'espace colorimétrique faite à l'image. Son but est de créer une impression de haute qualité.

rendu

L'intention de rendu pour l'impression ("perceptif", "colorimétrie relative", "saturation" ou "colorimétrie absolue"). Voir intention de rendu pour plus de détails.

compensation du point noir

Le point noir du profil de sortie, qui est souvent plus clair que celui du profil d'entrée, sera ajusté quand la case est cochée . Elle devrait l'être si le paramètre rendu ci-dessus est fixé à “colorimétrie relative”.

page

taille papier

La taille du papier pour l'impression.

orientation

Portrait ou paysage (notez que darktable choisit par défaut la meilleure solution).

unités

L'unité à utiliser pour régler les marges : mm, cm, et pouce sont les options disponibles.

marges

Il est possible de régler séparément chaque marge ou de toutes les régler simultanément en cliquant le bouton « sync » central.

afficher la grille

Sélectionnez la taille de la grille à l'aide du champ de saisie (exprimée dans l'unité actuellement sélectionnée). Cochez pour afficher la grille sur le canevas.

aligner sur la grille

aide à définir les zones de l'image en les accrochant à la grille pour un alignement correct.

mode sans bordure requis

Lorsque les marges de l'utilisateur sont inférieures aux marges matérielles de l'imprimante, cet élément est activé (il n'est plus grisé). Il indique alors que le mode sans bordure de l'imprimante doit être activé. Notez qu'il ne s'agit que d'un indicateur car il n'active pas automatiquement le mode sans bordure.

disposition des images

largeur/hauteur image

Ce champ d'informations affiche les largeur et hauteur réelle de l'image sur le papier (données avec les unités sélectionnées).

facteur d’agrandissement

Ce champ d'informations affiche le facteur d'agrandissement de l'image nécessaire à son ajustement à la taille du papier. Si cette valeur est inférieure à 1 l'image est réduite sinon elle est agrandie. C'est un important facteur à surveiller -- une trop grande valeur (agrandissement) peut produire une impression de qualité médiocre. Le dpi (nombre de points par pouce ; dots per inch en anglais) est aussi affiché.

alignement

Sélectionnez l'alignement de l'image sur sa zone.

nouvelle zone image

Créer une nouvelle zone image. Glissez-déposez sur le canevas pour la placer. Si l'option aligner sur la grille est activée, la zone peut être facilement alignée sur les lignes de la grille. Une image peut être placée dans cette zone en la faisant glisser depuis la pellicule et en la déposant sur la nouvelle zone.

supprimer zone image

Supprime de la composition la zone image actuellement sélectionnée.

effacer composition

Supprime toutes les zones image en laissant le canevas vide.

Les quatre champs suivants représentent la position de la zone actuellement sélectionnée sur la page -- le coin supérieur/gauche sur la première ligne et la largeur/hauteur de la zone sur la deuxième ligne.

Lorsque vous survolez une zone image, sa position et sa taille sont affichées. Il est également possible de saisir le côté et le coin de la zone pour changer la taille ou de faire glisser toute la zone pour changer sa position.

La mise en page peut être enregistrée à l'aide d'un préréglage.

paramètres d'impression

profil

Ceci vous permet de sélectionner le profil d'exportation à utiliser. Ce profil est le point d'entrée utilisé par la prochaine transformation utilisant le profil d'imprimante ICC ci-dessus. Habituellement il est préférable d'utiliser un profil avec un grand gamut comme AdobeRVB plutôt qu'un profil avec un gamut plus petit comme sRVB.

rendu

Cette option fixe l'intention de rendu à utiliser pour l'exportation de l'image. Pour plus de d'informations voir intention de rendu.

style

Définit le style à appliquer lors de l'exportation de l'image, la valeur par défaut est « sans ». Voyez le panneau exportation pour une discussion plus détaillée de l'application d'un style lors de l'exportation.

mode

Indique si le style sera ajouté à l'historique existant ou s'il le remplacera complètement. Voir exportation pour plus de détails.

bouton d'impression

Lorsqu'il est cliqué, les images sont d'abord exportées en utilisant les options sélectionnées, ensuite la page est constituée puis envoyée à l'imprimante.

partagé

collections

collections récentes

détection de focus

éditeur de métadonnées

exporter

géolocalisation

informations de l'image

mots-clés

pellicule

scopes

collections

Filtrer les images affichées dans la table lumineuse et le bandeau pellicule en utilisant les attributs des images. Cet ensemble d'images filtrées est appelé collection.

L'importation d'images dans darktable permet de stocker les informations les concernant (nom de fichier, chemin d'accès, données Exif, données des fichiers XMP sidecar, etc) dans la base de données de la bibliothèque. Une collection peut être définie en appliquant des règles de filtrage à ces attributs, créant ainsi un sous-ensemble d'images à afficher dans la vue table lumineuse et le module pellicule.

La collection par défaut est basée sur l'attribut pellicule et affiche toutes les images de la dernière pellicule importée ou sélectionnée.

les attributs de filtrage

Les images d'une collection peuvent être filtrées à l'aide des attributs d'image suivants :

fichiers

pellicule

Le nom de la pellicule à laquelle appartient l'image (qui est le même que le nom du dossier dans lequel se trouve l'image). Cliquez sur une pellicule en maintenant Ctrl + Maj pour basculer vers le dossier correspondant. Cliquez avec le bouton droit de la souris pour supprimer la collection ou indiquer à darktable que son emplacement a changé dans le système de fichiers.

dossier

Le dossier (chemin du fichier) où se trouve le fichier image. Cliquez sur un dossier pour inclure le contenu de ce dossier et de tous les sous-dossiers de la collection ; cliquez en maintenant Maj enfoncé pour inclure uniquement les images du dossier sélectionné ; cliquez en maintenant Ctrl enfoncé pour afficher uniquement les images de tous les sous-dossiers ; cliquez en maintenant Ctrl et Maj enfoncés pour passer à la pellicule correspondant. Cliquez avec le bouton droit de la souris sur le nom d'un dossier pour supprimer son contenu de la bibliothèque de darktable ou indiquer à darktable que son emplacement a changé dans le système de fichiers.

nom de fichier

Le nom de fichier de l'image.

métadonnées

mot-clé

Tout mot-clé qui est attaché à l'image. Les images sans mot-clé sont regroupées dans la section "non positionnée". Lorsque l'option est activée, une liste hiérarchique des mots-clés connus s'affiche.

titre

Le champ « titre » des métadonnées de l'image.

description

Le champ « description » des métadonnées de l'image.

auteur

Le champ « auteur » des métadonnées de l'image.

diffuseur

Le champ « diffuseur » des métadonnées de l'image.

droits

Le champ « droits » des métadonnées de l'image.

notes

Le champ « notes » des métadonnées de l'image.

nom de version

Le champ « nom de version » des métadonnées de l'image.

étoile

L'évaluation de l'image par étoiles

label couleur

Tout label couleur attaché à une image ("rouge", "jaune", "vert", "bleu", "violet").

géolocalisation

La position géographique de l'image (voir emplacements).

heures

date de prise

La date à laquelle la photo a été prise, au format AAAA:MM:JJ.

date/heure de prise

La date et l'heure auxquelles la photo a été prise, au format AAAA:MM:JJ hh:mm:ss.

date importation

La date et l'heure auxquelles la photo a été importée, au format AAAA:MM:JJ hh:mm:ss.

date changement

La date et l'heure de la dernière modification, au format AAAA:MM:JJ hh:mm:ss.

date exportation

La date et l'heure de la dernière exportation du fichier, au format AAAA:MM:JJ hh:mm:ss.

date impression

La date et l'heure de la dernière impression du fichier, au format AAAA:MM:JJ hh:mm:ss.

les détails de capture

boîtier

La marque et le modèle du boîtier, venant des données EXIF.

objectif

La description de l'objectif, venant des données EXIF.

ouverture

L'ouverture, venant des données EXIF.

exposition

Le temps d'exposition, venant des données EXIF.

focale

La longueur focale, venant des données EXIF.

ISO

La sensibilité ISO, venant des données EXIF.

aspect

Le rapport hauteur/largeur de l'image, incluant le recadrage sous darktable.

darktable

groupe

Si les images sont "membres du groupe" ou "tête de groupe".

copie locale

Si les images sont ou ne sont pas copiées localement.

historique

Si les images sont “développées” (historique altéré), “basique” (historique non altéré) ou appliqué automatiquement (l’historique contient uniquement les modules appliqués automatiquement).

module

Filtre basé sur les modules de traitement appliqués à l'image.

ordre des modules

Si l'ordre des modules est "v3.0", "originel" (avant la v3.0 de darktable) ou "personnalisé".

contrôles du module

définition des critères de filtre

La ligne supérieure du module peut être utilisée pour définir les critères de filtrage de votre collection comme suit :

attribut d'image

La liste déroulante de gauche vous permet de choisir quel attribut utiliser pour filtrer votre collection.

motif de recherche

Dans le champ de texte à droite de la liste déroulante des attributs, vous pouvez écrire un motif de recherche. Ce motif est comparé à toutes les entrées de l'attribut sélectionné. Le mécanisme de filtrage détecte une correspondance si l'attribut d'une image contient le motif dans son texte intégral. Vous pouvez utiliser «%» comme caractère joker. La collection sera limitée aux seules images correspondantes. Laissez le champ de texte vide pour filtrer toutes les images ayant cet attribut. Si applicable, une info-bulle apparaît en survolant l'attribut ou le motif de recherche afin de fournir plus d'informations.

Les attributs représentant des nombres ou des dates/heures peuvent être utilisés en combinaison avec des opérateurs de comparaison et de plage. Utilisez <, <=, >, >=, <> ou =pour ne sélectionner respectivement que les images dont l'attribut est inférieur à, inférieur ou égal à, plus grand que, plus grand ou égal à, différent de ou égal. Une expression de la forme [de ; à] peut être utilisée pour sélectionner une plage.

sélection par valeur

En plus de définir des critères de recherche à l'aide d'un motif de recherche, vous pouvez également choisir manuellement dans une liste d'entrées venant de l'ensemble des images actuellement correspondantes. La sélection remplira automatiquement le champ du motif de recherche.

La zone sous le motif de recherche va lister les valeurs présentes, pour l'attribut sélectionné, dans toutes les images actuellement sélectionnées. Cette liste est mise à jour en temps réel lors de la frappe dans le champ de recherche. Vous pouvez également choisir un critère de tri en double-cliquant sur une entrée de la liste.

Si l'option utiliser un seul clic dans le module collections des préférences est activée (voir preferences > lighttable), un simple clic permet de sélectionner une entrée au lieu d'un double-clic. Ce mode vous permet également de sélectionner une plage de valeurs avec la souris. Ceci ne fonctionne que pour les nombres et les dates.

combinaisons de filtres multiples

Vous pouvez combiner plusieurs filtres (à l'aide d'une série de règles) pour créer des collections d'images encore plus complexes. Une règle est une combinaison de critères de filtre liés entre eux par des opérations logiques qui définit comment ce critère est combiné avec les règles précédentes.

Cliquez sur le bouton collect-expander-icon (à droite du champ de recherche) afin d'ouvrir un menu contenant les options suivantes :

effacer cette règle

Supprimer la règle actuelle, ou la réinitialiser si c'est la seule règle définie.

affiner la recherche

Ajouter une nouvelle règle, qui est combinée avec la ou les règles précédentes dans une opération de ET logique. Une image n'est conservée dans la collection que si elle remplit également les nouveaux critères.

ajouter d'autres images

Ajouter une nouvelle règle, qui est combinée avec la ou les règles précédentes dans une opération logique OU. Les images qui remplissent les nouveaux critères sont ajoutées à la collection.

exclure les images

Ajouter une nouvelle règle, qui est combinée avec la ou les règles précédentes dans une opération logique SAUF. Les images qui remplissent les nouveaux critères sont supprimées de la collection.

Les opérateurs logiques définissant comment les règles sont combinées sont indiqués par des icônes à droite de chaque règle ajoutée : ET par le symbole collect-and-icon , OU par le symbole le symbole collect-or-icon et SAUF par le symbole collect-except-icon . Cliquez sur l'une de ces icônes pour modifier l'opération logique de cette règle.

mettre à jour le chemin du dossier des images déplacées

Bien qu'il soit préférable de ne pas toucher aux fichiers importés hors de darktable, ce module peut vous aider à récupérer des situations où vous avez déplacé ou renommé des dossiers d'images après les avoir importés. Le module collections possède une fonctionnalité qui vous permet de mettre à jour la base de données de la bibliothèque de darktable avec le nouvel emplacement du dossier. Le processus est le suivant :

Dans la zone de liste déroulante choisissez «dossier» ou «pellicule» comme attribut de filtrage.

Le nom de la pellicule ou du dossier d'origine sera barré (barré) pour souligner qu'il ne peut pas être localisé.

Cliquez avec le bouton droit de la souris sur le nom du dossier ou de la pellicule, sélectionnez "rechercher une pellicule..." ou "rechercher un dossier...", puis sélectionnez le nouvel emplacement du dossier.

préférences

L'option "préférences..." du menu des préréglages vous permet d'ajuster le comportement du module des collections comme suit :

ne pas utiliser le groupe 'sans catégorie' pour les tags

N'affiche pas la balise 'sans catégorie' pour les mots-clés qui n'ont pas d'enfants (désactivé par défaut).

sensibilité à la casse

Définit si les mots-clés doivent être sensibles à la casse ou non (insensible par défaut) -- sans l'extension ICU d'sqlite, cela ne s'appliquera qu'aux 26 lettres latines.

nombre de niveaux de dossiers à afficher dans les listes

Le nombre de niveaux de dossiers à afficher dans les noms de pellicule, en commençant par la droite (par défaut 1).

trier les pellicules par

Triez les pellicules soit par "dossier" (chemin) soit par "numéro" (à peu près équivalent à la date à laquelle les pellicules ont été importées pour la première fois) (par défaut "numéro").

tri descendant des collections

Trie les collections suivantes par ordre décroissant : "pellicule" (lorsqu'elle est trié par dossier), "dossier", date/heure (par exemple, date/heure de prise) (activé par défaut).

collections récentes

Affiche une liste des collections récemment utilisées, générées par le module collections.

Cliquez sur une entrée pour rouvrir la collection sélectionnée. Cela met également à jour le module de collections avec les critères et règles de filtrage appropriés.

préférences

L'option "préférences..." du menu des préréglages vous permet d'ajuster le comportement du module des collections comme suit :

nombre de collections à conserver

Le nombre de collections récentes à conserver et à afficher dans le module des collections récentes (10 par défaut)

détection de focus

Identifie les parties de l'image contenant des bords nets, ce qui indique généralement qu'elles sont dans la zone de mise au point.

Le module s'active en cliquant sur l'icône ( focus-peaking-icon ). Il met en évidence les parties nettes de l'image avec un affichage en surbrillance jaune, vert et bleu :

Le module fonctionne en filtrant le bruit de l'image, en mesurant les gradients d'intensité dans l'image par des calculs de moyennes et d'écarts-types (σ). Lorsque le gradient d'un bord diffère significativement de la moyenne, les pixels associés sont marqués d'une "carte thermique" indiquant la netteté du bord.

Le jaune représente un fort gradient (6σ), indiquant un bord très net.

Le vert représente un gradient moyen (4σ), indiquant un bord assez net.

Le bleu représente un gradient faible (2σ) , indiquant un bord légèrement net.

L'image ci-dessus a été prise avec une grande ouverture pour obtenir une faible profondeur de champ, et vous pouvez voir comment l'appareil photo a fait la mise au point sur le caractère chinois écrit sur la deuxième lanterne rouge en partant de l'avant. Il y a également des tiges de fleurs roses qui se trouvent dans la zone de netteté acceptable autour du plan focal, et celles-ci sont également marquées de jaune et de vert.

éditeur de métadonnées

Modifie les métadonnées des images sélectionnées.

Les métadonnées sont du texte au format libre (titre, description, créateur, éditeur, droits, etc.) décrivant vos images.

contrôles du module

champs de saisie des métadonnées

Un champ distinct est affiché pour chaque élément des métadonnées. Maintenez la touche CTRL enfoncée tout en déroulant avec la molette souris pour augmenter la hauteur d'un champ. Appuyez sur CTRL + Entrée pour insérer une nouvelle ligne. Appuyez sur Entrée pour appliquer tout texte saisi dans le champ de métadonnées actuel aux images sélectionnées. Double-cliquez sur l'étiquette d'un champ pour supprimer le contenu de ce champ.

appliquer

Applique les nouvelles valeurs des champs de saisie des métadonnées aux images sélectionnées.

bouton réinitialiser

Supprime les métadonnées existantes des images sélectionnées.

préférences

L'option "préférences..." dans le menu des préréglages fait apparaître un dialogue dans lequel vous pouvez configurer la façon dont les métadonnées sont traitées dans darktable. Pour chaque métadonnée, deux cases à cocher vous permettent de restreindre la façon dont les métadonnées sont traitées :

visible : Afficher ou masquer ce champ de métadonnées. Les champs cachés ne sont affichés nulle part dans darktable et ne sont pas inclus dans les images exportées.

privé : Garder ce champ de métadonnées privé. Les champs privés sont affichés dans darktable mais ne sont pas inclus dans les images exportées.

Les champs dont les deux options ne sont pas cochées sont affichés dans darktable et inclus dans les images exportées.

exporter

Exporter les images sélectionnées

Lorsqu'elle est utilisée dans la vue chambre noire, l'image actuellement éditée sera exportée si aucune autre image n'est sélectionnée dans le bandeau des miniatures.

Les fichiers peuvent être exportés vers un fichier sur le disque, un e-mail, divers emplacements de stockage en ligne, un album Web ou un modèle de livre.

contrôles du module

options de stockage

stockage cible

Le type d'emplacement pour stocker vos images sélectionnées. Différents types de stockage sont mis en œuvre, notamment le fichier sur disque, le modèle de livre LaTeX et divers albums Web. En fonction de la cible sélectionnée, il vous sera demandé de fournir des informations supplémentaires, telles que les noms de fichiers ou le nom de compte et le mot de passe.

modèle de nom de fichier

Définissez le dossier et le fichier vers lesquels l'image sera exportée. Ceci peut être généré automatiquement en utilisant plusieurs variables prédéfinies. Voir la section variables pour plus de détails.

sélecteur de répertoire de sortie

Le bouton situé à côté de l'entrée du modèle de nom de fichier ouvre une boîte de dialogue permettant de sélectionner le répertoire parent pour l'exportation.

sur conflit

Choisir ce qu'il faut faire si le nom de fichier généré entre en conflit avec un fichier existant lors de l'exportation.

créer fichier unique : crée automatiquement un nouveau nom unique de fichier en ajoutant un entier au nom du fichier en conflit.

écraser : écrase les fichiers existants. Cette option présente une boîte de dialogue de confirmation afin de vous protéger contre la perte accidentelle de données -- vous pouvez la désactiver dans préférences > sécurité > demander avant d'exporter en mode écraser. Remarque : Cette boîte de dialogue n'est pas présentée à chaque fichier mais une seule fois au démarrage de la tâche d'exportation.

sauter : n'exporte pas les images dont le nom de destination existe déjà.

options de format

format de fichier

Choisit le format de fichier pour l'image exportée. Des options supplémentaires apparaissent (ci-dessous) en fonction du format sélectionné.

qualité

La qualité du fichier exporté. Des valeurs plus élevées entraînent des tailles de fichier plus importantes. La qualité par défaut (95) est un bon paramètre pour les exportations de très haute qualité (par exemple, pour l'archivage ou l'impression). Si vous avez besoin d'un bon compromis entre la taille et la qualité (par exemple, pour l'affichage ou le téléchargement d'images en ligne), vous devriez plutôt envisager une valeur de "90".

bits

Le nombre de bits utilisés pour chaque canal de couleur. Plus il est élevé, moins il y aura de postérisation/bandes de couleur.

compression ou type de compression

Le type de compression à utiliser (WebP ou OpenEXR).

compression

Pour les formats où la compression peut être spécifiée, la réglette compression permet de fixer sa force. Plus le niveau est élevé, plus les données seront compressées, au prix d'un plus grand temps de traitement.

image n&b

Pour le format TIFF, il est possible d'enregistrer une image monochrome. Ce paramètre contrôle si le fichier résultant code les nuances de gris en tant que canaux RVB distincts ou en tant que canal de niveaux de gris unique.

options globales

taille

Choisissez comment est calculé la taille maximale de l'image exportée.

en pixels (pour fichier) : entrez la largeur et hauteur maximales en pixels.

en cm (pour impression) : entrez la largeur et hauteur maximales en cm, ainsi que la résolution en points par pouce (dpi). La définition équivalente en pixels sera automatiquement calculée.

en pouce (pour impression) : entrez la largeur et hauteur maximales en pouce, ainsi que la résolution en points par pouce (dpi). La définition équivalente en pixels sera automatiquement calculée.

par facteur (pour fichier) : entrez un multiplicateur pour spécifier de combien l'image exportée doit être mise à l'échelle par rapport à l'image d'entrée. Par exemple, entrez une valeur de 0.5 pour réduire l'image de sortie de moitié en largeur et hauteur (en pixels).

dpi

Dans le cas des options pour l'impression (en cm ou en pouces), ceci enregistre la résolution de l'image de sortie. Cette résolution est enregistrée dans les données EXIF de l'image exportée. Elle est automatiquement réglée à 300 si les options en pixels ou par facteur sont sélectionnées.

taille maximale

Entrez la taille maximale de la largeur et de la hauteur de l'image exportée, en pixels, en cm ou en pouces (dépend de l'option choisie). Une valeur de zéro ne met aucune contrainte sur cette dimension. Les images exportées seront contraintes de manière à ne dépasser aucune de ces valeurs, tout en conservant le rapport hauteur/largeur. Mettez les deux à zéro pour exporter avec les dimensions d'origine (après recadrage). Si les valeurs saisies dépassent les dimensions d'origine, darktable exportera avec les dimensions d'origine ou augmentera l'échelle de l'image, en fonction du paramètre « autorise l’agrandissement ».

autorise l'agrandissement

Mettez sur « oui » pour effectuer une étape de mise à l'échelle si la largeur et la hauteur maximales définies par l'utilisateur dépassent les dimensions d'origine de l'image. En mettant « non », les dimensions de l'image exportée ne dépasseront pas les dimensions de l'image d'origine (après recadrage).

échantillonnage de haute qualité

Mettez sur « oui » pour effectuer un ré-échantillonnage de haute qualité sur l'image. L'image sera traitée en pleine résolution et uniquement réduite à la toute fin. Cela donne parfois une meilleure qualité, mais le traitement sera toujours plus lent.

profil

Le profil de couleur de sortie. Selectionnez « paramètres d'image » si vous souhaitez conserver celui du module profil de couleur de sortie de chaque image.

rendu

Cette option vous permet de définir le rendu : la manière dont darktable gère les couleurs hors gamut. Voir rendu pour une description plus détaillée des différentes options.

style

Choisissez un style que darktable ajoutera à l'historique existant pour générer l'image de sortie. Les éléments du style sont ajoutés temporairement : l'historique d'origine n'est pas écrasé. Vous pouvez utiliser cette fonctionnalité pour ajouter des étapes de traitement et des paramètres que vous souhaitez appliquer spécifiquement aux images avant l'exportation. Par exemple, vous pouvez définir un style qui ajoute une netteté plus élevée lorsque vous produisez des fichiers JPEG réduits pour Internet ou encore ajouter une compensation d'exposition à toutes vos images de sortie.

mode

Lors de l'application d'un style pour l'exportation, cette option définit si les éléments de l'historique de ce style remplacent l'historique d'origine de l'image ou y sont ajoutés. Techniquement parlant, en mode ajout, des instances des modules de l'historique du style à appliquer, seront placées au-dessus des modules de l'historique existant (voir instances multiples). Par conséquent, le traitement d'origine de l'image restera en vigueur, et en plus, les nouveaux modules lui seront appliqués. De cette façon, vous pouvez appliquer un ajustement global (par exemple l'exposition) à un certain nombre d'images à exporter, tout en respectant le traitement de chaque image réalisé avant l’exportation.

exporter

Appuyez sur ce bouton pour lancer l'exportation en tâche d'arrière-plan pour toutes les images sélectionnées. Une barre en bas du panneau de gauche affiche la progression de la tâche d'exportation. De plus, un message de notification s'affiche pour signaler l'achèvement de chaque exportation individuelle. Vous pouvez cliquer sur le pop-up pour le faire disparaître. Vous pouvez annuler la tâche d'exportation en cliquant sur l'icône « x » située à proximité de la barre de progression.

Remarque : les images sélectionnées mais actuellement masquées (parce qu'elles sont membres d'un groupe réduit) ne seront pas exportées.

préférences des métadonnées

L'option "préférences..." du menu des préréglages fait apparaître une boîte de dialogue dans laquelle vous pouvez configurer les métadonnées à inclure dans les fichiers exportés :

Les paramètres entrés dans ce dialogue sont sauvegardés avec d'autres paramètres d'exportation dans des préréglages utilisateur et les dernières valeurs entrées sont conservées lorsque darktable est fermé.

réglages généraux

La partie gauche de cette boîte de dialogue vous permet de choisir les groupes de métadonnées à exporter avec l'image. Les options suivantes sont disponibles :

données exif

Exporte les données Exif de l'image source.

métadonnées

Exporte les métadonnées définies dans le module metadata editor. Les champs de métadonnées marqués comme privés ou cachés ne seront pas exportés.

géolocalisation

Exporter les données de géolocalisation.

mots-clés

Exporte les mots-clés créés dans le module mots-clés (vers Xmp.dc.Subject). Trois options supplémentaires peuvent également être sélectionnées :

mots-clés privés : exporte les mots-clés privés

synonymes : exporte les synonymes des mots-clés

omet la hiérarchie : n'exporte que le dernier nœud des mots-clés hiérarchiques

mots-clés hiérarchiques

Exporte les mots-clés hiérarchiques (vers Xmp.lr.Hierarchical Subject)

historique

Exporte l'intégralité du développement (historique et formes) lorsque ceci est pris en charge (par exemple, JPEG, JPEG2000, TIFF). L'historique de développement sera stocké sous forme de balises XMP dans le fichier de sortie. Ces informations peuvent ensuite être utilisées pour reconstruire les paramètres et les réglages qui ont été utilisés pour produire l'image exportée.

Attention : Pour diverses raisons, l'intégration de balises XMP dans les fichiers de sortie peut échouer sans préavis, par exemple si certaines limites de taille sont dépassées. Il est donc conseillé aux utilisateurs de ne pas se fier à cette fonctionnalité pour leur stratégie de sauvegarde. Pour sauvegarder vos données, assurez-vous toujours de sauvegarder votre fichier d'entrée (brut) ainsi que tous les fichiers annexes XMP de darktable.

pour les paramètres de métadonnées

La partie droite de cette boîte de dialogue vous permet de définir des formules pour alimenter les métadonnées de l'image. Les formules définies ici ont priorité sur les paramètres de la partie gauche de la boîte de dialogue. La première colonne identifie l'entrée à modifier. La deuxième colonne vous permet de définir comment calculer la valeur de cette entrée de métadonnées à l'aide d'une formule.

Voir la section variables pour plus de détails sur les variables que vous pouvez utiliser dans votre formule de métadonnées. Appuyez sur Entrée pour valider la formule. Laissez la formule vide pour empêcher l'exportation de cette métadonnée (Exif.GPSInfo.GPSVersionID dans l'exemple ci-dessus).

Utilisez l'icône “--” pour supprimer une entrée de métadonnées de la liste et l'icône “+” pour en ajouter une nouvelle à partir d'une liste prédéfinie des métadonnées disponibles.

Cliquer sur le bouton "ajouter" pour ajouter une métadonnée à la liste.

Les formules vous permettent de définir virtuellement toutes les métadonnées dont vous avez besoin pour qualifier vos images lors du balisage et d'exporter les valeurs dans les balises XMP ou IPTC de votre choix. Les mots-clés exportés peuvent être différents d'une exportation à l'autre en fonction de la destination des images. Les mots-clés et les catégories sont affichés séparément dans les informations sur les images.

Rappelez-vous qu'une balise définie comme une catégorie n'est jamais exportée.

astuces

Pour empêcher l'exportation d'une métadonnées spécifique, ajoutez-la à la liste et laissez la formule vide.

Pour forcer l'exportation d'une métadonnée exif spécifique lorsque "données exif" est désactivée, ajoutez-la à la liste et saisissez = dans la formule.

exemples

exemple 1

Un premier niveau de mot-clé appelé places est qualifié de catégorie, et est suivi de quatre niveaux d'information (ou mots-clés) : pays, région, ville et lieu (par exemple 'places|France|Nord|Lille|rue Nationale). Chaque niveau peut être récupéré (quand défini) par une des variables $(CATEGORY0(places)), $(CATEGORY1(places)), $(CATEGORY2(places))et$(CATEGORY3(places)). Dans cet exemple, les valeurs retournées sont "France", "Nord", "Lille" et "rue Nationale", respectivement. Ces mots-clés peuvent aussi être récupérés comme simple balise en utilisant la variable $(TAGS)`. Le dernier mot-clé défini (la feuille) est affiché dans informations de l'image, ici "rue Nationale".

exemple 2

Un mot-clé de premier niveau appelé créateur est suivie du nom du photographe, tous deux définis en tant que catégorie : créateur|prénom nom. La formule copyrights ($(YEAR) $(CATEGORY0(creator))) construit le texte associé aux droits d'image. Ici, informations de l'image affiche "créateur : prénom nom" en tant que catégories. Ni le créateur ni le "prénom nom" n'apparaissent dans la liste des mots-clés et ils ne sont pas exportés en tant que mots-clés simples.

Remarque : les mots-clés ne sont pas appropriés pour définir des métadonnées de texte libre, comme un titre ou une description, qui peuvent être spécifiques à chaque image. Utilisez l'éditeur de métadonnées pour ce type d'informations.

géolocalisation

Importe et applique les données de traces GPX à une sélection d'images.

Ce module est commun aux vues table lumineuse et carte. La vue carte fournit un mode avancé qui vous permet de prévisualiser la position des images le long des traces GPS tout en ajustant la date/heure (décalage) et le fuseau horaire des images.

présentation des flux de travail

Un récepteur GPS calcule sa position courante à partir des informations qu'il reçoit des satellites et les enregistre, avec la date et l'heure courante, dans un fichier GPX. Les données EXIF des images contiennent aussi une estampille temporelle définie par les paramètres de l'appareil photo. Le module de géolocalisation prend l'estampille temporelle de l'image, cherche la position dans le fichier GPX correspondant à cette heure, et stocke les coordonnées (latitude/longitude/altitude) dans sa base de données et dans le fichier XMP associé à l'image.

Deux problèmes peuvent survenir :

Contrairement aux appareils GPS, la plupart des appareils photo n'enregistrent pas l'heure précise.

L'heure enregistrée dans les données EXIF ne contient pas de fuseau horaire. La plupart des gens règlent leur appareil photo en heure locale, alors que les appareils GPS stockent l'heure en UTC (temps universel coordonné), c'est-à-dire par rapport au fuseau horaire de Greenwich (Londres). Si les fuseaux horaires de l'appareil photo et du fichier GPX diffèrent la position associée sera mauvaise.

Si votre image comporte déjà une estampille temporelle UTC vous pouvez appliquer directement la trace GPX sans autres ajustements.

Sinon, suivez la procédure ci-dessous pour corréler l'heure des images et des fichiers de trace GPS :

Corriger manuellement l'heure d'une image en entrant la date et l'heure correctes pour cette image dans le champ date/heure. Un bon moyen de le réaliser précisément est de prendre la photo d'une source de temps fiable. Cela peut être une horloge précise ou mieux encore l'heure affichée sur votre appareil GPS (normalement, il affiche l'heure locale, bien qu'il stocke le temps universel). La différence (décalage) entre l'heure saisie et celle associée à l'image dans ses données EXIF est affichée dans le champ décalage date/heure.

Presser le bouton cadenas pour mémoriser le décalage calculé dans le module.

Sélectionner les images que vous voulez ajuster et cliquer sur appliquer décalage pour appliquer celui-ci aux images.

Si votre appareil photo ne gère pas l'UTC, indiquer le fuseau horaire dans le champ fuseau horaire.

Une fois le réglage horaire corrigé, vous pouvez appliquer les données traces GPX en utilisant le bouton appliquer un fichier GPX

les contrôles du module (communs)

date/heure

Ce champ est initialisé avec la date et l'heure de la première image sélectionnée (format aaaa:mm:jj hh:mm:ss) et peut être modifié pour corriger la date et l'heure de cette image. Chaque champ peut être modifié avec la roulette de votre souris. Si un champ atteint sa limite, les champs voisins sont automatiquement mis à jour. Par exemple, si vous dépassez 60 pour le champ des minutes, le champ heure est automatiquement incrémenté.

data/heure originale

La date et l'heure originales de l'image sont montrées pour référence.

décalage date/heure

La différence calculée entre la date/heure originale et celle saisie dans le champ date/heure. Si la différence calculée est plus grande que 99 jours 23 heures 59 minutes et 59 secondes, le décalage est invalidé.

bouton cadenas

Si le bouton cadenas est actif, la valeur du décalage est mémorisée. Si vous sélectez une(des) autre(s) image(s), la valeur de date/heure de la nouvelle image est mise à jour en appliquant le décalage mémorisé. Cela permet d'appliquer le même décalage à un groupe d'images sélectionné.

appliquer décalage

Applique le décalage aux images sélectionnées.

appliquer date/heure

Il est parfois utile de pouvoir affecter une valeur de date/heure absolue à une image, par exemple quand cette information est manquante. Ce bouton vous permet d'appliquer la date et l'heure saisies dans le champ date/heure aux images sélectionnées, sans tenir compte de la valeur précédente. Vous pouvez utiliser Ctrl+Z pour défaire toute modification non désirée.

fuseau horaire du boîtier

Sélectionne le fuseau horaire de l'appareil photo. Commencez la saisie pour faire apparaître les valeurs autorisées.

appliquer un fichier GPX... (seulement en table lumineuse)

Applique un fichier de traces GPX. Cliquez sur le boutons et sélectionnez le fichier GPX. Vous pouvez utiliser Ctrl+Z pour annuler des changements non désirés. Dans la fenêtre de sélection de fichier, le bouton aperçu liste les traces du fichier GPX sélectionné avec les informations suivantes: nom de la trace, la date/heure de début et de fin (en heure locale), le nombre de points de trace et le nombre d'images qui seront géolocalisées.

les contrôles du module (vue carte)

fichier gpx

Le chemin du fichier gpx sélectionné.

liste de traces

Cette table montre la date/heure de début de chaque trace, ainsi que son nombre de points et le nombre d'images correspondantes. Lorsqu'un bouton de contrôle est activé, la trace correspondante est affichée sur la carte. Un bouton de contrôle de l'en-tête de la table vous permet de sélectionner ou désélectionner toutes les traces à la fois. Le survol d'une ligne avec votre souris affiche les heures de début et de fin en heure locale (LT) et en UTC.

images de prévisualisation

Si cette case est cochée, les images correspondantes sont affichées sur la carte le long des pistes visibles.

sélectionner des images

Si vous ne souhaitez pas appliquer un décalage à toutes les images sélectionnées, mais seulement aux images correspondantes, utilisez ce bouton pour sélectionner les images. Si vous ne voulez pas perdre le décalage actuel, vous pouvez le verrouiller avant de modifier la sélection.

comptes

Un décompte du nombre d'images correspondantes et du nombre sélectionné est affiché à droite du bouton sélectionner les images.

applique géolocalisation

Ce bouton apparaît quand le décalage est nul. Le bouton applique géolocalisation applique les données GPX aux images correspondantes sur les traces sélectionnées.

applique décalage et géolocalisation

Ce bouton apparaît quand un décalage est entré. Pour rappel, le bouton applique décalage applique le décalage à toutes les images sélectionnées. Au contraire, le bouton applique décalage et géolocalisation n'applique le décalage et les données GPX qu'aux images correspondantes aux traces sélectionnées.

Vous pouvez utiliser Ctrl+Z pour annuler les changements non désirés (deux fois dans le cas d'applique décalage et géolocalisation).

informations de l'image

Affiche les informations contenues dans les données EXIF d'une image ainsi qu'un certain nombre de champs spécifiques à darktable.

Lorsque vous passez la souris sur les miniatures des images, les données affichées sont automatiquement mises à jour avec les informations de l'image actuellement sous le curseur de la souris.

Lorsque plusieurs images sont sélectionnées et que le focus n'est pas sur une seule image, le module n'affiche que des informations qui sont les mêmes pour toutes les images. Si des champs diffèrent entre les images, le texte "<valeurs diverses>" s'affiche à la place.

Lorsque vous êtes dans la vue de la table lumineuse, vous pouvez double-cliquer sur le champ pellicule d'une image donnée pour afficher toutes les images incluses dans la pellicule de cette image.

préférences

L'option « préférences… » dans le menu des préréglages ouvre une boîte de dialogue avec une liste de tous les champs affichables.

La case à cocher dans la colonne visible permet de choisir quels champs s'affichent. Vous pouvez également faire un glisser-déposer d'une ligne pour modifier l'ordre d'affichage des champs.

Ces préférences peuvent être enregistrées en tant que préréglages de module. Appuyez sur le bouton de réinitialisation du module pour remettre toutes les informations visibles et dans l'ordre par défaut.

mots-clés

Gérer les mots-clés associés aux images.

Les mots-clés permettent d'ajouter des informations aux images à l'aide d'un dictionnaire de mots-clés. Vous pouvez gérer les mots-clés sous forme d'arborescence hiérarchique, ce qui peut être utile lorsque leur nombre devient important.

Les mots-clés sont écrits dans les fichiers annexes XMP ainsi que dans la bibliothèque de darktable. Ils peuvent être inclus dans les images exportées.

définitions

Les définitions suivantes supposent que vous avez configuré un seul mot-clé nommé "places|France|Nord|Lille".

mot-clé

Un mot-clé est un texte descriptif qui peut être attaché à une image. Un mot-clé peut être un terme unique ou une séquence de termes connectés formant un chemin, séparés par le symbole tuyau '|'. Par exemple, "places|France|Nord|Lille" définit un mot-clé unique, où chaque terme du chemin forme un sous-ensemble plus petit de ceux qui le précèdent. Vous pouvez attacher autant de mots-clés à une image que souhaité.

Les propriétés d'un mot-clé sont : nom, privé, catégorie, synonymes et ordre des images.

nœud

Tout chemin faisant partie d'un mot-clé est un nœud. Dans l'exemple ci-dessus, "places", "places|France", "places|France|Nord" et "places|France|Nord|Lille" sont tous des nœuds. Dans l'arborescence hiérarchique, les nœuds forment les branches et les feuilles de l'arbre.

nœud libre

Tout nœud qui n'est pas explicitement défini en tant que balise est appelé nœud libre. Dans l'exemple ci-dessus, "places", "places|France" et "places|France|Nord" sont tous des nœuds libres. Vous ne pouvez pas définir de propriétés, à l'exception du "nom", pour un nœud libre et vous ne pouvez pas ajouter un nœud libre à une image. Voir la section "mots-clés multiples" ci-dessous pour plus d'informations.

catégorie

Tout mot-clé peut être marqué par l'utilisateur comme étant une "catégorie".

mots-clés multiples

Les définitions ci-dessus s'appliquent à un exemple simple : un seul mot-clé et ses propriétés. Considérez maintenant le scénario dans lequel les quatre mots-clés suivants sont définis dans darktable.

lieux|France|Nord|Lille
lieux|France|Nord
lieux|France
lieux|Angleterre|Londres

Dans ce cas, les nœuds sont

lieux
lieux|France
lieux|France|Nord
lieux|France|Nord|Lille
lieux|Angleterre
lieux|Angleterre|Londres

Les seuls nœuds libres sont "lieux" et "lieux|Angleterre". Ces deux nœuds libres sont également (par convention) des catégories.

Vous pouvez attacher tous ces mots-clés à toute image. Tous les mots-clés attachés à une image, à l'exception des mots-clés catégorie, peuvent être exportés avec cette image.

Si vous attachez le mot-clé "lieux|France|Nord|Lille" à une image, les mots-clés "places|France|Nord" et "places|France" sont implicitement attachés à cette image (vous n'avez pas besoin de les attacher manuellement). Notez que cela n'est vrai que parce que ces mots-clés étaient définis séparément -- le nœud "lieux" n'est pas inclus car il s'agit d'un "nœud libre" (pas un mot-clé).

sections du module

Le module mots-clés se compose de deux sections

La section supérieure mots-clés liés (avec les boutons attacher/détacher en dessous)

La section dictionnaire des mots-clés plus bas (avec les boutons nouveau/importer.../exporter... en dessous)

section mots-clés liés

La section mots-clés liés affiche les mots-clés attachés aux images, où ces images sont

sous le curseur de votre souris (si vous survolez une image dans la vue table lumineuse) ; ou

actuellement sélectionnées (si vous ne survolez pas une image)

Au bas de la section mots-clés liés se trouvent les boutons suivants, de gauche à droite :

attacher

Si un mot-clé est sélectionné dans la section dictionnaire de mots-clés, associe ce mot-clé aux images sélectionnées.

détacher

Si un mot-clé est sélectionné dans la liste des mots-clés liés, détache ce mot-clé des images sélectionnées. Un mot-clé peut également être détaché si vous faites un clic droit sur le mot-clé et sélectionnez détacher dans le menu contextuel.

check-icon mots-clés cachés

Activez pour afficher les mots-clés cachés que darktable a automatiquement attachés aux images sélectionnées.

sort-icon trier

Trie la liste des mots-clés liés par ordre alphabétique ou par nombre indiqué entre parenthèses à côté du mot-clé (ce nombre indique combien d'images sélectionnées ont ce mot-clé attaché).

minus-icon parents

Affiche ou non les nœuds parents du mot-clé.

Vous pouvez ajuster la hauteur de la fenêtre des mots-clés liés en maintenant la touche Ctrl enfoncée et en faisant défiler avec la molette de votre souris.

section dictionnaire de mots-clés

La section dictionnaire de mots-clés affiche toutes les mots-clés disponibles dans la base de données de darktable. En haut de la section dictionnaire de mots-clés se trouve une zone de texte dans laquelle les mots-clés peuvent être saisis. En dessous se trouve la liste des mots-clés disponibles, qui peuvent également inclure des symboles indicateurs à gauche des mots-clés. Les significations de ces symboles sont les suivantes :

une coche [✓] indique que le mot-clé est attaché à toutes les images sélectionnées

un signe moins [--] indique que le mot-clé est attaché à au moins une des images sélectionnées. Si le symbole est à côté d'un nom de nœud dans la vue hiérarchique arbre, cela signifie que l'un des mots-clés enfants de ce nœud est attaché à au moins une des images sélectionnées.

si aucun symbole indicateur n'est présent, cela signifie que le mot-clé n'est attaché à aucune des images sélectionnées, ou que le nœud n'a aucun mot-clé enfant attaché à aucune des images sélectionnées.

Dans la vue hiérarchique arbre, un nom en italique représente soit un nœud libre, soit une catégorie.

Sous la liste dictionnaire de mots-clés se trouvent les boutons suivants, de gauche à droite :

nouveau

Crée un nouveau mot-clé, en utilisant le nom qui a été entré dans la zone de saisie de texte en haut de la section dictionnaire de mots-clés.

importer...

Importe les mots-clés à partir d'un fichier de mots-clés Lightroom

exporter...

Exporte tous les mots-clés vers un fichier de mots-clés au format Lightroom.

plus-icon suggestions

Affiche une liste de mots-clés suggérés en fonction des mots-clés déjà associés aux images sélectionnées. ATTENTION : cette vue interroge la base de données et peut donc être lente.

list-tree-icon liste/arbre

Bascule l'affichage des mots-clés entre la simple vue liste et la vue hiérarchique arbre.

Vous pouvez ajuster la hauteur de la fenêtre dictionnaire de mots-clés en maintenant la touche Ctrl enfoncée tout en faisant défiler avec la molette de votre souris.

utilisation

Les sections suivantes décrivent les opérations qui peuvent être effectuées sur les mots-clés.

entrée texte

La zone de saisie de texte (affichée sous les boutons attacher/détacher) a plusieurs objectifs.

Si la liste dictionnaire de mots-clés est en mode d'affichage liste (plutôt qu'en mode d'affichage arbre), alors la saisie des premiers caractères d'un mot-clé fera apparaître une liste de suggestions. Vous pouvez ensuite faire défiler vers le bas avec les touches fléchées et appuyer sur Entrée pour sélectionner l'une des suggestions. Appuyez sur Entrée une deuxième fois pour l'attacher aux images sélectionnées. Vous pouvez également modifier le nom du mot-clé avant d'appuyer sur Entrée -- dans ce cas, le mot-clé sera créé si il n'existe pas déjà dans la base de données.

Outre les suggestions de saisie semi-automatique, la saisie d'un texte partiel dans la zone de saisie de texte vous permet de filtrer l'ensemble des mots-clés affichés dans la fenêtre dictionnaire de mots-clés à ceux dont le nom ou le synonyme correspond au texte saisi. Appuyez sur Entrée pour attacher une étiquette avec le nom saisi aux images sélectionnées. Si ce nom de balise n'existe pas encore dans la base de données, il sera créé avant d'être attaché.

L'entrée de menu contextuel « copier dans l'entrée » peut être utilisée pour copier un mot-clé sélectionné dans la zone de saisie de texte. Vous pouvez ensuite modifier ce nom et appuyer sur Entrée pour créer un nouveau mot-clé avec ce nom, ce qui facilite la création de plusieurs mots-clés avec des noms similaires.

Remarque : Si vous trouvez le comportement d'auto-complétion ennuyeux, il peut être désactivé dans [préférences > divers > mots-clés > désactiver l'auto-complétion](../../../preferences-settings/miscellaneous.md #mots clés).

créer un mot-clé

Il y a plusieurs manières de créer un nouveau mot-clé :

Importer un fichier texte. Vous pouvez importer un ou plusieurs fichiers texte au format de fichier de mots-clés Lightroom. Vous pouvez aussi exporter vos mots-clés, éditer le fichier exporté, puis le réimporter. La fonction d'importation met à jour les mots-clés existants et crée de nouveaux mots-clés si nécessaire. Si vous modifiez le nom d'un mot-clé dans un fichier importé, il sera traité comme un nouveau mot-clé.

Importez des images déjà affectées de mots-clés. Cette méthode n'offre aucune flexibilité pour modifier les noms ou les catégories des mots-clés pendant le processus d'importation.

Sous-menu créer un mot-clé. Un mot-clé peut être créé manuellement, sous un mot-clé existant (hiérarchique) ou au niveau racine.

Sous-menu "définir comme un mot-clé". Vous pouvez convertir un nœud libre (par exemple "places|England") en un mot-clé afin qu'il soit implicitement attaché à toutes les images affectées d'un des sous-mots-clés (par exemple "places|England|London").

Tapez dans la zone de texte et appuyez sur le bouton "nouveau". Les mots-clés hiérarchiques sont créées à l'aide du symbole pipe “|” pour séparer les nœuds. Notez que le mot-clé saisi est également attaché à toutes les images sélectionnées.

Un certain nombre de mots-clés sont générés automatiquement par darktable lorsque certaines actions sont réalisées. Par exemple, les mots-clés « darktable|exported » et « darktable|styles|your_style » peuvent être utilisés pour identifier respectivement les images qui ont été exportées et celles auxquelles des styles ont été appliqués.

modifier/renommer un mot-clé

Le dictionnaire de mots-clés peut être maintenu via les éléments « éditer... » et « changer le chemin... » dans le menu contextuel (clic-droit).

L'opération "éditer..." vous permet de changer le nom d'un mot-clé, bien que vous ne puissiez pas changer le nœud auquel elle appartient (vous ne pouvez pas utiliser le symbole pipe "|" dans le champ du nom du mot-clé). La commande est abandonnée si vous essayez d'entrer un nom de mot-clé qui existe déjà. Vous pouvez définir les indicateurs privé et catégorie et définir des synonymes pour le mot-clé (voir ci-dessous). Ces attributs sont enregistrés respectivement dans les entrées de métadonnées "XMP-dc Subject" et "XMP-lr Hierarchical Subject". Vous pouvez contrôler les mots-clés inclus dans les exportations en modifiant les paramètres dans le module exporter.

Un mot-clé qualifié de "privé" n'est pas exporté, par défaut.

Un mot-clé défini comme "catégorie" n'est pas exporté dans XMP-dc Subject. Cependant, il est exporté dans XMP-lr Hierarchical Subject car ce type de métadonnées XMP contient l'organisation de vos mots-clés.

Les « synonymes » enrichissent le mot-clé et sont principalement utilisés pour assister les moteurs de recherche. Par exemple, "juvénile", "môme" ou "jeune" peut être défini comme synonyme d'"enfant". Les synonymes peuvent également être utilisés pour traduire les mots-clés dans d'autres langues.

L'opération "change le chemin..." n'est disponible qu'en mode d'affichage arbre, et elle montre le nombre d'images qui seraient touchées par une modification du nom de ce nœud. La fenêtre de changement de chemin permet à l'utilisateur de modifier le chemin complet du nœud, y compris les nœuds auxquels il appartient (les nœuds peuvent être spécifiés à l'aide du symbole tuyau "|"). Cette opération est puissante, mais soyez prudent car elle peut avoir des conséquences importantes sur les métadonnées de vos images. L'opération est abandonnée si la modification demandée provoque un conflit avec un mot-clé existant.

Un moyen rapide d'organiser la structure des mots-clés consiste à faire glisser et déposer les nœuds. Dans le mode d'affichage arbre, vous pouvez faire glisser n'importe quel nœud et le déposer au-dessus de n'importe quel autre nœud. Le premier nœud et ses descendants, s'il y en a, deviennent les descendants du deuxième nœud. Faire glisser sur un nœud ouvre automatiquement ce nœud. Pour placer un nœud au niveau de la racine, faites-le glisser vers le haut de la fenêtre des mots-clés. Si la modification demandée provoque un conflit avec un mot-clé existant, l'opération est abandonnée.

attacher un mot-clé

Il existe plusieurs façons d'attacher un mot-clé aux images sélectionnées :

cliquez sur un mot-clé dans la fenêtre dictionnaire de mots-clés pour le sélectionner, puis cliquez sur le bouton attacher.

clic-droit sur un mot-clé dans la fenêtre dictionnaire de mots-clés, pour afficher le menu contextuel, puis sélectionnez l'élément de menu "attacher le mot-clé".

double-clic sur un tag dans la fenêtre dictionnaire de mots-clés.

clic-droit sur un mot-clé affiché dans la vue mots-clés liés pour afficher le menu contextuel. Si certaines des images sélectionnées n'ont pas ce mot-clé, l'élément de menu "attache le mot-clé à toutes les images sélectionnées" peut être utilisé pour attacher ce mot-clé à toutes les images sélectionnées.

Tapez dans la zone de texte et appuyez sur le bouton "nouveau" ou sur la touche Entrée. Cela créera le mot-clé s'il n'existe pas déjà et l'attachera aux images sélectionnées.

Appuyez sur Ctrl+T pour ouvrir une petite zone de texte en bas de la vue centrale de la table lumineuse. Tapez le nom d'un mot-clé et appuyez sur Entrée. Le mot-clé sera créé s'il n'existe pas, et attaché à toutes les images sélectionnées.

Faites glisser une image ou un groupe d'images et déposez-le sur le mot-clé souhaité.

Lorsque vous survolez les images dans la table lumineuse, vous pouvez vérifier quels mots-clés sont attachés à l'image, soit en regardant la fenêtre mots-clés liés dans le module mots-clés, soit dans l'attribut mots-clés dans le module information de l'image.

détacher un mot-clé

Il existe plusieurs manières de supprimer un mot-clé des images sélectionnées :

cliquez sur une balise dans la fenêtre mots-clés liés du module mots-clés pour sélectionner le mot-clé, puis cliquez sur le bouton détacher.

double-clic sur un mot-clé dans la fenêtre mots-clés liés.

clic-droit sur un mot-clé dans la fenêtre mots-clés liés, pour afficher le menu contextuel, et sélectionnez "détacher".

supprimer un mot-clé

Il est possible de supprimer complètement un mot-clé de toutes les images (qu'elles soient sélectionnées ou non) et de supprimer le mot-clé de la base de données. Étant donné que cela pourrait avoir un impact sur un grand nombre d'images, un avertissement s'affichera indiquant le nombre d'images associées à ce mot-clé. Prenez cet avertissement au sérieux car il n'y a aucun moyen d'annuler cette action (sauf en restaurant votre base de données et/ou vos fichiers annexes XMP à partir d'une sauvegarde). Un mot-clé dans la fenêtre dictionnaire de mots-clés peut être supprimé des manières suivantes :

clic-droit sur un mot-clé dans la fenêtre dictionnaire de mots-clés, pour afficher le menu contextuel, et choisissez "supprimer un mot-clé".

clic-droit sur un nœud de l'arbre dans la fenêtre dictionnaire de mots-clés, pour afficher le menu contextuel, et choisissez "supprimer le nœud" pour supprimer le nœud sélectionné avec tous ses nœuds enfants.

importer / exporter

Le bouton « importer » permet de choisir un fichier texte (qui doit respecter le format de fichier texte des mots-clés Lightroom) et d'importer son contenu. Si un mot-clé dans le fichier importé existe déjà, ses propriétés seront mises à jour, sinon un nouveau mot-clé sera créé.

Le bouton « exporter » exporte tout votre dictionnaire de mots-clés dans un fichier texte de votre choix (format de fichier texte de mots-clés Lightroom).

navigation

Pour voir les images portant un mot-clé particulier dans la fenêtre dictionnaire de mots-clés, cliquez avec le bouton droit sur le mot-clé et choisissez "aller à la collection liée au mot-clé" dans le menu contextuel qui s'affiche. Cela ouvre une collection dans le module collections affichant toutes les images contenant ce mot-clé. Dans le module collections vous pouvez sélectionner un autre mot-clé en double-cliquant sur ce mot-clé.

Pour revenir à la collection active avant d'ouvrir la collection d'un mot-clé, sélectionnez l'élément "retourner au module des mots-clés" dans le menu contextuel. Cela vous permettra de revenir à la collection d'origine, tant que vous n'aurez pas sélectionné d'autres collections entre-temps.

pellicule

La pellicule peut être utilisée pour basculer rapidement entre les images dans n'importe quelle vue de darktable. Les images dont les miniatures sont affichées dans la pellicules sont les mêmes que celles qui sont affichées dans la vue table lumineuse et sont définies par la collection actuellement sélectionnée.

La pellicule peut être activée et désactivée à l'aide du raccourci Ctrl+F. La hauteur du panneau de la pellicule peut être modifiée en cliquant et en faisant glisser sa bordure supérieure.

Parcourez rapidement les miniatures de la pellicule en faisant défiler avec la souris. Dans la chambre noire, vous pouvez changer de photo en cours de traitement en cliquant sur une autre miniature de la pellicule.

Dans la vue chambre noire, la miniature de l'image en cours de traitement est sélectionnée et mise en surbrillance. Survolez la pellicule avec la souris pour sélectionner une autre miniature (afin d'agir sur l'image correspondante à l'aide d'un raccourci clavier) sans changer l'image en cours de traitement.

Si vous souhaitez sélectionner plusieurs miniatures dans la pellicule, utilisez Alt+clic pour sélectionner la première, puis Ctrl+clic pour ajouter ou supprimer de la sélection d'autres miniatures ou encore Maj+clic pour sélectionner une plage de miniatures.

Les raccourcis suivants sont disponibles pour sélectionner des miniatures dans la pellicule ou pour effectuer des actions sur les images correspondant aux miniatures sélectionnées :

Ctrl+A         sélectionner toutes les miniatures de la pellicule
Ctrl+Maj+A   désélectionner toutes les miniatures
Ctrl+I         inverser la sélection actuelle

F1 - F5        basculer d'une étiquette de couleur à une autre (rouge, jaune, vert, bleu, violet)
0 - 5          définir/changer l'évaluation d'une image
R              rejeter une image
Ctrl+D         cloner une image
Ctrl+C         copier tout l'historique
Ctrl+V         coller tout l'historique copié
Alt+Ctrl+C     copier l'historique de manière sélective
Alt+Ctrl+V     coller l'historique copié de manière sélective

Voir la documentation du module historique pour plus d'information sur les fonctionnalités du copier-coller.

scopes

Ce module fournit diverses représentations graphiques des niveaux de lumière ou de chromaticité de l'image développée.

Déplacez la souris sur le panneau pour afficher les boutons qui vous permettent de régler l'affichage. Le bouton le plus à gauche permet de passer d'un mode à l'autre : histogramme, forme d'onde, parade RVB et vectorscope. Les autres boutons contrôlent la façon dont le graphique de l'oscilloscope actuel est dessiné.

Quand la souris survole le panneau scopes, la roulette souris avec la touche Ctrl maintenue permet de changer la hauteur du graphique. Vous pouvez cacher/afficher le module scopes entièrement avec un raccourci clavier (par défaut : Ctrl+Maj+H).

Vous pouvez déplacer le module des scopes vers le panneau de gauche dans préférences > divers > position du module des scopes.

Pour des raisons de performances, l'affichage des scopes est calculé à partir de l'aperçu de l'image (celle affichée dans la vue navigation) plutôt que depuis la vue centrale de haute qualité. Cet aperçu est calculé avec une faible résolution et peut contourner certaines étapes du traitement qui prennent trop de temps. C'est pourquoi l'affichage de l'histogramme peut ne pas rendre avec précision les détails les plus fins, et peut dévier d'autres sortes de l'image finale développée.

histogramme

L'histogramme « classique » montre la distribution de la clarté des pixels pour chaque canal de couleur.

Par défaut, les données des trois canaux RVB sont affichés. L'axe des x va de 0% à 100% de clarté pour chaque canal. L'axe des y donne le nombre de pixels de l'image pour une clarté donnée.

Cliquez sur le deuxième bouton en partant de la gauche pour basculer entre une échelle linéaire et logarithmique de l'axe y.

Les trois boutons colorés les plus à droite permettent de basculer l'affichage des canaux de couleur rouge, vert et bleu.

forme d'onde

La forme d'onde représente des données similaires à celles de l'histogramme, mais vous permet de visualiser ces données dans un contexte spatial.

Dans la forme d'onde horizontale "standard", l'axe des abscisses de la forme d'onde représente également celui de l'image -- le côté droit de la forme d'onde correspond au côté droit de l'image et le côté gauche de la forme d'onde au côté gauche de l'image.

L'axe des ordonnées représente la répartition de clarté des pixels pour chaque canal de couleur. La ligne pointillée en haut représente 100% de clarté (les valeurs au dessus peuvent être tronquées), la ligne pointillée du milieu correspond à 50% de clarté, et le bas de la ligne d'onde représente 0% de clarté.

La luminosité de chaque point sur la forme d'onde représente le nombre de pixels à la position donnée (l'axe des x) ayant la clarté donnée (l'axe des y).

En cliquant sur le deuxième bouton, vous basculez entre une forme d'onde horizontale et une forme d'onde verticale. Dans la forme d'onde verticale, l'axe des y du tracé représente l'axe des y de l'image et l'axe des x représente la répartition des pixels par clarté. La forme d'onde verticale peut être utile pour les images au format portrait, ou simplement pour comprendre une image d'une manière différente.

Comme pour l'histogramme « classique », vous pouvez afficher sélectivement chacun des canaux rouge, vert et bleu, en cliquant sur les boutons appropriés.

Voir l'article (en anglais) Of Histograms and Waveforms pour plus d'information sur la forme d'onde de darktable.

parade rvb

Le mode parade RVB affiche les mêmes données que la forme d'onde, mais avec les canaux rouge, vert et bleu présentés côte à côte.

Comme pour la forme d'onde, un clic sur le deuxième bouton le plus à gauche du panneau permet de basculer entre le traitement horizontal et vertical des données de l'image.

Le mode parade RVB peut être utile pour faire correspondre les intensités des canaux rouge, vert et bleu. Cela peut également aider à comprendre les différences entre les canaux et les qualités intrinsèques de chaque canal.

vectorscope

Le vectorscope montre la chromaticité sans tenir compte de la clarté ou des données spatiales.

La distance depuis le centre du graphique représente la chroma et l'angle représente la teinte. Les zones du graphique sont colorées en fonction de la chromaticité des couleurs présentes dans l'image. Le graphique représente le "volume" de couleur en affichant les couleurs les plus fréquemment utilisées dans l'image dans des tons plus clairs.

L'échelle de chroma du vectorscope peut être linéaire ou logarithmique. Cliquez sur le deuxième bouton en partant de la gauche pour basculer de mode.

Le vectorscope peut décrire l'image dans les espaces colorimétriques CIELUV, JzAzBz ou RJB. Le troisième bouton en partant de la gauche permet de basculer entre les modes u*v*, AzBz et RJB. Le graphique CIELUV sera plus rapide à calculer en plus d'être un standard bien connu. JzAzBz peut être plus précis sur le plan de la perception.

Le graphique comprend un « anneau de teinte » représentant la chroma maximale de chaque teinte du profil d'histogramme actuel (en RVB borné). Les RVB primaires/secondaires sont marqués par des points.

mises en garde

L'anneau de teinte n'est pas un contrôle de gamut, car une couleur peut se trouver dans l'anneau de teinte, mais hors du gamut en raison de son obscurité/clarté.

Lors d'un ajustement colorimétrique basé sur une charte de couleurs, des résultats plus rapides et plus précis pourront être faits avec l'option calibrer avec une charte couleur dans le module calibration des couleurs.

Le vectorscope n'a pas de « ligne de ton de peau », ce qui est une mauvaise généralisation plutôt qu'un standard.

Le vectorscope représente un encodage colorimétrique d'une image, qui diverge inévitablement de la perception de l'utilisateur.

ajustement de l'exposition

Les modes « histogramme classique », « forme d'onde » et « parade RVB » peuvent être utilisés pour modifier directement l'exposition et le niveau de noir du module exposition.

Pour l'histogramme classique, cliquez vers le côté droit de l'histogramme, puis faites glisser vers la droite pour augmenter ou vers la gauche pour diminuer l'exposition. De la même manière, vous pouvez contrôler le niveau de noir en cliquant et en faisant glisser la partie la plus à gauche de l'histogramme.

Pour les modes forme d'onde et parade RVB, faites glisser la partie supérieure de l'histogramme vers le haut ou le bas pour augmenter ou diminuer l'exposition. Faites glisser la partie inférieure vers le haut ou le bas pour augmenter ou diminuer le niveau de noir.

Pour les modes forme d'onde et parade RVB, les régions correspondantes sont à droite (exposition) et à gauche (niveau de noir).

Vous pouvez également utiliser la molette de la souris sur la zone appropriée (plutôt que de faire glisser) pour ajuster l'exposition et le point noir. Double-cliquez dans l'histogramme pour réinitialiser les paramètres du module d'exposition à leurs valeurs par défaut.

profil de l'histogramme

Les données de l'image sont converties en profil de l'histogramme avant que celui-ci ne soit calculé. Vous pouvez choisir ce profil en cliquant avec le bouton droit sur les icônes épreuvage écran ou vérification de gamut dans le bandeau inférieur, puis en sélectionnant le profil qui vous intéresse. Lorsque l'épreuvage écran ou la vérification de la gamut est activée, l'histogramme est affiché dans le profil d'épreuvage écran.

Comme l'histogramme s'exécute à la fin du calcul de rendu de prévisualisation, il reçoit ses données dans l'espace colorimétrique d'affichage. Si vous utilisez un espace colorimétrique d'affichage qui ne se « comporte pas très bien » (courant pour un profil de périphérique), les couleurs qui se trouvent en dehors du gamut du profil d'affichage peuvent être écrêtées ou déformées.

table lumineuse

chronologie

historique

images sélectionnées

importer

lua scripts installer

sélectionner

styles

chronologie

Affiche vos images par date/heure de prise de vue.

Dans la vue navigateur de fichiers de la table lumineuse, vous pouvez afficher/masquer le module chronologie dans le panneau inférieur avec le raccourci Ctrl+F.

Dans la chronologie, vous pouvez afficher les dates suivantes et précédentes en faisant défiler avec votre souris ; Ctrl+défilement pour zoomer/dézoomer.

Vous pouvez également utiliser la chronologie pour sélectionner des images par plage de dates en cliquant et en faisant glisser votre souris.

historique

Manipule l'historique d'une ou plusieurs images sélectionnées.

contrôles du module

copier sélectivement...

Copier des parties de l'historique de l'image sélectionnée. Une boîte de dialogue apparaît dans laquelle vous pouvez choisir les éléments de l’historique à copier. Si plusieurs images sont sélectionnées, l'historique est extrait de l'image sélectionnée en premier. Double-cliquez sur un élément de l'historique pour copier cet élément uniquement et fermer immédiatement la boîte de dialogue.

copier

Copier l'historique complet de l'image sélectionnée. Si plusieurs images sont sélectionnées, l'historique est extrait de l'image sélectionnée en premier.

Les informations relatives à l'encodage interne de l'affichage et à la gestion des masques sont considérées comme peu sûres pour être copiées automatiquement vers d'autres images et ne seront donc pas copiées lors de l'utilisation de ce bouton.

Les modules suivants sont exclus de l'opération copier :

orientation

correction des objectifs

point noir/blanc raw

rotation des pixels

mise à l'échelle des pixels

balance des blancs

modules dépréciés

Vous pouvez outrepasser toutes ces exclusions en utilisant « coller sélectivement... » et en choisissant les modules à coller sur la ou les images cibles.

compresser

Compresser l'historique de l'image sélectionnée. Si un module apparaît plusieurs fois dans l'historique, ces occurrences seront compressées en une seule étape dans l'historique. Attention : cette action ne peut pas être annulée !

supprimer

Supprimer physiquement l'historique des images sélectionnées. Attention : cette action ne peut pas être annulée !

coller sélectivement...

Coller, sur toutes les images sélectionnées, des parties de l'historique copié. Une boîte de dialogue apparaît dans laquelle vous pouvez choisir les éléments à coller de l'historique source.

coller

Coller, sur toutes les images sélectionnées, tous les éléments d'un historique copié.

mode

Ce paramètre définit le comportement des actions coller lorsqu'elles sont appliquées à une image qui possède déjà un historique. En termes simples, le mode « écraser » supprime l'historique précédent avant de coller, tandis que « ajouter » concatène les deux historiques.

Un historique copié peut avoir plusieurs entrées du même module (avec le même nom ou des noms différents) et coller se comporte différemment pour ces entrées dans les modes empiler et écraser.

En mode empiler, pour chaque module de l'historique copié, s'il y a un module dans l'image de destination avec le même nom, il sera remplacé. S'il n'y a pas de tel module, une nouvelle instance sera créée. Dans les deux cas, l'instance collée est placée au sommet de l'historique. Si un module particulier apparaît plusieurs fois dans l'un ou l'autre des historiques, seule la dernière occurrence de ce module sera traitée.

En mode écraser, le comportement est le même sauf que l'historique de l'image de destination est supprimé avant que l'opération coller ne commence. Dans ce mode, les actions « copier tous » / « coller tous » dupliqueront exactement l'historique copié sur les images de destination (y compris les occurrences en double).

Remarques

Les préréglages automatiques du module ne sont ajoutés à une image que lorsqu'elle est ouverte pour la première fois dans la chambre noire ou que son historique est supprimé. Si vous utilisez le mode écraser pour coller des entrées de l'historique sur des images qui n'ont pas été précédemment ouvertes dans la chambre noire, la prochaine fois que cette image sera ouverte dans la chambre noire, des préréglages automatiques lui seront appliqués. Il peut donc sembler que le mode « écraser » ne duplique pas exactement l'historique existant, mais dans ce cas, des modules automatiques ont été ajoutés après l'action d'un coller.

Le mode « empiler » vous permet de reconstituer ultérieurement votre historique préexistant (car les éléments d'historique précédents sont conservés dans l'historique de l'image de destination). Cependant, en mode « écraser », toutes les modifications précédentes sont irrévocablement perdues.

Le paramètre mode est conservé lorsque vous quittez darktable -- si vous le modifiez pour un copier-coller unique, assurez-vous de le modifier à nouveau.

charger un xmp

Ouvre une boîte de dialogue qui vous permet d'importer l'historique à partir d'un fichier XMP sélectionné. Cet historique copié peut ensuite être collé sur une ou plusieurs images.

Les images qui ont été exportées par darktable contiennent généralement l'historique complet si le format de fichier prend en charge les métadonnées intégrées (voir le module exporter pour plus de détails sur cette fonctionnalité et ses limitations). Vous pouvez charger une image exportée en tant que fichier lié de la même manière qu'un fichier XMP. Cette fonctionnalité vous permet de récupérer tous les réglages si vous avez accidentellement perdu ou écrasé le fichier XMP. Tout ce dont vous avez besoin est l'image source, généralement un fichier RAW, et le fichier image exporté.

sauver en xmp

Écrire les fichiers liés XMP pour toutes les images sélectionnées. Le nom de fichier est généré en ajoutant ".xmp" au nom du fichier d'entrée sous-jacent.

Par défaut, darktable génère et met à jour les fichiers liés automatiquement chaque fois que vous travaillez sur une image et en modifiez l'historique. Vous pouvez désactiver la génération automatique de fichiers liés dans préférences> stockage. Cela peut être utile lorsque vous exécutez plusieurs versions de darktable (afin que les modifications de chaque version n'entrent pas en conflit les unes avec les autres), cependant, en général, il n'est pas recommandé de désactiver cette fonctionnalité.

images sélectionnées

Effectue des actions sur les images qui ont été sélectionnées dans la vue table lumineuse.

contrôles du module

Les contrôles du module sont répartis en deux onglets pour manipuler, l'un les fichiers images, et l'autre les métadonnées associées.

onglet images

enlever

Enlève les images sélectionnées de la bibliothèque darktable sans les supprimer. Les images enlevées ne peuvent plus être visualisées ou modifiées dans darktable, mais les fichiers image restent sur le système de fichiers avec tous les fichiers liés XMP. Comme darktable maintient les fichiers XMP à jour avec votre dernier historique de développement, vous pouvez restaurer entièrement votre travail plus tard en réimportant les images.

supprimer (corbeille)

Supprime du système de fichiers, les images sélectionnées de la bibliothèque de darktable et supprime tous les fichiers liés XMP. S'il ne reste aucun clone d'une image supprimée dans la bibliothèque de darktable, le fichier image lui-même est également supprimé. Vous pouvez contrôler si cette action supprime irrévocablement les fichiers ou tente de les mettre dans la corbeille de votre système avec un élément de configuration dans préférences> sécurité. Un deuxième élément de configuration dans le même onglet vous permet de contrôler s'il faut ou non être averti avant de supprimer des images.

déplacer...

Déplace physiquement les images sélectionnées (les fichiers image et tous les fichiers liés XMP) vers un autre répertoire du système de fichiers. Si une image avec le nom de fichier donné existe déjà dans le répertoire cible, l'image source ne sera pas déplacée.

copier...

Copie physiquement les images sélectionnées (les fichiers image et tous les fichiers liés XMP) dans un autre répertoire du système de fichiers. Si une image avec le nom de fichier donné existe déjà dans le répertoire cible, elle ne sera pas écrasée -- à la place, un nouveau clone sera généré avec le même historique que l'image source.

créer HDR

Crée une image à plage dynamique élevée (HDR) à partir des images sélectionnées et l'ajoute à la bibliothèque de darktable en tant que nouvelle image au format DNG. Les images doivent être correctement alignées, ce qui implique qu'elles ont été prises sur un trépied solide. Vous pouvez également générer des images HDR avec des programmes tels que Luminance HDR, puis les importer dans darktable pour un traitement ultérieur. Notez que darktable ne peut créer des images HDR qu'à partir de fichiers RAW.

cloner

Crée des clones des images sélectionnées. Les images clonées partagent le même fichier image, mais chaque clone a son propre fichier lié XMP et une entrée distincte dans la base de données de darktable. Cela vous permet de tester différents développements de la même image.

rotation

Effectue une rotation des images sélectionnées dans le sens horaire ou antihoraire. Un troisième bouton peut être utilisé pour réinitialiser la rotation de l'image à la valeur stockée dans ses données Exif. Cette fonctionnalité est directement liée au module de traitement orientation -- le module avec les ajustements effectués ici est automatiquement placé dans l'historique.

copier localement

Crée, sur le disque local, des copies locales des images sélectionnées. Ces copies seront ensuite utilisées lorsque les images originales ne seront pas accessibles (voir copies locales).

resync copie locale

Synchronise le fichier lié XMP de la copie locale de chaque image sélectionnée avec la copie dans le stockage externe et supprime les copies locales. Notez que si une copie locale a été modifiée et que le stockage externe n'est pas accessible, la copie locale ne sera pas supprimée (voir copies locales).

grouper

Crée un nouveau groupe à partir des images sélectionnées (voir grouper des images).

dégrouper

Enlève les images sélectionnées de leur groupe (voir grouper des images).

onglet métadonnées

cases à cocher des types de métadonnées

Choisissez les types de métadonnées (étoiles, balises, métadonnées, couleurs, géolocalisation) sur lesquels vous souhaitez opérer

copier

Copie les types de métadonnées choisis de l'image sélectionnée dans le presse-papiers. Si plusieurs images sont sélectionnées ou si aucune image n'est sélectionnée, ce bouton n'est pas disponible.

coller

Colle toutes les métadonnées du presse-papiers sur les images sélectionnées.

effacer

Efface les types de métadonnées choisis des images sélectionnées.

mode

Lors du collage de métadonnées sur des images, cette option contrôle si les métadonnées du presse-papiers doivent être fusionnées avec les métadonnées existantes (fusionner), ou doivent les remplacer entièrement (écraser).

rafraîchir exif

Actualise les données Exif du fichier source. Attention : cela peut écraser certaines balises et métadonnées que vous avez modifiées dans darktable (comme les étoiles).

monochrome

Marque l'image comme monochrome, ce qui signifie qu'elle recevra tout traitement spécifique au flux de travail monochrome. Reportez-vous à la section développement d'images monochromes pour plus de détails.

couleur

Supprime le drapeau monochrome de l'image afin qu'il reçoive le traitement de flux de travail par défaut normalement utilisé lors du développement de photos couleur.

importer

Ajoute des images à la bibliothèque darktable, en les copiant éventuellement à partir d'un autre emplacement du système de fichiers ou à partir d'un boîtier connecté.

Voir formats de fichiers supportés pour plus d'informations.

contrôles du module

Les boutons suivants sont affichés par défaut dans l'interface :

ajouter à la bibliothèque...

Ajoute des images existantes à la bibliothèque de darktable sans copier ni déplacer de fichiers. Si vous n'ajoutez qu'une seule image à la bibliothèque, elle sera automatiquement ouverte dans la chambre noire.

copier & importer...

Crée des copies d'images à partir du système de fichiers, puis ajoute ces copies à la bibliothèque de darktable.

Lorsqu'un appareil photo est détecté, une nouvelle section apparaît dans le module pour cet appareil. Si vous passez la souris sur son nom, une info-bulle affiche des informations à son sujet (modèle, version du firmware, etc.)

Selon les caractéristiques du boîtier, les boutons supplémentaires suivants peuvent s'afficher :

monter le boîtier

Monte le boîtier pour une utilisation exclusive par darktable. Ce bouton n'apparaît que si le boîtier n'est pas monté ni verrouillé par un autre processus.

copier & importer depuis le boîtier

Crée des copies d'images à partir du boîtier connecté, puis ajoute ces images à la bibliothèque darktable. Ce bouton n'apparaît que si un boîtier est connecté.

capture

Ouvre la vue capture afin de pouvoir prendre des images avec votre appareil photo connecté en utilisant darktable. Ce bouton n'apparaît que si l'appareil est monté.

démonter le boîtier

Démonte le boîtier et le libère pour utilisation par d'autres applications. Ce bouton n'apparaît que si le boîtier est monté.

paramètres du module

Cliquez sur l'étiquette « paramètres » ou sur le bouton d'extension à côté pour afficher les options supplémentaires suivantes.

Tous les paramètres sont conservés d'une session à l'autre et peuvent être enregistrés dans un préréglage du module.

ignorer la notation exif

Cochez cette option pour ignorer toute évaluation enregistrée dans les données Exif de l'image et utiliser à la place une valeur codée en dur (ci-dessous).

notation initiale

Nombre d'étoiles initial (de 0 à 5) à appliquer aux images nouvellement importées (1 par défaut).

appliquer métadonnées

Cochez cette option pour définir automatiquement les champs de métadonnées et/ou les balises au moment de l'importation (voir ci-dessous).

métadonnées

Si la case « appliquer les métadonnées » est cochée, la liste des champs de métadonnées visibles est présentée pour être complétée (voir éditeur de métadonnées pour plus de détails). Toutes les chaînes remplies sont automatiquement ajoutées aux images importées. Vous pouvez également choisir parmi tous les préréglages enregistrés dans le module d'éditeur de métadonnées.

Double-cliquez sur une étiquette pour réinitialiser le champ correspondant. Double-cliquez sur l'étiquette « préréglages de métadonnées » pour réinitialiser tous les champs.

Lorsque préférences > stockage > écrire un fichier xmp redondant pour chaque image est fixé à jamais, une colonne supplémentaire « depuis xmp » est présentée afin que vous puissiez choisir d'interdire ou d'autoriser l'importation de certaines métadonnées à partir de fichiers XMP.

mots-clés

Si vous souhaitez ajouter d'autres mots-clés par défaut lors de l'importation d'images, vous pouvez les fournir ici sous forme de liste, séparés par des virgules. Comme pour les métadonnées, vous pouvez également choisir parmi tous les préréglages enregistrés dans le module mots-clés.

la boîte de dialogue d'importation

Chacun des trois boutons d'importation (ajouter à la bibliothèque, copier & importer, copier & importer depuis le boîtier) utilise une fenêtre de dialogue similaire pour le processus d'importation, décrit dans cette section.

L'exemple de capture d'écran suivant est tiré du bouton « ajouter à la bibliothèque » :

fonctionnalité commune

emplacements et dossiers

La fenêtre de dialogue d'importation vous permet de configurer des emplacements d'importation communs, afin de rendre les importations ultérieures aussi simples que possible. Lorsque vous ouvrez la boîte de dialogue pour la première fois, darktable tente d'ajouter des emplacements communs (utilisateur, images, périphériques) dans le volet des emplacements. Vous pouvez ajouter de nouveaux emplacements à la liste en cliquant sur le bouton '+' et vous pouvez supprimer des lieux de la liste en faisant un clic-droit dessus. Si vous souhaitez restaurer un emplacement par défaut que vous avez supprimé, vous pouvez le faire avec le bouton de réinitialisation.

Lorsque vous choisissez un emplacement, l'arborescence des dossiers est automatiquement renseignée (dans le volet dossiers) à partir de l'emplacement sélectionné. Vous pouvez ensuite parcourir l'arborescence des dossiers et sélectionner un dossier à importer. Le dernier dossier sélectionné est automatiquement affiché à l'ouverture de la fenêtre de dialogue.

Dans l'exemple de capture d'écran ci-dessus, vous pouvez voir qu'un "emplacement" a été créé pour la racine du dossier Images et qu'un sous-dossier au sein de cette structure a été sélectionné. Il s'agit du flux de travail recommandé pour le processus d'importation -- vous ne devriez pas avoir à créer de nouveaux emplacements très souvent.

fichiers

Une fois que vous avez sélectionné un dossier, le volet des fichiers est automatiquement rempli avec la liste des fichiers trouvés dans ce dossier. Par défaut, tous les fichiers du dossier choisi sont sélectionnés.

Vous pouvez afficher les miniatures de n'importe quelle image en cliquant sur l'icône icône œil . Des boutons sont disponibles en bas de l'écran pour sélectionner tous les fichiers, « tout sélectionner » ou aucun, « rien sélectionner ».

Quand vous êtes satisfait de votre sélection, appuyez sur Entrée ou cliquez sur le bouton en bas à droite de l'écran pour importer (ce bouton sera nommé différemment selon le type d'importation en cours).

Appuyez sur la touche Echap ou cliquez sur le bouton « annuler » pour quitter sans importer.

options communes

Les options supplémentaires suivantes sont communes à toutes les boîtes de dialogue d'importation :

récursivement

Cochez cette option pour importer des images dans le dossier sélectionné et tous les sous-dossiers. Il est déconseillé d'utiliser cette option pour importer un grand nombre d'images en même temps. Le processus d'importation amène darktable à générer des miniatures pour toutes les images importées, mais à la fin, il ne pourra conserver que les plus récentes dans son cache. Il est donc préférable d'importer des images en plusieurs fois pour éviter des problèmes de performance.

ignorer les fichiers JPEG

Cochez cette option s'il y a des images JPEG dans le même dossier que vous ne souhaitez pas importer. Cette option est généralement utilisée lorsque l'appareil photo est configuré en RAW+JPEG et que vous souhaitez uniquement travailler sur les fichiers RAW et ignorer les fichiers JPEG.

ajouter à la bibliothèque

Le bouton « ajouter à la bibliothèque » vous permet d'ajouter une ou plusieurs images à la bibliothèque de darktable à partir du système de fichiers local. Ce processus ne copie ni ne déplace les images, mais les ajoute simplement à la bibliothèque et crée les fichiers liés XMP.

sélectionner seulement nouvelles images

Cochez cette case pour restreindre la sélection au chargement du dialogue aux images qui n'ont pas encore été incluses dans la bibliothèque de darktable. Si vous essayez de recharger des images dans la bibliothèque de darktable, les données associées sont lues des fichiers liés XMP. Le bouton « sélectionner nouveaux » au bas de la boîte de dialogue sélectionne uniquement les « nouvelles » images pour le dossier courant.

Remarque : « ajouter à la bibliothèque » ne crée pas de doublons de vos fichiers image dans une structure de dossiers distincte, mais les traite sur place. Le processus « ajouter à la bibliothèque » ajoute simplement les détails de ces images dans la bibliothèque de darktable (et crée un fichier lié XMP le cas échéant) permettant aux images d'être visualisées et développées.

Cela signifie que si vous supprimez des images du disque après les avoir ajoutées, darktable ne peut plus y accéder. De plus, darktable ne surveille pas les changements dans le système de fichiers. Les nouvelles images ne sont pas affichées tant qu'elles ne sont pas explicitement importées.

copier & importer

Cette option copie les images d'un autre emplacement de votre système de fichiers (y compris les périphériques de stockage montés), puis ajoute les images copiées à la bibliothèque de darktable.

Les options supplémentaires suivantes sont disponibles pour définir le nom des répertoires et fichiers copiés. Par défaut, seule l'option nom importation est affichée -- cliquez sur l'étiquette règles de nommage ou sur l'icône d'extension à côté pour afficher des options supplémentaires :

nom importation

Le nom de la tâche d'importation (définit la variable $(JOBCODE)).

surcharger la date actuelle

Entrez une date/heure valide (au format YYYY-MM-DD[Thh:mm:ss]) si vous souhaitez remplacer la date/heure actuelle en provenance des variables $(YEAR), $(MONTH), $(DAY), $(HOUR), $(MINUTE) et $(SECONDS). Sinon, laissez le champ vide.

nommage du répertoire de base

Entrez votre modèle (par défaut $(PICTURES_FOLDER)/Darktable). Vous pouvez aussi cliquez sur l'icône à côté du champ de saisie pour choisir un répertoire manuellement.

nommage du sous répertoire

Entrez votre modèle (par défaut $(YEAR)$(MONTH)$(DAY)_$(JOBCODE)).

garder le nom d'origine

Cochez cette case pour conserver le nom d'origine des fichiers au lieu d'utiliser le modèle ci-dessous lors de l'importation.

nommage des fichiers

Entrez votre modèle pour le nom des fichiers (par défaut $(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION)).

garder cette fenêtre ouverte

Laisse la fenêtre ouverte une fois l'importation terminée, permettant plusieurs importations avec différentes options de nommage.

La plupart de ces options peuvent également être définies dans préférences> importer. Consultez cette section pour connaître les différentes variables possibles.

copier& importer depuis le boîtier

Cette option copie les fichiers d'un appareil photo connecté vers le système de fichiers local et ajoute ensuite les images copiées à la bibliothèque de darktable. Elle fournit les mêmes options de nommage que la boîte de dialogue « copier & importer " mais ne permet pas la sélection d'emplacements ou de dossiers.

lua scripts installer

Ce module fournit une interface pour installer les scripts Lua darktable. La première fois qu'il est exécuté, des instructions sont affichées dans le module.

Il peut être désactivé par une option dans préférences > options lua.

sélectionner

Sélectionne des images dans la table lumineuse selon des critères simples.

contrôles du module

tout sélectionner

Sélectionne toutes les images de la collection actuelle.

rien sélectionner

Désélectionne toutes les images.

inverser la sélection

Sélectionne toutes les images non sélectionnées de la collection actuelle.

dossier

Sélectionne toutes les images de la collection actuelle appartenant à la même pellicule que les images sélectionnées.

non développées

Sélectionne toutes les images de la collection actuelle encore non développées.

styles

Des images étant sélectionnées, créer à partir de leur historique des styles nommés ou leur appliquer des styles.

Les styles peuvent être créés dans ce panneau ou dans le module historique de la chambre noire.

Une liste de tous les styles disponibles s'affiche dans le module. Un champ de recherche au-dessus de la liste vous permet de localiser un style par son nom ou sa description. Ce module permet également d'éditer et de supprimer des styles.

Double-cliquez sur un nom de style pour appliquer ce style à toutes les images sélectionnées. Lorsque vous êtes dans les vues table lumineuse ou chambre noire, un style peut également être appliqué aux images sélectionnées en appuyant sur une touche de raccourci qui lui a été attribuée (voir préférences> raccourcis) .

Supprimez tous les styles en cliquant sur le bouton de réinitialisation du module.

Veuillez noter que les styles incluent également l'état actif de chaque module. Vous pouvez utiliser ceci pour créer vos propres paramètres par défaut -- vous pourrez ensuite les activer à la demande. Définissez simplement les valeurs par défaut souhaitées pour chaque module, désactivez le module et enregistrez le style.

contrôles du module

cloner l'image et appliquer le style

Lors de l'application d'un style aux images sélectionnées, cochez cette case pour créer un clone de chaque image avant d'appliquer le style choisi à ce clone. Désactivez cette option pour appliquer le style choisi directement aux images sélectionnées. Attention, dans ce cas, tout historique existant est écrasé (selon le mode choisi -- voir ci-dessous) et ne peut pas être récupéré.

mode

Comme dans le module historique, la liste déroulante vous propose "ajouter" le style à l'historique actuel ou "écraser" l'historique de l'image cible.

créer

Créer de nouveaux styles à l'aide de l'historique des images sélectionnées. Pour chaque image sélectionnée, une fenêtre de création de style s'affiche. Vous devez fournir un nom unique pour chaque nouveau style et vous pouvez également ajouter une description facultative. Vous aurez la possibilité de désélectionner tous les éléments de l'historique que vous ne souhaitez pas inclure dans le style créé.

Le panneau prend en charge une vue hiérarchique, ce qui signifie que vous pouvez créer des catégories à l'aide du symbole barre verticale « | » comme séparateur. Par exemple, "imprimer|courbe des tonalités +0,5 IL" créera une catégorie "imprimer" avec un style "courbe des tonalités +0,5 IL" en dessous.

éditer

Affiche une boîte de dialogue qui vous permet d'inclure ou d'exclure des éléments spécifiques de l'historique d'un style existant. Cochez l'option «cloner le style» si vous souhaitez créer un nouveau style, au lieu d'écraser celui existant, auquel cas vous devrez fournir un nom unique pour le nouveau style.

supprimer

Supprime le style sélectionné, sans aucune invite.

importer

Importer un style précédemment enregistré. Les styles sont stockés sous forme de fichiers XML avec l'extension .dtstyle. Si un style du même nom existe déjà, il vous sera demandé si vous souhaitez l'écraser.

exporter

Enregistrer le style sélectionné sur le disque en tant que fichier .dtstyle. Cela permet aux styles d'être publiés et partagés avec d'autres utilisateurs.

Préférences et réglages

présentation

général

importer

table lumineuse

chambre noire

traitement

sécurité

stockage

divers

raccourcis

préréglages

options lua

présentation

darktable est livré avec un certain nombre de préférences configurables par l'utilisateur. Celles-ci peuvent être ajustées dans la boîte de dialogue des préférences, accessible en cliquant sur l'icône d'engrenage à droite du panneau supérieur. Les préférences sont séparées en onglets, dont chacun est décrit plus en détail dans les sections suivantes.

Lorsqu'il est ouvert depuis les vues table lumineuse ou chambre noire, l'onglet approprié sera chargé par défaut pour vous permettre de modifier les paramètres de cette vue.

Tous les paramètres modifiés (c'est-à-dire ceux qui diffèrent de leur état par défaut) sont mis en évidence par une puce à côté de leur label. Si vous modifiez un paramètre qui nécessite un redémarrage pour prendre effet, un message apparaîtra comme rappel quand vous quitterez la boîte de dialogue des préférences.

Double-cliquez sur l'étiquette d'un paramètre pour réinitialiser sa valeur par défaut.

La boîte de dialogue des préférences peut être fermée en cliquant sur le bouton Fermer de votre gestionnaire de fenêtres ou en appuyant sur la touche Échap.

général

Contrôler l'aspect général de darktable.

langue pour l'interface

Définissez la langue de l'interface utilisateur. La valeur par défaut du système est marquée d'un * (nécessite un redémarrage)

thème

Définissez le thème de l'interface utilisateur. Indépendamment de toute considération esthétique, la couleur d'interface recommandée pour l'évaluation des couleurs est le gris moyen. La perception visuelle est affectée par la luminosité ambiante, et une faible luminosité de l'interface provoque toutes sortes d'illusions. Utiliser une interface sombre pour retoucher les photos peut donc conduire à des retouches excessives (abus de contraste et de saturation) et à une photo trop sombre une fois imprimée. Il est donc fortement recommandé d'utiliser l'un des thèmes "gris" pour les travaux de retouche car ils sont conçus pour que l'interface utilisateur se rapproche du gris moyen ("darktable" par défaut).

favoriser la performance à la qualité

Activez cette option pour afficher les miniatures et les aperçus avec une qualité inférieure. Cela augmente la vitesse de rendu d'un facteur 4, et est utile lorsque vous travaillez sur des ordinateurs plus lents (désactivé par défaut). Cela améliore également les performances du rendu d'image du diaporama.

utiliser la taille de la police système

Sélectionnez cette option pour utiliser la taille de police définie par votre système. Si elle n'est pas cochée, vous pouvez saisir une taille de police personnalisée dans la case ci-dessous (activée par défaut).

taille de la police en points

Si l'option «utiliser la taille de la police système» est désactivée, entrez une taille de police (en points) que darktable doit utiliser. La taille de la police sera modifiée immédiatement.

contrôles et texte DPI

Ajustez la résolution globale de l'interface graphique pour redimensionner les contrôles, les boutons, les étiquettes, etc. Augmentez pour une interface graphique agrandie, diminuez pour ajuster plus de contenu dans la fenêtre. Défini sur -1 pour utiliser la résolution globale définie par le système. La valeur par défaut est 96 PPP sur la plupart des systèmes. (nécessite un redémarrage)

modifier le thème via les ajustements CSS ci-dessous

En plus de sélectionner un thème pré-construit vous pouvez également appliquer vos propres personnalisations CSS pour modifier l'aspect général de darktable. Une zone de texte est prévue à cet effet.

Lorsque vous avez terminé de saisir vos modifications CSS, cliquez sur le bouton «sauvegarder et appliquer». Cela enregistrera votre CSS dans un fichier ($HOME/.config/darktable/user.css) et l'appliquera immédiatement à la session actuelle de darktable.

Si vos modifications posent des problèmes, vous pouvez décocher la case "modifier le thème via les ajustements CSS ci-dessous". Cela restaurera immédiatement le thème de base, mais laissera vos réglages dans l'éditeur afin que vous puissiez les rééditer et les réessayer. Appuyez simplement sur "sauvegarder et appliquer" à nouveau lorsque vous êtes prêt à réessayer. Cela revérifiera automatiquement la case à cocher "modifier le thème via les ajustements CSS ci-dessous" et appliquera le nouveau CSS.

Si vous rencontrez des problèmes avec darktable, veuillez réessayer avec cette option décochée pour être certain qu'ils n'ont pas été causés par l'une de vos modifications.

Si vous voulez comprendre comment sont construits les thèmes de darktable, nous vous recommandons d'examiner le fichier $DARKTABLE/share/darktable/themes/darktable.css (où $DARKTABLE désigne le répertoire d'installation de darktable). Vous pouvez aussi utiliser l'outil d'inspection de GTK pour analyser la présentation existante.

importer

Contrôler les conventions de nommage des fichiers utilisées par défaut lors de l'importation des images.

options de session

Les options suivantes définissent un modèle de nommage par défaut à utiliser dans les options "copier & importer" ou "copier & importer depuis le boîtier" dans le module importer, ou lors de la prise de photos dans la vue capture.

Le modèle de nommage se compose de trois parties : une partie de base définissant le dossier parent, une partie session définissant un sous-répertoire (qui est spécifique à la session d'importation individuelle) et une partie nom de fichier définissant la structure de nom de fichier pour chaque image importée.

Plusieurs variables prédéfinies peuvent être utilisées dans le modèle comme variables de substitution :

(HOME)              dossier personnel de l'utilisateur, défini par le système
$(PICTURES_FOLDER)   dossier d'images, défini par le système (généralement «$HOME/Images»)
$(DESKTOP)           dossier du bureau, défini par le système (généralement «$HOME/Bureau»)
$(USERNAME)          nom du compte utilisateur sur le système
$(FILE_NAME)         nom de base de l'image importée
$(FILE_EXTENSION)    extension de l'image importée
$(JOBCODE)           identifiant unique de la tâche d'importation
$(SEQUENCE)          nombre séquentiel dans la tâche d’importation
$(MAX_WIDTH)         largeur maximale d'une image lors de la session d'exportation
$(MAX_HEIGHT)        hauteur maximale d'une image lors de la session d'exportation
$(ID)                identifiant numérique unique de l’image dans la base de données
$(YEAR)              année de la date d’importation
$(MONTH)             mois de la date d’importation
$(DAY)               jour de la date d’importation
$(HOUR)              heure de la date d’importation
$(MINUTE)            minute de la date d’importation
$(SECOND)            seconde de la date d’importation
$(EXIF_YEAR)         année de prise de la photo ( données EXIF)
$(EXIF_MONTH)        mois de prise de la photo (données EXIF)
$(EXIF_DAY)          jour de prise de la photo (données EXIF)
$(EXIF_HOUR)         heure de prise de la photo (données EXIF)
$(EXIF_MINUTE)       minute prise de la photo (données EXIF)
$(EXIF_SECOND)       seconde de prise de la photo (données EXIF)
$(EXIF_ISO)          sensibilité ISO de la photo (données EXIF)

nommage du répertoire de base

Entrez votre modèle (par défaut $(PICTURES_FOLDER)/Darktable). Vous pouvez aussi cliquez sur l'icône à côté du champ de saisie pour choisir un répertoire manuellement.

nommage du sous répertoire

Entrez votre modèle (par défaut $(YEAR)$(MONTH)$(DAY)_$(JOBCODE)).

garder le nom d'origine

Cochez cette case pour conserver le nom de fichier d'origine au lieu d'utiliser le modèle ci-dessous lors de l'importation depuis un appareil photo ou une carte (désactivé par défaut).

nommage des fichiers

Entrez votre modèle pour le nom des fichiers (par défaut $(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION)).

table lumineuse

Contrôler les fonctionnalités de la vue et des modules de la table lumineuse.

général

cacher les préréglages internes des modules utilitaires

Si cette option est activée, seuls les préréglages définis par l'utilisateur seront affichés dans le menu des préréglages des modules utilitaires -- les préréglages intégrés seront masqués (par défaut désactivé).

utiliser un seul clic dans le module collections

Activer le mode "simple clic" dans le module collections. Cela permet aussi de sélectionner des plages de dates et de valeurs numériques (désactivée par défaut).

déplier un seul module utilitaire de la table lumineuse à la fois

Contrôle la façon dont les modules utilitaires sont dépliés. Si cette option est activée, déplier un module en cliquant dessus replie tout autre module actuellement déplié. Si vous souhaitez déplier un module sans replier les autres, vous pouvez le faire avec Maj+clic. La désactivation de cette option inverse la signification de Clic et de Maj+clic (désactivé par défaut).

positionne les modules utilitaires lorsqu'ils sont dépliés/repliés

Lorsque cette option est activée darktable essaiera de positionner le module pour qu'il soit entièrement visible (désactivée par défaut).

appliquer une étoile deux fois à une image ne supprimera pas l'étoile

Normalement, cliquer une seconde fois sur l'étoile d'une évaluation à une étoile la supprime. Cocher cette option supprime cette fonctionnalité (décoché par défaut).

afficher les barres de défilement pour la zone centrale

Si activé les barres de défilement seront affichées dans la zone centrale de la table lumineuse (activé par défaut).

miniatures

utiliser le raw au lieu de JPEG intégré à partir de la taille

Lors de la génération de vignettes pour des images qui n'ont pas encore été traitées en chambre noire, si la taille de la vignette est supérieure à cette valeur, la génère en développant l'image RAW. Si la miniature est inférieure à cette taille, utilise l'image d'aperçu JPEG intégrée dans le fichier RAW. Une fois qu'une image a été traitée dans la chambre noire, les vignettes sont toujours générées à partir des données RAW (vous pouvez revenir à l'aperçu JPEG en supprimant l'historique). Pour avoir les vignettes avec la meilleure qualité, choisissez "toujours".

développement haute qualité à partir de la taille

Si la taille de la miniature est supérieure à cette valeur et qu'elle est générée à partir de données RAW, elle sera traitée en haute qualité. Ce qui est meilleur mais plus lent (par défaut 720p). Pour rendre les miniatures avec la meilleure qualité, choisissez "toujours".

séparateurs des catégorie de tailles

Les catégories de tailles permettent d'afficher différentes superpositions des miniatures en fonction de la taille des miniatures. Un ensemble de valeurs délimitées par une barre verticale définit à quelles tailles d'image les catégories changent. La valeur par défaut "120|400" signifie qu'il y aura trois catégories de miniatures : 0-120px, 120-400px et> 400px.

patron pour les surimpressions des miniatures

Si l'utilisateur a choisi de superposer aux miniatures le texte étendu, ce paramètre lui permet de définir les informations à afficher. Ce patron peut utiliser n'importe laquelle des variables définies dans la section substitution de variable.

patron pour les infos bulles des miniatures (vide pour désactiver)

Définit les informations affichées dans l'info-bulle lorsque la souris survole les miniatures d'image. Ce patron peut utiliser n'importe laquelle des variables définies dans la section substitution de variable.

chambre noire

Contrôler les fonctionnalités de la vue chambre noire et des modules associés.

général

contrôle de la pression du pinceau du masque

Contrôle comment la lecture de pression d'une tablette graphique impacte les coups de pinceau sur un masque dessiné nouvellement généré. Vous pouvez contrôler la taille, la dureté et l'opacité du pinceau. La valeur «absolue» signifie que la lecture de pression définit directement l'attribut avec une valeur comprise entre 0% et 100%. La valeur «relative» signifie que la lecture de pression ajuste l'attribut entre zéro et la valeur par défaut prédéfinie (désactivée par défaut).

lissage du pinceau

Définit le niveau de lissage des traits de pinceau du masque dessiné. Un lissage plus fort entraîne moins de nœuds et une édition plus facile au détriment d'une précision moindre.

molette vers le bas pour augmenter les attributs des masques

Par défaut, fait défiler votre souris vers le haut augmente la valeur des paramètres de la forme dans masques dessinés. Définissez cette préférence pour inverser le comportement (désactivé par défaut).

format de la ligne d'information sur l'image

Définit les informations à afficher dans ligne d'information de l'image. Vous pouvez utiliser toute variable définie dans la section substitution de variable ainsi que $(NL) pour une nouvelle ligne.

position de la ligne d'information de l'image

Choisir le panneau de la vue chambre noire sur lequel sera affiché la ligne d'information de l'image. Choix possibles : “haut/gauche”, “haut/droite”, “haut/centre”, “bas” et “caché” ("bas" par défaut).

bordure autour de l'image dans la vue chambre noire

Traiter l'image centrale en mode chambre noire avec une bordure du nombre de pixels donné (par défaut 20).

affiche les barres de défilement de la zone centrale

Définit si les barres de défilement doivent être affichées dans la vue centrale de la chambre noire (désactivé par défaut).

méthode de dématriçage pour la vue chambre noire

Choisir la méthode pour dématricer les images de la vue chambre noire qui ne sont pas affichées à l'échelle de zoom 1:1

toujours bilinéaire (rapide) est la plus rapide, mais donne des résultats peu nets

au mieux PPG (raisonnable) utilise PPG plus les modes d'interpolation

full (possibly slow) utilise exactement les paramètres définis pour l'exportation en taille réelle

(par défaut "au mieux PPG (raisonnable)").

réduire la résolution de la pré-visualisation

Réduire la résolution de l'image de prévisualisation dans la navigation (choisir la taille entre "original", "1/2", "1/3" ou "1/4"). Cela peut améliorer la vitesse du rendu, mais attention car cela peut également gêner la sélection précise des couleurs et le masquage ("original" par défaut).

afficher l'écran de chargement entre les images

Afficher l'écran de chargement gris lors de la navigation entre les images dans la chambre noire. Désactivez cette option pour afficher un simple message et laissez l'image précédente jusqu'à ce que l'image suivante soit chargée. Notez que la désactivation de cette option peut être très utile pour comparer rapidement les images en double, cependant, il peut y avoir des problèmes si le temps de chargement est long (vous laissant penser que l'image suivante a déjà été chargée) et vous pouvez observer des artefacts visuels pendant le chargement de l'image suivante (activé par défaut).

modules

affiche les différents canaux de couleur

Contrôle la façon dont les canaux de couleur sont affichés lorsqu'ils sont activés dans les masques paramétriques. Vous pouvez choisir entre “fausse couleur” et “échelle de gris” (par défaut "fausse couleur").

cacher les préréglages internes des modules de développement

Si cette option est activée, seuls les préréglages définis par l'utilisateur seront affichés dans le menu des préréglages pour le traitement des modules -- les préréglages intégrés seront masqués (désactivée par défaut).

déplier un seul module de développement à la fois

Contrôle comment sont dépliés les modules de traitement dans la chambre noire. Si cette option est activée, développer un module en cliquant dessus replie tout module actuellement déplié. Si vous souhaitez déplier un module sans replier les autres, vous pouvez le faire avec Maj+clic. La désactivation de cette option inverse la signification de Clic et Maj+clic (activé par défaut).

replier les modules du groupe actuel seulement

Lorsque vous choisissez de déplier un seul module de développement à la fois (en utilisant la logique définie dans le paramètre précédent), ne replie que les autres modules apparaissant dans le groupe visible actuel. Désactivez cette option pour vous assurer que les modules des groupes non visibles sont également repliés (activé par défaut).

développer le module lorsqu'activé, et le réduire lorsque désactivé

Sélectionnez cette option pour que darktable déplie ou replie automatiquement les modules de traitement selon qu'ils sont activés ou désactivés (désactivée par défaut)

positionne les modules de développement lorsqu'ils sont dépliés/repliés

Avec cette option activée, les modules de traitement défilent en haut du panneau de droite lorsqu'ils sont développés ou réduits (activé par défaut).

contrôles colorés de balance des blancs

Contrôle l'apparence des curseurs de température et teinte dans le module balance des blancs.

sans couleur : l'arrière-plan des curseurs n'est pas du tout coloré,

couleur de l'illuminant : les couleurs du curseur représentent la couleur de la source lumineuse, c'est-à-dire la couleur que vous ajustez pour obtenir un blanc neutre,

effet d'émulation : les couleurs du curseur représentent l'effet que l'ajustement aurait eu sur la scène. C'est ainsi que la plupart des autres processeurs de fichiers raw affichent les couleurs des curseurs de température/teinte.

(sans couleur par défaut)

disposition des contrôles du module balance couleur

Contrôle l'apparence des sections ombres/tons moyens/hautes lumières dans le module balance couleur.

liste : tous les curseurs sont affichés dans une longue liste (avec en-têtes),

onglets : utiliser les onglets pour basculer entre les blocs de curseurs,

colonnes : les blocs de curseurs sont affichés les uns à côté des autres (dans des colonnes étroites).

(liste par défaut)

affichage des boutons sur la droite des modules de développement

Choisissez d'afficher les quatre boutons (indicateur de masque, instances multiples, réinitialiser, préréglages) sur le côté droit de l'en-tête des modules de traitement. Ces boutons apparaîtront toujours lorsque la souris survolera le module. D'autres fois, ils seront affichés ou masqués selon le choix fait entre :

toujours : toujours afficher tous les boutons,

actif : n'afficher les boutons que lorsque la souris est au-dessus du module,

atténué : les boutons sont grisés lorsque la souris est n'est pas au dessus du module,

auto : masquer les boutons lorsque le panneau est étroit,

estompé : atténuer tous les boutons quand le panneau est étroit,

ajusté : masquer tous les boutons si le nom du module n'a pas assez de place,

doux : atténuer tous les boutons d'un module simultanément,

glisser : cacher progressivement les boutons lorsque nécessaire.

(par défaut toujours).

affiche la présence de masques dans l'en-tête du module

Si cette option est activée, une icône sera affichée dans l'en-tête de tous les modules de traitement qui ont un masque appliqué (activé par défaut).

active l'édition du nom lors de l'ajout d'une nouvelle instance

Si coché, la zone de saisie du nom de l'instance est activée lors de la création d'une nouvelle instance d'un module de traitement. Non coché par défaut.

traitement

Contrôler le traitement des images.

traitement de l'image

toujours utiliser LittleCMS 2 pour le profile couleur de sortie

Si cette option est activée, darktable utilisera la bibliothèque système LittleCMS 2 pour appliquer le profil couleur de sortie au lieu de ses propres routines internes. Ceci est nettement plus lent que la valeur par défaut, mais peut donner des résultats plus précis dans certains cas.

Remarque : Si l'ICC donné est basé sur une LUT ou contient à la fois une LUT et une matrice, darktable utilisera LittleCMS2 pour rendre les couleurs quelle que soit la valeur de ce paramètre (par défaut désactivé).

interpolation des pixels (déformation)

L'interpolateur de pixels utilisé pour la rotation, la correction de l'objectif, la liquéfaction, le recadrage et la mise à l'échelle finale.

Chaque fois que nous redimensionnons ou déformons une image, nous devons choisir un algorithme d'interpolation de pixels (voir wikipedia pour plus de détails). Pour les modules de déformation, darktable propose les méthodes : bilinéaire, bicubique ou lanczos2. Dans la plupart des cas bicubique est une option sûre, c'est la valeur par défaut.

interpolations des pixels (mise à l'échelle)

L'interpolateur de pixels utilisé pour la mise à l'échelle. Les mêmes options sont fournies que pour les modules de déformation, mais avec lanczos3 en plus.

lanczos3 peut provoquer des dépassements de pixels conduisant à des artefacts mais donne parfois un aspect plus net. Cette option n'est donc fournie que pour les algorithmes de transformation (mise à l'échelle) et c'est la valeur par défaut.

répertoire 3D lut racine

Définir le répertoire racine (et les sous-répertoires) contenant les fichiers Lut utilisés par le module lut 3D.

flux de travail par défaut appliqué automatiquement

Choisissez les modules et l'ordre des modules à appliquer par défaut aux nouvelles images :

Le flux de travail relatif à la scène (défaut) suppose que la plupart des traitements seront effectués dans un espace colorimétrique RVB linéaire. La sélection de cette option activera automatiquement les modules filmique rvb et exposition et définira l'ordre du pipeline graphique sur v3.0 qui est l'ordre (relatif à la scène) défini pour darktable 3.0 et les versions ultérieures.

Le module exposition ajoutera automatiquement +0,5 IL à l'exposition pour que le gris moyen corresponde à celui de la majorité des boîtiers SLR. Cet ajout peut être remplacé par un préréglage appliqué automatiquement si cette valeur par défaut produit constamment des images sombres pour votre appareil.

Enfin, ce paramètre active automatiquement l'option «compenser exposition boîtier» dans le module exposition pour ajuster la luminosité globale de manière appropriée quand la molette de compensation d'exposition du boîtier a été utilisée.

Le flux de travail relatif à l'affichage suppose que la plupart des traitements seront effectués dans l'espace colorimétrique Lab et correspond au mode originel de darktable 2.6 et des versions antérieures. La sélection de cette option activera automatiquement le module courbe de base et définira l'ordre du pipeline graphique sur l'ordre originel (relatif à l'affichage) utilisé par défaut jusqu'à la version 2.6.

aucun n'activera aucun module par défaut et définira l'ordre d'application des modules dans le pipeline graphique sur v3.0 (relatif à la scène), soit celui de darktable 3.0 et plus.

appliquer l'adaptation chromatique par défaut

Choisissez le module chargé d'effectuer les ajustements de balance des blancs (adaptation chromatique) par défaut. Sélectionnez "originel" (par défaut) pour effectuer une adaptation chromatique de base en utilisant uniquement le module balance des blancs. Sélectionnez "moderne" pour utiliser une combinaison des modules balance des blancs et calibration des couleurs pour effectuer une adaptation chromatique moderne avec une science des couleurs améliorée. Ces paramètres sont appliqués par défaut aux nouveaux développements et n'auront aucun impact sur les anciens.

appliquer le préréglage de la courbe de base pour le boîtier

Applique par défaut une courbe de base définie pour le boîtier (si disponible) au lieu de la courbe générique du fabricant. Ceci ne doit être utilisé que conjointement au flux de travail relatif à l’affichage défini ci-dessus (désactivé par défaut).

applique automatiquement de la netteté

Appliquer automatiquement le module netteté aux nouvelles images. Cette option n'est pas recommandée pour les boîtiers n'ayant pas de filtre passe-bas. (activé par défaut, nécessite un redémarrage si modifié).

détecter les miniatures monochromes

Activez cette option pour analyser les images lors de l'importation et les étiqueter avec le mot-clé chambre noire|mode|monochrome si elles sont monochromes. L'analyse est basée sur l'aperçu intégré dans le fichier importé. Cela permet un flux de travail plus pratique lorsque vous travaillez avec des images monochromes, mais cela ralentit l'importation, ce paramètre est donc désactivé par défaut.

montrer les messages d'alerte

Activez cette option pour afficher des messages d'alerte dans les modules de traitement où des paramètres non standard et potentiellement dangereux ont été utilisés dans le pipeline. De tels messages peuvent parfois être des faux positifs (en raison de paramètres intentionnels non standard) et peuvent être ignorés si vous savez ce que vous faites. Désactivez pour masquer ces alertes (activées par défaut).

cpu / gpu / mémoire

mémoire en mégaoctets à utiliser pour le cache des miniatures

Afin d'accélérer l'affichage des pellicules, darktable stocke les miniatures dans un fichier cache sur le disque (cache principal) et le charge en mémoire au démarrage. Ce paramètre contrôle la taille du cache en mégaoctets. Un redémarrage est nécessaire en cas de modification (512 Mo par défaut).

utilisation du disque dur pour le cache des miniatures

Si activé, darktable stocke toutes les miniatures sur le disque dur en tant que cache secondaire, et les garde ainsi accessibles si elles sont supprimées du cache principal. Cela nécessite plus d'espace disque mais accélère la vue lighttable car cela évite le retraitement des miniatures (activé par défaut).

utilisation du disque dur pour le cache des images 100%

Si activé, darktable écrit les images de prévisualisation complètes sur le disque (.cache/darktable/) lorsqu'elles sont supprimées du cache mémoire. Notez que cela peut prendre beaucoup de stockage (plusieurs gigaoctets pour 20000 images) et darktable ne supprimera jamais les images mises en cache. Vous pouvez les supprimer manuellement si vous le souhaitez. L'activation de cette option améliorera considérablement les performances de la table lumineuse lors du zoom sur une image en mode d'aperçu complet (désactivé par défaut).

mémoire limite (en mégaoctets) pour le tuilage

Afin de gérer de grandes images sur des systèmes avec une mémoire limitée, darktable effectue un traitement par tuiles. Cette variable contrôle la quantité maximale de mémoire (en Mo) qu'un module peut utiliser pendant le développement. Des petites valeurs forceront les modules gourmands en mémoire à utiliser de nombreuses tuiles. Mettre cette variable à 0 pour une infinité de tuiles. Les valeurs inférieures à 500 seront traitées comme 500. Nécessite un redémarrage en cas de modification (par défaut 1500).

quantité minimale de mémoire (en Mo) pour la mémoire tampon d'une tuile

Une valeur strictement positive définit la quantité de mémoire minimale (en Mo) que darktable doit utiliser pour une tuile. Nécessite un redémarrage en cas de modification (par défaut 16).

activer le support d'OpenCL

darktable peut utiliser votre GPU pour accélérer considérablement le développement. L'interface OpenCL nécessite un matériel approprié et les pilotes OpenCL correspondants sur votre système. Si l'un de ceux-ci n'est pas trouvé, l'option est grisée. Peut être activée et désactivée à tout moment et prend effet immédiatement (activée par défaut).

profil de planification OpenCL

Définit comment l'image complète et la prévisualisation sont traitées sur les systèmes avec support OpenCL :

défaut : le GPU est utilisé pour le rendu de l'image complète ; le CPU pour la prévisualisation,

GPUs multiples : l'image complète et la prévisualisation sont traitées en parallèle sur des GPUs différents,

GPU très rapide : l'image complète et la prévisualisation sont traitées séquentiellement sur le GPU.

sécurité

Contrôler quels messages d'avertissements sont affichés avant d'entreprendre certaines actions.

général

demander avant d'enlever des images de la bibliothèque

Toujours demander avant de supprimer une image de la base de données de la bibliothèque de darktable, où le fichier image/xmp est conservé (activé par défaut).

demander avant de supprimer des images sur le disque

Toujours demander à l'utilisateur avant de supprimer une image ou tout fichier image (activé par défaut).

demander avant de supprimer l'historique

Toujours demander à l'utilisateur avant de supprimer l'historique d'une image (activé par défaut).

essayer d'utiliser la poubelle lors de l'effacement des images

Au lieu de supprimer physiquement les images du disque, essayer de les placer dans la corbeille du système (activé par défaut).

demander avant de déplacer des images vers un autre dossier

Toujours demander à l'utilisateur avant de déplacer un fichier image (activé par défaut).

demander avant de copier des images vers un nouveau dossier

Toujours demander à l'utilisateur avant de copier un fichier image (activé par défaut).

demander avant d'enlever les répertoires vides

Toujours demander avant de supprimer tout dossier vide. Cela peut se produire après avoir déplacé ou supprimé des images (désactivé par défaut).

demander avant de supprimer un mot-clé

Toujours demander à l'utilisateur avant de supprimer un mot-clé d'une image (activé par défaut).

demander avant de supprimer un style

Toujours demander à l'utilisateur avant de supprimer un style (activé par défaut).

demander avant de supprimer un préréglage

Toujours demander à l'utilisateur avant de supprimer un préréglage (activé par défaut).

demander avant d'exporter en mode écraser

Toujours demander à l'utilisateur avant l'exportation en mode écraser.

autre

stockage à utiliser pour les mots de passe

Options : auto (par défaut), aucun, libsecret, kwallet.

exécutable pour jouer les fichiers audio

Définissez un programme externe qui sera utilisé dans la vue table lumineuse pour lire les annotations audio des images enregistrées par certains appareils photo (aplay par défaut).

stockage

Les options suivantes sont relatives à la base de données de darktable et aux fichiers liés XMP.

base de données

vérifier pour la maintenance de la base de données

Indique quand darktable doit vérifier la fragmentation de la base de données et effectuer la maintenance. Les options sont "jamais", "au démarrage", "à la fermeture", et "au deux". Chacun de ceux-ci est également disponible avec une option supplémentaire "(sans confirmation)" pour effectuer les vérifications automatiquement et sans invite (par défaut "à la fermeture").

seuil de fragmentation de la base de données

Taux de fragmentation (en pourcentage) au-dessus duquel la maintenance de la base de données doit être effectuée (sous réserve de la sélection effectuée dans l'option ci-dessus) (par défaut 25).

faire une sauvegarde de la base de données

Spécifie la fréquence des sauvegardes de la base de données. Les options sont «jamais», «une fois par mois», «une fois par semaine», «une fois par jour» et «à la fermeture» (par défaut «une fois par semaine»)

nombre de sauvegarde à conserver

Nombre de sauvegardes à conserver après la création d'une nouvelle sauvegarde, sans compter les sauvegardes de base de données effectuées lors du passage d'une version de darktable à une autre. Entrez "-1" pour stocker un nombre illimité de sauvegardes. (par défaut 10)

xmp

écrire un fichier redondant pour chaque image

Les fichiers XMP fournissent une méthode redondante pour enregistrer les modifications que vous avez apportées à une image, en plus de celles enregistrées dans la base de données de darktable. Cette option vous permet de choisir quand écrire ces fichiers. Choisissez parmi:

jamais : N'écrit pas de fichiers XMP. Cela peut être utile si vous exécutez plusieurs versions de darktable à des fins de développement/test, mais n'est normalement pas recommandé

après édition: Un fichier XMP est écrit la première fois que vous éditez une image et est mis à jour à chaque modification ultérieure. L'importation ne génère pas de fichier XMP par défaut

à l'importation : un fichier XMP est écrit dès que vous ajoutez une image à la bibliothèque de darktable et est ensuite mis à jour à chaque fois que vous l'éditez.

Il est fortement recommandé de choisir soit "après édition" soit "à l'importation". Les fichiers XMP fournissent une sécurité utile pour ne pas perdre de données si votre base de données était corrompue. La sauvegarde de votre fichier brut et du fichier XMP qui l'accompagne vous permet de restaurer complètement votre travail à une date ultérieure en ré-important votre historique de développement dans darktable (par défaut "à l'importation").

enregistre les mots-clés XMP avec un format compressé

Les données des mots-clés XMP peuvent devenir assez volumineuses et peuvent dépasser l'espace disponible pour stocker l'historique de développement dans des fichiers lors de l'exportation. Cette option permet de compresser les mots-clés XMP binaires afin d'économiser de l'espace. Les options disponibles sont "jamais", "toujours" et "seulement les grands" (par défaut).

vérifie au démarrage les fichiers xmp modifiés

Analyser tous les fichiers XMP au démarrage et vérifier s'ils ont été modifiés entre-temps par un autre logiciel. Si des fichiers XMP modifiés sont trouvés, un menu s'ouvre pour que l'utilisateur choisisse les fichiers XMP qu'il faut recharger (en remplaçant les entrées de la base de données de darktable par le contenu du fichier XMP) et ceux qu'il faut écraser à partir de la base de données de darktable. L'activation de cette option amène également darktable à rechercher les fichiers liés XMP qui ont été ajoutés après l'importation (désactivé par défaut).

divers

interface

trier les préréglages internes en premier

Choisir comment le menu des préréglages est trié. Si cette option est activée, les préréglages internes sont montrés en premier. Si cette option est désactivée, les préréglages de l'utilisateur sont montrés en premier (activée par défaut).

déplacement des panneaux latéraux avec la molette

Lorsqu'elle est activée, par défaut, la molette de la souris fait défiler les panneaux latéraux et Ctrl+Alt+molette fait défiler les champs de saisie de données. Lorsqu'elle est désactivée, ce comportement est inversé (désactivée par défaut)

toujours montrer les ascenseurs des panneaux

Définit si les barres de défilement du panneau doivent être toujours visibles ou activées uniquement en fonction du contenu du panneau (activé par défaut). (nécessite un redémarrage)

position du module des scopes

Choisissez d'afficher le module des scopes dans le panneau de gauche ou dans celui de droite (à droite par défaut). (nécessite un redémarrage)

méthode à utiliser pour récupérer le profil d'affichage

Cette option permet à l'utilisateur de forcer darktable à utiliser une méthode spécifique pour obtenir le profil d'affichage actuel pour la gestion des couleurs. Avec le paramètre par défaut tout, darktable choisira d'interroger le xatom du serveur d'affichage X ou le service système colord. Vous pouvez définir cette option sur xatom ou colord pour appliquer une méthode spécifique si les deux méthodes donnent des résultats différents. Vous pouvez exécuter le binaire darktable-cmstest pour examiner votre sous-système de gestion des couleurs.

mots clés

ignorer la hiérarchie des mots-clés

Lors de l'exportation d'images, les mots-clés hiérarchiques sont également ajoutés sous la forme d'une simple liste de mots-clés non hiérarchiques pour les rendre visibles par d'autres programmes. Lorsque cette option est cochée, darktable n'inclura que la dernière partie de la hiérarchie et ignorera le reste. Donc foo | bar | baz ajoutera seulement baz

désactiver l'auto-complétion

L'auto-complétion est utile pour ceux qui saisissent des mots-clés uniquement au clavier. Pour les autres, l'auto-complétion peut être embarrassante (désactivée par défaut). (nécessite un redémarrage)

raccourcis clavier avec instances multiples

Il est possible de créer plusieurs instances de nombreux modules de traitement. Dans ce scénario, il n'est pas toujours évident de savoir quelle instance doit être contrôlée par des opérations de raccourci clavier. Les options suivantes contrôlent les règles qui sont appliquées (dans l'ordre) pour décider à quelle instance les raccourcis clavier doivent être appliqués.

Ces règles sont également utilisées lorsque vous cliquez et faites glisser sur le module scopes pour modifier l'exposition.

préférence aux instances développées

si des instances du module sont dépliées, ignore les instances repliées (désactivée par défaut).

préférence aux instances actives

Après avoir appliqué la règle ci-dessus, si les instances restantes du module sont actives, ignorez les instances inactives (désactivée par défaut).

préférence aux instances visibles

Après avoir appliqué les règles ci-dessus, si les instances restantes du module sont visibles, ignorez les instances cachées (désactivée par défaut).

ordre de sélection

Après avoir appliqué les règles ci-dessus, appliquez le raccourci à la première ou à la dernière instance restante ("dernière instance" par défaut).

vue carte / géolocalisation

affichage plus clair de la localisation d'image

Afficher une représentation plus lisible de la géolocalisation dans le module informations de l'image (activé par défaut).

vue diaporama

temporisation entre chaque image du diaporama

Le nombre de secondes avant d'afficher l'image suivante (5 par défaut) dans la vue diaporama.

raccourcis

Vous pouvez effectuer presque n'importe quelle action dans darktable avec un raccourci clavier/souris. Vous pouvez également utiliser divers autres périphériques d'entrée, y compris des périphériques MIDI et des contrôleurs de jeu -- voir la section prise en charge des périphériques midi pour plus de détails. Ceux-ci sont appelés périphériques externes ou simplement périphériques dans ce guide.

définir les raccourcis

Un raccourci est une combinaison de touches ou de boutons et/ou de mouvements de souris ou d'un périphérique qui effectue une action dans darktable.

Une action peut avoir plusieurs raccourcis, mais un raccourci ne peut être lié qu'à une seule action dans une vue darktable donnée -- vous ne pouvez pas chaîner les actions, sauf en appliquant un préréglage ou un style. Vous pouvez cependant configurer un raccourci qui fait une chose dans la vue table lumineuse, par exemple, et une autre dans la vue chambre noire.

activer un raccourci

Un raccourci peut être activé en

en pressant une touche du clavier ; ou

en pressant un bouton ou en déplaçant un bouton/manette sur un périphérique externe

Vous ne pouvez pas activer un raccourci en déplaçant votre souris ou en appuyant sur l'un de ses boutons, car ces actions sont utilisées pour interagir avec l'interface utilisateur de darktable.

raccourcis simples

Un raccourci qui n'inclut que des pressions sur un bouton et/ou une touche (et non des mouvements de la souris/du périphérique) est appelé raccourci simple.

Un raccourci simple doit être activé comme ci-dessus, mais peut inclure :

Une ou plusieurs touches de modification (Maj, Ctrl, Alt), maintenues enfoncées pendant l'exécution du reste du raccourci

Jusqu'à trois pressions de touche, dont la dernière peut être une pression longue (plus longue que la durée du double-clic de votre système)

De même, jusqu'à trois pressions sur un bouton du périphérique ou clics sur un bouton de la souris, dont le dernier peut être long

Diverses combinaisons de touches clavier, de boutons de souris et du périphérique peuvent être utilisées pour créer des raccourcis simples.

création de modificateurs supplémentaires

Les seuls modificateurs valides sont les touches Maj, Ctrl et Alt du clavier. Vous pouvez définir des touches supplémentaires (ou des boutons de périphérique) comme modificateurs en attribuant ces touches/boutons à l'action "options globales/modificateur". Cependant, celles-ci fonctionneront simplement comme des touches supplémentaires Ctrl, Alt ou Shift -- vous ne pouvez pas créer de "nouveaux" modificateurs.

extension des raccourcis simples avec un mouvement

Pour certaines actions, vous pouvez choisir d'étendre un raccourci simple en utilisant le mouvement de la souris/du périphérique. Par exemple, vous pouvez maintenir Ctrl+X tout en faisant défiler avec votre souris pour modifier la valeur d'un curseur. Les éléments suivants peuvent être utilisés pour étendre un raccourci simple :

Mouvement de la molette de la souris

Mouvement horizontal, vertical ou diagonal du curseur de la souris

Mouvement d'un bouton/manette sur un périphérique externe

Pour étendre un raccourci simple, vous devez maintenir la dernière touche/bouton du raccourci simple enfoncé tout en effectuant le mouvement d'extension de la souris/du périphérique.

Pour les périphériques externes, vous n'avez pas besoin de commencer par un raccourci simple -- vous pouvez directement affecter un bouton ou une manette à une action -- bien que cela réduise considérablement la flexibilité du périphérique.

Les appuis longs sur les boutons et les touches ne peuvent pas être étendus, car la durée du clic/appui est mesurée au relâchement du dernier bouton/touche.

Remarque : Vous devrez peut-être désactiver le paramètre "désactiver le pavé tactile lors de la frappe" si vous souhaitez utiliser des raccourcis étendus avec un pavé tactile d'ordinateur portable.

actions

Les raccourcis sont utilisés pour lancer des actions dans darktable.

Une action est généralement (mais pas toujours) une opération que vous pouvez exécuter en utilisant l'interface utilisateur pointer-cliquer de darktable. Par exemple :

Augmenter, diminuer ou réinitialiser les curseurs (réglettes)

Faire défiler les menus déroulants

Activer, développer ou donner le focus à un module

Cliquez sur les boutons

Basculer entre les vues

Ces actions de type pointer-cliquer sont normalement définies comme l'application d'un effet à un élément d'un widget, ces termes étant définis comme suit :

widget

chaque partie visible de l'interface utilisateur est appelée widget. Par exemple, la fenêtre d'application de darktable est un widget, contenant les widgets des panneaux latéraux, dont chacun contient des widgets de module, dont chacun contient des widgets de bouton, de curseur et de liste déroulante, etc... Lorsque vous attribuez un raccourci à une action, vous devez d'abord décider à quel widget il doit être appliqué.

élément

Un élément est la partie d'un widget de l'interface utilisateur qui est affectée par votre raccourci. Par exemple, pour un curseur doté d'une pipette de couleur, vous pouvez créer un raccourci pour activer l'élément bouton de la pipette de couleur ou modifier l'élément valeur du curseur. Pour une rangée d'onglets (la rangée est un widget unique), vous pouvez sélectionner l'élément d'onglet à activer.

effet

Un raccourci peut parfois avoir plusieurs effets possibles sur un élément donné. Par exemple, un bouton peut être activé comme s'il était pressé avec un simple clic de souris ou comme s'il était pressé avec un Ctrl+clic. La valeur d'un curseur peut être modifiée, augmentée/diminuée ou réinitialisée.

affectation de raccourcis aux actions

Il y a deux méthodes pour attribuer un raccourci à une action.

mappage visuel des raccourcis

Cliquez sur l'icône visual mapping button dans le panneau supérieur pour activer le mode de mappage visuel des raccourcis.

Le curseur de la souris change lorsque vous survolez les widgets de l'interface utilisateur indiquant si un mappage peut être créé ou non :

Une flèche vers le bas avec une ligne l'icône développer apparaît lorsque vous survolez l'en-tête d'un module, pour indiquer que vous pouvez cliquer pour développer le module.

Une spirale spiral icon indique qu'un raccourci peut être défini pour le widget sous le curseur.

Une flèche vers le haut up icon indique qu'en plus d'attribuer un raccourci, vous pouvez également ajouter le widget au panneau d'accès rapide de la chambre noire (Ctrl+clic).

Une flèche vers le bas icône vers le bas indique que le widget est déjà dans le panneau d'accès rapide (Ctrl+clic pour le supprimer).

Une croix cross icon indique qu'il n'y a pas de widget mappable sous le curseur.

Appuyez sur une combinaison de touches tout en survolant un widget mappable pour attribuer un raccourci à ce widget - une action par défaut sera attribuée à ce raccourci en fonction du type de widget et du raccourci, simple ou étendu, que vous avez saisi. Voir ci-dessous pour plus de détails sur les actions attribuées par défaut.

Cliquez avec le bouton gauche sur un widget mappable pour ouvrir l'écran de mappage des raccourcis sur ce widget (voir ci-dessous). Cliquez avec le bouton gauche n'importe où ailleurs sur l'écran pour ouvrir l'écran de mappage des raccourcis, développé (si possible) en fonction de la partie de l'écran sur laquelle vous avez cliqué. Cet écran permet de modifier l'action attribuée à un raccourci et de configurer des raccourcis pour des actions non visuelles. L'accès à l'écran de mappage des raccourcis ferme le mode de mappage de raccourci visuel.

Vous pouvez affecter autant de raccourcis que souhaité dans une session de mappage, puis quitter le mode de mappage lorsque vous avez terminé avec un clic sur l'icône visual mapping button ou un clic-droit n'importe où sur l'écran.

Vous pouvez supprimer un mappage de raccourci utilisateur en le redéfinissant pour le même widget. Si vous essayez d'affecter un raccourci existant à une nouvelle action, vous en êtes averti et êtes invité à indiquer si vous souhaitez effectivement le remplacer.

écran de mappage des raccourcis

Le moyen le plus flexible de créer des raccourcis consiste à utiliser l'écran de mappage des raccourcis, accessible à partir de la boîte de dialogue des préférences globales ou avec un clic-gauche en mode de mappage visuel. Cet écran permet d'accéder à toutes les actions disponibles, y compris certaines qui ne sont pas directement liées à un widget de l'interface utilisateur.

Le panneau supérieur de cet écran affiche la liste des widgets/actions de l'interface utilisateur disponibles et le panneau inférieur affiche les raccourcis qui leur sont affectés. Vous pouvez effectuer une recherche dans les panneaux supérieur et inférieur à l'aide des zones de saisie de texte en bas de la fenêtre.

Double-cliquez sur un élément du panneau supérieur pour créer un nouveau raccourci pour cet élément, puis entrez le raccourci souhaité (clic-droit pour annuler). Cela fait, une nouvelle entrée apparaît dans le panneau inférieur montrant le raccourci créé. Vous pouvez ensuite modifier manuellement l'élément, l'effet, la vitesse ou l'instance de l'action associée à ce raccourci dans le panneau inférieur. Pour supprimer un raccourci utilisateur, sélectionnez-le dans le panneau inférieur et appuyez sur la touche Suppr.

Les options supplémentaires suivantes sont fournies dans l'écran de mappage des raccourcis :

exporter...

Exporte le mappage des raccourcis pour un ou tous vos périphériques (clavier/souris, midi, jeu) vers un fichier externe. La boîte de dialogue vous montre combien de raccourcis existent pour chaque périphérique.

importer...

Importe des mappages de raccourcis à partir d'un fichier externe pour un ou tous vos périphériques. Lors du chargement d'un périphérique, vous pouvez choisir de lui attribuer un numéro différent. Cela peut être utilisé pour échanger des mises en page midi. Vous pouvez choisir de nettoyer un périphérique avant son chargement. Charger "tout" à partir d'un fichier vide supprime alors tous vos raccourcis.

restaurer...

Restaure vos mappages de raccourcis (a) Aux mappages par défaut de darktable, (b) Au début de votre session en cours, ou (c) Tels qu'ils étaient lors de la dernière ouverture de l'écran de mappage de raccourcis. Lors de la restauration, vous pouvez laisser tels quels les raccourcis qui ont été ajoutés de sorte que seuls les raccourcis modifiés retrouvent leur signification précédente. Ou vous pouvez effacer d'abord tous les raccourcis et juste charger le point de restauration.

supprimer les raccourcis par défaut

Il n'est actuellement pas possible de supprimer les raccourcis par défaut -- si vous supprimez un raccourci par défaut, il sera automatiquement rétabli la prochaine fois que vous démarrerez darktable.

Pour contourner le problème, vous pouvez remplacer l'action par défaut en attribuant ce raccourci à l'action "options globales/sans-action" (qui ne fait rien). Vous pouvez le faire soit dans l'écran de mappage des raccourcis (ci-dessus) soit en éditant directement votre fichier $HOME/.config/darktable/shortcutsrc. Si vous souhaitez désactiver de nombreux raccourcis par défaut, cette dernière option est recommandée (vous devez d'abord quitter darktable). Par exemple, les raccourcis par défaut suivants sont définis dans shortcutsrc (en anglais) pour changer de vue dans darktable :

d=global/switch views/darkroom
l=global/switch views/lighttable
m=global/switch views/map
p=global/switch views/print
s=global/switch views/slideshow
t=global/switch views/tethering

Vous pouvez désactiver tous ces raccourcis en modifiant shortcutsrc comme suit :

d=global/no-op
l=global/no-op
m=global/no-op
p=global/no-op
s=global/no-op
t=global/no-op

actions communes

Ce qui suit est une liste d'actions auxquelles vous pouvez affecter des raccourcis, organisées par type de widget. Cette liste n'est pas exhaustive et nous vous encourageons à parcourir l'écran de mappage des raccourcis pour obtenir une liste complète des actions disponibles. Si vous attribuez un raccourci à un widget, une action par défaut lui sera attribuée, selon le type de widget et selon que vous avez attribué un raccourci simple ou étendu.

Notez qu'il est possible d'attribuer un certain nombre d'actions qui n'ont aucun effet. Par exemple, tous les curseurs incluent un élément bouton, qu'un tel bouton soit réellement présent ou non à côté du curseur.

options globales

Les actions de la section "options globales" de l'écran de mappage des raccourcis peuvent être exécutées à partir de n'importe quelle vue darktable. La plupart de ces actions n'ont pas d'éléments spécifiques car elles sont utilisées pour effectuer des opérations activer/désactiver.

vues

Les actions de la section "vues" ne peuvent être exécutées qu'à partir de la vue correspondante. Comme pour les actions globales, la plupart n'ont pas d'éléments spécifiques car ils sont utilisés pour effectuer des opérations activer/désactiver.

boutons

Un bouton est une icône cliquable dans l'interface de darktable. L'action par défaut, lors de l'affectation d'un simple raccourci à un bouton, est d'activer ce bouton comme s'il était cliqué avec le bouton gauche de la souris. Vous pouvez modifier cette action pour activer le bouton comme si vous aviez cliqué avec une touche de modification.

bascules

Une bascule (ou case à cocher) est un bouton qui a un état marche/arrêt persistant. Il a donc des effets supplémentaires pour vous permettre de le basculer ou de définir explicitement son état. Comme avec un bouton normal, l'action par défaut, lors de l'affectation d'un simple raccourci à une bascule, consiste à activer la bascule comme si vous cliquiez avec le bouton gauche de la souris (ce qui active/désactive le bouton).

modules utilitaires

Tous les modules utilitaires ont les éléments suivants :

afficher le module

Développe ou réduit le module.

réinitialiser les paramètres

Agit comme un bouton qui réinitialise tous les paramètres du module lorsqu'il est activé. L'action ctrl-activer peut être utilisée pour réappliquer les préréglages automatiques pour ce module.

préréglages

Vous permet de sélectionner des actions dans le menu préréglages (par exemple, modifier, mettre à jour, précédent, suivant). L'action par défaut, lors de l'affectation d'un simple raccourci à un élément préréglages, consiste à afficher une liste des préréglages disponibles à la sélection. Les raccourcis étendus ne sont actuellement pas disponibles pour les entrées de préréglages.

L'action par défaut, lors de l'affectation d'un simple raccourci à un module utilitaire, consiste à basculer l'élément afficher le module (développer/réduire le module).

De plus, des raccourcis sont disponibles pour toutes les commandes de chaque module ainsi que pour tous les préréglages de base (voir ci-dessous).

modules de traitement

Les modules de traitement ont les mêmes éléments et actions par défaut que les modules utilitaires avec les éléments supplémentaires suivants :

activer

Agit comme un bascule qui active ou désactive le module.

focus

Agit comme une bascule qui donne ou reprend le focus au module. Ceci est utile pour les modules tels que recadrer ou égaliseur de ton, dont les commandes à l'écran ne sont activées que lorsqu'ils ont le focus. Pour recadrer, les modifications ne sont enregistrées que lorsque le module perd le focus.

instance

Vous permet de sélectionner des actions dans le menu instances multiples (par exemple, monter/descendre, créer une nouvelle instance). L'action par défaut, lors de l'affectation d'un simple raccourci à l'élément instance, consiste à afficher une liste des options disponibles ; un raccourci étendu déplace l'instance de module préférée (voir ci-dessous) de haut en bas dans le pipeline.

Si une action affecte un module de traitement qui peut avoir plusieurs instances, vous pouvez choisir l'instance à ajuster avec un raccourci donné. Par défaut, toutes les actions affectent l'instance "préférée", telle que définie à l'aide des paramètres dans préférences > divers > raccourcis instances multiples.

menus déroulants

Un menu déroulant est une zone de sélection multiple qui contient les éléments suivants :

sélection

Permet de sélectionner des valeurs dans le menu déroulant de différentes manières. L'action par défaut, lors de l'affectation d'un simple raccourci à un menu déroulant, consiste à afficher une boîte de dialogue d'édition avec la liste des valeurs disponibles à la sélection ; Un raccourci étendu (incluant un mouvement de souris) fait défiler les valeurs disponibles.

bouton

Un élément standard bouton qui permet d'activer le bouton à droite du menu déroulant (si présent). Par exemple, le menu déroulant aspect dans le module recadrer a un bouton qui permet de basculer le recadrage de portrait à paysage et vice versa.

curseurs

Une réglette (ou curseur) vous permet de modifier graphiquement une valeur entière ou décimale, et dispose des éléments suivants :

valeur

Permet de modifier la valeur de la réglette. L'action par défaut, lors de l'affectation d'un simple raccourci à une réglette, affiche une boîte de dialogue d'édition afin que vous puissiez saisir une valeur ; un raccourci étendu (incluant un mouvement de souris) change la valeur de haut en bas. Les éléments valeur sont également utilisés pour modifier certains graphiques à l'écran. Lors de la modification de l'élément valeur avec un raccourci, vous ne pouvez pas dépasser les limites définies pour la réglette.

force

C'est le même que l'élément value décrit ci-dessus, mais il vous permet de dépasser les limites définies pour la réglette.

zoom

Permet de modifier les limites supérieure et inférieure de la réglette sans modifier la valeur actuelle.

bouton

Un élément standard bouton qui permet d'activer le bouton à droite de la réglette (s'il est présent). Par exemple, une réglette peut inclure une pipette de couleur pour définir sa valeur en fonction de la zone sélectionnée de l'image.

Vous pouvez modifier la valeur d'une réglette plus rapidement ou plus lentement que la normale en définissant la vitesse de l'action dans l'écran de mappage des raccourcis. Par défaut, la vitesse est de 1,0, ce qui signifie que la valeur est modifiée au taux par défaut de la réglette. Vous pouvez modifier la réglette plus rapidement en augmentant la vitesse (une vitesse de 10 rend l'action 10 fois plus rapide) ou plus lentement en la diminuant (une vitesse de 0,1 rend l'action 10 fois plus lente).

replis

Lorsqu'un widget peut avoir plusieurs actions différentes, il peut être fastidieux de configurer des raccourcis individuels pour chacune de ces actions. Pour simplifier ce processus, si vous créez un raccourci simple, un certain nombre d'effets peuvent être disponibles par défaut en tant qu'extensions de ce raccourci. Ceux-ci sont connus sous le nom de replis.

Bien que les replis soient un moyen puissant de configurer rapidement plusieurs actions à l'aide de raccourcis prédéfinis et cohérents, ils attribuent automatiquement de nombreuses actions (ce qui peut ne pas être ce que vous voulez) et peuvent être difficiles à comprendre. Les replis sont donc désactivés par défaut et vous devez cliquer sur la case à cocher "activer les replis" dans la fenêtre de configuration des raccourcis pour les activer.

Pour prendre un bref exemple, vous pouvez créer un simple raccourci (par exemple Ctrl+R) vers un module de traitement. Cela configure automatiquement les effets de replis suivants en utilisant le raccourci défini, étendu avec des clics de souris. Dans chaque cas (sauf le premier), vous devez maintenir le raccourci initial tout en cliquant avec votre souris. Le dernier clic de souris appliquera l'action définie ci-dessous :

Ctrl+R (pas de clic de souris) pour afficher/masquer le module (le repli par défaut)

Ctrl+R+clic gauche pour activer/désactiver le module

Ctrl+R+double-clic gauche pour réinitialiser le module

Ctrl+R+clic droit pour afficher le menu préréglages du module

Ctrl+R+double-clic droit pour afficher le menu instance du module

Des replis similaires sont définis pour de nombreux éléments de l'interface utilisateur et peuvent tous être remplacées manuellement.

Certains replis sont définies à l'aide de touches de modification (généralement Ctrl+ et Maj+). Dans ce cas, vous devez définir un raccourci initial sans un tel modificateur afin de pouvoir utiliser ces replis. Par exemple, si vous affectez Ctrl+R à une action, vous ne pouvez pas utiliser un repli Ctrl+. Des replis par défaut de ce type sont fournies pour l'élément value et pour les mouvements horizontaux/verticaux dans la zone centrale (zoomée) -- dans ce cas, Shift+ augmente la vitesse à 10,0 et Ctrl+ diminue la vitesse à 0,1.

Pour voir la liste de tous les replis par défaut, cochez la case "activer les replis" dans l'écran de mappage des raccourcis et sélectionnez la catégorie "replis" dans le panneau supérieur. Pour voir les replis pour un widget donné (par exemple une réglette), sélectionnez simplement ce widget dans le panneau supérieur. Dans les deux cas, un élément supplémentaire (également nommé "replis") apparaît alors dans le panneau inférieur contenant le détail des replis.

Les replis ne sont appliqués que si aucun autre raccourci utilisant cette combinaison n'a été explicitement créé. Dans l'exemple ci-dessus, si vous avez affecté Ctrl+R+clic gauche à une autre action, le repli "activer/désactiver le module" est ignoré.

Comme pour tout autre raccourci, les paramètres de repli sont entièrement personnalisables.

préréglages

Ce menu fournit un aperçu des préréglages qui sont définis pour les modules de darktable, et vous permet de modifier certaines de leurs propriétés.

Les préréglages de base (ceux qui sont inclus par défaut dans darktable) sont affichés avec un symbole de cadenas. Leurs propriétés ne peuvent pas être modifiées.

Les préréglages utilisateur peuvent être importés à partir de fichiers .dtpreset exportés à l'aide du bouton "importer" en bas de l'écran. Vous pouvez exporter tous les préréglages définis par l'utilisateur vers un seul répertoire à l'aide du bouton "exporter".

Supprimez un préréglage défini par l'utilisateur en le sélectionnant et en appuyant sur la touche Suppr.

Modifiez les propriétés d'un préréglage utilisateur en le sélectionnant et en appuyant sur Entrée ou en double-cliquant. Cela ouvre une boîte de dialogue permettant de modifier le préréglage, de l'exporter vers un fichier externe .dtpreset ou de le supprimer.

Consultez la section création et modification des préréglages pour plus d'informations sur les autres propriétés qui peuvent être modifiées dans cette boîte de dialogue.

options lua

ne plus montrer l'installeur de scripts Lua

Cochez cette case pour masquer dans la table lumineuse le programme d'installation des scripts Lua si aucun script Lua n'est installé.

Automatisation avec Lua

présentation

Principes de base : fichiers luarc

Un exemple Lua simple

impression d'images étiquetées

ajouter un raccourci simple

exporter des images avec Lua

Constructions d'éléments de l'interface utilisateur

partage de scripts

appeler Lua de dbus

utiliser darktable depuis un script Lua

API Lua

présentation

Les scripts Lua peuvent être utilisés pour définir les actions à exécuter par darktable lorsqu'un événement est déclenché. Un exemple pourrait être d'appeler une application externe lors de l'exportation de fichiers afin d'appliquer des étapes de traitement supplémentaires en dehors de darktable.

Lua est un projet indépendant fondé en 1993, fournissant un langage de script puissant, rapide, léger et intégrable. Lua est largement utilisé par de nombreuses applications open source, dans des programmes commerciaux et pour la programmation de jeux.

darktable utilise Lua version 5.4. Décrire les principes et la syntaxe de Lua dépasse le cadre de ce manuel d'utilisation. Pour une introduction détaillée, voir le Manuel de référence Lua.

Les sections suivantes vous fourniront une brève introduction sur la façon dont les scripts Lua peuvent être utilisés dans darktable.

Principes de base : fichiers luarc

Au démarrage, darktable lance automatiquement le scripts Lua $DARKTABLE/share/darktable/luarcet $HOME/.config/darktable/luarc (où $DARKTABLEreprésente le dossier d'installation de darktable et $HOME votre dossier utilisateur).

C'est la seule fois que darktable lance des scripts Lua de lui même. Ces scripts peuvent enregistrer des rappels pour réaliser des actions sur divers évènements de darktable. Ce mécanisme de rappel est la principale méthode de déclenchement d'actions Lua.

Un exemple Lua simple

Commençons par un exemple simple qui affiche un message sur la console. Créez un fichier appelé luarc dans le répertoire de configuration de darktable (généralement $HOME/.config/darktable/) et ajoutez-y la ligne suivante :

print("Hello World !")

Lancez darktable et vous verrez la phrase « Hello World ! » s'afficher sur la console. Rien d'extraordinaire, mais c'est un début.

À ce stade, il n'y a rien de spécifique à darktable dans le script. Nous utilisons simplement la fonction d'affichage standard de Lua, permettant d'afficher une chaîne de caractère. C'est bien beau, mais nous pouvons faire mieux. Ainsi pour accéder à l'API darktable, vous devez d'abord la demander (require) et enregistrer le résultat dans une variable. Depuis cette variable, vous pouvez accéder à toute l'API darktable en appelant des sous-champs. Tout est documenté dans le manuel de l'API Lua

local darktable = require "darktable"
darktable.print_error("Hello World !")

Exécutez le script et... rien de ne s'affiche ! La fonction darktable.print_error est comme le print classique mais affiche le message uniquement si vous avez activé les traces Lua en lançant darktable avec la commande « darktable -d lua ». C'est la méthode recommandée pour afficher des traces dans un script Lua de darktable.

impression d'images étiquetées

Le premier exemple nous a montré les bases mêmes de Lua et nous a permis de vérifier que tout fonctionnait correctement. Faisons maintenant quelque chose d'un peu plus complexe. Essayons d'imprimer la liste des images auxquelles est attachée l'étiquette « rouge ». Mais avant tout, qu'est-ce qu'une image ?

local darktable = require "darktable"
local debug = require "darktable.debug"
print(darktable.debug.dump(darktable.database[1]))

L'exécution du code ci-dessus produit beaucoup de données. Nous l'examinerons dans un instant, mais regardons d'abord le code lui-même.

Nous connaissons require darktable. Ici, nous devons ajouter require darktable.debug qui est une section facultative de l'API qui fournit des fonctions d'assistance pour aider à déboguer les scripts Lua.

darktable.database est une table fournie par l'API qui contient toutes les images de la base de données de la bibliothèque. Chaque entrée de la base de données est un objet image. Les objets image sont des objets complexes qui vous permettent de manipuler votre image de différentes manières (toutes documentées dans la section types_dt_lua_image_t du manuel de l'API). Pour afficher nos images, nous utilisons darktable.debug.dump qui est une fonction qui accepte n'importe quel paramètre et en imprime le contenu. Étant donné que les images sont des objets complexes qui font indirectement référence à d'autres objets complexes, la sortie est énorme. Vous trouverez ci-dessous un exemple réduit de la sortie.

toplevel (userdata,dt_lua_image_t) : /images/100.JPG
   publisher (string) : ""
   path (string) : "/images"
   move (function)
   exif_aperture (number) : 2.7999999523163
   rights (string) : ""
   make_group_leader (function)
   exif_crop (number) : 0
   duplicate_index (number) : 0
   is_raw (boolean) : false
   exif_iso (number) : 200
   is_ldr (boolean) : true
   rating (number) : 1
   description (string) : ""
   red (boolean) : false
   get_tags (function)
   duplicate (function)
   creator (string) : ""
   latitude (nil)
   blue (boolean) : false
   exif_datetime_taken (string) : "2014:04:27 14:10:27"
   exif_maker (string) : "Panasonic"
   drop_cache (function)
   title (string) : ""
   reset (function)
   create_style (function)
   apply_style (function)
   film (userdata,dt_lua_film_t) : /images
      1 (userdata,dt_lua_image_t): .toplevel
      [......]
   exif_exposure (number) : 0.0062500000931323
   exif_lens (string) : ""
   detach_tag (function): toplevel.film.2.detach_tag
   exif_focal_length (number) : 4.5
   get_group_members (function): toplevel.film.2.get_group_members
   id (number) : 1
   group_with (function): toplevel.film.2.group_with
   delete (function): toplevel.film.2.delete
   purple (boolean) : false
   is_hdr (boolean) : false
   exif_model (string) : "DMC-FZ200"
   green (boolean) : false
   yellow (boolean) : false
   longitude (nil)
   filename (string) : "100.JPG"
   width (number) : 945
   attach_tag (function): toplevel.film.2.attach_tag
   exif_focus_distance (number) : 0
   height (number) : 648
   local_copy (boolean) : false
   copy (function): toplevel.film.2.copy
   group_leader (userdata,dt_lua_image_t): .toplevel

Comme on peut le voir, une image a un grand nombre de champs qui fournissent toutes sortes d'informations à son sujet. Ici, on s'intéresse au label « rouge (red) ». Ce champ est un booléen, et la documentation nous dit qu'il peut être écrit. Il ne nous reste plus qu'à trouver toutes les images avec ce champ et les imprimer :

darktable = require "darktable"
for _,v in ipairs(darktable.database) do
  if v.red then
    print(tostring(v))
  end
end

Ce code devrait être assez simple à comprendre à ce stade, mais il contient des aspects intéressants de Lua qui méritent d'être soulignés :

ipairs est une fonction Lua standard qui parcourt tous les indices numériques d'une table. Nous l'utilisons ici car la base de données de darktable a des indices non numériques qui sont des fonctions permettant de manipuler la base de données elle-même (ajout ou suppression d'images, par exemple).

L'itération dans une table renvoie à la fois la clé et la valeur. Il est conventionnel dans Lua d'utiliser une variable nommée « _ » pour stocker des valeurs dont nous ne nous soucions pas.

Notez que nous utilisons ici la fonction Lua standard tostring et non la fonction darktable.debug.dump spécifique à darktable. La fonction standard renvoie un nom pour l'objet tandis que la fonction de débogage imprimera le contenu. La fonction de débogage serait trop prolixe ici. Encore une fois, c'est un excellent outil de débogage mais il ne doit pas être utilisé pour autre chose.

ajouter un raccourci simple

Jusqu'à présent, tous nos scripts ont fait des choses au démarrage. Ceci est d'une utilité limitée et ne nous permet pas d'interagir avec l'utilisateur. Pour faire des choses plus avancées, nous devons enregistrer une fonction qui est appelée sur un événement donné. L'événement le plus courant auquel réagir est un raccourci clavier.

darktable = require "darktable"

local function hello_shortcut(event, shortcut)
darktable.print("Hello, I just received '"..event..
       "' with parameter '"..shortcut.."'")
end

darktable.register_event("shortcut",hello_shortcut,
       "A shortcut that prints its parameters")

Maintenant, démarrez darktable, allez dans « préférences > raccourcis > Lua > A shortcut that prints its parameters » (Un raccourci qui imprime ses paramètres), attribuez un raccourci et essayez-le. Vous devriez voir un joli message imprimé à l'écran.

Regardons le code en détail. Nous définissons d'abord une fonction qui prend deux chaînes comme paramètres d'entrée. Le premier est le type de l'événement déclenché ("raccourci") et le second est le nom du raccourci ("A shortcut that prints its parameters"). La fonction elle-même appelle darktable.print, qui imprime le message dans la fenêtre principale.

Une fois cette fonction définie, nous l'enregistrons en tant que fonction de rappel pour un événement de type raccourci. Pour ce faire, nous appelons darktable.register_event qui est une fonction générique pour tous les types d'événements. Nous lui disons que nous enregistrons un événement raccourci, puis nous donnons la fonction de rappel à appeler et enfin, nous donnons la chaîne à utiliser pour décrire le raccourci dans la fenêtre des préférences.

Essayons un raccourci un peu plus interactif. Celui-ci examine les images qui intéressent l'utilisateur (celles qui sont sélectionnées ou survolées) et augmente sa note :

darktable = require "darktable"

darktable.register_event("shortcut",function(event,shortcut)
    local images = darktable.gui.action_images
    for _,v in pairs(images) do
      v.rating = v.rating + 1
    end
  end,"Increase the rating of an image")

À ce stade, une grande partie de ce code devrait être explicite. Juste quelques remarques :

Au lieu de déclarer une fonction et de la référencer ensuite, nous la déclarons directement dans l'appel à darktable.register_event, c'est strictement équivalent mais légèrement plus compact.

image.rating est un champ qui donne le nombre d'étoiles de n'importe quelle image (entre 0 et 5 étoiles, -1 signifie rejeté).

darktable.gui.action_images est un tableau contenant toutes les images d'intérêt. darktable agit sur les images sélectionnées s'il y en a au moins une, ou sinon, sur l'image sous la souris. Cette fonction permet de suivre facilement la logique de l'interface utilisateur de darktable dans Lua.

Si vous sélectionnez une image et appuyez plusieurs fois sur votre raccourci, cela fonctionne correctement au début, mais lorsque vous atteignez cinq étoiles, darktable commence à afficher l'erreur suivante sur la console :

<![CDATA[
LUA ERROR : rating too high : 6
stack traceback:
   [C]: in ?
   [C]: in function '__newindex'
  ./configdir/luarc:10: in function <./configdir/luarc:7>
      LUA ERROR : rating too high : 6
  ]]>

C'est la façon dont Lua signale les erreurs. Nous avons essayé de donner une note de 6 à une image, mais elle est limitée à 5. Il serait trivial d'ajouter une vérification, mais suivons le chemin compliqué et capturons l'erreur :

darktable.register_event("shortcut",function(event,shortcut)
    local images = darktable.gui.action_images
    for _,v in pairs(images) do
      result,message = pcall(function()
        v.rating = v.rating + 1
        end)
      if not result then
        darktable.print_error("could not increase rating of image "..
          tostring(v).." : "..message)
      end
    end
end,"Increase the rating of an image")

pcall exécute son premier argument et intercepte toute exception émise par celui-ci. S'il n'y a pas d'exception, il renvoie true (vrai) plus tout résultat renvoyé par la fonction. S'il y a une exception, il renverra false (faux) et le message d'erreur de l'exception. Nous testons simplement ces résultats et les imprimons sur la console.

exporter des images avec Lua

Jusqu'à présent, nous avons appris à utiliser Lua pour adapter darktable à notre flux de travail particulier. Voyons maintenant comment utiliser Lua pour exporter facilement des images vers un service en ligne. Si vous êtes capable de télécharger une image vers un service via la ligne de commande, vous pouvez utiliser Lua pour intégrer cela dans l'interface utilisateur de darktable.

Dans l'exemple suivant, nous utilisons Lua pour exporter via scp. Un nouveau type de stockage apparaît dans l'interface utilisateur de darktable qui exporte les images vers une cible distante via le mécanisme de copie de ssh.

darktable = require "darktable"

darktable.preferences.register("scp_export","export_path",
  "string","target SCP path",
  "Complete path to copy to. Can include user and hostname","")

darktable.register_storage("scp_export","Export via scp",
  function( storage, image, format, filename,
     number, total, high_quality, extra_data)
    if not darktable.control.execute("scp "..filename.." "..
      darktable.preferences.read("scp_export",
         "export_path","string")) then
      darktable.print_error("scp failed for "..tostring(image))
    end
end)

darktable.preferences.register ajoute une nouvelle préférence au menu des préférences de darktable, scp_export et export_path nous permettent d'identifier de manière unique notre préférence. Ces paramètres sont utilisés lorsqu'on lit la valeur de la préférence. Le paramètre string indique au moteur Lua que la préférence est de type chaîne. Il peut également s'agir d'un entier, d'un nom de fichier ou de l'un des types détaillés dans le manuel de l'API relatif à types_lua_pref_type . On a alors le libellé de la préférence dans le menu des préférences, l'info-bulle au survol de la valeur et une valeur par défaut.

darktable.register_storage est l'appel qui enregistre réellement le nouveau type de stockage. Le premier argument est le nom du type de stockage, le second est l'étiquette qui est affichée dans l'interface utilisateur et le dernier est une fonction à appeler sur chaque image. Cette fonction a beaucoup de paramètres, mais filename est le seul que nous utilisons dans cet exemple. Il contient le nom d'un fichier temporaire de l'image exportée par le moteur de darktable.

Ce code fonctionne mais il a quelques limitations. Ce n'est qu'un exemple simple après tout :

Nous utilisons les préférences pour configurer le chemin cible. Il serait plus agréable d'ajouter un élément à l'interface utilisateur d'exportation dans darktable. Nous détaillerons comment procéder dans la section suivante.

Nous ne vérifions pas la valeur renvoyée de scp. Cette commande peut échouer, en particulier si l'utilisateur n'a pas correctement défini la préférence.

Ce script ne peut pas lire d'entrée utilisateur. Le scp distant doit utiliser une copie sans mot de passe -- scp ne peut pas être fourni facilement avec un mot de passe, nous allons donc le laisser ainsi.

Aucun message ne s'affiche une fois l'exemple terminé, seule la barre de progression en bas à gauche indique à l'utilisateur que le travail est terminé.

Nous utilisons coroutine.yield pour appeler un programme externe. L'appel os.execute empêcherait d'autres codes Lua de s'exécuter.

Constructions d'éléments de l'interface utilisateur

Notre exemple précédent était un peu limité. En particulier, l'utilisation d'une préférence pour le chemin d'exportation n'est pas très élégante. Nous pouvons faire mieux en ajoutant des éléments à l'interface utilisateur dans la boîte de dialogue d'exportation.

Les éléments de l'interface utilisateur sont créés via la fonction darktable_new_widget. Cette fonction prend un paramètre type de widget et renvoie un nouvel objet pour ce widget. Vous pouvez ensuite définir divers champs dans ce widget pour définir ses paramètres. Vous utilisez ensuite cet objet comme paramètre de fonctions qui l'ajoutent à l'interface utilisateur de darktable. L'exemple simple suivant ajoute un module dans la vue table lumineuse avec une étiquette simple :

local my_label = darktable.new_widget("label")
my_label.label = "Hello, world !"

dt.register_lib("test","test",false,{
    [dt.gui.views.lighttable] = {"DT_UI_CONTAINER_PANEL_LEFT_CENTER",20},
    },my_label)

Il existe une astuce syntaxique intéressante pour rendre le code des éléments de l'interface utilisateur plus facile à lire et à écrire. Vous pouvez appeler ces objets en tant que fonctions avec une table de valeurs de clé en comme argument. Cela permet à l'exemple suivant de fonctionner. Il crée un widget conteneur avec deux sous-widgets : une étiquette et un champ de saisie de texte.

   local my_widget = darktable.new_widget("box"){
      orientation = "horizontal",
      darktable.new_widget("label"){ label = "here => " },
      darktable.new_widget("entry"){ tooltip = "please enter text here" }
   }

Maintenant que nous le savons, allons améliorer un peu notre script.

darktable = require "darktable"

local scp_path = darktable.new_widget("entry"){
  tooltip ="Complete path to copy to. Can include user and hostname",
  text = "",
  reset_callback = function(self) self.text = "" end
}

darktable.register_storage("scp_export","Export via scp",
  function( storage, image, format, filename,
     number, total, high_quality, extra_data)
    if not darktable.control.execute(scp "..filename.." "..
      scp_path.text
    ) then
      darktable.print_error("scp failed for "..tostring(image))
    end
    end,
    nil, --finalize
    nil, --supported
    nil, --initialize
    darktable.new_widget("box") {
    orientation ="horizontal",
    darktable.new_widget("label"){label = "target SCP PATH "},
    scp_path,
})

partage de scripts

Jusqu'à présent, tout notre code Lua était dans luarc. C'est un bon moyen de développer votre script mais pas très pratique pour la distribution. Nous devons en faire un module Lua dédié. Pour ce faire, nous sauvegardons le code dans un fichier séparé (ici scp-storage.lua) :

--[[
SCP STORAGE
a simple storage to export images via scp

AUTHOR
Jérémy Rosen (jeremy.rosen@enst-bretagne.fr)

INSTALLATION
* copy this file in $CONFIGDIR/lua/ where CONFIGDIR
is your darktable configuration directory
* add the following line in the file $CONFIGDIR/luarc
  require "scp-storage"

USAGE
* select "Export via SCP" in the storage selection menu
* set the target directory
* export your images

LICENSE
GPLv2

]]
darktable = require "darktable"
darktable.configuration.check_version(...,{2,0,0})

local scp_path = darktable.new_widget("entry"){
  tooltip ="Complete path to copy to. Can include user and hostname",
  text = "",
  reset_callback = function(self) self.text = "" end
}

darktable.register_storage("scp_export","Export via scp",
  function( storage, image, format, filename,
     number, total, high_quality, extra_data)
    if coroutine.yield("RUN_COMMAND","scp "..filename.." "..
      scp_path.text
    ) then
      darktable.print_error("scp failed for "..tostring(image))
    end
    end,
    nil, --finalize
    nil, --supported
    nil, --initialize
    darktable.new_widget("box") {
    orientation ="horizontal",
    darktable.new_widget("label"){label = "target SCP PATH "},
    scp_path,
})

darktable recherche les scripts *.lua (en suivant les règles Lua normales) dans le répertoire $CONFIGDIR/lua. Ainsi, notre script peut être appelé en ajoutant simplement require « scp-storage » dans le fichier luarc. Quelques notes supplémentaires...

La fonction darktable.configuration.check_version vérifie la compatibilité pour vous. Le « ... » est le nom de votre script et {2,0,0} est la version de l'API avec laquelle vous avez testé votre script. Vous pouvez ajouter plusieurs versions d'API si vous mettez à jour votre script pour plusieurs versions de darktable.

Assurez-vous de déclarer toutes vos fonctions comme locales afin de ne pas polluer l'espace de noms global.

Assurez-vous de ne pas laisser de messages de débogage dans votre code -- utilisez darktable.print_error pour laisser des traces de débogage dans votre code final sans polluer la console.

Vous êtes libre de choisir n'importe quelle licence pour votre script, mais les scripts téléchargés sur le site Web de darktable doivent être GPLv2.

Une fois que vous avez rempli tous les champs, vérifié votre code, vous pouvez le télécharger sur notre page de script ici.

appeler Lua de dbus

Il est possible d'envoyer une commande Lua à darktable via son interface DBus. La méthode org.darktable.service.Remote.Lua prend une seule chaîne de paramètre qui est interprétée comme une commande Lua. La commande est exécutée dans le contexte Lua en cours et doit retourner un nul ou une chaîne de caractères. Le résultat est retourné comme résultat de la méthode DBus.

Si l'appel Lua aboutit à une erreur, l'appel de la méthode DBus renvoie une erreur org.darktable.Error.LuaError avec le message d'erreur Lua attaché à l'erreur DBus.

utiliser darktable depuis un script Lua

Attention : Cette fonctionnalité est très expérimentale. Il est connu que plusieurs éléments ne fonctionnent pas encore en mode bibliothèque. Des tests prudents sont hautement recommandés.

L'interface Lua vous permet d'utiliser darktable à partir de n'importe quel script Lua. Cela charge darktable en tant que bibliothèque et vous fournit une grande part de l'API Lua (comme darktable est configuré sans interface utilisateur les fonctions correspondantes ne sont pas disponibles).

Par exemple, le programme suivant écrit la liste de toutes les images dans votre bibliothèque.

#!/usr/bin/env lua
package = require "package"
package.cpath=package.cpath..";./lib/darktable/lib?.so"

dt = require("darktable")(
"--library", "./library.db",
"--datadir", "./share/darktable",
"--moduledir", "./lib/darktable",
"--configdir", "./configdir",
"--cachedir","cachedir",
"--g-fatal-warnings")

require("darktable.debug")

for k,v in ipairs(dt.database) do
   print(tostring(v))
end

Notez la troisième ligne qui pointe vers l'emplacement du fichier libdarktable.so.

Notez également que l'appel require renvoie une fonction qui ne peut être appelée qu'une seule fois et vous permet de définir les paramètres de la ligne de commande de darktable. Le paramètre :memory: de --library est utile ici si vous ne voulez pas travailler sur votre bibliothèque personnelle.

API Lua

L'API Lua de darktable est documentée avec son propre manuel comprenant une description détaillée de toutes les structures de données et fonctions. Vous pouvez télécharger le manuel de l'API à partir de (https://www.darktable.org/resources/).

Guides & Tutoriels

développement d'images monochromes

autres ressources

développement d'images monochromes

La photographie a une longue histoire de production d'images monochromes, et beaucoup apprécient encore cet aspect de la photographie. Bien qu'il existe des appareils photo spécialisés/modifiés avec un capteur véritablement monochrome, la plupart utilisent toujours un boîtier ordinaire pour capturer une image couleur et la transformer en une image monochrome pendant le post-traitement.

Il existe deux approches principales pour cette conversion :

Une approche physique, où nous essayons de simuler comment une émulsion de film photographique à base d'argent réagirait à la lumière capturée sur la scène.

Une approche perceptuelle, où nous développons une image couleur et réduisons la saturation dans un espace couleur perceptuel tel que CIE Lab.

Ces approches, et d'autres fonctionnalités liées au monochrome dans darktable, sont discutées dans les sections suivantes.

importation et marquage d'images en monochrome

Lors de l'import d'une image, plusieurs propriétés permettent d'indiquer que l'image nécessite un traitement monochrome :

Si l'image a été prise à l'aide d'un boîtier achromatique, l'image sera automatiquement considérée comme monochrome.

Lorsque vous capturez une scène pour produire une image monochrome, il peut être utile de mettre votre appareil photo en mode créatif « noir et blanc ». Cela vous permet de visualiser à quoi ressemblerait la scène en monochrome via l'écran de visualisation de votre appareil photo ou le viseur électronique. L'appareil photo capturera toujours les données en couleur dans le fichier brut, mais l'image d'aperçu jpeg intégrée sera monochrome. Lorsque vous importez une telle image, darktable peut automatiquement marquer l'image comme monochrome en fonction de l'image d'aperçu.

La vérification que l'aperçu est monochrome est désactivée par défaut car elle ralentit le processus d'importation. Vous pouvez la réactiver dans préférences > traitement > détecter les miniatures monochromes

Lors du traitement d'un fichier brut, l'une des premières étapes consiste à dématricer l'image. Si la méthode de dématriçage est "« passer (monochrome) », les informations de couleur sont supprimées pendant le processus de dématriçage et darktable marque l'image comme monochrome.

Remarque : Vous ne devez utiliser cette méthode que pour les images prises avec un appareil photo dont la matrice de filtres de couleur a été supprimée.

Après avoir importé l'image, vous pouvez marquer manuellement une image comme monochrome (ou non) en utilisant l'onglet métadonnées dans le module [images sélectionnées] de la table lumineuse (../module-reference/utility-modules/lighttable/selected-image.md).

Si l'une des méthodes ci-dessus a marqué une image comme monochrome, darktable utilise ces informations pour présenter à l'utilisateur des commandes de module spécifiques au monochrome et/ou appliquer un traitement spécial à l'image.

Le mot-clé darktable|mode|monochrome sera automatiquement appliqué à toutes les images marquées comme monochromes et, si vous avez activé la superposition permanente des informations sur les miniatures de votre table lumineuse, ces images seront marquées d'un indicateur visuel B&W à côté du type de fichier. En appliquant automatiquement ce mot-clé et cet indicateur visuel, darktable permet de configurer facilement des filtres pour sélectionner les images à traiter en monochrome et de voir en un coup d'œil quelles images de la collection courante portent le mot-clé monochrome.

conversion monochrome

approche physique

Cette approche a tendance à fonctionner avec des données linéaires relatives à la scène provenant du capteur et tente d'imiter la réponse d'un film photographique avec une émulsion d'argent. Elle se décompose en trois étapes :

Mappe les canaux de couleur du capteur en un seul canal monochrome. Différents types de films photographiques monochromes ont différents niveaux de sensibilité à diverses longueurs d'onde, et cela peut être simulé en donnant aux trois canaux de couleur des pondérations différentes lors de leur combinaison en un seul canal monochrome. Le module calibration des couleurs permet aux trois canaux d'être mélangés dans un canal gris en quantités variables, et il comprend un certain nombre de préréglages conçus pour imiter les caractéristiques de certains films photographiques bien connus.

Applique une courbe de saturation de luminosité. Lorsqu'une partie de film photographique est exposée à une lumière plus intense, sa réponse diminue à mesure que l'émulsion d'argent devient saturée. Cette courbe de saturation peut être simulée au sein du module filmique rgb.

Le développement d'un film monochrome en chambre noire implique traditionnellement des actions d'« assombrir/éclaircir » (dodging and burning) pour contrôler le niveau d'exposition sur les différentes parties de l'image. Cela peut être émulé dans darktable en utilisant soit le module exposition avec des masques créés manuellement, soit en utilisant le module égaliseur de ton qui génère un masque à l'aide d'un filtre guidé.

approche perceptuelle

L'autre option pour produire une image monochrome est de réduire la saturation des couleurs dans l'image, ce qui peut se faire dans un espace colorimétrique linéaire, ou dans un espace colorimétrique modélisé pour la perception humaine.

Le module balance couleur opère dans l'espace linéaire RVB, et vous permet de réduire la saturation des couleurs de l'image en utilisant soit le curseur de saturation pour la couleur d'entrée soit le curseur de saturation pour la couleur de sortie -- le choix que vous faites est fonction de ce que vous souhaitez faire dans le module balance couleur : apporter des ajustements soit à l'image couleur, soit à l’image monochrome. Le module de balance couleur tend à donner un résultat prévisible et perceptuellement uniforme.

Le module monochrome opère dans l'espace colorimétrique LAB, et il permet à l'utilisateur de définir graphiquement une combinaison pondérée de couleurs pour déterminer la densité des noirs dans l'image monochrome. L'interface peut être quelque peu sensible aux paramètres, avec de petits changements produisant des effets importants, et vous pouvez rencontrer des problèmes avec le contraste global et/ou les artefacts de pixels noirs.

D'autres modules tels que zones couleur peuvent également être utilisés pour supprimer la saturation des couleurs de l'image, mais ceux-ci n'offrent aucun avantage réel par rapport à la simplicité des curseurs de saturation du module balance couleur.

autres ressources

Pour une aide et un support, vous pouvez aussi poser une question sur les forums de discussion sur discuss.pixls.us

Les sites officiels pour obtenir des informations concernant darktable sont les suivants :

darktable.org

GitHub wiki

Les articles suivants fournissent des informations générales utiles sur le flux de travail relatif à la scène de darktable :

darktable 3.0 for dummies in 3 modules

darktable 3.0 for dummies -- hardcore edition

darktable 3.0 : RGB or Lab ? Which modules ? Help !

darktable's filmic FAQ

Introduction au module calibration des couleurs

Les ressources suivantes peuvent fournir une compréhension plus approfondie des fonctionnalités de certains modules de traitement spécifiques :

Image processing and the pixel pipeline in darktable 3.0

Filmic RGB v3: remapping any dynamic range in darktable 3.0

Filmic RGB v4: highlights reconstruction in darktable 3.2

Dodging and burning with tone equalizer in darktable 3.0

Noise reduction (profiled) with non-local means in darktable 3.0

Noise reduction (profiled) with wavelets in darktable 3.0

Contrast equalizer modules in darktable

Certaines autres chaînes YouTube avec du contenu récent sur l'utilisation de darktable sont :

Bruce Williams Photography

Boris Hajdukovic

Sujets spéciaux

gestion de la couleur

mémoire

opencl

utilisation de darktable-chart

appel du programme

variables

ordre des modules par défaut

pipeline graphique de darktable

prise en charge des périphériques midi

contribuer à dtdocs

traduire dtdocs

gestion de la couleur

présentation

profil d'affichage

méthode de rendu

intention de rendu

espaces colorimétriques de darktable

couleurs non bornées

possibles artefacts de couleur

dimensions de la couleur dans darktable

présentation

darktable utilise un flux de travail entièrement géré par la couleur :

Les spécifications de couleur d'entrée proviennent de profils ICC intégrés ou fournis par l'utilisateur ou, dans le cas de fichiers raw, d'une bibliothèque de matrices de couleurs spécifiques à l'appareil photo.

darktable lit automatiquement le profil d'affichage de votre moniteur (s'il est correctement configuré) pour un rendu précis des couleurs à l'écran. Les configurations multi-écrans sont entièrement prises en charge tant qu'un service système tel que colord est en place et correctement configuré pour informer darktable du profil correct des moniteurs.

Les fichiers de sortie peuvent être encodés dans l'un des profils intégrés de darktable, y compris sRVB et Adobe RVB, ou dans un espace colorimétrique fourni par l'utilisateur en tant que profil ICC.

profil d'affichage

Pour que darktable rende fidèlement les couleurs à l'écran, il doit trouver le profil d'affichage correct pour votre moniteur. En général, cela nécessite que votre moniteur soit correctement calibré et profilé, et il a besoin que le profil soit correctement installé sur votre système. darktable interroge le xatom de votre serveur d'affichage X ainsi que le service colord du système (si disponible) pour le bon profil. Si nécessaire, vous pouvez appliquer une méthode spécifique dans préférences>divers.

Pour examiner la configuration de votre profil d'affichage, vous pouvez exécuter le binaire darktable-cmstest (Linux uniquement) qui affiche des informations utiles (par exemple le nom du profil par moniteur) et vous indique si le système est correctement configuré.

Dans de rares cas, vous devrez peut-être sélectionner manuellement le profil d'affichage. Ceci est possible à partir de l'épreuvage écran et de la vérification de gamut dans la vue chambre noire et dans la boîte de dialogue de profil d'affichage dans la vue table lumineuse.

Gardez à l'esprit que les écrans grand public de haut niveau n'ont généralement pas besoin d'un profil d'affichage personnalisé, sauf si vous devez effectuer un épreuvage écran avec des attentes professionnelles, car ils sont correctement calibrés en usine pour sRGB.

Un profil d'affichage mal conçu sera plus nocif que de s'en tenir au profil sRGB par défaut, car la valeur par défaut peut être légèrement inexacte mais sera au moins fiable. Il est conseillé aux utilisateurs avancés et professionnels de procéder à la production de profils d'affichage personnalisés uniquement s'ils ont la formation nécessaire pour évaluer la qualité du profil résultant et la compréhension des options de profilage.

méthode de rendu

darktable peut rendre les couleurs soit avec ses propres algorithmes internes, soit en utilisant la bibliothèque externe LittleCMS2. La méthode interne de darktable est plus rapide, d'un ordre de grandeur, que la méthode externe. L'option externe vous donne le choix de l'intention de rendu et peut offrir une précision légèrement supérieure dans certains cas.

Vous pouvez changer la méthode par défaut dans préférences> traitement>toujours utiliser LittleCMS 2 pour le profil de couleur de sortie

Remarque : Si l'ICC donné est basé sur une LUT ou contient à la fois une LUT et une matrice, darktable utilisera LittleCMS2 pour rendre les couleurs quelle que soit la valeur du paramètre de configuration.

intention de rendu

Si le rendu avec LittleCMS2 est activé (voir méthode de rendu), vous pouvez définir comment gérer les couleurs hors gamut lors de la conversion entre les espaces colorimétriques. Une boîte de sélection dans les modules exporter,profil de couleur de sortie et épreuvage écran vous donnent le choix entre les intentions de rendu suivantes :

perceptif

Convient aux photographies car il maintient la position relative des couleurs. C'est généralement le meilleur choix.

colorimétrique relative

Les couleurs hors gamut sont converties en couleurs ayant la même clarté, mais une saturation différente. Les autres couleurs restent inchangées.

saturation

La saturation est conservée mais la clarté est légèrement modifiée.

colorimétrique absolue

Garder le point blanc.

espaces colorimétriques de darktable

Les images d'entrée sont soit des fichiers RVB (comme des JPEG ou des TIFF) soit des RAW de l'appareil photo. Les deux stockent des informations visuelles sous la forme d'une combinaison de couleurs primaires (par exemple, rouge, vert et bleu) qui, ensemble, décrivent une émission lumineuse à recréer par un écran.

L'image suivante illustre ce concept.

Le côté gauche de l'image représente une lumière colorée que nous devons représenter numériquement. Nous pouvons utiliser trois filtres idéaux de couleur pour décomposer cette lumière en trois lumières primaires colorées à différentes intensités. Afin de recréer la lumière colorée d'origine à partir de notre décomposition idéale (comme illustré au centre de l'image), nous devons simplement recombiner ces trois lumières primaires par addition.

Il devrait être possible de reproduire la lumière colorée d'origine en prenant un ensemble de lumières blanches aux intensités correctes et en projetant ces lumières à travers des filtres de couleur appropriée. Cette expérience peut être réalisée à la maison en utilisant des gels et des ampoules blanches à intensité variable. C'est à peu près ce que faisaient les anciens écrans CRT couleur et c'est ainsi que les vidéoprojecteurs fonctionnent toujours.

En photographie, l'étape de décomposition initiale est effectuée par le réseau de filtres de couleur qui se trouve au-dessus du capteur de votre appareil photo. Cette décomposition n'est pas idéale, il n'est donc pas possible de recréer avec précision l'émission d'origine avec une simple addition -- une mise à l'échelle intermédiaire est nécessaire pour ajuster les trois intensités.

Sur les écrans, les ampoules LED sont atténuées proportionnellement à chaque intensité, et les émissions des trois lumières sont physiquement ajoutées pour reconstituer l'émission d'origine. Les images numériques stockent les intensités de ces lumières primaires sous la forme d'un ensemble de trois nombres pour chaque pixel, représentés à droite de l'image ci-dessus sous forme de nuances de gris.

Alors qu'un ensemble d'intensités d'affichage peut être facilement combiné pour recréer une lumière originale sur un écran (par exemple, si nous avons créé une image de synthèse avec l'ordinateur), l'ensemble des intensités capturées par un capteur nécessite une mise à l'échelle pour que l'addition de ces intensités à l'écran reproduise raisonnablement l'émission lumineuse d'origine. Cela signifie que chaque ensemble d'intensités, exprimé sous la forme d'un ensemble de valeurs RVB, doit être lié à un ensemble de filtres (ou de couleurs primaires de LED) définissant un espace colorimétrique -- tout ensemble RVB n'a de sens qu'en référence à un espace colorimétrique.

Nous devons donc adapter les intensités capturées pour les rendre à nouveau sommables. Mais si nous devons aussi recomposer la lumière d'origine sur un écran qui n'a pas les mêmes filtres colorés ou primaires que l'espace auquel notre ensemble de valeurs RVB appartient, alors, ces intensités doivent être mises à l'échelle pour prendre en compte les filtres différents de l'écran. Le mécanisme de cette mise à l'échelle est décrit dans les profils de couleur, généralement stockés dans des fichiers .icc.

Remarque : La couleur n'est pas une propriété physique de la lumière. Elle n'existe que dans le cerveau humain. Elle résulte de la décomposition d'une émission de lumière par les cônes de la rétine. Le principe de cette décomposition est très similaire à celui du filtrage de l'exemple précédent. Une valeur «RVB» doit être comprise comme «une émission lumineuse codée par trois canaux connectés à trois primaires». Mais les primaires elles-mêmes peuvent être différentes de ce que les humains appellent «rouge», «vert» ou «bleu».

Les filtres décrits ici sont des filtres passe-bande qui se chevauchent. Puisqu'ils se chevauchent, additionner leurs valeurs ne préserverait pas l'énergie du spectre d'origine. Donc, pour faire court, nous devons recomposer ces valeurs en prenant en compte la réponse des cônes de la rétine.

La plus grande partie du traitement d'image de darktable a lieu dans un grand espace "profil de travail" RVB, avec certains modules (pour la plupart anciens) travaillant en interne dans l'espace colorimétrique CIELab 1976 (souvent simplement appelé "Lab"). La sortie finale du pipeline graphique est à nouveau dans un espace RVB adapté soit à un affichage sur un moniteur soit à un fichier de sortie.

Ce processus implique que le pipeline graphique comporte deux étapes fixes de conversion de couleur : profil de couleur d'entrée et profil de couleur de sortie. De plus, il y a l'étape dématriçage pour les images RAW, où les couleurs de chaque pixel sont reconstruites par interpolation.

Chaque module a une position dans le pipeline graphique qui vous indique dans quel espace colorimétrique le module travaille :

jusqu'à dématriçage : Les informations d'image RAW ne constituent pas encore une "image" mais simplement des "données" concernant la lumière capturée par le boîtier. Chaque pixel porte une intensité pour chaque couleur primaire, et les couleurs primaires du boîtier sont très différentes de celles utilisées dans les modèles de vision humaine. Gardez à l'esprit que certains des modules de cette partie du pipeline peuvent également agir sur des images d'entrée non RAW au format RVB (ayant des informations complètes sur les trois canaux de couleur).

entre dématriçage et profil de couleur d'entrée : L'image est au format RVB dans l'espace colorimétrique du boîtier ou du fichier d'entrée spécifique.

entre profil de couleur d'entrée et profil de couleur de sortie : L'image se trouve dans l'espace défini par le profil de travail sélectionné (linéaire Rec2020 RVB par défaut). Comme darktable traite les images dans des tampons à virgule flottante 4x32 bits, nous pouvons gérer de grands espaces colorimétriques de travail sans risquer des bandes ou des coupures tonales.

après profil de couleur de sortie : L'image est au format RVB tel que défini par l'affichage sélectionné ou le profil ICC de sortie.

couleurs non bornées

Les écrans et la plupart des formats de fichiers image ne peuvent encoder que des intensités RVB confinées dans une certaine plage. Par exemple, les images encodées sur 8 bits ne peuvent contenir que des valeurs de 0 à 255, des images sur 10 bits de 0 à 1023, etc. Les standards graphiques postulent que le maximum de cette plage, quelle que soit sa valeur réelle, représentera toujours la luminosité maximale que le support d'affichage est capable de rendre, généralement entre 100 et 160 Cd /m² (ou nits). Nous appelons généralement ce maximum "100 % relatif à l'affichage". Le minimum de la plage, codé 0 quelle que soit la profondeur de bits utilisée, devient alors "0 % relatif à l'affichage". 100 % code le blanc pur, 0 % code le noir pur.

Il s'agit d'une limitation pour les applications de traitement d'image, car cela signifie que tout pixel situé en dehors de cette plage sera tronqué à la limite la plus proche, entraînant une perte non récupérable de données (couleurs et/ou textures).

Pendant très longtemps, les logiciels de traitement d'image ont également été assujettis à cette limitation pour des raisons techniques. Certains le sont encore, mais maintenant c'est par choix lors de leur conception. En conséquence, ils tronqueront les intensités RVB à 100 % relatif à l'affichage lors des opérations sur l'image.

darktable utilise l'arithmétique à virgule flottante dans son pipeline graphique. Il peut donc gérer en interne n'importe quelle valeur RVB, même si elle ne se trouve pas dans la plage relative à l'affichage, pourvu qu'elle soit strictement positive. Ce n'est qu'à la toute fin du pipeline graphique, avant que l'image ne soit enregistrée dans un fichier ou envoyée à l'affichage, que les valeurs RVB sont tronquées si cela est nécessaire.

On dit que les pixels qui peuvent prendre des valeurs en dehors de la plage relative à l'affichage ont “des couleurs non bornées”. À chaque étape du traitement, on pourrait choisir de confiner ces valeurs dans la plage autorisée ou choisir de les conserver, et de les tronquer uniquement lors de la dernière étape du pipeline. Cependant, il a été constaté que le traitement est moins sujet aux artefacts si les couleurs non bornées ne sont pas confinées mais traitées comme toutes les autres données de couleur.

À la fin du pipeline graphique, des modules comme filmique peuvent vous aider à mapper les valeurs RVB dans la plage relative à l'affichage tout en maximisant la préservation des données, évitant ainsi l'écrêtage dur qui n'est généralement pas agréable visuellement.

Cependant, à tout moment dans le pipeline graphique, vous devez vous assurer de ne pas créer de valeurs RVB négatives. Les intensités RVB codent les émissions lumineuses et la lumière négative n'existe pas. Les modules qui, pour traiter les pixels, reposent sur une interprétation physique de la lumière échoueront s'ils rencontrent une émission de lumière non physique. Par prévention, les valeurs RVB négatives sont toujours écrêtées chaque fois qu'elles peuvent faire échouer les algorithmes, mais le résultat visuel peut sembler dégradé. Des valeurs négatives peuvent être produites en abusant de la correction du niveau de noir dans le module exposition ou de l'offset dans le module balance couleur. Des précautions doivent donc être prises lors de l'utilisation de ces modules.

possibles artefacts de couleur

Il existe quelques situations rares qui peuvent encore conduire à des résultats problématiques à moins que l'utilisateur ne prenne des mesures. Pour certains modules de l'espace colorimétrique Lab, comme niveaux et monochrome, il faut tenir compte du fait que les canaux L transportent toutes les informations de clarté, les canaux a et b représentant, quant à eux, purement la chroma et la teinte. Des couleurs non bornées contenant des valeurs L négatives sont particulièrement problématiques pour ces modules et peuvent conduire à des artefacts de pixels noirs.

On a constaté que des sources de lumière bleue hautement saturées dans l'image sont des candidats probables pour des pixels ayant des valeurs de L négatives. Si vous êtes engagé dans la photographie de spectacle, vous devez prêter une attention particulière à ces lumières apparaissant dans les images.

Afin d'atténuer ce problème, le module profil de couleur d'entrée a une option d'écrêtage du gamut. Cette option est désactivée par défaut mais peut être activée si des artefacts sont observés. En fonction des paramètres, les couleurs seront limitées à l'un des gamuts RVB disponibles. En effet, les artefacts de pixels noirs sont évités au prix d'un rétrécissement de la plage des couleurs.

dimensions de la couleur dans darktable

Cette section définit les propriétés perceptuelles de la couleur, à la fois conceptuellement et quantitativement, afin de caractériser et de quantifier les ajustements créatifs et correctifs apportés à la couleur dans darktable.

définitions

Les propriétés de la couleur comme la "saturation", la "luminosité" (brightness) ou la "clarté " (lightness) sont passées dans l'usage courant mais sont largement utilisées à mauvais escient et souvent utilisées pour signifier différentes choses. En science des couleurs, chacun de ces termes a une signification précise.

Il existe deux cadres dans lesquels les propriétés de la couleur peuvent être analysées et décrites :

Un cadre linéaire de scène, physiologique, qui se concentre principalement sur la réponse des cônes de la rétine, en utilisant des espaces colorimétriques tels que CIE XYZ 1931 ou CIE LMS 2006,

Un cadre perceptuel et psychologique qui empile les corrections du cerveau au-dessus du signal de la rétine, en utilisant des espaces colorimétriques tels que CIE Lab 1976, CIE Luv 1976, CIE CAM 2016 et JzAzBz (2017).

Ces deux cadres nous fournissent des métriques et des dimensions pour analyser la couleur et nous permettent de modifier certaines de ses propriétés tout en préservant d'autres.

darktable utilise les dimensions de la couleur suivantes :

teinte

Attribut de perception visuelle dans lequel une zone semble être similaire à l'une des couleurs rouge, jaune, verte ou bleue, ou à une combinaison de paires adjacentes de ces couleurs considérées dans un anneau fermé. ¹ La teinte est une propriété partagée entre les cadres perceptuel et linéaire de scène.

luminance

La densité d'intensité lumineuse par rapport à une zone projetée dans une direction spécifiée à un point spécifié sur une surface réelle ou imaginaire. ² La luminance est une propriété des cadres de travail relatifs à la scène et est exprimée par le canal Y de l'espace CIE XYZ 1931.

luminosité

Attribut de la perception visuelle selon lequel une zone semble émettre, transmettre ou réfléchir plus ou moins de lumière. ³

clarté

La luminosité d'une zone évaluée par rapport à la luminosité d'une zone éclairée de manière similaire qui semble être blanche ou hautement émettrice. ⁴ La clarté est l'homologue perceptif et non linéaire de la luminance (à peu près égale à la racine cubique de la luminance Y). La clarté est exprimée par le canal L dans CIE Lab et Luv 1976 et le canal J dans JzAzBz.

chroma

Le degré de coloration (colorfulness) d'une zone évaluée comme une proportion de la luminosité d'une zone éclairée de manière similaire qui apparaît grise, blanche ou hautement émissive. ⁵ Attention : chroma n'est pas l'abréviation de chrominance, qui est la partie couleur d'un signal vidéo (les canaux Cb et Cr dans YCbCr, par exemple).

brillance

La luminosité d'une zone jugée par rapport à la luminosité de son environnement. ⁶

saturation

L'intensité de couleur d'une zone jugée proportionnellement à sa luminosité. ⁷

Les couleurs peuvent être décrites dans de nombreux espaces de couleur différents, mais quel que soit l'espace, chaque couleur nécessite au moins trois composantes : une mesure de luminance ou de luminosité et deux mesures de chromaticité (teinte et chroma, ou coordonnées de couleur opposées sur le cercle chromatique).

illustrations

Bien que les définitions précédentes soient utiles pour donner un sens aux mots, elles ne nous disent pas ce que nous devrions regarder. Les graphiques suivants montrent la luminance, la clarté, la chroma, la brillance/luminosité et la saturation variant à partir d'une couleur de base "0" et comment les couleurs résultantes se dégradent :

(clarté + chroma) ou (brillance/luminosité + saturation) sont deux manières différentes d'encoder la même réalité. Ce sont des espaces orthogonaux qui peuvent être convertis de l'un à l'autre par une simple rotation de la base. Cela signifie que la chroma évolue à clarté constante, la saturation évolue à brillance/luminosité constante, et vice versa :

Les lignes d'égale chroma sont verticales (suit la grille des pastilles), ce qui signifie que la chroma a la même direction pour toutes les couleurs de la gamme (voir ci-dessous). Cependant, les lignes d'égale saturation sont obliques (tracées en pointillés sur le graphique) et vont toutes du noir à travers chaque pastille de couleur, ce qui signifie que leurs directions sont particulières à chaque couleur.

L'augmentation de la chroma éloigne donc uniformément toutes les couleurs de l'axe gris central horizontalement, tandis que l'augmentation de la saturation ferme ou ouvre l'angle des lignes pointillées obliques comme une fleur.

De même, l'augmentation de la clarté déplace toutes les couleurs uniformément vers le haut à partir de l'axe horizontal, tandis que l'augmentation de la brillance/luminosité les déplace le long des lignes d'égale saturation.

Sur les deux graphiques ci-dessus, la clarté, la chroma, la saturation et la brillance sont dessinées dans l'espace colorimétrique JzAzBz, qui est un espace colorimétrique perceptuel adapté à un signal HDR, et est utilisé dans les masques paramétriques et le module balance couleur rvb. La luminance est dessinée dans l'espace colorimétrique CIE XYZ 1931 et représente l'effet d'une compensation d'exposition. Elle présente le même comportement que la brillance, sauf que la taille du pas n'est pas à l'échelle perceptuelle.

Remarque : Dans cette section, brillance et luminosité sont tous deux utilisés pour décrire la même dimension. En toute rigueur, la luminosité est une métrique absolue, tandis que la brillance est la luminosité d'une surface par rapport à la luminosité de son environnement (c'est-à-dire à quel point une surface "se distingue" de son environnement et semble fluorescente). Mais dans l'édition d'images, l'augmentation de la luminosité de certaines surfaces augmentera également sa brillance, c'est pourquoi le terme brillance est préféré dans l'interface utilisateur de darktable pour plus de clarté et en référence à son effet visuel.

dimensions de la couleur et gamut

Le gamut est le volume de couleurs qu'un certain espace colorimétrique peut englober et coder. Il est important de noter qu'une fois converti en espaces perceptifs, le gamut de tout espace RVB n'est plus uniforme le long des teintes.

Les exemples suivants montrent le volume du gamut de l'espace sRGB sur des tranches de teinte contenant les lumières primaires rouge, vert et bleu, sur un plan de clarté-chroma dans une échelle uniforme :

Cela montre que l'augmentation de la chroma (déplacement sur l'axe horizontal) d'une certaine quantité peut être sans danger pour certaines teintes à une certaine clarté, mais peut pousser d'autres coordonnées de teinte-clarté hors du gamut. Par exemple, nous avons beaucoup plus de marge pour le vert ou le magenta que pour le cyan.

De nombreux problèmes de gamut à l'exportation sont en fait induits par l'utilisateur et le résultat d'un grossissement brutal de la chroma. Pour cette raison, l'utilisation d'un modèle luminosité-saturation peut être plus sûre.

dimensions de la couleur et couleurs complémentaires

Le cyan, le magenta, le jaune (CMJ) sont des couleurs complémentaires du rouge, du vert, du bleu (RVB). Cependant, les espaces CMJ complémentaires calculés à partir des espaces RVB ne sont pas perceptuellement complémentaires. Pour montrer cela, nous créons un espace CMJ à partir de sRGB, où le cyan a des coordonnées sRGB (0, 1, 1), magenta (1, 0, 1) et jaune (1, 1, 0), et l'affichons dans un espace clarté-chroma :

En comparant avec les tranches de teinte des couleurs primaires de la section précédente, il est facile de voir que non seulement les gamuts n'ont pas la même forme, mais que les couleurs ne correspondent pas.

C'est une raison de plus pour éviter d'utiliser des espaces HSL/HSV (dérivés des espaces RVB) pour éditer les couleurs : puisque en premier lieu, ces espaces RVB ne sont pas perceptuellement uniformes et que les espaces HSV/HSL dérivés ne le sont pas non plus. Bien que les espaces RVB aient un certain mérite de par leur connexion à la lumière physique, tout processus impliquant la teinte devrait s'appliquer dans un espace perceptuel.

dimensions de la couleur et paramètres

De nombreuses applications, y compris darktable, nomment "saturation" tous les paramètres qui affectent la chroma (par exemple, dans le module balance couleur, dans "contraste/luminosité/saturation"). C'est le symptôme d'un logiciel qui essaye d'être accessible aux non-professionnels en utilisant un langage commun. Ceci est trompeur, car la saturation existe et est assez différente de la chroma. De plus, de nombreuses spécifications vidéo appellent à tort la chroma "saturation". Chaque fois que darktable réutilise ces spécifications, il utilise le terme incorrect de la spécification plutôt que le terme approprié de la dimension de couleur.

définition IEC de teinte (hue) : https://www.electropedia.org/iev/iev.nsf/display?openform&ievref=845-22-067 ↩︎

définition IEC de luminance : https://www.electropedia.org/iev/iev.nsf/display?openform&ievref=845-21-050 ↩︎

définition IEC de clarté (lightness) : https://www.electropedia.org/iev/iev.nsf/display?openform&ievref=845-22-063 ↩︎

définition IEC de luminosité (brightness) : https://www.electropedia.org/iev/iev.nsf/display?openform&ievref=845-22-059 ↩︎

définition IEC de chroma : https://www.electropedia.org/iev/iev.nsf/display?openform&ievref=845-22-074 ↩︎

définition IEC d'éclat apparent (point brillance) : https://www.electropedia.org/iev/iev.nsf/display?openform&ievref=845-21-096 ↩︎

définition IEC de saturation : https://www.electropedia.org/iev/iev.nsf/display?openform&ievref=845-22-073 ↩︎

mémoire

Les besoins en mémoire de darktable sont élevés. Un simple calcul rend cela clair. Si nous avons une image 20 Mpx, alors, pour des raisons de précision, darktable stockera en interne chacun de ces pixels sous la forme d'une cellule à virgule flottante 4 x 32 bits. Chaque image complète de cette taille aura donc besoin d'environ 300 Mo de mémoire. Comme nous voulons traiter l'image, nous aurons au moins besoin de deux tampons pour chaque module -- un pour l'entrée et un pour la sortie. Si nous avons un module plus complexe, son algorithme peut nécessiter plusieurs autres tampons intermédiaires de même taille. Sans optimisation supplémentaire, entre 600 Mo et 3 Go seront nécessaires simplement pour stocker et traiter les données de l'image. En plus de cela, nous avons le segment de code de darktable, le code et les données de toutes les bibliothèques système liées dynamiquement, et ne pas oublier, d'autres tampons où darktable stocke des images intermédiaires pour un accès rapide pendant le travail interactif (cache mip map).

Dans l'ensemble, darktable a besoin d'un minimum d'environ 4 Go de mémoire pour fonctionner correctement.

mémoire total du système

D'après l'analyse ci-dessus, il est évident que votre ordinateur a besoin d'une configuration de mémoire raisonnable pour exécuter correctement darktable. Nous vous suggérons de disposer d'au moins 4 Go de RAM physique et de 4 à 8 Go d'espace d'échange supplémentaire.

Théoriquement, vous pouvez exécuter darktable avec des quantités inférieures de RAM et compenser avec suffisamment d'espace de swap. Cependant, cela pourrait mettre votre système «en difficulté», car il utilise le disque dur pour lire ou écrire des pages de données. Nous avons des rapports positifs selon lesquels cela fonctionne bien pour certains utilisateurs. Mais pour d'autres, leur système peut encore rester extrêmement lent. Un disque SSD peut améliorer légèrement les choses.

espace d'adressage disponible

Outre la quantité totale de mémoire système, il existe un autre facteur limitant : l'espace d'adressage disponible de votre architecture matérielle. La quantité de mémoire pouvant être adressée par un processus dépend du nombre de bits d'adresse offerts par votre CPU. Pour une CPU avec des registres d'adresses 32 bits, c'est 2^32 octets, ce qui fait un total de 4 Go. C'est la limite supérieure absolue de mémoire qui peut être utilisée par un processus et cela met darktable dans une situation difficile comme nous l'avons vu ci-dessus.

La porte de sortie de darktable s'appelle le tuilage. Pour chaque module de traitement, au lieu de traiter une image en un seul gros morceau, darktable la divise en parties plus petites (des tuiles). Cela nécessite encore un tampon d'entrée et de sortie, mais ces tampons intermédiaires peuvent être suffisamment petits pour tout faire rentrer dans les limites du matériel.

fragmentation de la mémoire

Malheureusement, ce n’est pas encore la fin de l’histoire. Un effet appelé fragmentation de la mémoire peut toucher et touchera les logiciels qui doivent réaliser une gestion étendue de la mémoire. Si un tel programme alloue 5 fois 300 Mo à la fois et ensuite les libère, cette mémoire devrait normalement être disponible pour une grande allocation ultérieure de 1,5 Go. Cependant ce n'est pas souvent le cas. L'allocateur de mémoire du système peut ne plus voir cette zone comme un bloc contigu de 1,5 Go mais comme une rangée de blocs séparés de 300 Mo. S'il n'y a pas d'autre zone libre de 1,5 Go disponible, une allocation ultérieure échouera. Pendant l'exécution d'un programme, ce mécanisme enlèvera de plus en plus de blocs de mémoire plus gros au profit de blocs plus petits. Le cache mip map de darktable alloue plusieurs petits blocs de mémoire par miniature, ce problème est donc encore plus important. Pour cette raison, à partir de darktable 2.0, la prise en charge des systèmes 32 bits est obsolète.

autres limitations

Comme si cela n'était pas suffisant, il y a d’autres choses qui pourraient limiter votre accès à la mémoire. Sur certaines cartes de fabrication assez ancienne, vous devez activer l’option BIOS « memory remapping » de manière à ce que toute la mémoire physique soit activée. Si, de plus, vous avez un système 32 bits, vous devrez probablement avoir un noyau avec l’option « Physical Address Extension » (PAE) activée. Ceci est souvent le cas sous Linux, mais pas toujours. De nombreuses distributions fournissent différents noyaux, certains avec et d’autres sans PAE activée, il vous faudra choisir le bon. Pour vérifier que le système est correctement configuré, utilisez la commande «free» dans un terminal et examinez la sortie. Si la sortie indique moins de RAM que celle qui est installée, vous avez alors un problème qui demande une correction : par exemple, si vous avez 4 Go sur votre carte mais que votre noyau n'en voit que 3 Go ou moins. Il vous faudra consulter le manuel de votre BIOS et les informations concernant votre variante de Linux pour plus d’informations.

configurer darktable sur un système 32 bits

Comme nous l'avons vu, les systèmes 32 bits sont des environnements difficiles pour darktable. Certains les utilisent encore pour exécuter darktable, quand les exigences de base en termes de mémoire système totale et les sujets mentionnés dans les paragraphes ci-dessus sont traités correctement.

Il existe plusieurs paramètres qui nécessitent un ajustement pour le faire fonctionner. Si vous installez une nouvelle version, darktable détectera votre système et définira des valeurs prudentes par défaut. Cependant, si vous mettez à niveau darktable à partir d'une version plus ancienne, il est probable que vous ayez des paramètres défavorables dans vos préférences. Les conséquences peuvent être un abandon de darktable en raison d'échecs d'allocation ou -- très typiquement -- darktable ne peut pas importer correctement une nouvelle pellicule. En tant que symptôme fréquent, vous obtenez pour beaucoup de vos photos des crânes affichés au lieu des miniatures.

Si tel est le cas, prenez une minute pour optimiser vos paramètres dans les préférences. Vous les trouverez dans [préférences > traitement> cpu / gpu / mémoire]../preferences-settings/processing.md#cpu--gpu--mémoire).

Voici une brève explication des paramètres pertinents et de leurs réglages proposés :

nombre de fils d'exécution

Ce paramètre définit le nombre maximum de fils d'exécution autorisés à s'exécuter en parallèle pour l'importation de pellicules ou pour d'autres tâches d'arrière-plan. Pour des raisons évidentes sur les systèmes 32 bits, vous ne pouvez avoir qu'un seul fil d'exécution consommant des ressources à la fois. Vous devez donc définir ce paramètre sur 1 ; toute valeur supérieure provoquera un plantage.

mémoire limite (en Mo) pour le tuilage

Ce paramètre indique à darktable la quantité de mémoire (en Mo) qu'il doit supposer disponible pour stocker les tampons d'image pendant les opérations du module. Si une image ne peut pas être traitée dans ces limites en un seul bloc, le tuilage prendra le relais et traitera l'image en plusieurs parties, l'une après l'autre. Fixez ce paramètre à la valeur la plus faible possible, avec 500 comme point de départ. Vous pourrez par la suite tester si vous pouvez l’augmenter un peu de manière à réduire la surcharge due au tuilage.

quantité minimale de mémoire (en Mo) pour la mémoire-tampon d'une tuile

c'est le second paramètre qui contrôle le tuilage. Il définit une limite basse pour la taille, en mégaoctets, des tampons intermédiaires. Le paramètre est nécessaire pour éviter un tuilage excessif dans certains cas (pour certains modules). Fixez ce paramètre à la faible valeur de 8. Vous pourrez tenter de l’augmenter à 16 par la suite.

mémoire en mégaoctets à utiliser pour le cache des miniatures

Ceci contrôle combien de miniatures (ou mip maps) peuvent être stockées à la fois en mémoire. Comme point de départ fixez ce nombre à quelque chose comme 256 MB. Depuis darktable 2.0, le cache doit allouer de petits buffers pour chaque miniature, causant ainsi une significative fragmentation de la mémoire. Comme expliqué auparavant, ceci pose problème aux systèmes 32-bits. Pour cette raison, à partir de darktable 2.0, le support du 32-bits est déconseillé.

darktable sur les systèmes 64-bits

Il n'y a plus grand chose à dire ici. Bien sûr, les systèmes 64 bits ont besoin d’une certaine quantité de mémoire principale, donc la recommandation de 4 Go plus le swap reste vraie. D’un autre côté, l’architecture 64 bits ne souffre pas des limitations spécifiques au 32 bits comme l’espace adressable réduit et le problème de la fragmentation.

Les CPU les plus modernes d’Intel ou AMD 64 bits ont un espace mémoire adressable dans la plage de quelques téraoctets. Le mot «moderne» est relatif dans ce contexte : tous les CPU AMD ou Intel introduits depuis 2003 et 2004 respectivement, offrent un mode 64-bits. Linux 64-bits est disponible depuis de nombreuses années.

Toutes les distributions de Linux concernées vous donnent le choix d’installer une version 32 bits ou une version 64 bits. Vous pouvez même faire tourner des binaires 32 bits sous une version 64 bits de Linux. La seule chose pour laquelle vous devrez passer un peu de temps sera la migration. Nous recommandons finalement de passer à une version 64 bits de Linux. Il n'y a vraiment aucune raison de ne pas le faire.

Sur un système à 64 bits, vous pouvez laisser en toute sécurité les paramètres de configuration du tuilage à leurs valeurs par défaut : «la mémoire limite (en Mo) pour le tuilage» devrait avoir une valeur de 1500 et «la quantité minimale de mémoire (en Mo) pour la mémoire-tampon d'une tuile» devrait être positionné à 16. Au cas où vous seriez en train d’effectuer une migration depuis un système 32 bits vers un système 64 bits, veuillez vérifier ce paramétrage et modifiez-le manuellement dans la boîte de dialogue des préférences de darktable si cela est nécessaire.

Typiquement il n'est pas nécessaire de se limiter dans le nombre de fils d'exécution sur un système 64-bits. Sur un système multi-processeurs un nombre de fils de deux à huit peut accélérer considérablement la génération des miniatures par rapport à l'utilisation d'un seul fil. La raison n'est pas tant de profiter au maximum de tous les cœurs de votre CPU -- de toute façon, le pipeline graphique de darktable les utilise tous ensemble en parallèle -- que de cacher la latence des entrées/sorties.

Une exception vaut la peine d'être mentionnée. Si vous utilisez darktable pour traiter des vues panoramiques par assemblage (par exemple des TIFFs générés par le logiciel Hugin) alors ces images peuvent atteindre des tailles considérables. Chaque fil d'exécution a besoin d'allouer suffisamment de mémoire pour garder dans ses tampons une image complète, des intermédiaires et l'image de sortie. Ceci peut rapidement conduire à un dépassement de mémoire même avec un système 64 bits bien équipé. Dans ce cas réduisez à un le nombre de fils d'exécution.

opencl

le contexte

comment travaille opencl

activer OpenCL dans darktable

configurer opencl

problèmes possibles et solutions

périphériques amd/ati

optimisation des performances

profil de planification

multiples périphériques

opencl ne fonctionne toujours pas pour moi

le contexte

Le traitement d’images en haute résolution est une tâche exigeante qui nécessite un ordinateur moderne. Que ce soit en termes de ressources mémoire et en termes de puissance du processeur CPU, tirer le meilleur partie d’une image typique de 15, 20 ou 25 mégapixels peut rapidement pousser votre ordinateur à ses limites.

Les exigences de darktable ne font pas exception. Tous les calculs se font en virgule flottante 4x32 bits. Ceci est plus lent que l’algèbre «ordinaire» en entiers 8 ou 16 bits mais élimine tous les problèmes de ruptures de ton ou de pertes d’informations.

De nombreuses optimisations ont été mises en œuvre afin de rendre darktable aussi rapide que possible. Si vous avez une version actuelle de darktable sur un système moderne, vous ne devriez pas noter de «ralentissement». Il y a cependant certaines conditions et certains modules où vous ressentirez (ou entendrez au vrombissement du ventilateur de votre CPU) la manière dont votre pauvre processeur multi-cœurs est en train de lutter.

C'est ici qu’OpenCL arrive. OpenCL nous permet de tirer avantage de l’énorme puissance des cartes graphiques modernes. Dans les jeux de tir modernes la demande des joueurs en mondes 3D très détaillés (tout comme le minage de crypto-monnaie) a favorisé le développement des GPU rapides . Afin de répondre à cette demande, AMD, NVIDIA et Co ont mis une énorme puissance de traitement dans leurs GPU. On obtient ainsi des cartes graphiques modernes avec des GPU hautement parallélisées qui peuvent calculer rapidement les surfaces et les textures à des fréquences d'images élevées.

Vous n'êtes pas un joueur et vous ne tirez pas parti de cette puissance ? Et bien vous pouvez l’utiliser au moins dans darktable ! Pour les tâches demandant des calculs fortement parallélisés en virgule flottante, les GPU modernes sont bien plus rapides que les CPU. Ceci est particulièrement vrai lorsque vous souhaitez répéter les mêmes étapes de traitement sur des millions d’éléments. Cas typique d’utilisation : traitement d’images comportant des millions de pixels.

comment travaille opencl

Comme vous pouvez l’imaginer, les architectures matérielles des GPU peuvent être très différentes. Il y a différents fabricants, et même, pour le même fabricant, différentes générations de GPU peuvent être différentes. Dans le même temps, les fabricants de GPU ne rendent pas public tous les détails matériels de leurs produits. Une des conséquences connues est la nécessité d’utiliser sous Linux des pilotes propriétaires si vous désirez tirer le maximum de votre carte graphique.

Heureusement, un consortium industriel dirigé par The Khronos Group a développé une interface ouverte et standardisée appelée OpenCL. Elle permet d’utiliser votre GPU comme dispositif de traitement numérique. OpenCL propose un langage de programmation similaire à C99 qui se concentre fortement sur le calcul parallèle. Une application qui veut utiliser OpenCL aura besoin du code source d’OpenCL qui est transmis à un compilateur OpenCL spécifique au matériel lors de l’exécution. De cette manière, l’application peut utiliser OpenCL avec différentes architectures de GPU (y-compris simultanément). Tous les «secrets» matériels sont masqués dans ce compilateur et ne sont normalement pas visibles par l’utilisateur (ou par l’application). Le code OpenCL compilé est chargé dans votre GPU et -- avec certains appels d’API -- il est prêt à effectuer des calculs pour vous.

activer OpenCL dans darktable

L’utilisation d’OpenCL dans darktable nécessite que votre PC soit équipé d’une carte graphique adaptée et que les bibliothèques requises soient installées. Les cartes graphiques modernes de NVIDIA et d'ATI prennent en charge complètement OpenCL. Le compilateur OpenCL fait normalement partie du pilote graphique propriétaire ; il est utilisé sous la forme d'une bibliothèque dynamique appelée libOpenCL.so. Cette bibliothèque doit se trouver dans un répertoire qui puisse être trouvé par l’éditeur dynamique de liens de votre système.

Quand darktable démarre, il va d’abord essayer de trouver et de charger libOpenCL.so et, en cas de succès, vérifier que la carte graphique disponible prend en charge OpenCL. Une quantité de mémoire graphique suffisante (1 Go+) doit être disponible afin de tirer parti du GPU. Si ce contrôle réussit, darktable va essayer de configurer son environnement OpenCL : un contexte de traitement doit être initialisé, un pipeline de calcul doit être démarré. Les fichiers du code source d’OpenCL (d’extension .cl) doivent être lus et compilés et les routines incluses (noyaux d’OpenCL) doivent être préparées pour les modules de darktable. Une fois tout ceci effectué avec succès, la préparation est terminée.

Par défaut OpenCL est activé dans darktable si toutes les étapes ci-dessus se sont terminées avec succès. Si vous désirez le désactiver vous pouvez le faire dans l'onglet préférences >traitement >cpu/gpu/mémoire. Ce paramètre de configuration vous indique aussi si l’initialisation d’OpenCL a échoué : il est grisé dans ce cas.

Vous pouvez à tout moment activer ou désactiver la prise en charge d’OpenCL, ce qui aura un effet immédiat. Selon le type des modules que vous utilisez, vous en remarquerez l’effet comme une accélération générale lors du travail interactif et lors de l’exportation. La plupart des modules de darktable peuvent profiter d’OpenCL mais tous ne sont pas suffisamment consommateurs de ressources pour que la différence puisse être remarquée. Afin de ressentir une vraie différence, prenez un module comme ombres et hautes lumières, renforcer la netteté, filtre passe-bas, filtre passe-haut ou encore plus extrême contrast equalizer et réduction bruit (profil).

Si vous êtes intéressé par les valeurs de profilage, vous pouvez lancer darktable avec les paramètres de la ligne de commande -d opencl -d perf. Après chaque exécution du pipeline graphique, vous allez obtenir l’allocation détaillée du temps d’exécution de chaque module avec un profil encore plus fin pour tous les noyaux OpenCL utilisés.

En dehors de l'accélération, vous ne devriez voir aucune différence dans les résultats entre le traitement CPU et GPU. À l'exception de quelques erreurs d'arrondi, les résultats sont conçus pour être identiques. Si, pour une raison quelconque, darktable ne parvient pas à terminer correctement un calcul GPU, il détectera normalement l'échec et reviendra automatiquement (et de manière transparente) au traitement CPU.

configurer opencl

La grande diversité des systèmes, les différences marquées entre les vendeurs OpenCL et les versions de pilotes, ne permettent pas de donner une vue d'ensemble de la manière de configurer OpenCL. Nous ne pouvons que vous donner un exemple pour la version du pilote NVIDIA 331.89 sur Ubuntu 14.04. Nous espérons que cela servira d'introduction de base et vous aidera à résoudre tous les problèmes spécifiques à votre configuration.

Le principe de fonctionnement d'OpenCL ressemble à ceci :

darktable > libOpenCL.so > libnvidia-opencl.so.1 > kernel driver module(s) > GPU

darktable charge dynamiquement libOpenCL.so -- une bibliothèque système qui doit être accessible au chargeur dynamique du système (ld.so).

libOpenCL.solira le fichier d'informations spécifique au vendeur (/etc/OpenCL/vendors/nvidia.icd) pour trouver la bibliothèque qui contient l’implémentation OpenCL spécifique au vendeur.

L'implémentation OpenCL spécifique au vendeur est fournie sous forme d'une bibliothèque libnvidia-opencl.so.1 qui dans notre cas est un lien symbolique vers libnvidia-opencl.so.331.89).

libnvidia-opencl.so.1 a besoin de communiquer avec les modules du noyau spécifiques au vendeur nvidia et nvidia_uvm via des fichiers spéciaux de périphériques /dev/nvidia0, /dev/nvidiactl, et /dev/nvidia-uvm.

Au démarrage du système les fichiers spéciaux de périphériques requis (/dev/nvidia*) doivent être créés. Si cela ne se produit pas par défaut sur votre système, le moyen le plus simple pour les définir et pour être sûr que tous les modules seront chargés est d'installer le paquet nvidia-modprobe.

Un compte utilisateur qui souhaite faire usage d'OpenCL à partir de darktable doit avoir des droits en lecture et en écriture sur les fichiers spéciaux de périphériques de NVIDIA. Sur certains systèmes ces fichiers autorisent par défaut un accès universel en lecture et écriture, ce qui évite les problèmes de permission mais peut être discutable en termes de sécurité du système. D'autres systèmes restreignent l'accès aux utilisateurs d'un groupe, par exemple «video». Dans ce cas votre compte utilisateur doit appartenir à ce groupe.

En résumé, les paquets qui doivent être installés dans ce cas particulier sont :

nvidia-331 (331.89-0ubuntu1~xedgers14.04.2)
nvidia-331-dev (331.89-0ubuntu1~xedgers14.04.2)
nvidia-331-uvm (331.89-0ubuntu1~xedgers14.04.2)
nvidia-libopencl1-331 (331.89-0ubuntu1~xedgers14.04.2)
nvidia-modprobe (340.24-1)
nvidia-opencl-dev:amd64 (5.5.22-3ubuntu1)
nvidia-opencl-icd-331 (331.89-0ubuntu1~xedgers14.04.2)
nvidia-settings (340.24-0ubuntu1~xedgers14.04.1)
nvidia-settings-304 (340.24-0ubuntu1~xedgers14.04.1)
nvidia-libopencl1-331 (331.89-0ubuntu1~xedgers14.04.2)
nvidia-opencl-dev:amd64 (5.5.22-3ubuntu1)
nvidia-opencl-icd-331 (331.89-0ubuntu1~xedgers14.04.2)
opencl-headers (1.2-2013.10.23-1)

La liste des modules du noyau concernant NVIDIA affichée par la commande lsmod est :

nvidia
nvidia_uvm

La liste des fichiers spéciaux de périphériques liés à NVIDIA (obtenue par la commande ls -l /dev/nvidia*) devrait ressembler à ceci :

crw-rw-rw- 1 root root 195,   0 Jul 28 21:13 /dev/nvidia0
crw-rw-rw- 1 root root 195, 255 Jul 28 21:13 /dev/nvidiactl
crw-rw-rw- 1 root root 250,   0 Jul 28 21:13 /dev/nvidia-uvm

Méfiez-vous que les numéros majeurs/mineurs (par exemple 250/0 pour /dev/nvidia-uvm dans cet exemple) peuvent varier en fonction de votre système.

problèmes possibles et solutions

darktable détecte automatiquement les problèmes d’OpenCL en cours de fonctionnement. Il effectuera alors le traitement sur le CPU ; seule la vitesse est affectée et le résutat final ne sera pas impacté.

Il peut y avoir plusieurs raisons pour lesquelles OpenCL peut échouer pendant la phase d'initialisation. OpenCL dépend des exigences matérielles et de la présence de certains pilotes et bibliothèques. De plus, tous ces éléments doivent correspondre en termes de fabricant, de modèle et de numéro de révision. Si quelque chose ne convient pas (par exemple, votre pilote graphique - chargé en tant que module de noyau - ne correspond pas à la version de votre libOpenCL.so), le support OpenCL ne sera probablement pas disponible.

Dans ce cas, la meilleure chose à faire est de démarrer darktable depuis une console par darktable -d opencl.

Ceci va donner des informations de débogage supplémentaires concernant l’initialisation et l’utilisation d’OpenCL. Regardez d’abord si vous voyez une ligne qui commence par [opencl_init] FINALLY .... Ceci doit vous indiquer si la prise en charge d’OpenCL est disponible pour vous ou pas. S’il y a un échec de l’initialisation, regardez dans les messages au-dessus s’il y a quelque chose qui ressemble à could not be detected ou could not be created. Regardez s’il y a une indication de l’endroit où l’échec a eu lieu.

Voici un certain nombre de cas observés dans le passé :

darktable peut vous indiquer qu’aucune carte graphique prenant en charge OpenCL n'a été détectée ou que la mémoire disponible sur votre GPU est trop faible et que la carte ne sera pas utilisée. Dans ce cas, il vous faudra acheter une nouvelle carte si vous désirez la prise en charge d’OpenCL.

darktable pourrait trouver votre libOpenCL.so mais vous dire ensuite qu'il ne peut obtenir de plate-forme. Les pilotes NVIDIA donnent souvent un code d’erreur -1001 dans ce cas. Ceci arrive parce que libOpenCL.so n'est qu'un encapsuleur de bibliothèque. Pour le travail réel, d'autres bibliothèques spécifiques au fournisseur doivent être chargées. Ceci a échoué pour une raison quelconque. Il y a une structure de fichiers dans/etc/OpenCL sur votre système que libOpenCL.so consulte pour rechercher ces bibliothèques. Voyez si vous pouvez trouver quelque chose de louche par là et essayez de le corriger. Souvent, les bibliothèques ne peuvent pas être trouvées par le chargeur dynamique de votre système. Donner les noms de chemin complet peut aider.

darktable peut aussi vous indiquer qu'un contexte ne peut être créé. Ceci indique souvent qu'il y a une incompatibilité de version entre le pilote graphique chargé et libOpenCL. Vérifiez que vous n'avez pas laissé de modules du noyau ou de bibliothèques graphiques provenant d’une installation plus ancienne et prenez les mesures appropriées. En cas de doute, faites une réinstallation propre de votre pilote graphique. Quelquefois, immédiatement après une mise à jour de pilote, le module du noyau ne correspond pas aux bibliothèques nouvellement installées. Dans ce cas, redémarrez votre système.

Il arrive, dans quelques rares cas, que darktable se plante durant le démarrage. Ceci peut se produire si votre configuration OpenCL est complètement cassée ou si un pilote ou une bibliothèque comporte un bogue sévère. Si vous n'arrivez pas à le corriger, vous pouvez toujours utiliser l’option de lancement de darktable --disable-opencl, qui sautera alors l’ensemble de la phase d’initialisation d’OpenCL.

darktable ne parvient pas à compiler ses fichiers source OpenCL au moment de l'exécution. Dans ce cas, vous verrez un certain nombre de messages d'erreur ressemblant à des erreurs de compilation typiques. Cela pourrait indiquer une incompatibilité entre votre implémentation OpenCL et l'interprétation de la norme par darktable. Dans ce cas, veuillez soulever un problème sur github et nous essaierons de vous aider. Veuillez également signaler si vous constatez des différences significatives entre le traitement CPU et GPU d'une image.

Il existe aussi quelques implémentation d’OpenCL sur le CPU, disponibles sous la forme de pilotes fournis par INTEL ou AMD. Nous avons remarqué qu'ils n’apportaient aucun gain en vitesse comparé à notre code CPU optimisé à la main. Par conséquent, darktable, par défaut, rejette tout simplement ces périphériques. Ce comportement peut être modifié en définissant à VRAI la variable de configuration opencl_use_cpu_devices (dans$HOME/.config/darktablerc).

périphériques amd/ati

Alors que les cartes NVIDIA et la plupart des cartes AMD/ATI modernes fonctionnent immédiatement la plupart du temps, il y a un peu plus de travail à faire pour les cartes graphiques AMD/ATI plus anciennes, c’est-à-dire celles avant les séries HD7xxx. Ceci commence avec le fait que ces cartes ne reportent à darktable qu’une partie de la mémoire totale du GPU. Pour un système possédant 1GB de mémoire, ceci donne typiquement une valeur de 512MB, une valeur que darktable refuse dans sa configuration standard parce qu'elle est insuffisante pour exécuter ses tâches. En conséquence le GPU ne sera pas utilisé.

Sur le web, vous trouverez peut-être une astuce indiquant de fixer la valeur de la variable d’environnement GPU_MAX_HEAP_SIZE à 100 dans ce cas. Bien entendu cela fera que le pilote AMD/ATI va signaler toute la mémoire installée à darktable. Cependant, il y a un problème. Sur de nombreuses (toutes ?) cartes, ceci va entraîner l’allocation des tampons sur votre ordinateur (hôte) et non sur la carte vidéo ! Dans ce cas, les accès mémoire auront besoin de passer par le bus PCI qui est lent. Ceci va vous coûter un facteur 10 ou davantage dans les performances et rendra OpenCL inutile pour vous, particulièrement lors de l’exportation de fichiers.

Une autre variable d’environnement qui modifie le comportement du pilote est GPU_MAX_ALLOC_PERCENT. Vous pourriez la mettre à 100 de manière à autoriser des allocations mémoire aussi importantes que 1 Go sur votre carte AMD/ATI. Le problème est que cela tend à faire planter darktable tôt ou tard.

Notre recommandation est de laisser ces paramètres inchangés. Souvent, votre carte sera reconnue avec 512 Mo de mémoire et une taille maximum d’allocation de 128 Mo. Il existe trois paramètres de configuration que vous pouvez assigner dans le fichier $HOME/.config/darktable/darktablercafin que les choses fonctionnent. En voici les détails :

opencl_memory_requirement

Définissez ce paramètre à 500 de manière à ce que darktable accepte les 512 Mo de mémoire graphique comme étant une quantité de mémoire suffisante.

opencl_memory_headroom

Ce paramètre contrôle la quantité de mémoire graphique (parmi celle qui est reportée par votre carte) que darktable doit laisser libre pour les pilotes et l’écran. Comme pour les systèmes AMD/ATI nous n'avons, de toutes manières, que la moitié de la mémoire RAM disponible, on peut mettre cette valeur à 0. De cette manière, les 512 Mo pourront être utilisés par darktable.

opencl_avoid_atomics

Les opérations atomiques d’OpenCL sont une manière particulière d’effectuer la synchronisation de données. Elles ne sont utilisées qu’avec certains noyaux. Malheureusement, certains (la plupart ?) dispositifs AMD/ATI sont extrêmement lents dans les opérations atomiques. Il est préférable de traiter les modules concernés par la CPU plutôt que d’accepter un code GPU très lent. Définissez ce paramètre à TRUE si vous rencontrez un traitement lent de modules comme ombres et hautes lumières, monochrome, contraste local, ou mappage global des tonalités (déprécié) ou encore si vous avez des blocages intermittents du système.

Ces recommandations ne s’appliquent pas aux cartes Radeon plus récentes des séries HD7xxx avec l’architecture GCN. En plus d’être très rapides en termes de calcul GPU, elles fonctionnent normalement directement. Vous ne devrez vous intéresser qu’à quelques options d’optimisation qui sont décrites dans la section suivante.

optimisation des performances

Certains paramètres de configuration dans $HOME/.config/darktable/darktablerc permettent d’ajuster finement les performances OpenCL de votre système. Performances, dans ce contexte signifie principalement la latence de darktable lors du travail interactif (par exemple, le temps qu'il faut pour retraiter votre pipeline graphique). Afin d’avoir un flux de travail confortable, il est essentiel de maintenir une faible latence.

Afin d'obtenir des informations de profilage, démarrez darktable depuis un terminal avec darktable -d opencl -d perf.

Après chaque retraitement du pipeline graphique -- provoqué par un changement de paramètre de module, un zoom, un déplacement de panneau, etc. -- vous obtiendrez le temps total passé dans le pipeline graphique et le temps passé dans chacun des noyaux OpenCL. La valeur la plus fiable est le temps passé dans le pipeline graphique. Veuillez noter que les temps indiqués pour chaque module individuel sont imprécis lorsque le pipeline graphique OpenCL est exécuté de manière asynchrone (voir opencl_async_pixelpipe ci-dessous).

Afin de permettre un traitement rapide du pipeline graphique avec OpenCL, il est essentiel de maintenir le GPU occupé. Toute interruption ou flux de données discontinu augmentera le temps de traitement total. Ceci est particulièrement important pour les petits tampons d’image que nous devons gérer rapidement lors du travail interactif. Ils peuvent être traités rapidement par un GPU rapide. Cependant, même les interruptions courtes du pipeline graphique peuvent rapidement devenir un goulet d’étranglement.

D’autre part, les performances de darktable lors de l’exportation de fichiers ne sont plus ou moins influencées que par la vitesse de nos algorithmes et la puissance de votre GPU. Les courts arrêts d'exécution n'ont pas d’influence sur la durée totale de l’exportation.

Le paramétrage par défaut de darktable devrait donner des performances GPU correctes sur la plupart des systèmes. Cependant, si vous désirez bidouiller un peu afin d’essayer d’améliorer les choses, voici une description des paramètres de configuration appropriés

opencl_async_pixelpipe

Cet indicateur booléen contrôle la fréquence de blocage du pipeline graphique OpenCL et récupère un état succès/échec de tous les noyaux ayant été exécutés. Pour une latence optimisée, fixez-le à VRAI, pour que darktable traite le pipeline graphique de manière synchrone et essaie d'utiliser aussi peu d’interruptions que possible. Si vous rencontrez des erreurs OpenCL, comme des échecs de noyaux, changez ce pa ramètre en FAUX. darktable va alors s’interrompre après chaque module ainsi vous pourrez isoler le problème plus facilement. Des problèmes ont été signalés avec certaines cartes ATI/AMD anciennes comme les HD57xx, qui peuvent produire une sortie corrompue si ce paramètre a la valeur VRAI. En cas de doute, laissez-le à sa valeur par défaut FAUX.

opencl_number_event_handles

Des gestionnaires d’événements sont utilisés de manière à pouvoir surveiller le succès ou l’échec des noyaux et pour obtenir des informations de profilage même si le pipeline graphique tourne de manière asynchrone. Le nombre de gestionnaires d’événements est une ressource limitée de votre pilote OpenCL. Bien entendu, ils peuvent être recyclés, mais il n'y en a qu'un certain nombre qui puissent être utilisés simultanément. Malheureusement, il n'y a aucun moyen de savoir quelles sont les limites de ressources ; darktable doit donc estimer. Notre valeur 25 par défaut est assez prudente. Vous pouvez essayer de voir si des valeurs plus importantes comme 100 donnent de meilleures performances OpenCL. Si votre pilote n'a pas assez de gestionnaires libres, vous aurez des échecs de noyaux OpenCL avec le code -5 (CL_OUT_OF_RESOURCES) ou même des plantages ou un système figé. Réduisez alors ce nombre. Une valeur 0 interdira à darktable d’utiliser un quelconque gestionnaire d’événements. Ceci empêchera darktable de surveiller correctement le succès de vos noyaux OpenCL mais évitera une certaine surcharge des pilotes. Les conséquences sont qu'un échec conduira probablement à une sortie corrompue sans notification de darktable. Ce n'est recommandé que si vous êtes certain que votre système tourne solide comme un roc. Vous pouvez aussi fixer ce paramètre à -1, ce qui signifie que darktable supposera qu'il n'y a aucune restriction du nombre de gestionnaires d’événements. Ceci n'est pas recommandé.

opencl_synch_cache

Ce paramètre, s’il est défini à "vrai", forcera darktable à aller chercher, après chaque module, les tampons d’image depuis votre GPU et à les enregistrer dans le cache du pipeline graphique. C'est une opération qui consomme beaucoup de ressources, mais elle a du sens en fonction de votre GPU (même si le GPU est plutôt lent). Dans ce cas, darktable peut en fait gagner du temps lorsque les paramètres du module ont été modifiés. Car il peut revenir à des états antérieurs mis en cache et retraiter uniquement une partie du pipeline graphique. Dans la plupart des cas, ce paramètre peut être laissé à "module actif" (sa valeur par défaut), qui mettra en cache uniquement l'entrée du module actuellement ciblé.

opencl_micro_nap

Dans un cas idéal vous garderez votre GPU occupé à 100% lors retraitement du pipeline graphique. Ceci est une bonne chose. D’autre part votre GPU est aussi nécessaire pour effectuer régulièrement des mises à jour de l’interface. Il peut arriver qu'il ne reste plus assez de temps pour cette tâche. En conséquence, vous aurez un affichage saccadé lors des défilements, des zooms et des déplacements des curseurs. Pour résoudre ce problème darktable peut ajouter des petits instants de repos dans le traitement de son pipeline graphique pour laisser le GPU respirer un peu et faire des tâches liées à la gestion de l’interface graphique. Le paramètre OpenCL opencl_micro_nap contrôle la durée en microsecondes de ces instants de repos. Vous devrez faire des essais afin de trouver la valeur optimum pour votre système. Des valeurs 0, 100, 500 et 1000 sont des bons points de départ à essayer. La valeur par défaut est de 1000.

opencl_use_pinned_memory

Lors du tuilage, d’énormes quantités de mémoire doivent être transférées entre hôte et périphérique. Sur certains périphériques (à savoir AMD), les transferts directs de mémoire vers et depuis une région arbitraire de la mémoire de l’hôte peuvent entraîner une perte très importante de performances. On peut le remarquer particulièrement lors de l’exportation de grosses images. Positionner ce paramètre de configuration VRAI indique à darktable d’utiliser un type particulier de tampon intermédiaire pour les transferts de données entre hôte et périphérique. Sur certains périphériques, ceci peut accélérer l’exportation des gros fichiers d’un facteur 2 ou 3. Les périphériques et les pilotes NVIDIA semblent avoir une technique de transfert plus efficace, même pour des régions arbitraires de la mémoire. Comme ils peuvent ne pas montrer de gain de performance et même produire des sorties déformées opencl_use_pinned_memory devrait être laissé à FAUX, pour ces périphériques, sa valeur par défaut.

opencl_building_gpuXXX

Ajoutez manuellement ce paramètre à darktablerc pour ajouter des options de compilation OpenCL supplémentaires pour votre ou vos GPU, où XXX est le nom du GPU. Ces options sont utilisées lors de la compilation des noyaux OpenCL et peuvent être fournies pour le réglage des performances ou pour contourner les bogues. Vous devez supprimer tous les noyaux existants afin de les recompiler avec les nouvelles options. Fournissez une chaîne vide à recompiler sans aucune option. Supprimez entièrement le paramètre pour recompiler avec les options par défaut.

Vous pouvez référencer votre GPU par son ID (par exemple opencl_building_gpu0) ou par son nom canonique (par exemple opencl_building_gpugeforce10606gb). Démarrez darktable avec darktable -d opencl pour trouver votre nom de GPU canonique et les options de compilation par défaut.

Par exemple, les lignes suivantes ajouteraient des options de compilation supplémentaires pour le GPU avec l'ID 0 et pour le GPU nommé "geforce10606gb" :

opencl_building_gpu0=-cl-mad-enable -cl-no-signed-zeros -cl-unsafe-math-optimizations -cl-finite-math-only -cl-fast-relaxed-math
opencl_building_gpugeforce10606gb=-cl-mad-enable -cl-no-signed-zeros

profil de planification

darktable peut utiliser le CPU ainsi qu'un ou plusieurs GPUs supportant OpenCL. En fonction des performances relatives de ces périphériques, les utilisateurs peuvent choisir parmi différents profils de planifications pour optimiser les performances. Ceci est fait par le paramètre de configuration préférences > traitement > cpu/gpu/mémoire > profil de planification OpenCL qui offre les choix suivants :

défaut

Si un GPU supportant OpenCL est trouvé, darktable l'utilise pour traiter l'image du panneau central pendant que la fenêtre de prévisualisation est traitée en parallèle par le CPU. Ceci est le réglage préférable pour des systèmes ayant un CPU raisonnablement rapide et un GPU modérément rapide. L'exacte allocation des dispositifs aux différents types de pipelines peut être ajustée avec le paramètre de configuration “opencl_device_priority” (voir multiples périphériques).

GPU très rapide

Avec ce profil de planification darktable traite séquentiellement sur le GPU le panneau central contenant l'image et la fenêtre de prévisualisation. Ceci est le réglage préférable pour les systèmes qui ont un GPU surpassant fortement le CPU.

GPUs multiples

Ce réglage est destiné aux systèmes ayant plusieurs GPUs dont les performances relatives ne diffèrent pas de manière significative. Chaque fois qu'un travail de traitement est démarré, darktable utilise tout GPU actuellement inactif mais pas le CPU. Les utilisateurs de systèmes avec une variété de GPUs auront besoin d'un meilleur contrôle sur la priorité relative de ceux-ci. Il serait préférable qu'ils choisissent le profil par “défaut” et affinent leur système avec le paramètre de configuration “opencl_device_priority” (voir multiples périphériques).

Au premier démarrage ou après détection d'une modification de la configuration du GPU de votre système, darktable essaie d'identifier le profil qui vous convient le mieux. Vous pouvez changer ceci à tout moment dans l'onglet préférences > traitement> cpu/gpu/mémoire avec effet immédiat .

multiples périphériques

Sur la plupart des systèmes, la planification des périphériques OpenCL peut être optimisée en utilisant le réglage du «profil de planification OpenCL». Cependant, si votre système est équipé de plus d'un GPU, vous pourriez souhaiter fixer manuellement la priorité relative des périphériques. Pour ce faire, vous devez sélectionner le profil de planification «par défaut» et définir vos paramètres dans le paramètre de configuration «opencl_device_priority».

Il est important de comprendre comment darktable utilise les périphériques OpenCL. Chaque séquence de traitement d’une image -- pour convertir une entrée en une sortie finale en utilisant un certain historique -- est exécutée dans ce qu'on appelle un pipeline graphique. Il y a quatre types de pipelines graphiques différents dans darktable. Un type est responsable du traitement de l’image du panneau central (ou vue complète) dans le mode chambre noire, un autre pipeline graphique traite l’image de prévisualisation de la fenêtre de navigation. Il peut y avoir une instance de chacun de ces deux pipelines graphiques en cours d'exécution à un instant donné, avec le pipeline graphique de prévisualisation et celui de l’image complète tournant en parallèle. De plus, il peut y avoir plusieurs pipelines graphiques tournant en parallèle pour effectuer l’exportation et il peut y avoir plusieurs pipelines graphiques qui génèrent les miniatures. Si un dispositif OpenCL est disponible, darktable va l’allouer dynamiquement à un pipeline graphique spécifique pour une exécution et le libérer ensuite.

La demande en calcul dépend beaucoup du type de pipeline. L'image de prévisualisation et les miniatures ont une basse résolution et peuvent être traitées rapidement. Par contre l'image du panneau central est plus gourmande. Le pipeline réalisant l'exportation complète l'est encore plus.

Le paramètre de configuration «opencl_device_priority» contient une chaîne de caractères ayant la structure suivante : a,b,c.../k,l,m.../o,p,q.../x,y,z.... Chaque lettre représente un périphérique OpenCL spécifique. Il y a quatre champs dans la chaîne des paramètres séparés par une barre oblique, chacun représente un type de pipeline graphique. a,b,c...définit les périphériques qui seront autorisés à effectuer le traitement (complet) du pipeline graphique de l’image centrale. De la même manière, des périphériques comme k,l,m... peuvent traiter le pipeline graphique de prévisualisation, les périphériques o,p,q... le pipeline graphique d’exportation, et finalement les périphériques x,y,z... le pipeline graphique de traitement des miniatures. Un champ vide signifie qu'aucun périphérique OpenCL ne peut traiter ce type de pipeline graphique.

darktable possède un système de numérotation interne, où le premier périphérique OpenCL disponible recevra le numéro « 0 ». Les périphériques suivants seront numérotés consécutivement. Ce numéro, utilisé conjointement avec le nom du périphérique, est affiché lorsque vous démarrez darktable avec darktable -d opencl. Vous pouvez indiquer un dispositif soit par son numéro, soit par son nom (la casse et les espaces ne sont pas pris en compte). Si vous avez plus d’un dispositif ayant le même nom vous devrez utiliser les numéros de périphérique afin de les différencier.

Un indicateur de périphérique peut être précédé d’un point d’exclamation !, dans ce cas, le périphérique ne pourra pas exécuter ce pipeline graphique. Vous pouvez aussi utiliser un astérisque* comme joker, qui représentera tous les périphériques non encore mentionnés explicitement dans ce groupe.

L’ordre dans un groupe a une importance -- darktable va lire la liste de la gauche vers la droite et lorsqu’il cherche à allouer un périphérique OpenCL à un pipeline graphique, il va balayer les périphériques dans cet ordre et prendra le premier périphérique libre qu'il trouvera

Si un pipeline est sur le point d'être lancé et si tous les GPUs du groupe correspondant sont occupés, darktable, par défaut, traite automatiquement l'image sur le CPU. Vous pouvez forcer le traitement sur GPU en préfixant la liste des GPUs autorisés par un signe plus +. darktable n'utilisera pas le CPU mais suspendra le traitement jusqu'à ce que le premier périphérique OpenCL soit disponible.

Le paramétrage par défaut de darktable pour «opencl_device_priority» is */!0,*/*/*.

Tout périphérique OpenCL détecté est autorisé à traiter l'image du panneau central. Le premier périphérique OpenCL (0) n'est pas autorisé à traiter le pipeline graphique de prévisualisation. En conséquence, s’il n'y a qu'un seul GPU sur votre système, le pipeline graphique de prévisualisation sera toujours traité par le CPU, réservant exclusivement votre unique GPU au panneau central contenant l’image qui demande davantage de ressources. Ceci est un paramétrage raisonnable pour la plupart des systèmes. Aucune restriction de ce type ne s’applique au pipeline de l’exportation et au pipeline des miniatures.

La valeur par défaut est un bon choix si vous n’avez qu'une carte. Si vous en avez plusieurs, cela reste un bon point de départ. Cependant, comme vos cartes peuvent avoir un niveau de puissance de calcul assez différent, cela vaut le coup de passer un peu de temps à optimiser votre liste de priorités.

Voici un exemple. Supposons que nous ayons un système avec deux périphériques, une Radeon HD7950 rapide et une GeForce GTS450 plus ancienne et plus lente. darktable (démarré avec darktable -d opencl) signalera les appareils suivants :

[opencl_init] successfully initialized.
[opencl_init] here are the internal numbers and names of
                          OpenCL devices available to darktable:
[opencl_init]           0       'GeForce GTS 450'
[opencl_init]           1       'Tahiti'
[opencl_init] FINALLY: opencl is AVAILABLE on this system.

Ici, la GeForce GTS 450 est détectée comme le premier périphérique et la Radeon HD7950 («Tahiti») comme le second. Cet ordre ne changera normalement pas à moins que la configuration du matériel ou du pilote ne soit modifiée, mais il est préférable d'utiliser des noms de périphériques plutôt que des numéros pour être en sécurité.

Comme la GTS450 est plus lente que la HD7950, un «opencl_device_priority"» optimisé devrait ressembler à : !GeForce GTS450,*/!Tahiti,*/Tahiti,*/Tahiti,*.

La GTS450 est explicitement exclue du traitement de l'image centrale, ceci est réservé à «tous» les autres périphériques (c'est à dire la HD7950/Tahiti). A l'inverse, pour le pipeline graphique de prévisualisation, le Tahiti est exclu, de sorte que seul le GTS450 est autorisé à faire le travail.

Nous souhaitons que l’exportation des fichiers et la génération des miniatures se fassent sans toucher à rien. Cependant, darktable va d’abord vérifier que le dispositif Tahiti est libre parce qu'il est le plus rapide. Si cela n'est pas le cas, il va vérifier tous les autres périphériques – en fait, uniquement la GTS450.

opencl ne fonctionne toujours pas pour moi

Comme nous l’avons dit précédemment, les systèmes OpenCL possèdent une énorme variété de configurations : différents fabricants de GPU, différents modèles de GPU, une quantité de mémoire variable pour le GPU, différents pilotes, différentes distributions, etc.

Beaucoup des problèmes potentiels n'apparaîtront qu'avec une combinaison spécifique de ces facteurs. Comme les développeurs de darktable ont seulement accès à un nombre limité de ces variantes, comprenez que nous pouvons ne pas être à même de résoudre votre problème spécifique. Nous ne pouvons pas y faire grand chose s’il n'y a aucun moyen pour nous de le reproduire.

Si rien d’autre ne peut aider, la meilleure option est de démarrer darktable par

darktable --disable-opencl

Enfin, il n'y a rien dans darktable qui ne tourne que sur un GPU. Ne laissez pas OpenCL vous décourager -- le code CPU de darktable est fortement optimisé pour les performances !

utilisation de darktable-chart

présentation

utilisation

image source

valeurs de références

processus

faire une image d'entrée pour darktable-chart

présentation

darktable-chart est un outil pour extraire les valeurs de luminance et de couleurs d'une image. Ces valeurs sont prises dans des cartes de référence couleur comme les chartes IT8.7 / 1. Le but principal de ce module est de comparer une image source (typiquement une image RAW non traitée) à une image cible (typiquement une image JPEG créée par le boîtier) et de créer un style darktable capable de convertir les valeurs de luminance et de couleur de l'image source pour produire l'image cible. Ce style utilise pour cela les modules courbe des tonalités, profil couleur d'entrée et table correspondance couleurs.

Certains boîtiers mettent à votre disposition divers modes de simulation de film. Avec l'aide du module darktable-chart et des modules sous-jacents, vous pouvez maintenant créer des styles qui reproduisent ces simulations de film.

utilisation

L'outil comporte trois onglets dans la partie supérieure et un cadre de sortie de texte dans la partie inférieure.

Le premier onglet est utilisé pour définir l'image source, le deuxième onglet définit les valeurs de référence (cible) et le troisième onglet contient les contrôles pour générer le style darktable résultant.

image source

Dans l'onglet «image source» vous définissez votre image source ce qui nécessite deux éléments. Le premier élément est un fichier d'entrée au format Lab Portable Float Map (extension .pmf). Le fichier source contient les données largement non modifiées telles que le boîtier les voit. Les détails de la prise de photos d'une carte de références couleur et la production d'un fichier de sortie .pfm sont décrits ci-dessous. Le deuxième élément est un fichier graphique contenant une description formelle de la disposition de la carte de références couleur sous-jacente (extension .cht ). Les fichiers graphiques sont généralement livrés avec votre carte de références couleur ou peuvent être téléchargés.

Dans la réalité la photo prise de la carte de références couleurs montrera quelques distorsions de perspective par rapport à la disposition définie dans le fichier graphique. Pour cette raison la disposition est affichée en tant que grille superposée à l'image et peut être modifiée.

Vous pouvez déplacer les coins de la grille en utilisant la souris pour obtenir le meilleur alignement de la grille et de l'image.

Un cadre rectangulaire est affiché pour chaque pastille et définit la zone à partir de laquelle darktable-chart échantillonnera les données en entrée nécessaires. Il peut être nécessaire de redimensionner ces rectangles de telle sorte que la zone d'échantillonnage soit suffisamment grande sans pour autant recouvrir les pastilles voisines. Utilisez le curseur «taille» situé dans la partie supérieure droite de l'interface graphique. De plus grandes valeurs conduisent à des tailles plus petites.

valeurs de références

L'onglet «valeurs de référence» détermine vers quelles valeurs cible le style résultant doit modifier l'image. Vous pouvez soit fournir des valeurs de référence sous la forme de données mesurées de votre carte de références couleur (mode «fichier cie/it8»), soit fournir une photographie (mode «color chart image») tout comme décrit ci-dessus. Cette seconde image doit aussi être fournie au format Lab Portable Float Map. Il n'est pas utile de fournir à nouveau le fichier graphique car darktable-chart prend le même que celui défini dans «image source». De nouveau vous n'avez qu'à aligner la grille et l'image et qu'à potentiellement ajuster le curseur «taille».

Dans un cas typique d'utilisation la seconde image sera basée sur le fichier JPEG produit par le boîtier. De cette façon vous pouvez créer dans darktable un style qui simule le processus du boîtier.

Dans le cadre inférieur de sortie texte vous voyez les valeurs couleur extraites des données disponibles pour chaque pastille couleur. La première colonne donne le nom de la pastille, les deuxième et troisième colonnes montrent respectivement les valeurs couleur de l'image source en format RVB et Lab. La quatrième colonne contient la valeur Lab provenant de la référence (ou du fichier graphique si aucune image référence n'a été donnée). Finalement, les cinquième et sixième colonnes indiquent à quel point les valeurs source et référence dévient en termes de valeurs delta E.

processus

Si tous les paramètres requis dans les onglets « image source » et « valeurs de référence » sont prêts, vous pouvez passer à l'onglet « processus ».

Vous devez tout d'abord indiquer à darktable-chart quelles pastilles représentent la rangée des gris. Dans la capture d'écran affichée plus haut, la rangée des gris est positionnée dans la partie inférieure du tableau de référence des couleurs, désignée par "GS00...GS23".

L'entrée "nombre de pastilles finales" définit le nombre de pastilles couleur éditables que le style résultant utilisera dans le module table correspondance couleurs.

En cliquant le bouton “processus” vous lancez le calcul.

La qualité du résultat (en termes de delta E moyen et de delta E maximum) est affichée sous le bouton. Ces données montrent à quel point le style résultant appliqué à l'image source sera en mesure de correspondre aux valeurs de référence -- plus ils sont faibles, mieux c'est.

Dès que vous êtes satisfait du résultat vous pouvez cliquer sur “exporter” et sauvegarder le style généré.

Vous fournissez un nom de style et une description du style sous lesquels le style apparaîtra ultérieurement dans darktable. darktable-chart sauvegarde le style dans un fichier ayant l'extension .dtstyle qui peut être importé dans darktable et peut être partagé avec d'autres. Voir styles.

Le bouton «exporter les données RAW comme CVS» vous permet de sauvegarder les données RAW dans un fichier CVS à des fins de débogage ou pour un usage ultérieur. darktable-chart offre une option ligne de commande pour produire un style ayant le nombre souhaité de pastilles finales à partir d'un fichier CVS fourni (voir darktable-chart).

faire une image d'entrée pour darktable-chart

Pour commencer vous avez besoin d'une photo appropriée de votre carte de références couleur au format RAW+JPEG. Il n'entre pas dans le cadre de ce manuel d'expliquer en détail la prise de cette photo, mais en quelques mots, vous avez besoin de prendre votre photo un jour de soleil vers midi avec la source de lumière (soleil) brillant juste au-dessus de la carte. Vous devez éviter tout scintillement sur l'image. La pastille blanc neutre de la rangée des gris (G00) doit se terminer à la valeur de L spécifiée dans la description de votre carte. Souvent il s'agit de L=92 et nécessite que vous sur-exposiez votre photo d'environ 1/3 de IL. Idéalement vous prenez plusieurs photos avec des expositions légèrement différentes et vous sélectionnez la bonne dans darktable. Assurez-vous que le diagramme remplit la majeure partie du cadre. Prenez un objectif ayant une longueur focale normale (par exemple équivalent 50mm) et sous-exposez un peu pour éviter le vignettage.

Vous ouvrez ensuite le fichier RAW dans darktable et désactivez la plupart des modules, spécialement le module courbe de base. Sélectionnez la matrice d'entrée standard dans le module profil de couleur d'entrée et désactiver la troncature du gamut. Sélectionnez « boîtier » dans le module balance des blancs.

Il y a une situation particulière quand votre boîtier applique automatiquement au fichier JPEG résultant des corrections d'objectif, à savoir des corrections de vignettage. Dans ce cas vous devez activer le module correction des objectifs de darktable afin que le traitement raw corresponde au JPEG. Cependant, étant donné que la correction de vignetage de darktable peut ne pas correspondre exactement à la correction intégrée à l'appareil photo, il est préférable de désactiver cette correction si possible.

Pour sortir votre image allez dans le module exporter de la table lumineuse.

Vous devez sélectionner «Lab» comme profil couleur de sortie. Cet espace de couleur n'est pas visible par défaut dans la boîte de sélection déroulante. Vous devez tout d'abord l'activer en définissant à TRUE le paramètre allow_lab_output dans le fichier $HOME/.config/darktable/darktablerc. Vous pouvez alternativement lancer darktable avec :

darktable --conf allow_lab_output=true

Puis sélectionnez «PFM (floattant)» comme format de sortie et cliquez «exporter» pour générer le fichier de l'image source.

De façon similaire vous produirez l'image correspondante de référence (cible) à partir du fichier JPEG. Cette fois aussi vous devrez désactiver tous les modules et exporter avec le profil couleur de sortie «Lab» dans un fichier au format «PMF (flottant)».

appel du programme

darktable

darktable-cli

darktable-generate-cache

darktable-chart

darktable-cltest

darktable-cmstest

purge_non_existing_images.sh

darktable

Le binaire darktable démarre darktable avec son interface graphique et ses fonctionnalités complètes. C'est la manière standard d'utiliser darktable.

darktable peut être appelé avec les paramètres de ligne de commande suivants :

darktable [-d {all,cache,camctl,camsupport,control,dev,
               fswatch,input,lighttable,lua,masks,memory,nan,
               opencl,perf,pwstorage,print,sql,ioporder,
               imageio,undo,signal}]
          [<fichier en entrée>|<répertoire des images>]
          [--version]
          [--disable-opencl]
          [--library <fichier bibliothèque>]
          [--datadir <répertoire des données>]
          [--moduledir <répertoire des modules>]
          [--tmpdir <répertoire tmp>]
          [--configdir <répertoire config de l'utilisateur>]
          [--cachedir <répertoire cache de l'utilisateur>]
          [--localedir <répertoire locale>]
          [--luacmd <commande lua>]
          [--noiseprofiles <fichier json des profils de bruit>]
          [--d-signal <signal>]
          [--d-signal-act <all,raise,connect,disconnect,print-trace>]
          [--enforce-tiling]
          [--conf <clé>=<valeur>]
          [-t <nombre de fils d'exécution openmp>]

Tous les paramètres sont optionnels. Dans la plupart des cas, les utilisateurs lanceront darktable sans paramètres supplémentaires. Dans ce cas, darktable utilise les valeurs par défaut adaptées.

-d {all,cache,camctl,camsupport,control,dev,fswatch,input,lighttable,lua,masks,memory,nan,opencl,perf,pwstorage,print,sqlioporder,imageio,undo,signal}

Cette option active la sortie de débogage vers le terminal. Il y a plusieurs sous-systèmes dans darktable et le débogage de chacun d’eux peut être activé séparément. Vous pouvez utiliser cette option plusieurs fois si vous désirez déboguer la sortie de plus d’un sous-système (e.g. darktable -d opencl -d camctl).

--d-signal <signal>

Si -d signal ou-d all est spécifié, spécifiez le signal à déboguer en utilisant cette option. Spécifiez ALL pour déboguer tous les signaux ou spécifiez le signal en utilisant son nom complet. Peut être utilisé plusieurs fois.

--d-signal-act <all,raise,connect,disconnect,print-trace>

Si -d signal ou-d all est spécifié, spécifiez le signal à déboguer en utilisant cette option.

--enforce-tiling

Force l'utilisation du tuilage, même sur des systèmes disposant de beaucoup de mémoire (pour un débogage plus facile des problèmes de tuilage).

<input file>|<image folder>

Optionnellement vous pouvez indiquer le nom de fichier d’une image ou le nom d’un dossier contenant des fichiers d’images. Si un nom de fichier est donné darktable démarre en mode chambre noire avec ce fichier ouvert. Si un nom de dossier est donné darktable démarre en mode table lumineuse avec le contenu de ce dossier comme collection courante.

--version

Avec cette option darktable affiche son numéro de version, un avis de droits d'auteur, quelques autres informations utiles et ensuite s'arrête.

--disable-opencl

Cette option empêche darktable d'initialiser le sous-système OpenCL. Utilisez cette option dans le cas de plantage de darktable au démarrage en raison d’une implémentation défectueuse d’OpenCL.

--library <library file>

Pour un accès rapide, darktable conserve les informations des images qu'il a traitées dans une base de données sqlite. Son emplacement par défaut est $HOME/.config/darktable/library.db. Vous pouvez donner un autre emplacement si, par exemple, vous désirez expérimenter sans polluer votre library.db d’origine. Si le fichier de base de données n’existe pas, darktable va le créer pour vous. Vous pouvez aussi indiquer :memory: comme nom de fichier ; dans ce cas, la base de données résidera dans la mémoire système et toutes les modifications seront perdues à l’arrêt de darktable.

Chaque fois que darktable démarre, il verrouille la bibliothèque à l'utilisateur actuel. Il le fait en écrivant l'identifiant de processus actuel (PID) dans un fichier de verrouillage <fichier de bibliothèque>.lock à côté de la bibliothèque spécifiée. Si darktable trouve un fichier de verrouillage existant pour la bibliothèque, il se terminera immédiatement.

--datadir <data directory>

Cette option définit le répertoire où darktable recherche ses données d'exécution. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont/opt/darktable/share/darktable/ et /usr/share/darktable/.

--moduledir <module directory>

darktable a une structure modulaire et organise ses modules sous forme de bibliothèques partagées à charger lors de l'exécution. Avec cette option, vous indiquez à darktable où il doit les rechercher. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont /opt/darktable/lib64/darktable/ et /usr/lib64/darktable/.

--tmpdir <tmp directory>

Emplacement où darktable enregistre ses fichiers temporaires. Si cette option n’est pas fournie, darktable utilise la valeur par défaut du système.

--configdir <config directory>

Cette option définit le répertoire où darktable enregistre la configuration propre à l’utilisateur. L’emplacement par défaut est $HOME/.config/darktable/.

--cachedir <cache directory>

darktable conserve un cache des miniatures des images pour une prévisualisation rapide et un cache des exécutables OpenCL pré-compilés pour un démarrage rapide. Par défaut, le cache est situé dans $HOME/.cache/darktable/. Il peut exister plusieurs caches de miniatures en parallèle, un pour chaque fichier de bibliothèque.

--localedir <locale directory>

Emplacement où darktable recherche ses chaînes de texte propres aux différentes langues. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont /opt/darktable/share/locale/ et /usr/share/locale/.

--luacmd <lua command>

Une chaîne contenant les commandes Lua à exécuter après l'initialisation de Lua. Ces commandes seront exécutées après votre fichier luarc.

Si Lua n'est pas compilé, cette option sera acceptée mais sera sans effet.

--noiseprofiles <noiseprofiles json file>

Le fichier json qui contient les profils de bruit spécifiques aux boîtiers. L'emplacement par défaut dépend de votre installation. Les emplacements typiques sont /opt/darktable/share/darktable/noiseprofile.json et /usr/share/darktable/noiseprofile.json.

--conf <key>=<value>

darktable prend en charge un riche ensemble de paramètres de configuration que l’utilisateur peut définir dans $HOME/.config/darktable/darktablerc. Vous pouvez écraser de manière temporaire des paramètres particuliers depuis la ligne de commande à l’aide de cette option. Ces paramètres ne seront pas enregistrés dans darktablerc à la fin du programme.

-t <num openmp threads>

nombre maximum de fils openmp à utiliser dans les sections parallèles openmp.

darktable-cli

L'exécutable darktable-cli lance la variante en ligne de commande de l’interface de darktable qui permet l’exportation d’images.

Cette variante n'ouvre aucun affichage -- elle travaille en mode console pur sans lancer d'interface graphique. Ce mode est particulièrement utile pour les serveurs exécutant des tâches en arrière-plan.

darktable-cli peut être appelé avec les paramètres suivants de la ligne de commande :

darktable-cli [<input file or folder>]
              [<xmp file>]
              <output file or folder>
              [--width <max width>]
              [--height <max height>]
              [--bpp <bpp>]
              [--hq <0|1|true|false>]
              [--upscale <0|1|true|false>]
              [--style <style name>]
              [--style-overwrite]
              [--apply-custom-presets <0|1|false|true>]
              [--out-ext <extension>]
              [--import <file or dir>]
              [--icc-type <type>]
              [--icc-file <file>]
              [--icc-intent <intent>]
              [--verbose]
              [--help [option]]
              [--core <darktable options>]

L’utilisateur doit fournir un nom de fichier d’entrée et un nom de fichier de sortie. Tous les autres paramètres sont optionnels.

<input file or folder>

Le nom du fichier en entrée ou du répertoire (contenant des images) à exporter. Si vous souhaitez développer plusieurs images ou plusieurs répertoires utilisez plutôt l'option --import.

<xmp file>

Nom optionnel d’un fichier lié XMP qui contient les données de l’historique de développement qui sera appliqué lors de l’exportation. Si cette option n’est pas donnée, darktable recherchera un fichier XMP appartenant au(x) fichier(s) d’entrée indiqué(s).

<output file or folder>

Le nom du fichier de sortie ou le répertoire de destination. Le format du fichier de sortie est dérivé de son extension ou de l'option --out-ext . Vous pouvez aussi utiliser des variables de substitution dans le nom du fichier de sortie. Pour des raisons évidentes ceci est obligatoire si vous utilisez le programme pour un répertoire contenant de nombreuses images. Si vous spécifiez le répertoire de sortie, il est recommandé de spécifier également le format de fichier avec --out-ext.

--width <max width>

Ce paramètre permet de limiter la largeur de l’image exportée au nombre de pixels indiqué.

--height <max height>

Ce paramètre permet de limiter la hauteur de l’image exportée au nombre de pixels indiqué.

--bpp <bpp>

Ce paramètre définit la profondeur de bits de l’image exportée. Les valeurs autorisées dépendent du format de fichier.

Remarque Actuellement, cette option n’est pas encore fonctionnelle. Si vous devez définir la profondeur de bits, vous devez utiliser la solution suivante :

    --core
    --conf plugins/imageio/format/<FORMAT>/bpp=<VALUE>

où<FORMAT> est le nom du format de sortie sélectionné.

--hq <0|1|true|false>

Définit s’il faut utiliser un ré-échantillonnage de haute qualité lors de l’exportation (voir le module exporter sélection pour plus de détails). Vrai par défaut.

--upscale <0|1|true|false>

Indicateur définissant s’il faut utiliser un ré-échantillonnage de haute qualité lors de l’exportation Faux par défaut.

--style <style name>

Spécifiez le nom d'un style à appliquer lors de l'exportation. Si un style est spécifié, le chemin d'accès au répertoire de configuration darktable doit également être spécifié (c'est-à-dire --core --configdir ~/.config/darktable). Par défaut, aucun style n'est spécifié.

--style-overwrite

Le style spécifié remplace l'historique au lieu d'y être ajouté.

--apply-custom-presets <0|1|false|true>

S'il faut charger data.db qui contient des préréglages et des styles. Désactiver cette option vous permet de lancer plusieurs instances de darktable-cli au prix de ne pas pouvoir utiliser l'option --style. La valeur par défaut est vrai.

--out-ext <extension>

Définissez l'extension de sortie à utiliser. Si elle est spécifiée, elle est prioritaire sur celle du <fichier de sortie>. Par défaut, elle est extraite du nom du <fichier de sortie>. La valeur par défaut est jpg si un <répertoire de sortie>est spécifié.

--import <file or dir>

Spécifiez le fichier ou le répertoire d'entrée, peut être utilisé plusieurs fois. Cette option ne peut pas être combinée avec <input file or folder>.

--icc-type <type>

Spécifiez le type de profil ICC, ce qui revient à spécifier le "profil de sortie" dans le module profil de couleur de sortie. La valeur par défaut est "image spécifiée". Utilisez--help icc-type pour obtenir une liste des types pris en charge. Voir profil couleur de sortie pour une description plus détaillée des options disponibles.

--icc-file <file>

Spécifiez le nom de fichier du profil ICC. Par défaut, un nom de fichier vide.

--icc-intent <intent>

Spécifiez l'intention de rendu. Utilisez --help icc-intent pour obtenir une liste des modes de rendu pris en charge. Voir intention de rendu pour une description plus détaillée des options disponibles.

--verbose

Activer la sortie verbeuse.

--help [option]

Donne les paramètres d'usage et quitte. Si option est spécifié, donne en plus les paramètres de l'option donnée.

--core <darktable options>

Tous les paramètres de la ligne de commande suivant --core sont passés au noyau de darktable et manipulés comme des paramètres standards. Voir la section Exécutable darktable pour une description détaillée.

darktable-generate-cache

L'exécutable darktable-generate-cache met à jour le cache des miniatures. Vous pouvez lancer ce programme, en arrière-plan quand votre ordinateur est inactif, pour générer toutes les miniatures manquantes .

darktable-generate-cache est appelé avec les paramètres suivants de la ligne de commande :

darktable-generate-cache
              [-h, --help]
              [--version]
              [--min-mip <0-8>] [-m, --max-mip <0-8>]
              [--min-imgid <N>] [--max-imgid <N>]
              [--core <darktable options>]

Tous les paramètres sont optionnels. S'il est démarré sans paramètre darktable-generate-cache utilise des valeurs par défaut raisonnables.

-h, --help

Donne des informations d'utilisation et s'arrête.

--version

Donne des informations de version et de copyright et s'arrête.

--min-mip <0 - 8>, -m, --max-mip <0 - 8>

darktable peut gérer et stocker, pour chaque image, des miniatures ayant jusqu'à huit niveaux différents de résolution. Ces paramètres définissent la résolution maximale qui doit être générée (valeur par défaut dans une plage de 0 à 2). Il n'est normalement pas nécessaire de générer ici toutes les résolutions possibles ; celles qui manquent seront générées automatiquement par darktable au moment où elles seront nécessaires. Quand on demande la génération de plusieurs résolutions à la fois, les images de plus basse résolution sont rapidement sous-échantillonnées à partir de l'image de la plus haute résolution.

--min-imgid <N>, --max-imgid <N>

Spécifie la plage d'IDs des images de la base de données sur laquelle il faut travailler. Si aucune plage n'est donnée, darktable-generate-cache générera le cache de toutes les images de la collection.

--core <darktable options>

Tous les paramètres de la ligne de commande suivant --core sont passés au noyau de darktable et manipulés comme des paramètres standards. Voir la section Exécutable darktable pour une description détaillée.

darktable-chart

Cet exécutable est un utilitaire dédié à la création de styles à partir de paires d'images telles que RAW+JPEG fournies par le boîtier. Des détails de son utilisation peuvent être trouvés dans la section utiliser darktable-chart

darktable-chart soit démarre une interface graphique soit est utilisé comme programme en ligne de commande.

darktable-chart
              [--help]
              [<input Lab pfm file>]
              [<cht file>]
              [<reference cgats/it8 or Lab pfm file>]

Tous les paramètres sont optionnels, cependant, si vous voulez fournir le deuxième nom de fichier vous devez aussi fournir le premier. Démarrer darktable-chart de cette manière ouvre une interface graphique spéciale (des détails peuvent être trouvés dans la section utiliser darktable-chart).

--help

Donne des informations d'utilisation et s'arrête.

<input Lab pfm file>

Ouvre l'utilitaire avec le fichier donné comme image source. Le fichier en entrée doit être au format Lab Portable Float Map.

<cht file>

Spécifie un fichier décrivant la disposition du diagramme de références couleur.

<reference cgats/it8 or Lab pfm file>

Spécifie les valeurs de référence, soit comme valeurs mesurées en fonction du standard CGATS, soit comme image de référence dans le format Lab Portable Float Map.

Alternativement darktable-chart peut être utilisé comme un programme en ligne de commande pour générer des fichiers de style en utilisant des fichiers CVS précédemment sauvegardés.

darktable-chart
              --csv
              <csv file>
              <number patches>
              <output dtstyle file>

Tous les paramètres sont obligatoires.

<csv file>

Un fichier CSV précédemment sauvegardé avec darktable-chart.

<number of patches>

Le nombre de pastilles de couleur à utiliser dans le paramétrage de la table correspondance couleurs du style créé.

<output dtstyle file>

Nom du fichier de style qui doit être créé.

darktable-cltest

L'exécutable darktable-cltest vérifie s'il y a sur votre système un environnement OpenCL utilisable par darktable. Il émet une sortie de débogage équivalente à celle qu'on obtient par l'appel darktable -d opencl et puis s'arrête.

darktable-cltest est appelé sans paramètre sur la ligne de commande.

darktable-cmstest

L'exécutable darktable-cmstest (sous Linux uniquement) détermine si le sous-système de votre ordinateur gérant la couleur est correctement configuré et affiche des informations utiles sur le(s) profil(s)-moniteur installé(s) .

darktable-cmstest est appelé sans paramètre sur la ligne de commande.

purge_non_existing_images.sh

Recherche et supprime des entrées de la base de données de la bibliothèque référençant des images qui n'existent plus dans le système de fichiers. Vous devez fermer darktable avant d'exécuter ce script.

Le script peut être appelé avec les paramètres suivants de la ligne de commande :

purge_non_existing_images.sh [-c|--configdir <path>]
                             [-l|--library <path>]
                             [-p|--purge]

Exécutez le script sans aucune option pour effectuer un « galop d'essai », qui génère un rapport des fichiers manquants sans engager de modifications dans la base de données.

Les options disponibles sont :

-c|--configdir <chemin>

Spécifiez le chemin d'accès au répertoire de configuration de darktable à utiliser par le script. Si cette option n'est pas fournie, l'emplacement du répertoire de configuration par défaut sera utilisé.

-l|--library <chemin>

Spécifiez le chemin d'accès au fichier de base de données library.db à analyser par le script. Si cette option n'est pas spécifiée, l'emplacement par défaut du fichier library.db sera utilisé.

-p|--purge

Supprime en fait toutes les entrées de la base de données qui font référence à des fichiers inexistants. Si l'option n'est pas fournie, un rapport sera imprimé sans engager de modifications dans la base de données.

Remarques :

Le script doit être exécuté dans un shell Unix et le client sqlite3 doit être disponible dans le chemin de recherche de la commande. Pour les systèmes Linux, ce ne sera normalement pas un problème.

Pour les systèmes Windows, vous aurez normalement besoin que l'environnement MSYS2 soit installé, comme décrit dans les [instructions pour construire darktable dans un environnement Windows](https://github.com/darktable-org/darktable/blob/master/packaging/ windows/BUILD.md). Si vous avez installé darktable à l'aide du package d'installation standard de Windows, l'emplacement du script serait normalement quelque chose comme : C:\Program Files\darktable\share\darktable\tools\purge_non_existing_images.sh.

Pour les systèmes macOS, l'application Terminal fournit un shell et le client « sqlite3 » est fourni par le système d'exploitation par défaut. Si darktable a été installé à l'aide d'un ensemble d'applications à partir d'une image dmg, l'emplacement par défaut du script serait /Applications/darktable.app/Contents/Resources/share/darktable/tools/purge_non_existing_images.sh

L'opération de suppression ne peut pas être annulée. Il est donc fortement recommandé de faire une sauvegarde de la base de données avant de purger les entrées.

variables

darktable prend en charge la substitution de variables dans un certain nombre de modules et dans les préférences. Par exemple :

Définition des noms de fichiers dans le module exporter sélection

Affichage des informations de l'image dans la ligne d'informations de l'image de la chambre noire

Affichage des informations de l'image dans les superpositions et les info-bulles de la table lumineuse (voir préférences > table lumineuse)

Placement de texte sur une image dans le module filigrane.

variables disponibles

Les variables suivantes sont disponibles, bien qu'elles ne soient pas toutes applicables dans tous les contextes :

$(ROLL_NAME) pellicule de l'image en entrée
$(FILE_FOLDER) répertoire contenant l'image en entrée
$(FILE_NAME) nom de base de l'image en entrée
$(FILE_EXTENSION) extension du fichier de l'image en entrée
$(ID) id de l'image
$(VERSION) numéro de version de l'image clonée
$(VERSION_IF_MULTI) identique à $(VERSION) mais chaîne vide si une seule version existe
$(VERSION_NAME) nom de version des métadonnées
$(SEQUENCE) nombre séquentiel dans la tâche d’exportation
$(SENSOR_WIDTH) largeur en pixels des données RAW avant le recadrage RAW
$(SENSOR_HEIGHT) hauteur en pixels des données RAW avant le recadrage RAW
$(RAW_WIDTH) largeur en pixels des données RAW après le recadrage RAW
$(RAW_HEIGHT) hauteur en pixels des données RAW après le recadrage RAW
$(CROP_WIDTH) largeur en pixels de l'image à la fin du pipeline graphique, mais avant le redimensionnement de l'exportation
$(CROP_HEIGHT) hauteur en pixels de l'image à la fin du pipeline graphique, mais avant le redimensionnement de l'exportation
$(EXPORT_WIDTH) largeur en pixels de l'image à la fin du pipeline graphique et après le redimensionnement de l'exportation
$(EXPORT_HEIGHT) hauteur en pixels de l'image à la fin du pipeline graphique et après le redimensionnement de l'exportation
$(MAX_WIDTH) largeur maximale entrée dans le module exportation
$(MAX_HEIGHT) hauteur maximale entrée dans le module exportation
$(YEAR) année de la date d'exportation
$(MONTH) mois de la date d'exportation
$(DAY) jour de la date d'exportation
$(HOUR) heure de la date d'exportation
$(MINUTE) minutes de l'heure d'exportation
$(SECOND) secondes de l'heure d'exportation
$(EXIF_YEAR) année Exif
$(EXIF_MONTH) mois Exif
$(EXIF_DAY) jour Exif
$(EXIF_HOUR) heure Exif
$(EXIF_MINUTE) minute Exif
$(EXIF_SECOND) seconde Exif
$(EXIF_ISO) valeur ISO
$(EXIF_EXPOSURE)exposition Exif
$(EXIF_EXPOSURE_BIAS) biais d'exposition Exif
$(EXIF_APERTURE) ouverture Exif
$(EXIF_FOCAL_LENGTH) longueur focale Exif
$(EXIF_FOCUS_DISTANCE) distance focale Exif
$(LONGITUDE) longitude
$(LATITUDE) latitude
$(ELEVATION) élévation
$(STARS) évaluation par étoiles (texte seulement)
$(RATING_ICONS) évaluation par étoiles (utilisant des caractères étoile)
$(LABELS) étiquettes de couleur (texte seulement)
$(LABELS_ICONS) étiquettes de couleur (utilisant des caractères puce colorée)
$(LABELS_COLORICONS) étiquettes de couleur (utilisant des icônes colorées)
$(MAKER) fabricant du boîtier
$(MODEL) modèle du boîtier
$(LENS) objectif
$(TITLE) titre d'après les métadonnées
$(DESCRIPTION) description d'après les métadonnées
$(CREATOR) créateur d'après les métadonnées
$(PUBLISHER) éditeur d'après les métadonnées
$(RIGHTS) droits d'après les métadonnées
$(TAGS) liste de mots-clés (Xmp.dc.Subject)
$(CATEGORYn(category)) nom du mot-clé de niveau n [0,9] de la catégorie sélectionnée (ou du mot-clé)
$(SIDECAR_TXT) contenu texte du fichier lié s'il existe
$(PICTURES_FOLDER) répertoire des images
$(HOME) répertoire de l'utilisateur
$(DESKTOP) répertoire du bureau
$(OPENCL_ACTIVATED) si OpenCL est activé
$(USERNAME) nom de l'utilisateur défini par le système
$(NL) caractère nouvelle ligne
$(JOBCODE) code interne de la tâche courante

substitution de variable

Toutes les variables supportent la substitution de chaîne de base inspirée de bash, bien que certains détails diffèrent.

Tous les modèles sont traités comme de simples comparaisons de chaînes de caractères. Il n'y a pas de support des expressions régulières.

Les fonctions suivantes de remplacement de chaînes sont fournies, où var est l'une des variables répertoriées ci-dessus :

$(var-default)                   Si var est vide, renvoie "défaut"

$(var+alt_value)                 Si var est défini, renvoie "alt_value" sinon renvoie une chaîne vide

$(var:offset)                    Renvoie la partie de var commençant à offset
 Si offset est négatif on compte à partir de la fin de la chaîne

$(var:offset:length)             À partir de offset, renvoie au plus lenght caractères de var
 Si offset est négatif lenght est compté à partir de la fin de var
 Si length est négatif,  il indique la fin du résultat,
 compté à partir de la fin de var et non une longueur réelle

$(var#pattern)                   Supprime "pattern" au début de var

$(var%pattern)                   Supprime "pattern" à la fin de var

$(var/pattern/replacement)       Remplace par "replacement", la première occurrence de "pattern" dans var
 Si "replacement" est vide alors "pattern" sera supprimé.

$(var//pattern/replacement)      Remplace par "replacement", toutes les occurrences de "pattern" dans var
 Si "replacement" est vide alors "pattern" sera supprimé

$(var/#pattern/replacement)      Si var commence par "pattern" alors "pattern" est remplacé par "replacement"

$(var/%pattern/replacement)      Si var se termine par "pattern" alors "pattern" est remplacé par "replacement"

$(var^)                          Met en majuscule le premier caractère de var

$(var^^)                         Met en majuscule tous les caractères de var

$(var,)                          Met en minuscule le premier caractère de var

$(var,,)                         Met en minuscule tous les caractères de var

ordre des modules par défaut

Les sections suivantes décrivent l'ordre des modules par défaut dans le nouveau flux de travail relatif à la scène et le flux de travail originel relatif à l'affichage. Notez que dans les sections suivantes, l'ordre des modules va du haut (fichier d'entrée) au bas (image de sortie).

ordre des modules relatif à la scène

L'ordre par défaut des modules lors de l'utilisation du nouveau flux de travail relatif à la scène est le suivant :

point noir/blanc raw

inverser (déprécié)

balance des blancs

reconstruire hautes lumières

aberrations chromatiques RAW

pixels chauds

réduction du bruit raw

dématriçage

réduction du bruit (profil)

flou de surface

rotation des pixels

mise à l'échelle des pixels

correction des objectifs

aberrations chromatiques

suppression de la brume

rotation et perspective

orientation

recadrer et pivoter (déprécié)

liquéfier

correction des taches (déprécié)

retouche

exposition

mappage des tonalités (déprécié)

égaliseur de ton

recadrer

filtre dégradé

correction du profil d'entrée

égaliseur originel

profil de couleur d'entrée

calibration des couleurs

diffusion/netteté

censurer

docteur néga

réduction du bruit photo astro

table correspondance couleurs

suppression des franges (déprécié)

égaliseur de contraste

filtre passe-bas

filtre passe-haut

renforcer la netteté

vibrance (déprécié)

mappage des couleurs

mixeur de canaux (déprécié)

ajustements de base(déprécié)

balance couleur

balance couleur rvb

courbe rvb

niveaux rvb

courbe de base

filmique (originel)

FILMIQUE RVB -- passage de l'espace relatif à la scène à l'espace relatif à l'affichage

3D lut

contraste lum. saturation

courbe des tonalités

niveaux

ombre et hautes lumières

zones (déprécié)

mappage global des tonalités (déprécié)

lumière d'appoint (déprécié)

contraste local

correction des couleurs

contraste de couleur

velvia

vibrance (déprécié)

zones de couleurs

lumière d'arrière-plan

coloriser

faible lumière

monochrome

grain

effet Orton (adoucir)

virage partiel

vignetage

reconstruction des couleurs

profil de couleur de sortie

homogénéisation

cadre décoratif

filigrane

légende :

en italique : non recommandé pour le flux de travail relatif à la scène

en gras : module activé par défaut

ordre des modules originel/relatif à l'affichage

L'ordre par défaut des modules lors de l'utilisation du flux de travail originel relatif à l'affichage est le suivant :

point noir/blanc raw

inverser (déprécié)

balance des blancs

reconstruire hautes lumières

aberrations chromatiques RAW

pixels chauds

réduction du bruit raw

dématriçage

réduction du bruit (profil)

mappage des tonalités (déprécié)

exposition

correction des taches (déprécié)

retouche

correction des objectifs

aberrations chromatiques

rotation et perspective

liquéfier

rotation des pixels

mise à l'échelle des pixels

orientation

recadrer et pivoter (déprécié)

égaliseur de ton

recadrer

filtre dégradé

COURBE DE BASE -- transition par défaut entre l'espace relatif à la scène et l'espace relatif à l'affichage

flou de surface

correction du profil d'entrée

suppression de la brume

profil de couleur d'entrée

calibration des couleurs

diffusion/netteté

censurer

docteur néga

ajustements de base(déprécié)

reconstruction des couleurs

table correspondance couleurs

suppression des franges (déprécié)

égaliseur originel (déprécié)

vibrance (déprécié)

balance couleur

balance couleur rvb

coloriser

vibrance (déprécié)

mappage des couleurs

lumière d'arrière-plan

réduction du bruit photo astro

mappage global des tonalités (déprécié)

ombre et hautes lumières

égaliseur de contraste

contraste local

zones de couleurs

faible lumière

monochrome

filmique (originel)

filmique rvb

3D lut

contraste lum. saturation

zones (déprécié)

courbe des tonalités

niveaux

niveaux rvb

courbe rvb

lumière d'appoint (déprécié)

correction des couleurs

renforcer la netteté

filtre passe-bas

filtre passe-haut

grain

contraste de couleur

profil de couleur de sortie

mixeur de canaux (déprécié)

effet Orton (adoucir)

vignetage

virage partiel

velvia

homogénéisation

cadre décoratif

filigrane

pipeline graphique de darktable

La plupart des applications de traitement d'image proviennent des années 90 et/ou héritent d'un flux de travail des années 90. Ces applications traitaient des images codées avec des entiers non signés de 8 bits car c'était plus efficace en termes de mémoire et de calcul. Cependant, en raison de l'utilisation d'un format entier (qui implique des erreurs d'arrondi), elles ont dû appliquer un "gamma" (essentiellement une fonction de transfert appliquant une puissance 1/2,2 ou 1/2,4 pour encoder les valeurs RVB). Elles ont aussi dû augmenter la profondeur de bit afin de réduire les erreurs d'arrondi dans les basses lumières (les humains sont très sensibles aux détails de faible luminosité). Les formats d'entiers 8 bits sont également techniquement limités à la plage 0-255. Toute valeur qui ne se trouve pas dans cette plage est tronquée.

Ces flux de travail, utilisant des représentations RVB bornées et éventuellement des transformations non linéaires pour coder des signaux RVB, sont appelés relatifs à l'affichage. Ils reposent sur l'hypothèse que l'image a été préparée pour l'affichage à un stade précoce du pipeline graphique et intègrent des hypothèses codées en dur sur les valeurs RVB du noir, du gris moyen et du blanc. La plupart des algorithmes de traitement d'image utilisés dans ces flux de travail ont été ajustés autour de ces hypothèses. Par exemple, le mode de fusion superposition attend un gris moyen encodé à 50 % (ou à 128 en codage entier).

Malheureusement, la mise à l'échelle non linéaire, qui est obligatoire pour faire fonctionner le codage entier, rompt les relations naturelles entre les valeurs de pixel. La teinte et la saturation changent de manière imprévisible, et les relations de valeur entre les pixels voisins sont dilatées ou compressées de sorte que les dégradés sont également modifiés de manière imprévisible.

Les pipelines graphiques relatifs à l'affichage cassent donc l'effet des filtres optiques (flou ou correction du flou d'un objectif), la simulation de transparence (qui repose sur des définitions optiques et géométriques de l'occultation), les couleurs et les dégradés (relations locales entre chromaticité et luminance des pixels). Ils ne s'adaptent pas bien non plus aux images HDR, ce qui a conduit au développement de nombreuses méthodes discutables de mappage local et global des tonalités et au fameux «look HDR» des années 2010.

Les ordinateurs modernes ne sont pas assujettis aux mêmes limitations de calcul que ceux des années 1990 et peuvent travailler sur des pixels aux valeurs illimitées (de 0 à + infini) et encodées en nombres réels (en utilisant des formats à virgule flottante). Ces possibilités permettent ce que nous appelons un flux de travail "relatif à la scène", dans lequel les pixels peuvent conserver leurs relations radiométriques d'origine presque tout le long du pipeline graphique. Dans le flux de travail relatif à la scène, les pixels sont préparés pour l'affichage uniquement à la dernière étape du pipeline, dans la transformation d'affichage. Cela signifie que les valeurs RVB des pixels sont maintenues proportionnelles à l'intensité de l'émission de lumière enregistrée par la caméra dans la scène, permettant une simulation de transparence précise et des émulations de filtre optique, tout en s'adaptant à n'importe quelle plage dynamique via le même algorithme (SDR aussi bien que HDR).

Cependant, les pipelines graphiques relatifs à la scène perdent les valeurs fixes pratiques du blanc, du gris moyen et du noir qui caractérisaient les pipelines relatifs à l'affichage. Le réglage de ces valeurs, en fonction de la scène et des conditions de prise de vue, incombe désormais à l'utilisateur. Cela nécessite une interface utilisateur plus complexe.

De plus, comme les valeurs relatives à la scène sont supposées avoir une signification physique, les pixels ne peuvent pas avoir une intensité nulle. Cela signifierait qu'ils n'ont pas de lumière du tout et que l'existence d'une lumière nulle casse de nombreux algorithmes physiquement précis. En fait, le blanc et le noir ne signifient rien par rapport à la scène originale, qui n'est qu'un ensemble de luminances à des intensités variables. Le flux de travail relatif à la scène vise simplement à mapper certaines luminances arbitraires de la scène sur ce qui apparaîtra en blanc ou en noir sur le support de sortie.

Les versions de darktable antérieures à 2.6 avaient un pipeline relatif à l'affichage non linéaire, supposant qu'une transformation non linéaire avait lieu au début du pipeline et que le gris moyen était par la suite codé à 50%. Cependant, tous les modules et filtres ne tronquaient pas les valeurs de pixels supérieures à 100%, laissant ouverte la possibilité de récupérer ces valeurs plus tard dans le pipeline.

La transformation de vue du module filmique, introduit dans darktable 2.6, était la première étape vers un pipeline relatif à la scène. Elle a reporté la préparation, obligatoire, non linéaire, de l'affichage à la fin du pipeline. Elle a aussi donné la possibilité de définir des valeurs personnalisées de noir, de gris et de blanc. Le module balance couleur a ensuite introduit un moyen de traiter une définition variable du gris moyen.

À partir de darktable 3.2, les utilisateurs pouvaient choisir entre deux flux de travail qui définissaient des paramètres par défaut cohérents, un choix de modules et leur ordre dans le pipeline graphique, à la fois, pour le traitement relatif à l'affichage et pour le traitement relatif à la scène.

Dans darktable 3.4, une option complète de masquage et de fusion relative à la scène a été introduite, permettant de définir des masques pour des valeurs de pixel supérieures à 100% et utilisant uniquement des opérateurs de fusion non bornés.

Le passage à relatif à la scène est un saut cognitif pour les utilisateurs les plus expérimentés, qui sont habitués à penser relatif à l'affichage. Dans un flux de travail relatif à l'affichage, il est habituel d'ancrer la valeur du blanc et de laisser les réglages de ton tourner autour de ce point, en essayant de maximiser la luminosité tout en évitant l'écrêtage. Dans un flux de travail relatif à la scène, les valeurs du blanc et du noir sont libres et adaptées au support de sortie. Il est conseillé aux utilisateurs d'ancrer le gris moyen (qui sera conservé tel quel pour tout support de sortie) et de laisser la transformation de vue (filmique) dilater ou contracter la plage dynamique autour de ce point. Étant donné que le blanc HDR 10 bits est 4 fois plus brillant que le blanc SDR 8 bits, toute définition rigide du «blanc» devient non pertinente. Mais l'ancrage du gris moyen est en fait plus pratique, car il maintient la luminosité moyenne de l'image inchangée pendant la transformation de la vue.

Certains modules (niveaux, niveaux rvb, courbe des tonalités, courbe rvb) sont intrinsèquement incompatibles avec un flux de travail relatif à la scène, car leur interface graphique suggère implicitement des valeurs RVB limitées dans la plage de 0 à 100%. Les opérations sur les pixels qu'ils exécutent sont non bornées en interne et peuvent être utilisées dans des flux de travail relatif à la scène ou relatif à l'affichage. Mais leur interface de contrôle ne permet pas que des pixels soient sélectionnés en dehors de la plage de 0 à 100%.

De même, les modes de fusion tels que superposer, lumière linéaire, lumière douce, lumière dure, assombrir, éclaircir, etc. ont tous des seuils codés en dur qui attendent en interne un codage non linéaire relatif à l'affichage.

Dans darktable 3.4 et les versions ultérieures, le passage du curseur sur un en-tête de module affiche une info-bulle détaillant les espaces colorimétriques, les plages et les encodages que le module attend, utilise et produit. Voici les définitions des termes utilisés :

linéaire

Les valeurs de pixel sont proportionnelles à l'émission radiométrique de la scène, de manière à permettre une émulation précise des filtres physiques.

non linéaire

Les valeurs de pixel sont redimensionnées de telle sorte que les basses lumières reçoivent une plage de codage plus large, généralement pour que le gris moyen de référence de 18,45% ait alors une valeur comprise entre 46 et 50%.

relatif à l'affichage

Les valeurs de pixel sont censées se situer entre 0 et 100% de la plage d'affichage, où 100% est considéré comme la luminance d'une surface blanche réfléchissante à 20% (la pastille blanche d'un Color Checker) et 0% est compris comme densité maximale du support de sortie (encre noire saturée ou rétroéclairage minimum du panneau LED).

relatif à la scène

Les valeurs de pixel doivent être strictement supérieures à zéro et aller jusqu'à + infini. La signification des valeurs spécifiques des pixels doit être définie par l'utilisateur lors de l'exécution. Les valeurs relatives à la scène n'impliquent pas automatiquement un codage linéaire, mis à l'échelle dans le cadre de la radiométrie.

prise en charge des périphériques midi

Le système de mappage de raccourcis a été largement testé avec le Behringer X-Touch Mini et contient un code personnalisé pour gérer les fonctionnalités spécifiques de cet appareil. Tous les autres appareils sont traités comme des « midi génériques » et peuvent ou peuvent ne pas fonctionner (bien) ou nécessiter une configuration manuelle à chaque fois. Un cadre de configuration (éventuellement en Lua) pour prendre en charge des fonctionnalités supplémentaires spécifiques à l'appareil est sur la liste des tâches.

Behringer X-touch Mini

L'appareil doit être en mode standard (pas MC). Les couches A et B sont cependant quelque peu prises en charge, car l'appareil n'envoie pas de notification lors du basculement entre les couches, et puisque les mises à jour des rotors et des lumières "cachés" (à la fois sous les boutons et le motif utilisé autour des rotors) sont ignorées, tout ne sera complètement mis à jour qu'après avoir appuyé ou tourné quelque chose dans le "nouveau" calque.

Les anneaux lumineux autour des rotors montrent un motif différent selon que le curseur associé a une plage +/- symétrique centrée autour de 0, 0-100 (ou 0-1) ou autre. S'il est lié à une liste déroulante (ou à un nombre d'étoiles), le rotor allumera une lumière à la fois. Si la liste déroulante contient de nombreux éléments (plus de 13) (comme la liste déroulante du mode de fusion), le rotor fera le tour deux fois ; la première fois avec une lumière allumée et la deuxième fois avec deux lumières adjacentes.

Arturia Beatstep

Les rotors individuels peuvent être configurés pour envoyer des valeurs absolues (0-127) ou des changements (+/- 1,2,3,... dans différents encodages). Le réglage recommandé est Relative #1 pour tous les boutons avec Knob Acceleration réglé sur Slow (Off) ou Medium. Cela peut être configuré avec [Midi Control Center] (https://www.arturia.com/support/downloads&manuals), disponible pour Windows ou MacOS. Par défaut, le module midi de darktable suppose, pour les appareils inconnus, que les rotors utilisent des encodages absolus. Après le démarrage, il faut donc lui dire que l'appareil envoie des mouvements relatifs. Vous pouvez le faire en tournant lentement l'un des encodeurs vers la gauche (vers le bas) 5 fois. Cela permet au module de déterminer lequel des encodages relatifs est utilisé. Si vous ne parvenez pas à changer d'encodage du premier coup, vous pouvez réinitialiser les modules d'entrée en appuyant sur Ctrl+Maj+Alt+I et réessayer. Si vous rencontrez toujours des problèmes, vous pouvez essayer [ceci] (https://wd40.co.uk/product/fast-drying-contact-cleaner/).

Si vous associez les boutons du Beatstep à des notes, des étiquettes de couleur ou des boutons à bascule, ils devraient s'allumer lorsque l'élément correspondant est allumé.

Behringer BCR2000

(et peut-être BCF2000)

Ces machines sont hautement configurables, il existe donc de nombreux paramètres qui pourraient compliquer l'interaction avec le module midi de darktable. L'outil BC Manager (disponible pour Windows et MacOS) peut être utilisé pour les configurer. La chose la plus simple à faire est de réinitialiser tous les encodeurs et boutons à leurs paramètres les plus simples, ce qui peut être fait (pour le BCR2000) en utilisant [ce fichier] (https://github.com/dterrahe/darktable/files/6539400/bcr2000. tous.les.boutons.et.encodeurs.zip). Vous pouvez l'envoyer à la machine avec BC Manager ou (sous Linux) avec amidi. Il existe également un paramètre global appelé "Deadtime" qui détermine combien de temps le BCR ignore les messages arrivant après l'envoi des mises à jour. C'est pour éviter les boucles de rétroaction, mais pour darktable, cela signifie qu'il bloque les ajustements renvoyés immédiatement après chaque mouvement du rotor. Le temps mort doit donc être défini sur 0.

Une fois configurés de cette manière, les voyants des boutons et du rotor devraient tous fonctionner. La rangée supérieure de rotors (ou la seule rangée pour le BCF2000) prend en charge différents modèles de lumière (comme le X-Touch Midi, avec quelques options supplémentaires et il a 15 LED au lieu de 13). Cependant, leur configuration est plus compliquée et n'est pas encore implémentée. Cela semble également être plus lent, donc peut ne pas être faisable en temps réel pour chaque mise à jour (comme c'est le cas pour le X-touch). Ainsi, pour le moment, seul le motif à 12 points est utilisé. Pour les rotors liés à des listes déroulantes, tout comme sur le X-touch le rotor, la lumière fait deux tours ; pour les 15 premières options, une seule lumière s'allume, pour les 15 secondes options, deux lumières adjacentes seront allumées.

Loupedeck

(et Loupedeck+ mais pas les derniers appareils non-midi)

D'après les informations fournies [ici] (https://discuss.pixls.us/t/midi-controller-for-darktable/2582/92), la plupart des fonctionnalités des deux premiers modèles de loupedeck (tous deux basés sur midi) devraient être pris en charge, avec les exceptions et mises en garde suivantes :

les boutons Hue/Sat/Lum peuvent être mappés sur les onglets du bloc-notes dans le module des zones de couleur, mais les petites lumières à côté d'eux peuvent ne pas répondre aux messages de mise à jour envoyés lorsque l'utilisateur change d'onglet à l'aide de la souris, ils peuvent donc se désynchroniser.

les 8 curseurs/roues peuvent être mappés individuellement sur les éléments du graphique dans les zones de couleur.

A part ça, comme le loupedeck utilise l'encodage relatif (il est donc similaire au Beatstep) il devra le dire au module midi à chaque démarrage (jusqu'à ce qu'un système de configuration soit implémenté). Pour ce faire, tournez l'un des boutons (ou roues) lentement vers le bas/la gauche 5 fois. Réinitialisez la couche d'entrée avec Ctrl+Maj+Alt+I si cela n'a pas fonctionné la première fois afin que vous puissiez réessayer.

Korg nanoKONTROL2

L'appareil doit d'abord être configuré à l'aide de l'application Korg Kontrol Editor pour être en mode CC et chaque bouton doit être défini sur le type Note et le comportement du bouton sur Momentané. Pour contrôler les lumières des boutons, le mode LED doit être réglé sur Externe. Il est important de noter que les boutons Track et Marker n'ont pas de leds.

Il existe un profil Kontrol Editor disponible [ici] (https://github.com/darktable-org/darktable/files/7603658/note_buttons.zip) qui peut être chargé à l'aide de l'application Windows pour configurer directement tous ces paramètres pour qu'ils fonctionnent correctement avec darktable.

contribuer à dtdocs

Cette page définit le guide de style pour dtdocs et donne des informations sur la manière de contribuer au projet.

La page est incluse dans le manuel de l'utilisateur afin que vous puissiez voir comment elle est écrite et rendue. Veuillez aller sur GitHub pour voir la source de cette page.

La structure et le contenu du manuel ont été soigneusement étudiés sur la base des critères suivants :

Le manuel doit être complet - il doit décrire toutes les fonctionnalités disponibles dans darktable.

Il doit avoir une structure cohérente et logique ; et chaque élément de fonctionnalité doit apparaître à sa place logique propre dans cette structure.

Il doit être aussi long que nécessaire mais aussi court que possible -- la concision est une nécessité.

Il doit être factuel.

La fonctionnalité doit être expliquée une et une seule fois (à l'exception des directives de base sur le flux de travail dans la section d'aperçu).

Les images ne doivent être incluses que si elle sont indispensable à la compréhension de principes clés. Elles ne doivent pas contenir de texte, sauf si cela est inévitable.

Nous ne sommes en général pas intéressés par :

Une restructuration du manuel.

Un changement de langage de markup.

Des tutoriels détaillés de flux de travail (par contre, nous sommes intéressés à les publier sur les blogs de darktable.org, pixls.us ou darktable.fr ).

Nous sommes intéressés par :

Les corrections orthographiques et syntaxiques.

La clarification de texte.

La documentation de nouvelles fonctionnalités.

Nous sommes toujours extrêmement intéressés de savoir quelles sont les sections du manuel que vous n'avez pas trouvé intelligibles et pourquoi, afin que nous puissions améliorer cette documentation.

En général, si vous souhaitez apporter un changement majeur, veuillez ouvrir un ticket et en discuter tout d'abord avec les mainteneurs. Ceci afin de vous éviter un travail qui ne serait pas accepté.

format

Ce site Web est créé en pure markdown, en utilisant certaines extensions. Il est initialement conçu pour fonctionner avec Hugo SSG, mais il est suffisamment portable pour pouvoir être facilement rendu avec une autre application si nécessaire.

Les fichiers doivent être rendu en UTF-8 et ne doivent pas inclure de retour à la ligne automatique.

structure

Ce qui suit montre la structure d'un exemple de chapitre principal avec des sous-sections sur le site Web dtdocs.

example-chapter/
   _index.md
   section1-with-subsections/
      subsection1/
         image.png
      _index.md
      subsection1.md
      subsection2.md
   section2.md
   section3.md

Quelques notes sur la structure ci-dessus :

Les fichiers _index.md ne contiennent aucun contenu (ils contiennent uniquement des métadonnées) et sont utilisés pour rendre les en-têtes de section et les entrées de la table des matières. Dans l'exemple ci-dessus, example-chapter/_index.md définit le titre de l'exemple de chapitre et l'ordre dans lequel il apparaît dans la table des matières principale. De même, example-chapter/section1-with-subsections/_index.md définit les métadonnées pour la première section du chapitre.

Les fichiers multimédias doivent être contenus dans un répertoire portant le même nom que la page à laquelle ils se rapportent. Dans cet exemple, example-chapter/section1-with-subsections/subsection1 contient un média lié à la page subsection1.md.

métadonnées

Les métadonnées des fichiers markdown sont présentées en tête de page à l'aide de yaml. Toutes les métadonnées peuvent être définies - les sections de référence du module contiennent beaucoup de métadonnées spécifiques - cependant ce qui suit définit quelques métadonnées minimales pour la page d'exemple example-chapter/section1-with-subsections/subsection1.md.

---
title: Sub Section 1 Title
id: subsection1
weight: 10
---

title

Cela doit contenir le titre rendu de votre page. Pour inclure un deux-points dans un titre, placez le titre entre guillemets.

id

C'est l'identifiant utilisé pour identifier la page par Hugo. Il doit généralement avoir le même nom que le fichier (pour les fichiers de contenu) ou le répertoire parent (pour les fichiers _index.md).

weight

Il s'agit d'un champ de métadonnées facultatif utilisé pour définir l'ordre dans lequel les sections sont présentées dans la table des matières. Si le champ weight n'est pas inclus, les pages seront rendues dans l'ordre alphabétique par défaut. Par exemple, pour définir les sections et sous-sections de l'exemple ci-dessus dans l'ordre inverse, les métadonnées suivantes doivent être définies :

   example-chapter/
      section1-with-subsections/
         _index.md               # weight : 30 (place la page section1 à la fin de example-chapter)
         subsection1.md             # weight : 20 (place la  page subsection1 à la fin de la section1)
         subsection2.md             # weight : 10 (place la page subsection2 à la fin de la section1)
      section2.md                # weight : 20 (place la section2 au milieu de example-chapter)
      section3.md                # weight : 10 (place la section3 au début de example-chapter)

contenu

conseils généraux de style

Tout le contenu doit être rédigé en clair sans code abrégé et le HTML doit être réduit au minimum absolu, s'il est utilisé.

Le minimalisme est un must absolu. Le moins de mots possible est préféré

Les fichiers Markdown doivent être aussi courts que possible

Suivez les normes de dénomination et de capitalisation présentes dans l'interface graphique de l'application -- à savoir que tous les en-têtes et titres sont en minuscules, à l'exception des noms de chapitre de très haut niveau

Les en-têtes dans un fichier ne doivent pas dépasser le niveau trois (###)

La langue de création principale est l'anglais

Supposez que le lecteur a ouvert l'application lors de la lecture du manuel d'utilisation et n'incluez que des images où elles contribuent à l'explication de fonctionnalités complexes

Utilisez des références si vous avez besoin d'annoter une image (c.-à-d. Marquez des parties de l'image avec une lettre ou un chiffre, puis expliquez la signification dans un texte suivant l'image). Ne placez pas de mots directement dans l'image pour les annotations, car cela rend la localisation difficile. Voir cette page pour un exemple.

Les modifications du contenu doivent être proposées via une pull request ou un mécanisme similaire

Vos soumissions seront modifiées -- ne le prenez pas mal

listes de définitions

La méthode standard de présentation des informations concernant les contrôles des modules de darktable consiste à utiliser des listes de définitions.

nom d'un contrôle de l'interface graphique

Une déclaration de ce que fait le contrôle. Par exemple "Réglez l'exposition en unités EV"

Vous pouvez inclure autant de paragraphes que vous le souhaitez, mais essayez de limiter leur nombre à 2 ou 3 si possible.

active-icon un contrôle accessible via un bouton avec une icône

Lorsqu'un contrôle est activé à l'aide d'une icône, prenez une capture d'écran de l'icône en utilisant le thème standard de darktable et ajoutez-le avant le nom du contrôle

nom de la zone de liste déroulante de l'interface

Les les zones de liste déroulante ont souvent plusieurs options qui doivent toutes être affichées avec des définitions séparées. Utilisez des listes à puces avec italiques pour les valeurs de la zone de liste déroulante.

la première valeur : ce que signifie la première valeur

la seconde valeur : ce que signifie la seconde valeur

Les listes de définitions sont également utilisées dans tout le document, partout où une fonctionnalité nommée doit être définie. Voir, par exemple, darktable-cli.

remarques

Si vous souhaitez présenter une remarque importante à l'utilisateur, utilisez le format suivant :

Remarque : Ceci est une remarque importante.

polices à largeur fixe et blocs de code

Les polices à largeur fixe (utilisant le caractère `) ne doivent normalement être utilisées que pour les blocs de code et lors du référencement des noms de fichiers et des paramètres de la ligne de commande.

liens

Les liens internes doivent être relatifs au fichier actuel et doivent pointer vers un fichier markdown (.md) valide. Commencez les liens avec soit ./ Pour représenter le répertoire courant ou ../ pour représenter le répertoire parent.

Les liens vers un module de traitement doivent être en italique, par ex. exposition

Les liens vers un module utilitaire doivent être en texte brut, par exemple historique

Lien vers une section de niveau supérieur en référençant le fichier _index.md, par ex. référence des modules

Lien vers un onglet dans la boîte de dialogue des préférences : préférences > général

Lien vers un paramètre spécifique des préférences : préférences > général > langue pour l'interface

Chaque en-tête d'une page peut être lié directement avec un lien d'ancrage : contribution/remarques

images

Lorsque vous prenez des captures d'écran de l'application darktable elle-même, utilisez le thème darktable par défaut.

Plusieurs suffixes de nom de fichier peuvent être utilisés pour contrôler la façon dont une image est rendue.

icône

Pour insérer une image sous forme d'icône, incluez #icon après le nom de l'image dans le lien. Le markdown ![squirrel icon](./contributing/contributing.png#icon) affiche ce qui suit : squirrel icon

largeur de l'image

Vous pouvez définir la largeur de l'image à 25, 33, 50, 66, 75 ou 100% de la largeur de la page rendue en incluant #wxx après le nom de l'image dans le lien, où xx est la largeur souhaitée. Par exemple :

![squirrel](./contributing/squirrel.png#w25) affiche

![squirrel](./contributing/squirrel.png#w75) affiche

en ligne

À l'exception des icônes, les images sont incluses en tant qu'éléments de bloc par défaut. Vous pouvez remplacer cela en incluant #inline après le nom de l'image. Cela peut être combiné avec le paramètre de largeur comme suit.

![squirrel](./contributing/squirrel.png#w25#inline) affiche squirrel

défaut

Par défaut, les images sont présentées sous forme d'éléments de bloc avec une largeur de 100%. Donc ![squirrel](./contribution/squirrel.png#w100) et ![squirrel](./contribution/squirrel.png) sont équivalents et les deux produisent ce qui suit :

traduire dtdocs

Traduire la documentation de darktable se fait via notre instance de Weblate.

Vous pouvez soit utiliser l'interface utilisateur Web de Weblate pour traduire la documentation, soit télécharger la traduction de Weblate sur votre ordinateur, la modifier, puis téléverser les modifications.

Veuillez effectuer tous les travaux de traduction via Weblate. Nous n'accepterons pas les pull resquests directement sur github pour mettre à jour les fichiers PO.

Créer une nouvelle branche dans git

Créez une nouvelle branche pour y travailler dans git. Par exemple : git checkout -b fr-translation-init

Ajouter une nouvelle langue à Hugo

Dans les fichiers config.yaml et config-pdf.yaml, localisez la ligne languages:.

Ajoutez la langue que vous souhaitez traduire. Par exemple, l'anglais ressemble à ceci :

  en-us:
    title: darktable 3.4 user manual
    weight: 1

Enregistrez les fichiers.

Générer un fichier PO

Effectuez les étapes suivantes si vous souhaitez mettre à jour les fichiers POT et PO à partir de la source markdown.

Créez un fichier PO vide pour votre langue dans le répertoire po avec le nom de fichier content.<langue>.po. Par exemple : touch po/content.fr-fr.po

Exécutez le script pour remplir le fichier PO : cd tools/ && ./generate-translations.sh --no-translations

Générer des fichiers traduits

Suivez les étapes suivantes pour générer les fichiers du site Web à partir d'une traduction.

Générer les fichiers traduits : cd tools/ && ./generate-translations.sh --no-update.

Vérifiez la traduction en démarrant le serveur interne de Hugo : hugo server

Ouvrez un navigateur Web et vérifiez les modifications. L'URL est dans la sortie de la commande hugo server.

Supprimez les fichiers traduits, car nous ne les archivons jamais dans git : cd tools/ && ./generate-translations.sh --rm-translations.

Traduction de chaînes de sites Web, epub et PDF

Il existe deux thèmes pour la documentation de darktable : un pour le site Web HTML et un pour le PDF. Vous devrez traduire les chaînes pour les deux.

Allez dans themes/hugo-darktable-docs-themes/i18n.

Copiez le contenu du fichier en.yaml et nommez le nouveau fichier <votre langue>.yaml.

Traduisez le contenu du nouveau fichier yaml.

Vérifiez le fichier PO traduit dans git, poussez-le vers github et ouvrez une pull request pour que vos modifications soient acceptées.

Répétez les quatre dernières étapes pour les autres thèmes, themes/hugo-darktable-docs-epub-themeet themes/hugo-darktable-docs-pdf-theme.

Intégration de nouvelles traductions de Weblate

Ce qui suit suppose que votre répertoire de travail git soit propre, que vous ayez un accès API à l'instance Weblate, que vous ayez configuré le dépôt git Weblate en distant dans votre git local dtdocs, et que wlc, le client en ligne de commande de Weblate, soit configuré.

Validez toutes les modifications dans Weblate : wlc commit darktable/dtdocs

Verrouillez le projet Weblate pour empêcher d'autres modifications : wlc lock darktable/dtdocs

Dans votre git local dtdocs, créez une nouvelle branche : git checkout -b po-updates

Mettre à jour le Weblate distant : git remote update weblate

Fusionnez les modifications Weblate dans votre branche créée localement : git merge weblate/master

Réduisez à un tous les commits Weblate, car il y en a tellement : git reset $(git merge-base master $(git rev-parse --abbrev-ref HEAD))

Déclarer les fichiers PO modifiés : git add -A

Validez les fichiers PO (en provenance de Weblate) : git commit -m "Updated with the PO files from weblate."

Mettez à jour les fichiers POT et PO : cd tools/ && ./generate-translations.sh --no-translations && cd ..

Déclarez les fichiers POT et PO : git add -A

Validez les fichiers POT et PO : git commit -m "Updated POT and PO files."

Faites une demande d'intégration (Pull Request) sur Github.

Une fois la demande d'intégration acceptée, réinitialisez le dépôt Weblate pour qu'il corresponde au dépôt dtdocs : wlc reset darktable/dtdocs