You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
268 lines
6.3 KiB
268 lines
6.3 KiB
.\"
|
|
.\" Man page for dcraw
|
|
.\"
|
|
.\" Copyright (c) 2008 by David Coffin
|
|
.\"
|
|
.\" You may distribute without restriction.
|
|
.\"
|
|
.\" David Coffin
|
|
.\" dcoffin a cybercom o net
|
|
.\" http://www.cybercom.net/~dcoffin
|
|
.\"
|
|
.TH dcraw 1 "February 6, 2008"
|
|
.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 GENERAL 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, TIFF 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!!
|
|
.SH REPAIR OPTIONS
|
|
.TP
|
|
.B -P deadpixels.txt
|
|
Read the dead pixel list from this file instead of ".badpixels".
|
|
See
|
|
.B FILES
|
|
for a description of the format.
|
|
.TP
|
|
.B -K darkframe.pgm
|
|
Subtract a dark frame from the raw data. To generate a
|
|
dark frame, shoot a raw photo with no light and do
|
|
.BR dcraw\ -D\ -4\ -j\ -t\ 0 .
|
|
.TP
|
|
.B -k darkness
|
|
When shadows appear foggy, you need to raise the darkness level.
|
|
To measure this, apply
|
|
.B pamsumm -mean
|
|
to the dark frame generated above.
|
|
.TP
|
|
.B -S saturation
|
|
When highlights appear pink, you need to lower the saturation level.
|
|
To measure this, take a picture of something shiny and do
|
|
.B dcraw -D -4 -j -c
|
|
photo.raw
|
|
.B | pamsumm -max
|
|
.TP
|
|
.B ""
|
|
The default darkness and saturation are usually correct.
|
|
.TP
|
|
.B -n noise_threshold
|
|
Use wavelets to erase noise while preserving real detail.
|
|
The best threshold should be somewhere between 100 and 1000.
|
|
.TP
|
|
.B -C red_mag blue_mag
|
|
Enlarge the raw red and blue layers by the given factors,
|
|
typically 0.999 to 1.001, to correct chromatic aberration.
|
|
.TP
|
|
.B -H 0
|
|
Clip all highlights to solid white (default).
|
|
.TP
|
|
.B -H 1
|
|
Leave highlights unclipped in various shades of pink.
|
|
.TP
|
|
.B -H 2
|
|
Blend clipped and unclipped values together for a gradual fade
|
|
to white.
|
|
.TP
|
|
.B -H 3+
|
|
Reconstruct highlights. Low numbers favor whites; high numbers
|
|
favor colors. Try
|
|
.B -H 5
|
|
as a compromise. If that's not good enough, do
|
|
.BR -H\ 9 ,
|
|
cut out the non-white highlights, and paste them into an image
|
|
generated with
|
|
.BR -H\ 3 .
|
|
.SH COLOR OPTIONS
|
|
By default,
|
|
.B dcraw
|
|
uses a fixed white balance based on a color chart illuminated
|
|
with a standard D65 lamp.
|
|
.TP
|
|
.B -w
|
|
Use the white balance specified by the camera.
|
|
If this is not found, print a warning and use another method.
|
|
.TP
|
|
.B -a
|
|
Calculate the white balance by averaging the entire image.
|
|
.TP
|
|
.B -A left top width height
|
|
Calculate the white balance by averaging a rectangular area.
|
|
First do
|
|
.B dcraw\ -j\ -t\ 0
|
|
and select an area of neutral grey color.
|
|
.TP
|
|
.B -r mul0 mul1 mul2 mul3
|
|
Specify your own raw white balance.
|
|
These multipliers can be cut and pasted from the output of
|
|
.BR dcraw\ -v .
|
|
.TP
|
|
.BR +M " or " -M
|
|
Use (or don't use) any color matrix from the camera metadata.
|
|
The default is
|
|
.B +M
|
|
if
|
|
.B -w
|
|
is set,
|
|
.B -M
|
|
otherwise.
|
|
This option only affects Olympus, Leaf, and Phase One cameras.
|
|
.TP
|
|
.B -o [0-5]
|
|
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 RGB (1998) D65
|
|
.br
|
|
.B \t3
|
|
\ \ Wide Gamut RGB D65
|
|
.br
|
|
.B \t4
|
|
\ \ Kodak ProPhoto RGB 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).
|
|
.TP
|
|
.B -p embed
|
|
Use the ICC profile embedded in the raw photo.
|
|
.SH INTERPOLATION OPTIONS
|
|
.TP
|
|
.B -d
|
|
Show the raw data as a grayscale image with no interpolation.
|
|
Good for photographing black-and-white documents.
|
|
.TP
|
|
.B -D
|
|
Same as
|
|
.BR -d ,
|
|
but totally raw (no color scaling).
|
|
.TP
|
|
.B -h
|
|
Output a half-size color image. Twice as fast as
|
|
.BR -q\ 0 .
|
|
.TP
|
|
.B -q 0
|
|
Use high-speed, low-quality bilinear interpolation.
|
|
.TP
|
|
.B -q 1
|
|
Use Variable Number of Gradients (VNG) interpolation.
|
|
.TP
|
|
.B -q 2
|
|
Use Patterned Pixel Grouping (PPG) interpolation.
|
|
.TP
|
|
.B -q 3
|
|
Use Adaptive Homogeneity-Directed (AHD) interpolation.
|
|
.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 -m number_of_passes
|
|
After interpolation, clean up color artifacts by repeatedly
|
|
applying a 3x3 median filter to the R-G and B-G channels.
|
|
.SH OUTPUT OPTIONS
|
|
By default,
|
|
.B dcraw
|
|
writes PGM/PPM/PAM with 8-bit samples, a BT.709 gamma curve,
|
|
a histogram-based white level, and no metadata.
|
|
.TP
|
|
.B -W
|
|
Use a fixed white level, ignoring the image histogram.
|
|
.TP
|
|
.B -b brightness
|
|
Divide the white level by this number, 1.0 by default.
|
|
.TP
|
|
.B -4
|
|
Write 16-bit linear samples (fixed white level, no gamma).
|
|
.TP
|
|
.B -T
|
|
Write TIFF with metadata instead of PGM/PPM/PAM.
|
|
.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 -j
|
|
For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees.
|
|
For cameras with non-square pixels, do not stretch the image to
|
|
its correct aspect ratio. In any case, this option guarantees
|
|
that each output pixel corresponds to one raw pixel.
|
|
.TP
|
|
.BR "-s [0..N-1]" " or " "-s all"
|
|
If a file contains N raw images, choose one or "all" to decode.
|
|
For example, Fuji\ Super\ CCD\ SR cameras generate a second image
|
|
underexposed four stops to show detail in the highlights.
|
|
.SH FILES
|
|
.TP
|
|
\:./.badpixels, ../.badpixels, ../../.badpixels, ...
|
|
List of your camera's dead pixels, so that
|
|
.B dcraw
|
|
can interpolate around them. Each line specifies the column,
|
|
row, and UNIX time of death for one pixel. For example:
|
|
.sp 1
|
|
.nf
|
|
962 91 1028350000 # died between August 1 and 4, 2002
|
|
1285 1067 0 # don't know when this pixel died
|
|
.fi
|
|
.sp 1
|
|
These coordinates are before any cropping or rotation, so use
|
|
.B dcraw -j -t 0
|
|
to locate dead pixels.
|
|
.SH "SEE ALSO"
|
|
.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 AUTHOR
|
|
Written by David Coffin, dcoffin a cybercom o net
|