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 25, 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 -V
  56 Use the older VNG interpolation.  Faster than the default AHD
  57 algorithm, but more prone to zipper artifacts.
  58 .TP
  59 .B -q
  60 Use bilinear interpolation.  Much faster than
  61 .BR -V .
  62 .TP
  63 .B -h
  64 Half-size the output image.  Instead of interpolating, reduce
  65 each 2x2 block of sensors to one pixel.  Much faster than
  66 .BR -q .
  67 .TP
  68 .B -f
  69 Interpolate RGB as four colors.  This blurs the image a little,
  70 but it eliminates false 2x2 mesh patterns.
  71 .TP
  72 .B -B sigma_domain sigma_range
  73 Use a bilateral filter to smooth noise while preserving edges.
  74 .B sigma_domain
  75 is in units of pixels, while
  76 .B sigma_range
  77 is in units of CIELab colorspace.
  78 Try
  79 .B -B 1 2
  80 or
  81 .B -B 2 4
  82 to start.
  83 .TP
  84 .B -a
  85 Automatic color balance.  The default is to use a fixed
  86 color balance based on a white card photographed in sunlight.
  87 .TP
  88 .B -w
  89 Use the color balance specified by the camera.
  90 If this can't be found,
  91 .B dcraw
  92 prints a warning and reverts to the default.
  93 .TP
  94 .B -r red_mul -l blue_mul
  95 Further adjust the color balance by multiplying the red and
  96 blue output channels by these values.  Both default to 1.0.
  97 .TP
  98 .B -b brightness
  99 Change the output brightness.  Default is 1.0.
 100 .TP
 101 .B -k black
 102 Change the black point.  Default depends on the camera.
 103 .TP
 104 .B -n
 105 By default,
 106 .B dcraw
 107 clips all colors to prevent pink hues in the highlights.
 108 Combine this option with
 109 .B -b 0.25
 110 to leave the image data completely unclipped.
 111 .TP
 112 .B -m
 113 Write raw camera colors to the output file.  By default,
 114 .B dcraw
 115 converts to sRGB colorspace.
 116 .TP
 117 .B -j
 118 For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees
 119 so that each output pixel corresponds to one raw pixel.
 120 .TP
 121 .B -s
 122 For Fuji\ Super\ CCD\ SR cameras, use the secondary sensors, in
 123 effect underexposing the image by four stops to reveal detail
 124 in the highlights.
 125 .TP
 126 .B ""
 127 For all other cameras,
 128 .B -j
 129 and
 130 .B -s
 131 are silently ignored.
 132 .TP
 133 .B -t [0-7]
 134 Flip the output image.  The most common flips are 5
 135 (90 degrees CCW) and 6 (90 degrees clockwise).  By default,
 136 dcraw tries to use the flip specified by the camera.
 137 .RB \^" -t\ 0 \^"
 138 forces
 139 .B dcraw
 140 not to flip images.
 141 .TP
 142 .B -2
 143 Write eight bits per color value with a 99th-percentile white
 144 point and the standard 0.45 gamma curve.  Double the height if
 145 necessary to correct the aspect ratio.  This is the default.
 146 .TP
 147 .B -4
 148 Write sixteen bits per color value.  Output is linear with
 149 input -- no white point, no gamma, same aspect ratio.
 150 .TP
 151 .B -3
 152 Same image as
 153 .BR -4 ,
 154 written in Adobe PhotoShop format.  File extension is ".psd".
 155 .SH "SEE ALSO"
 156 .BR ppm (5),
 157 .BR ppm2tiff (1),
 158 .BR pnmtotiff (1),
 159 .BR pnmtopng (1),
 160 .BR gphoto2 (1),
 161 .BR djpeg (1)
 162 .SH BUGS
 163 The
 164 .B -w
 165 option does not work with many cameras.
 166 .P
 167 No attempt is made to save camera settings or thumbnail images.
 168 .P
 169 The author stubbornly refuses to add more output formats.
 170 .P
 171 Don't expect
 172 .B dcraw
 173 to produce the same images as software provided by the camera
 174 vendor.  Sometimes
 175 .B dcraw
 176 gives better results!
 177 .SH AUTHOR
 178 Written by David Coffin, dcoffin a cybercom o net