dcraw.1

   1 .\"
   2 .\" Man page for dcraw (Raw Photo Decoder)
   3 .\"
   4 .\" Copyright (c) 2003 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 "March 6, 2004"
  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 a list of raw digital camera files to
  22 .BR ppm (5)
  23 format.  Dozens of cameras are supported, and new ones are
  24 added as they reach the market.
  25 .SH OPTIONS
  26 .TP
  27 .B -i
  28 Identify files but don't decode them.
  29 Exit status is 0 if
  30 .B dcraw
  31 can decode the last file, 1 if it can't.
  32 .TP
  33 .B -c
  34 Write binary image data to standard output.
  35 Otherwise,
  36 .B dcraw
  37 creates files with a ".ppm" extension.
  38 .TP
  39 .B -v
  40 Print verbose messages.  Otherwise,
  41 .B dcraw
  42 prints only warnings and errors.
  43 .TP
  44 .B -f
  45 Interpolate RGB as four colors.  The default is to assume that
  46 all green pixels are the same.  If even-row green pixels are
  47 more sensitive to ultraviolet light than odd-row green pixels,
  48 this difference causes a mesh pattern in the output.
  49 .B -f
  50 solves this problem with minimal loss of detail.
  51 .TP
  52 .B -d
  53 Show the raw data as a grayscale image with no interpolation.
  54 Good for photographing black-and-white documents.
  55 .TP
  56 .B -q
  57 Use simple bilinear interpolation for quick results.  The
  58 default is to use a slow, high-quality adaptive algorithm.
  59 .TP
  60 .B -h
  61 Half-size the output image.  Instead of interpolating, reduce
  62 each 2x2 block of sensors to one pixel.  Much faster than
  63 .BR -q .
  64 .TP
  65 .B -g gamma
  66 Specify the gamma value for eight-bit output.  Default is 0.6.
  67 .TP
  68 .B -b brightness
  69 Specify the output brightness.  Default is 1.0.
  70 .TP
  71 .B -a
  72 Automatic color balance.  The default is to use a fixed
  73 color balance based on a white card photographed in sunlight.
  74 .TP
  75 .B -w
  76 Use the color balance specified by the camera.
  77 If this can't be found,
  78 .B dcraw
  79 prints a warning and reverts to the default.
  80 .TP
  81 .B -r red_mul -l blue_mul
  82 After all other color adjustments, multiply the red and blue
  83 channels by these values.  Default is 1.0.
  84 .TP
  85 .B -2
  86 Write eight bits per color value with gamma correction and
  87 automatic brightness adjustment.  Double the height
  88 if necessary to correct the aspect ratio.  This is the default.
  89 .TP
  90 .B -4
  91 Write sixteen bits per color value, with no gamma correction,
  92 no brightness adjustment, and no changes to the aspect ratio.
  93 .TP
  94 .B -3
  95 Same image as
  96 .BR -4 ,
  97 written in Adobe PhotoShop format.  File extension is ".psd".
  98 .SH "SEE ALSO"
  99 ppm(5), ppm2tiff(1), pnmtotiff(1), pnmtopng(1), gphoto2(1).
 100 .SH BUGS
 101 The
 102 .B -w
 103 option does not work with many cameras.
 104 .P
 105 No attempt is made to save camera settings or thumbnail images.
 106 .P
 107 Author stubbornly refuses to add more output formats.
 108 .P
 109 Don't expect
 110 .B dcraw
 111 to produce the same images as software provided by the camera
 112 vendor.  Sometimes
 113 .B dcraw
 114 gives better results!
 115 .SH TIPS
 116 First raise the brightness if the highlights are too dark,
 117 then lower the gamma if the lowlights are too dark.
 118 Use
 119 .B -q
 120 or
 121 .B -h
 122 until you get it right.
 123 .P
 124 To balance the color, do
 125 .RB \^" dcraw\ -q\ -g\ 1\ -b\ 0.5 \^"
 126 and select a rectangle of something that you know is white.
 127 Compute the average R, G, and B values for this area, then
 128 set red_mul and blue_mul to G/R and G/B.
 129 .SH AUTHOR
 130 Written by David Coffin, dcoffin a cybercom o net