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 "April 28, 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 -i
  27 Identify files but don't decode them.
  28 Exit status is 0 if
  29 .B dcraw
  30 can decode the last file, 1 if it can't.
  31 .TP
  32 .B -c
  33 Write binary image data to standard output.
  34 By default,
  35 .B dcraw
  36 creates files with a ".ppm" extension.
  37 .TP
  38 .B -v
  39 Print verbose messages.  Default is to print only warnings and errors.
  40 .TP
  41 .B -d
  42 Show the raw data as a grayscale image with no interpolation.
  43 Good for photographing black-and-white documents.
  44 .TP
  45 .B -q
  46 Use simple bilinear interpolation for quick results.  The
  47 default is to use a slow, high-quality adaptive algorithm.
  48 .TP
  49 .B -h
  50 Half-size the output image.  Instead of interpolating, reduce
  51 each 2x2 block of sensors to one pixel.  Much faster than
  52 .BR -q .
  53 .TP
  54 .B -f
  55 Interpolate RGB as four colors.  This causes a slight loss
  56 of detail, so use
  57 .B -f
  58 only if you see false 2x2 mesh patterns in blue sky.
  59 .TP
  60 .B -a
  61 Automatic color balance.  The default is to use a fixed
  62 color balance based on a white card photographed in sunlight.
  63 .TP
  64 .B -w
  65 Use the color balance specified by the camera.
  66 If this can't be found,
  67 .B dcraw
  68 prints a warning and reverts to the default.
  69 .TP
  70 .B -r red_mul -l blue_mul
  71 Further adjust the color balance by multiplying the red and
  72 blue channels by these values.  Both default to 1.0.
  73 .TP
  74 .B -b brightness
  75 Change the output brightness.  Default is 1.0.
  76 .TP
  77 .B -n
  78 By default,
  79 .B dcraw
  80 clips all colors to prevent pink hues in the highlights.
  81 Combine this option with
  82 .B -b 0.25
  83 to leave the image data completely unclipped.
  84 .TP
  85 .B -m
  86 Write raw camera colors to the output file.  By default,
  87 .B dcraw
  88 converts to sRGB colorspace.
  89 .TP
  90 .B -s
  91 For cameras based on the Fuji Super CCD SR, use the secondary
  92 sensors, in effect underexposing the image by four stops to
  93 reveal detail in the highlights.  For all other cameras,
  94 .B -s
  95 is silently ignored.
  96 .TP
  97 .B -t [0-7]
  98 Flip the output image.  The most common flips are 5
  99 (90 degrees CCW) and 6 (90 degrees clockwise).  By default,
 100 dcraw tries to use the flip specified by the camera.
 101 .RB \^" -t\ 0 \^"
 102 forces
 103 .B dcraw
 104 not to flip images.
 105 .TP
 106 .B -2
 107 Write eight bits per color value with a 99th-percentile white
 108 point and the standard 0.45 gamma curve.  Double the height if
 109 necessary to correct the aspect ratio.  This is the default.
 110 .TP
 111 .B -4
 112 Write sixteen bits per color value.  Output is linear with
 113 input -- no white point, no gamma, same aspect ratio.
 114 .TP
 115 .B -3
 116 Same image as
 117 .BR -4 ,
 118 written in Adobe PhotoShop format.  File extension is ".psd".
 119 .SH "SEE ALSO"
 120 ppm(5), ppm2tiff(1), pnmtotiff(1), pnmtopng(1), gphoto2(1).
 121 .SH BUGS
 122 The
 123 .B -w
 124 option does not work with many cameras.
 125 .P
 126 No attempt is made to save camera settings or thumbnail images.
 127 .P
 128 Author stubbornly refuses to add more output formats.
 129 .P
 130 Don't expect
 131 .B dcraw
 132 to produce the same images as software provided by the camera
 133 vendor.  Sometimes
 134 .B dcraw
 135 gives better results!
 136 .SH AUTHOR
 137 Written by David Coffin, dcoffin a cybercom o net