.\"
.\" Man page di dcraw
.\"
.\" Copyright (c) 2009 by David Coffin
.\"
.\" Distribuzione libera senza restrizioni
.\"
.\" David Coffin
.\" dcoffin a cybercom o net
.\" http://www.cybercom.net/~dcoffin
.\"
.TH dcraw 1 "14 maggio 2009"
.LO 1
.SH NOME
dcraw - Convertitore per foto digitali grezze (RAW) a linea di comando
.SH SOMMARIO
.B dcraw
[\fIOPZIONE\fR]... [\fIFILE\fR]...
.SH DESCRIZIONE
.B dcraw
decodifica foto grezze, mostra i metadati ed estrae le miniature.
.SH OPZIONI GENERALI
.TP
.B -v
Stampa messaggi di testo, non solo avvertimenti ed errori.
.TP
.B -c
Scrive sullo standard output le immagini decodificate o le miniature.
.TP
.B -e
Estrae la miniatura generata dalla fotocamera, non l'immagine grezza.
Può essere un file JPEG o PPM, dipende dalla fotocamera.
.TP
.B -z
Cambia ora e data di accesso del file AVI, JPEG, TIFF o raw con l'ora e la
data dello scatto, assumendo che la fotocamera sia stata sincronizzata
sull'Universal Time.
.TP
.B -i
Identifica i files ma non li decodifica.
Lo stato di uscita è 0 se
.B dcraw
riesce a decodificare l'ultimo file, 1 se non ci riesce.
.B -i -v
mostra i metadati.
.TP
.B ""
.B dcraw
non decodifica i files JPEG!!
.SH OPZIONI PER IL RECUPERO
.TP
.B -P pixelsmorti.txt
Legge l'elenco dei pixels morti da questo file anzichè da ".badpixels".
Vedi
.B FILES
per la descrizione del formato.
.TP
.B -K fotogrammanero.pgm
Sottrae un fotogramma nero ai dati grezzi.  Per generare un fotogramma
nero scattare una foto grezza senza luce e lanciare
.BR dcraw\ -D\ -4\ -j\ -t\ 0 .
.TP
.B -k nero
Quando le ombre appaiono velate, occorre alzare il livello del nero.
Per misurarlo, applicare
.B pamsumm -mean
al fotogramma nero generato prima.
.TP
.B -S saturazione
Quando le alte luci appaiono rosa, occorre abbassare il livello di saturazione.
Per misurarlo, scattare una foto a qualcosa di molto chiaro e lanciare
.B dcraw -D -4 -j -c
foto.raw
.B | pamsumm -max
.TP
.B ""
I valori di default per il nero e la saturazione in genere sono corretti.
.TP
.B -n soglia_di_rumore
Usa le wavelets per cancellare il rumore preservando i dettagli.
La soglia migliore dovrebbe rientrare nell'intervallo 100 - 1000.
.TP
.B -C mag_rosso mag_blu
Allarga i livelli grezzi rosso e blu dei fattori indicati, tipicamente
da 0.999 a 1.001, per correggere l'aberrazione cromatica.
.TP
.B -H 0
Le alte luci vengono clippate e rese come bianco puro (default).
.TP
.B -H 1
Le alte luci non vengono clippate e vengono rese in varie sfumature di rosa.
.TP
.B -H 2
Miscela i valori clippati con quelli non clippati in modo da
ottenere una sfumatura graduale verso il bianco.
.TP
.B -H 3+
Le alte luci vengono recuperate. Con un valore basso risultano
desaturate; con un valore alto vengono ricostruiti i colori.
Provare
.B -H 5
come compromesso. Se non risulta soddisfacente, usare
.BR -H\ 9 ,
copiare le alte luci non bianche ed incollarle nell'immagine ottenuta con
.BR -H\ 3 .
.SH OPZIONI COLORE
Di default,
.B dcraw
utilizza un bilanciamento del bianco fisso, basato su di una
tabella di colori illuminanta da una lampada standard D65.
.TP
.B -w
Utilizza il bilanciamento del bianco specificato dalla fotocamera.
Se non trovato, viene stampato un messaggio di avvertimento e usato
un altro metodo.
.TP
.B -a
Calcola il bilanciamento del bianco dalla media dell'intera immagine.
.TP
.B -A sinistra alto larghezza altezza
Calcola il bilanciamento del bianco dalla media di un'area rettangolare.
Utilizzare
.B dcraw\ -j\ -t\ 0
e selezionare un'area di colore grigio neutro.
.TP
.B -r mol0 mol1 mol2 mol3
Specifica il tuo bilanciamento del bianco in modalità grezza.
Questi coefficienti moltiplicativi possono essere tagliati e incollati
dall'uscita di
.BR dcraw\ -v .
.TP
.BR +M " o " -M
Utilizza (o non utilizza) l'eventuale matrice colore
presente nei metadati della fotocamera.
Di default è
.B +M
se è impostato
.BR -w ,
altrimenti
.BR -M .
Quest'opzione ha effetto solo sulle fotocamere Olympus, Leaf, e Phase One.
.TP
.B -o [0-6]
Seleziona lo spazio di colore in uscita, quando l'opzione
.B -p
non è usata:

