dcraw.1

   1 .\"
   2 .\" Man page for dcraw (Raw Photo Decoder)
   3 .\"
   4 .\" Copyright (c) 2005 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 "September 29, 2005"
  13 .LO 1
  14 .SH NAME
  15 dcraw - convert raw digital photos to PPM format
  16 .SH SYNOPSIS
  17 .B dcraw
  18 [\fIOPTION\fR]... [\fIFILE\fR]...
  19 .SH DESCRIPTION
  20 .B dcraw
  21 converts raw digital photos to
  22 .BR ppm (5)
  23 format.
  24 .SH OPTIONS
  25 .TP
  26 .B -v
  27 Print verbose messages.  The default is to print only warnings
  28 and errors.
  29 .TP
  30 .B -z
  31 Change the access and modification times of a JPEG or raw file to
  32 when the photo was taken, assuming that the camera clock was set
  33 to Universal Time.
  34 .TP
  35 .B -i
  36 Identify files but don't decode them.
  37 Exit status is 0 if
  38 .B dcraw
  39 can decode the last file, 1 if it can't.
  40 .TP
  41 .B ""
  42 .B dcraw
  43 cannot decode JPEG files!!
  44 .TP
  45 .B -c
  46 Write binary image data to standard output.
  47 By default,
  48 .B dcraw
  49 creates files with a ".ppm" extension.
  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 -q [0-3]
  56 Set the interpolation quality (default is 3):
  57
  58 .B \t0
  59 \ \ Bilinear (very fast, low quality)
  60 .br
  61 .B \t1
  62 \ \ Reserved
  63 .br
  64 .B \t2
  65 \ \ Variable Number of Gradients (VNG)
  66 .br
  67 .B \t3
  68 \ \ Adaptive Homogeneity-Directed (AHD)
  69 .TP
  70 .B -h
  71 Output a half-size image.  Twice as fast as
  72 .BR -q\ 0 .
  73 .TP
  74 .B -f
  75 Interpolate RGB as four colors.  This blurs the image a little,
  76 but it eliminates false 2x2 mesh patterns.
  77 .TP
  78 .B -B sigma_domain sigma_range
  79 Use a bilateral filter to smooth noise while preserving edges.
  80 .B sigma_domain
  81 is in units of pixels, while
  82 .B sigma_range
  83 is in units of CIELab colorspace.
  84 Try
  85 .B -B\ 2\ 4
  86 to start.
  87 .TP
  88 .B -a
  89 Automatic color balance.  The default is to use a fixed
  90 color balance based on a white card photographed in sunlight.
  91 .TP
  92 .B -w
  93 Use the color balance specified by the camera.
  94 If this can't be found,
  95 .B dcraw
  96 prints a warning and reverts to the default.
  97 .TP
  98 .B -r red_mul -l blue_mul
  99 Further adjust the color balance by multiplying the red and
 100 blue output channels by these values.  Both default to 1.0.
 101 .TP
 102 .B -b brightness
 103 Change the output brightness.  Default is 1.0.
 104 .TP
 105 .B -k black
 106 Set the black point.  Default depends on the camera.
 107 .TP
 108 .B -n
 109 By default,
 110 .B dcraw
 111 clips all colors to prevent pink hues in the highlights.
 112 Combine this option with
 113 .B -b 0.25
 114 to leave the image data completely unclipped.
 115 .TP
 116 .B -m
 117 Write raw camera colors to the output file.  By default,
 118 .B dcraw
 119 converts to sRGB colorspace.
 120 .TP
 121 .B -j
 122 For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees
 123 so that each output pixel corresponds to one raw pixel.
 124 .TP
 125 .B -s
 126 For Fuji\ Super\ CCD\ SR cameras, use the secondary sensors, in
 127 effect underexposing the image by four stops to reveal detail
 128 in the highlights.
 129 .TP
 130 .B ""
 131 For all other cameras,
 132 .B -j
 133 and
 134 .B -s
 135 are silently ignored.
 136 .TP
 137 .B -t [0-7]
 138 Flip the output image.  The most common flips are 5
 139 (90 degrees CCW) and 6 (90 degrees clockwise).  By default,
 140 dcraw tries to use the flip specified by the camera.
 141 .RB \^" -t\ 0 \^"
 142 forces
 143 .B dcraw
 144 not to flip images.
 145 .TP
 146 .B -2
 147 Write eight bits per color value with a 99th-percentile white
 148 point and the standard 0.45 gamma curve.  Double the height if
 149 necessary to correct the aspect ratio.  This is the default.
 150 .TP
 151 .B -4
 152 Write sixteen bits per color value.  Output is linear with
 153 input -- no white point, no gamma, same aspect ratio.
 154 .TP
 155 .B -3
 156 Same image as
 157 .BR -4 ,
 158 written in Adobe PhotoShop format.  File extension is ".psd".
 159 .SH "SEE ALSO"
 160 .BR ppm (5),
 161 .BR ppm2tiff (1),
 162 .BR pnmtotiff (1),
 163 .BR pnmtopng (1),
 164 .BR gphoto2 (1),
 165 .BR djpeg (1)
 166 .SH BUGS
 167 The
 168 .B -w
 169 option does not work with many cameras.
 170 .P
 171 No attempt is made to save camera settings or thumbnail images.
 172 .P
 173 The author stubbornly refuses to add more output formats.
 174 .P
 175 Don't expect
 176 .B dcraw
 177 to produce the same images as software provided by the camera
 178 vendor.  Sometimes
 179 .B dcraw
 180 gives better results!
 181 .SH AUTHOR
 182 Written by David Coffin, dcoffin a cybercom o net