.\"
.\" Man page for dcraw (Raw Photo Decoder)
.\"
.\" Copyright (c) 2006 by David Coffin
.\"
.\" You may distribute without restriction.
.\"
.\" David Coffin
.\" dcoffin a cybercom o net
.\" http://www.cybercom.net/~dcoffin
.\"
.TH dcraw 1 "February 7, 2006"
.LO 1
.SH NAME
dcraw - command-line decoder for raw digital photos
.SH SYNOPSIS
.B dcraw
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
.B dcraw
decodes raw photos, displays metadata, and extracts thumbnails.
.SH OPTIONS
.TP
.B -v
Print verbose messages, not just warnings and errors.
.TP
.B -c
Write decoded images or thumbnails to standard output.
.TP
.B -e
Extract the camera-generated thumbnail, not the raw image.
You'll get either a JPEG or a PPM file, depending on the camera.
.TP
.B -z
Change the access and modification times of an AVI, JPEG or raw
file to when the photo was taken, assuming that the camera clock
was set to Universal Time.
.TP
.B -i
Identify files but don't decode them.
Exit status is 0 if
.B dcraw
can decode the last file, 1 if it can't.
.B -i -v
shows metadata.
.TP
.B ""
.B dcraw
cannot decode JPEG files!!
.TP
.B -d
Show the raw data as a grayscale image with no interpolation.
Good for photographing black-and-white documents.
.TP
.B -h
Output a half-size color image.  Twice as fast as
.BR -q\ 0 .
.TP
.B -q [0-3]
Set the interpolation quality:

.B \t0
\ \ Bilinear (very fast, low quality)
.br
.B \t1
\ \ Reserved
.br
.B \t2
\ \ Variable Number of Gradients (VNG)
.br
.B \t3
\ \ Adaptive Homogeneity-Directed (AHD)
.TP
.B -f
Interpolate RGB as four colors.  Use this if the output shows
false 2x2 meshes with VNG or mazes with AHD.
.TP
.B -B sigma_domain sigma_range
Use a bilateral filter to smooth noise while preserving edges.
.B sigma_domain
is in units of pixels, while
.B sigma_range
is in units of CIELab colorspace.
Try
.B -B\ 2\ 4
to start.
.TP
.B -k black
Set the black point.  Default depends on the camera.
.TP
.B -a
Automatic color balance.  The default is to use a fixed
color balance based on a white card photographed in sunlight.
.TP
.B -w
Use the color balance specified by the camera.
If this can't be found, print a warning and revert to the default.
.TP
.B -r red_mul -l blue_mul
Customize the color balance by multiplying the red and blue
output channels by these values.  Both default to 1.0.
.TP
.B -b brightness
Multiply all output channels by this value.  Default is 1.0.
.TP
.B -n
By default,
.B dcraw
clips all colors to prevent pink highlights.  Use
.B -n -b 0.25
to leave the image data completely unclipped.
.TP
.B -m
Same as
.BR -o\ 0 .
.TP
.B -o [0-4]
Select the output colorspace when the
.B -p
option is not used:

.B \t0
\ \ Raw color (unique to each camera)
.br
.B \t1
\ \ sRGB D65 (default)
.br
.B \t2
\ \ Adobe 1998 D65
.br
.B \t3
\ \ Wide Gamut D65
.br
.B \t4
\ \ Kodak ProPhoto D65
.br
.B \t5
\ \ XYZ
.TP
.BR -p\ camera.icm \ [\  -o\ output.icm \ ]
Use ICC profiles to define the camera's raw colorspace and the
desired output colorspace (sRGB by default).
.B -p embed
uses the ICC profile embedded in the raw photo.
.TP
.B -j
For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees,
so that each output pixel corresponds to one raw pixel.
.TP
.B -s
For Fuji\ Super\ CCD\ SR cameras, use the secondary sensors, in
effect underexposing the image by four stops to reveal detail
in the highlights.
.TP
.B ""
For all other cameras,
.B -j
and
.B -s
are silently ignored.
.TP
.B -t [0-7,90,180,270]
Flip the output image.  By default,
.B dcraw
applies the flip specified by the camera.
.B -t 0
disables all flipping.
.TP
.B -2
Write 8-bit PGM/PPM/PAM with a 99th-percentile white point and
the BT.709 gamma curve.  Double one dimension if needed to
correct the aspect ratio.  This is the default.
.TP
.B -4
Write 16-bit linear pseudo-PGM/PPM/PAM.  No white point, no gamma,
raw aspect ratio.
.TP
.B -3
Same image as
.BR -4 ,
written in Adobe PhotoShop format.
.SH "SEE ALSO"
.BR pgm (5),
.BR ppm (5),
.BR pam (5),
.BR pnmgamma (1),
.BR pnmtotiff (1),
.BR pnmtopng (1),
.BR gphoto2 (1),
.BR cjpeg (1),
.BR djpeg (1)
.SH BUGS
The author stubbornly refuses to add more output formats.
.P
Don't expect
.B dcraw
to produce the same images as software provided by the camera
vendor.  Often
.B dcraw
yields better results!
.SH AUTHOR
Written by David Coffin, dcoffin a cybercom o net