.\"

.\" Page Man de dcraw

.\"

.\" Copyright (c) 2015 by David Coffin

.\"

.\" Vous pouvez distribuer sans aucune restriction.

.\"

.\" David Coffin

.\" dcoffin a cybercom o net

.\" http://www.cybercom.net/~dcoffin

.\"

.TH dcraw 1 "3 mars 2015"

.LO 1

.SH NOM

dcraw - décodeur en ligne de commande de photos numériques raw

.SH SYNOPSIS

.B dcraw

[\fIOPTION\fR]... [\fIFICHIER\fR]...

.SH DESCRIPTION

.B dcraw

décode des photos numériques raw, affiche les métadonnées et

extrait les vignettes

.SH OPTIONS GENERALES

.TP

.B -v

affiche les messages complets, pas uniquement les erreurs et les

avertissements.

.TP

.B -c

Ecrit les images décodées et les vignettes sur la sortie standard.

.TP

.B -e

Extrait la vignette générée par l'appareil photo (et pas l'image

raw) Vous obtiendrez soit un fichier JPEG soit un fichier PPM en

fonction de l'appareil photo.

.TP

.B -z

Change les dates d'accès et de modification d'un fichier AVI,

JPEG, TIFF ou raw à la date de prise de la photo en supposant que

l'horloge de l'appareil photo soit fixée sur le Temps Universel.

.TP

.B -i

Identifie les fichiers sans les décoder.

Le code de sortie est 0 si

.B dcraw

peut décoder le dernier fichier, 1 sinon.

.B -i -v

montre les métadonnées.

.TP

.B ""

.B dcraw

ne peut pas décoder les fichiers JPEG !!

.SH OPTION DE REPARATION

.TP

.B -I

Lit les pixels bruts depuis l'entrée standard selon l'ordre des

octets du processeur. Utilisez

.B dcraw -E -4

pour obtenir les valeurs brutes des pixels.

.TP

.B -P pixelsmorts.txt

Lit la liste des pixels morts depuis ce fichier au lieu de ".badpixels".

Voir

.B FICHIERS

pour une description du format.

.TP

.B -K noir.pgm

Soustrait un noir de la donnée raw.  Pour créer un noir, prendre

une photo dans le noir et exécuter

.BR dcraw\ -D\ -4\ -j\ -t\ 0 .

.TP

.B -k niveau_noir

Quand les zones sombres apparaissent brumeuses vous devez augmenter le

niveau de noir.

Pour le mesurer appliquer

.B pamsumm -mean

au noir généré ci-dessus.

.TP

.B -S saturation

Quand les zones claires apparaissent rosées vous devez baisser le niveau

de saturation.

Pour le mesurer prenez une image de quelque chose de brillant et faite

.B dcraw -D -4 -j -c

photo.raw

.B | pamsumm -max

.TP

.B ""

Par défaut le niveau de noir et la saturation sont normalement corrects.

.TP

.B -n seuil_du_bruit

Utilise des ondelettes pour supprimer le bruit tout en préservant

les vrais détails.  Le meilleur seuil devrait se trouver quelque

part entre 100 et 1000.

.TP

.B -C mag_rouge mag_bleu

Agrandit les couches bleue et rouge des facteurs passés en paramètre,

typiquement de 0.999 à 1.001 pour corriger l'aberration chromatique.

.TP

.B -H 0

Limite les zones claires à du blanc pur (par défaut).

.TP

.B -H 1

Laisse les zones claires sans limite (différentes teintes rosées

peuvent apparaitre).

.TP

.B -H 2

Combine les valeurs de pixels limitées et illimitées de façon à

obtenir un transition graduelle vers les blancs.

.TP

.B -H 3+

Reconstruit les zones claires.  Les petites valeurs favorisent

les blancs, les valeurs importantes favorisent les couleurs.

Essayez

.B -H 5

comme un compromis.  Si cela n'est pas assez bon utilisez

.BR -H\ 9 ,

supprimez les zones claires non blanches et copiez les dans une

image générée avec

.BR -H\ 3 .

.SH OPTIONS DES COULEURS

Par défaut,

.B dcraw

Utilise une balance des blancs fixe basée sur une carte couleur

éclairée par une lampe D65 standard.

.TP

.B -w

Utilise la balance des blancs de la caméra.

Si elle n'est pas trouvée, un avertissement est affiché et une autre

méthode est utilisée.

.TP

.B -a

Calcule la balance des blancs en moyennant toute l'image.

.TP

.B -A gauche haut largeur hauteur

Calcule la balance des blancs en moyennant une zone rectangulaire.

Utilisez

.B dcraw\ -j\ -t\ 0

et sélectionnez une zone de couleur gris neutre.

.TP

.B -r mul0 mul1 mul2 mul3

Précisez votre propre balance des blancs.

Ces coefficients multiplicateurs peuvent être copiés et collés depuis

la sortie de

.BR dcraw\ -v .

.TP

.BR +M " ou " -M