.B \t0
\ \ Colori grezzi (caratteristici di ogni fotocamera)
.br
.B \t1
\ \ sRGB D65 (default)
.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\ fotocamera.icm \ [\  -o\ output.icm \ ]
Usa i profili ICC per definire lo spazio colore grezzo della
fotocamera e lo spazio colore in uscita (sRGB di default).
.TP
.B -p embed
Usa il profilo ICC incorporato nella foto grezza.
.SH OPZIONI DI INTERPOLAZIONE
.TP
.B -d
Mostra i dati grezzi in scala di grigio senza interpolazione.
Adatto per la fotografia in bianco e nero di documenti.
.TP
.B -D
Come
.BR -d ,
ma in modo completamente grezzo (senza riscalamento dei colori).
.TP
.B -h
Restituisce l'immagine a colori con dimensioni dimezzate.
Due volte più veloce di
.BR -q\ 0 .
.TP
.B -q 0
Interpolazione bilineare, veloce e a bassa qualità.
.TP
.B -q 1
Interpolazione a numero variabile di gradienti (VNG).
.TP
.B -q 2
Interpolazione a raggruppamento di trame di pixels (PPG).
.TP
.B -q 3
Interpolazione adattativa orientata all'omogeneità (AHD).
.TP
.B -f
Interpolazione RGB a quattro colori.  Usarla se l'output mostra
falsi retini 2x2 con la VNG o labirinti con l'AHD.
.TP
.B -m numero_di_passi
Dopo l'interpolazione, rimuove gli artefatti di colore applicando
iterativamente un filtro mediano 3x3 ai canali R-G e B-G.
.SH OPZIONI DI OUTPUT
Di default,
.B dcraw
scrive in formato PGM/PPM/PAM a 8-bit, con una curva gamma
di BT.709, un livello del bianco basato sugli istogrammi, e
senza metadati.
.TP
.B -W
Utilizza un livello del bianco fisso, ignorando gli istogrammi
dell'immagine
.TP
.B -b luminosità
Divide il livello del bianco per questo numero, di default 1.0.
.TP
.B -g esponente pendenza_piede
Imposta la curva gamma, di default BT.709
.RB ( -g\ 2.222\ 4.5 ).
Se preferisci il gamma di sRGB, usa
.BR -g\ 2.4\ 12.92 .
Per una semplice curva di potenza, imposta la pendenza del piede
della curva a zero.
.TP
.B -6
Scrive sedici bit per campione invece di otto.
.TP
.B -4
16-bit lineari, come
.BR -6\ -W\ -g\ 1\ 1 .
.TP
.B -T
Scrive in TIFF con metadati anzichè in PGM/PPM/PAM.
.TP
.B -t [0-7,90,180,270]
Ruota l'immagine.
.B dcraw
di default applica la rotazione specificata dalla fotocamera.
.B -t 0
disabilita tutte le rotazioni.
.TP
.B -j
Per fotocamere con sensore Fuji\ Super\ CCD: l'immagine risulta
ruotata di 45 gradi.  Per fotocamere che hanno pixel non quadrati,
l'immagine non viene ricampionata per correggere il fattore di forma.
In ogni caso questa opzione garantisce che ogni pixel di uscita
corrisponda ad un pixel dell'immagine grezza.
.TP
.BR "-s [0..N-1]" " o " "-s all"
Se un file contiene N immagini grezze, ne sceglie una o "all"
(tutte) per la decodifica.
Per esempio le reflex dotate di Fuji\ Super\ CCD\ SR
generano una seconda immagine sottoesposta di quattro stops per
mostrare i dettagli nelle alte luci.
.SH FILES
.TP
\:./.badpixels, ../.badpixels, ../../.badpixels, ...
Lista dei pixel difettosi della fotocamera, grazie a cui
.B dcraw
può interpolare attorno ad essi.
Ogni linea del file specifica la colonna, la riga, e la data di
morte (in formato UNIX) di un pixel.
Esempio:
.sp 1
.nf
 962   91 1028350000  # morto fra l'1 e il 4 Agosto 2002
1285 1067 0           # non si conosce la data di morte di questo pixel
.fi
.sp 1
Queste coordinate si riferiscono all'immagine prima che sia
ritagliata o ruotata, per cui usare
.B dcraw -j -t 0
per localizzare i pixel difettosi.
.SH "VEDI ANCHE"
.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 AUTORE
Scritto da David Coffin, dcoffin a cybercom o net
.SH TRADUZIONE
Alberto Maccaferri, alberto o maccaferri a photoactivity o com