2 .\" Man page for dcraw (Raw Photo Decoder)
4 .\" Copyright (c) 2005 by David Coffin
6 .\" You may distribute without restriction.
9 .\" dcoffin a cybercom o net
10 .\" http://www.cybercom.net/~dcoffin
12 .TH dcraw 1 "August 30, 2005"
15 dcraw - convert raw digital photos to PPM format
18 [\fIOPTION\fR]... [\fIFILE\fR]...
21 converts raw digital photos to
27 Print verbose messages. The default is to print only warnings
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
36 Identify files but don't decode them.
39 can decode the last file, 1 if it can't.
43 cannot decode JPEG files!!
46 Write binary image data to standard output.
49 creates files with a ".ppm" extension.
52 Show the raw data as a grayscale image with no interpolation.
53 Good for photographing black-and-white documents.
56 Use simple bilinear interpolation for quick results. The
57 default is to use a slow, high-quality adaptive algorithm.
60 Half-size the output image. Instead of interpolating, reduce
61 each 2x2 block of sensors to one pixel. Much faster than
65 Interpolate RGB as four colors. This blurs the image a little,
66 but it eliminates false 2x2 mesh patterns.
69 Automatic color balance. The default is to use a fixed
70 color balance based on a white card photographed in sunlight.
73 Use the color balance specified by the camera.
74 If this can't be found,
76 prints a warning and reverts to the default.
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.
83 Change the output brightness. Default is 1.0.
86 Change the black point. Default depends on the camera.
91 clips all colors to prevent pink hues in the highlights.
92 Combine this option with
94 to leave the image data completely unclipped.
97 Write raw camera colors to the output file. By default,
99 converts to sRGB colorspace.
102 For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees
103 so that each output pixel corresponds to one raw pixel.
106 For Fuji\ Super\ CCD\ SR cameras, use the secondary sensors, in
107 effect underexposing the image by four stops to reveal detail
111 For all other cameras,
115 are silently ignored.
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.
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.
132 Write sixteen bits per color value. Output is linear with
133 input -- no white point, no gamma, same aspect ratio.
138 written in Adobe PhotoShop format. File extension is ".psd".
149 option does not work with many cameras.
151 No attempt is made to save camera settings or thumbnail images.
153 The author stubbornly refuses to add more output formats.
157 to produce the same images as software provided by the camera
160 gives better results!
162 Written by David Coffin, dcoffin a cybercom o net