Utilise (ou n'utilise pas) une matrice de couleurs contenue dans les

métadonnées de l'appareil photo.

La valeur par défaut est

.B +M

si

.B -w

est activé ou si la photo est au format DNG,

.B -M

sinon. A part DNG,

cette opinion est applicable aux appareils Olympus, Leaf et Phase One.

.TP

.B -o [0-6]

Sélectionne l'espace de couleur de sortie quand l'option

.B -p

n'est pas utilisée :

.B \t0

\ \ couleur raw (différente pour chaque appareil photo)

.br

.B \t1

\ \ sRGB D65 (par défaut)

.br

.B \t2

\ \ Adobe RGB (1998) D65

.br

.B \t3

\ \ Wide Gamut RGB D65

.br

.B \t4

\ \ Kodak ProPhoto RGB D65

.br

.B \t5

\ \ XYZ

.br

.B \t6

\ \ ACES

.TP

.BR -p\ appareilphoto.icm \ [\  -o\ sortie.icm \ ]

Utilise le profil ICC pour définir l'espace de couleur de

l'appareil photo et l'espace de couleur souhaité en sortie

(sRGB par défaut).

.TP

.B -p embed

Utilise le profil ICC contenu dans la photo raw.

.SH OPTIONS D'INTERPOLATION

.TP

.B -d

Montre les données raw comme une image monochrome sans interpolation.

Bon pour photographier des documents en noir et blanc.

.TP

.B -D

Comme avec

.BR -d ,

mais avec les valeurs de pixels non mise à l'échelle

.TP

.B -E

Comme avec

.BR -D ,

mais les pixels masqués ne sont pas découpés.

.TP

.B -h

Génère une image couleur réduite de moitié.  Deux fois plus rapide que

.BR -q\ 0 .

.TP

.B -q 0

Utilise une interpolation bilinéaire très rapide et de basse qualité.

.TP

.B -q 1

Utilise une interpolation Nombre Variable de Gradient (VNG).

.TP

.B -q 2

Utilise une interpolation Regroupement par Motif de Pixel (PPG).

.TP

.B -q 3

Utilise une interpolation Homogénéité Dirigée et Adaptative (AHD).

.TP

.B -f

Interpole RVB comme quatre couleurs.  A utiliser si la sortie

montre des faux motifs 2x2 avec VNG ou des labyrinthes avec AHD.

.TP

.B -m nombre_de_passes

Après l'interpolation, nettoie les artefacts de couleurs en appliquant

un filtre médian 3x3 de façon répétée aux canaux R-V et B-V.

.SH OPTION DE SORTIE

Par défaut,

.B dcraw

écrit des fichiers PGM/PPM/PAM 8 bits, une courbe gamma BT.709, un

niveau de blanc basé sur l'histogramme, et aucune méta donnée.

.TP

.B -W

Utilise un niveau de blanc fixé ignorant l'histogramme de l'image

.TP

.B -b luminosité

Divise le niveau de blanc par cette valeur, 1.0 par défaut.

.TP

.B -g puissance pente_a_l_origine

Fixe la courbe gamma, par défaut BT.709

.RB ( -g\ 2.222\ 4.5 ).

Si vous préférez le gamma du sRGB, utilisez

.BR -g\ 2.4\ 12.92 .

Pour une simple courbe de puissance, fixez la pente à l'origine à zéro.

.TP

.B -6

Ecrit seize bits par pixel/canal au lieu de huit.

.TP

.B -4

16 bits linéaires, équivalent à

.BR -6\ -W\ -g\ 1\ 1 .

.TP

.B -T

Ecrit des fichiers TIFF avec les métadonnées au lieu de

fichiers PGM/PPM/PAM.

.TP

.B -t [0-7,90,180,270]

Change l'orientation de l'image de sortie.  Par défaut,

.B dcraw

applique l'orientation spécifiée par l'appareil photo.

.B -t 0

désactive le changement d'orientation.

.TP

.B -j

Pour les appareils photos Fuji\ Super\ CCD, montre l'image

tournée à 45 degrés. Pour les appareils photos avec des pixels

non carrés, n'étire pas l'image à son rapport hauteur/largeur

réel.  Dans tous les cas cette option garantie que chaque pixel

en sortie correspond à un pixel raw.

.TP

.BR "-s [0..N-1]" " ou " "-s all"

Si un fichier contient N images raw, choisissez en une ou "all"

(toutes) pour les décoder.

Par exemple, les appareils photos Fuji\ Super\ CCD\ SR

génèrent une seconde image sous exposée de 4 stops pour montrer

les détails dans les zones claires.

.SH FICHIERS

.TP

\:./.badpixels, ../.badpixels, ../../.badpixels, ...

Liste des pixels morts de votre appareil photo afin que

.B dcraw

puisse interpoler autour d'eux.  Chaque ligne spécifie une colonne,

une ligne, et la date UNIX de la mort pour un pixel.  Par exemple :

.sp 1

.nf

 962   91 1028350000  # mort entre le 1er et le 4 Aout 2002

1285 1067 0           # mort à une date inconnue

.fi

.sp 1

Ces coordonnées sont avant tout étirement ou rotation,

donc utilisez

.B dcraw -j -t 0

pour identifier les pixels morts.

.SH "VOIR AUSSI"

.BR pgm (5),

.BR ppm (5),

.BR pam (5),

.BR pamsumm (1),

.BR pnmgamma (1),

.BR pnmtotiff (1),

.BR pnmtopng (1),

.BR gphoto2 (1),

.BR cjpeg (1),

.BR djpeg (1)

.SH AUTEUR

Ecrit par David Coffin, dcoffin a cybercom o net

.SH TRADUCTION

Luc Coiffier, luc o coiffier a free o fr