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