dcraw.1

   1 .\"
   2 .\" Man page for dcraw
   3 .\"
   4 .\" Copyright (c) 2007 by David Coffin
   5 .\"
   6 .\" You may distribute without restriction.
   7 .\"
   8 .\" David Coffin
   9 .\" dcoffin a cybercom o net
  10 .\" http://www.cybercom.net/~dcoffin
  11 .\"
  12 .TH dcraw 1 "June 8, 2007"
  13 .LO 1
  14 .SH NAME
  15 dcraw - command-line decoder for raw digital photos
  16 .SH SYNOPSIS
  17 .B dcraw
  18 [\fIOPTION\fR]... [\fIFILE\fR]...
  19 .SH DESCRIPTION
  20 .B dcraw
  21 decodes raw photos, displays metadata, and extracts thumbnails.
  22 .SH OPTIONS
  23 .TP
  24 .B -v
  25 Print verbose messages, not just warnings and errors.
  26 .TP
  27 .B -c
  28 Write decoded images or thumbnails to standard output.
  29 .TP
  30 .B -e
  31 Extract the camera-generated thumbnail, not the raw image.
  32 You'll get either a JPEG or a PPM file, depending on the camera.
  33 .TP
  34 .B -z
  35 Change the access and modification times of an AVI, JPEG or raw
  36 file to when the photo was taken, assuming that the camera clock
  37 was set to Universal Time.
  38 .TP
  39 .B -i
  40 Identify files but don't decode them.
  41 Exit status is 0 if
  42 .B dcraw
  43 can decode the last file, 1 if it can't.
  44 .B -i -v
  45 shows metadata.
  46 .TP
  47 .B ""
  48 .B dcraw
  49 cannot decode JPEG files!!
  50 .TP
  51 .B -d
  52 Show the raw data as a grayscale image with no interpolation.
  53 Good for photographing black-and-white documents.
  54 .TP
  55 .B -D
  56 Same as
  57 .BR -d ,
  58 but totally raw (no color scaling).
  59 .TP
  60 .B -h
  61 Output a half-size color image.  Twice as fast as
  62 .BR -q\ 0 .
  63 .TP
  64 .B -q 0
  65 Use high-speed, low-quality bilinear interpolation.
  66 .TP
  67 .B -q 1
  68 Use Variable Number of Gradients (VNG) interpolation.
  69 .TP
  70 .B -q 2
  71 Use Patterned Pixel Grouping (PPG) interpolation.
  72 .TP
  73 .B -q 3
  74 Use Adaptive Homogeneity-Directed (AHD) interpolation.
  75 .TP
  76 .B -f
  77 Interpolate RGB as four colors.  Use this if the output shows
  78 false 2x2 meshes with VNG or mazes with AHD.
  79 .TP
  80 .B -n noise_threshold
  81 Use wavelets to erase noise while preserving real detail.
  82 The best threshold should be somewhere between 100 and 1000.
  83 .TP
  84 .B -b brightness
  85 By default,
  86 .B dcraw
  87 writes 8-bit PGM/PPM/PAM with a BT.709 gamma curve and a
  88 99th-percentile white point.  If the result is too light or
  89 too dark,
  90 .B -b
  91 lets you adjust it.  Default is 1.0.
  92 .TP
  93 .B -4
  94 Write 16-bit linear pseudo-PGM/PPM/PAM with no gamma curve,
  95 no white point, and no
  96 .B -b
  97 option.
  98 .TP
  99 .B -T
 100 Write TIFF output (with metadata) instead of PGM/PPM/PAM.
 101 .TP
 102 .B -k black
 103 Set the black point.  Default depends on the camera.
 104 .TP
 105 .B -K darkframe.pgm
 106 Subtract a dark frame from the raw data.  To generate a
 107 dark frame, shoot a raw photo with no light and do
 108 .BR dcraw\ -D\ -4\ -j\ -t\ 0 .
 109 .TP
 110 .B -w
 111 Use the white balance specified by the camera.
 112 If this is not found, print a warning and use another method.
 113 .TP
 114 .B -a
 115 Calculate the white balance by averaging the entire image.
 116 .TP
 117 .B -A left top width height
 118 Calculate the white balance by averaging a rectangular area.
 119 First do
 120 .B dcraw\ -j\ -t\ 0
 121 and select an area of neutral grey color.
 122 .TP
 123 .B -r mul0 mul1 mul2 mul3
 124 Specify your own raw white balance.
 125 These multipliers can be cut and pasted from the output of
 126 .BR dcraw\ -v .
 127 .TP
 128 no white balance option
 129 Use a fixed white balance based on a color chart illuminated
 130 with a standard D65 lamp.
 131 .TP
 132 .B -M
 133 If the raw metadata contains a color matrix, don't use it.
 134 This option only affects Olympus, Leaf, and Phase One cameras.
 135 .TP
 136 .B -C red_mag blue_mag
 137 Enlarge the raw red and blue layers by the given factors,
 138 typically 0.999 to 1.001, to correct chromatic aberration.
 139 .TP
 140 .B -H 0
 141 Clip all highlights to solid white (default).
 142 .TP
 143 .B -H 1
 144 Leave highlights unclipped in various shades of pink.
 145 .TP
 146 .B -H 2
 147 Blend clipped and unclipped values together for a gradual fade to white.
 148 .TP
 149 .B -H 3-9
 150 Reconstruct highlights.  Low numbers favor whites; high numbers
 151 favor colors.  Try
 152 .B -H 5
 153 as a compromise.  If that's not good enough, do
 154 .BR -H\ 9 ,
 155 cut out the non-white highlights, and paste them into an image
 156 generated with
 157 .BR -H\ 3 .
 158 .TP
 159 .B -m
 160 Same as
 161 .BR -o\ 0 .
 162 .TP
 163 .B -o [0-5]
 164 Select the output colorspace when the
 165 .B -p
 166 option is not used:
 167
 168 .B \t0
 169 \ \ Raw color (unique to each camera)
 170 .br
 171 .B \t1
 172 \ \ sRGB D65 (default)
 173 .br
 174 .B \t2
 175 \ \ Adobe RGB (1998) D65
 176 .br
 177 .B \t3
 178 \ \ Wide Gamut RGB D65
 179 .br
 180 .B \t4
 181 \ \ Kodak ProPhoto RGB D65
 182 .br
 183 .B \t5
 184 \ \ XYZ
 185 .TP
 186 .BR -p\ camera.icm \ [\  -o\ output.icm \ ]
 187 Use ICC profiles to define the camera's raw colorspace and the
 188 desired output colorspace (sRGB by default).
 189 .TP
 190 .B -p embed
 191 Use the ICC profile embedded in the raw photo.
 192 .TP
 193 .B -t [0-7,90,180,270]
 194 Flip the output image.  By default,
 195 .B dcraw
 196 applies the flip specified by the camera.
 197 .B -t 0
 198 disables all flipping.
 199 .TP
 200 .B -s [0-99]
 201 Select which raw image to decode if the file contains more than one.
 202 For example, Fuji\ Super\ CCD\ SR cameras generate a second image
 203 underexposed four stops to show detail in the highlights.
 204 .TP
 205 .B -j
 206 For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees.
 207 For cameras with non-square pixels, do not stretch the image to
 208 its correct aspect ratio.  In any case, this option guarantees
 209 that each output pixel corresponds to one raw pixel.
 210 .TP
 211 .B ""
 212 If they don't apply to your camera,
 213 .B -s
 214 and
 215 .B -j
 216 are silently ignored.
 217 .SH FILES
 218 .TP
 219 \:./.badpixels, ../.badpixels, ../../.badpixels, ...
 220 List of your camera's dead pixels, so that
 221 .B dcraw
 222 can interpolate around them.  Each line specifies the column,
 223 row, and UNIX time of death for one pixel.  For example:
 224 .sp 1
 225 .nf
 226  962   91 1028350000  # died between August 1 and 4, 2002
 227 1285 1067 0           # don't know when this pixel died
 228 .fi
 229 .sp 1
 230 These coordinates are before any cropping or rotation, so use
 231 .B dcraw -j -t 0
 232 to locate dead pixels.
 233 .SH "SEE ALSO"
 234 .BR pgm (5),
 235 .BR ppm (5),
 236 .BR pam (5),
 237 .BR pnmgamma (1),
 238 .BR pnmtotiff (1),
 239 .BR pnmtopng (1),
 240 .BR gphoto2 (1),
 241 .BR cjpeg (1),
 242 .BR djpeg (1)
 243 .SH AUTHOR
 244 Written by David Coffin, dcoffin a cybercom o net