]>
Commit | Line | Data |
---|---|---|
ab7a4e6a | 1 | .\" |
1112078b | 2 | .\" Man page for dcraw |
ab7a4e6a | 3 | .\" |
1112078b | 4 | .\" Copyright (c) 2007 by David Coffin |
ab7a4e6a | 5 | .\" |
6 | .\" You may distribute without restriction. | |
7 | .\" | |
8 | .\" David Coffin | |
9 | .\" dcoffin a cybercom o net | |
10 | .\" http://www.cybercom.net/~dcoffin | |
11 | .\" | |
1112078b | 12 | .TH dcraw 1 "June 8, 2007" |
ab7a4e6a | 13 | .LO 1 |
14 | .SH NAME | |
1112078b | 15 | dcraw - command-line decoder for raw digital photos |
ab7a4e6a | 16 | .SH SYNOPSIS |
1112078b | 17 | .B dcraw |
ab7a4e6a | 18 | [\fIOPTION\fR]... [\fIFILE\fR]... |
19 | .SH DESCRIPTION | |
20 | .B dcraw | |
1112078b | 21 | decodes raw photos, displays metadata, and extracts thumbnails. |
ab7a4e6a | 22 | .SH OPTIONS |
23 | .TP | |
6e043b5b | 24 | .B -v |
1112078b PG |
25 | Print verbose messages, not just warnings and errors. |
26 | .TP | |
27 | .B -c | |
28 | Write decoded images or thumbnails to standard output. | |
29 | .TP | |
30 | .B -e | |
31 | Extract the camera-generated thumbnail, not the raw image. | |
32 | You'll get either a JPEG or a PPM file, depending on the camera. | |
6e043b5b PS |
33 | .TP |
34 | .B -z | |
1112078b PG |
35 | Change the access and modification times of an AVI, JPEG or raw |
36 | file to when the photo was taken, assuming that the camera clock | |
37 | was set to Universal Time. | |
6e043b5b | 38 | .TP |
ab7a4e6a | 39 | .B -i |
40 | Identify files but don't decode them. | |
41 | Exit status is 0 if | |
42 | .B dcraw | |
43 | can decode the last file, 1 if it can't. | |
1112078b PG |
44 | .B -i -v |
45 | shows metadata. | |
ab7a4e6a | 46 | .TP |
6e043b5b PS |
47 | .B "" |
48 | .B dcraw | |
49 | cannot decode JPEG files!! | |
50 | .TP | |
ab7a4e6a | 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 | |
1112078b PG |
55 | .B -D |
56 | Same as | |
57 | .BR -d , | |
58 | but totally raw (no color scaling). | |
ab7a4e6a | 59 | .TP |
60 | .B -h | |
1112078b | 61 | Output a half-size color image. Twice as fast as |
c35ebd7b | 62 | .BR -q\ 0 . |
ab7a4e6a | 63 | .TP |
1112078b PG |
64 | .B -q 0 |
65 | Use high-speed, low-quality bilinear interpolation. | |
66 | .TP | |
67 | .B -q 1 | |
68 | Use Variable Number of Gradients (VNG) interpolation. | |
69 | .TP | |
70 | .B -q 2 | |
71 | Use Patterned Pixel Grouping (PPG) interpolation. | |
72 | .TP | |
73 | .B -q 3 | |
74 | Use Adaptive Homogeneity-Directed (AHD) interpolation. | |
75 | .TP | |
dd32caf6 | 76 | .B -f |
1112078b PG |
77 | Interpolate RGB as four colors. Use this if the output shows |
78 | false 2x2 meshes with VNG or mazes with AHD. | |
04f33990 | 79 | .TP |
1112078b PG |
80 | .B -n noise_threshold |
81 | Use wavelets to erase noise while preserving real detail. | |
82 | The best threshold should be somewhere between 100 and 1000. | |
ab7a4e6a | 83 | .TP |
1112078b PG |
84 | .B -b brightness |
85 | By default, | |
ab7a4e6a | 86 | .B dcraw |
1112078b PG |
87 | writes 8-bit PGM/PPM/PAM with a BT.709 gamma curve and a |
88 | 99th-percentile white point. If the result is too light or | |
89 | too dark, | |
90 | .B -b | |
91 | lets you adjust it. Default is 1.0. | |
ab7a4e6a | 92 | .TP |
1112078b PG |
93 | .B -4 |
94 | Write 16-bit linear pseudo-PGM/PPM/PAM with no gamma curve, | |
95 | no white point, and no | |
96 | .B -b | |
97 | option. | |
dd32caf6 | 98 | .TP |
1112078b PG |
99 | .B -T |
100 | Write TIFF output (with metadata) instead of PGM/PPM/PAM. | |
dd32caf6 | 101 | .TP |
6e043b5b | 102 | .B -k black |
c35ebd7b | 103 | Set the black point. Default depends on the camera. |
6e043b5b | 104 | .TP |
1112078b PG |
105 | .B -K darkframe.pgm |
106 | Subtract a dark frame from the raw data. To generate a | |
107 | dark frame, shoot a raw photo with no light and do | |
108 | .BR dcraw\ -D\ -4\ -j\ -t\ 0 . | |
109 | .TP | |
110 | .B -w | |
111 | Use the white balance specified by the camera. | |
112 | If this is not found, print a warning and use another method. | |
113 | .TP | |
114 | .B -a | |
115 | Calculate the white balance by averaging the entire image. | |
116 | .TP | |
117 | .B -A left top width height | |
118 | Calculate the white balance by averaging a rectangular area. | |
119 | First do | |
120 | .B dcraw\ -j\ -t\ 0 | |
121 | and select an area of neutral grey color. | |
122 | .TP | |
123 | .B -r mul0 mul1 mul2 mul3 | |
124 | Specify your own raw white balance. | |
125 | These multipliers can be cut and pasted from the output of | |
126 | .BR dcraw\ -v . | |
127 | .TP | |
128 | no white balance option | |
129 | Use a fixed white balance based on a color chart illuminated | |
130 | with a standard D65 lamp. | |
131 | .TP | |
132 | .B -M | |
133 | If the raw metadata contains a color matrix, don't use it. | |
134 | This option only affects Olympus, Leaf, and Phase One cameras. | |
135 | .TP | |
136 | .B -C red_mag blue_mag | |
137 | Enlarge the raw red and blue layers by the given factors, | |
138 | typically 0.999 to 1.001, to correct chromatic aberration. | |
139 | .TP | |
140 | .B -H 0 | |
141 | Clip all highlights to solid white (default). | |
142 | .TP | |
143 | .B -H 1 | |
144 | Leave highlights unclipped in various shades of pink. | |
145 | .TP | |
146 | .B -H 2 | |
147 | Blend clipped and unclipped values together for a gradual fade to white. | |
148 | .TP | |
149 | .B -H 3-9 | |
150 | Reconstruct highlights. Low numbers favor whites; high numbers | |
151 | favor colors. Try | |
152 | .B -H 5 | |
153 | as a compromise. If that's not good enough, do | |
154 | .BR -H\ 9 , | |
155 | cut out the non-white highlights, and paste them into an image | |
156 | generated with | |
157 | .BR -H\ 3 . | |
dd32caf6 JB |
158 | .TP |
159 | .B -m | |
1112078b PG |
160 | Same as |
161 | .BR -o\ 0 . | |
162 | .TP | |
163 | .B -o [0-5] | |
164 | Select the output colorspace when the | |
165 | .B -p | |
166 | option is not used: | |
167 | ||
168 | .B \t0 | |
169 | \ \ Raw color (unique to each camera) | |
170 | .br | |
171 | .B \t1 | |
172 | \ \ sRGB D65 (default) | |
173 | .br | |
174 | .B \t2 | |
175 | \ \ Adobe RGB (1998) D65 | |
176 | .br | |
177 | .B \t3 | |
178 | \ \ Wide Gamut RGB D65 | |
179 | .br | |
180 | .B \t4 | |
181 | \ \ Kodak ProPhoto RGB D65 | |
182 | .br | |
183 | .B \t5 | |
184 | \ \ XYZ | |
185 | .TP | |
186 | .BR -p\ camera.icm \ [\ -o\ output.icm \ ] | |
187 | Use ICC profiles to define the camera's raw colorspace and the | |
188 | desired output colorspace (sRGB by default). | |
189 | .TP | |
190 | .B -p embed | |
191 | Use the ICC profile embedded in the raw photo. | |
192 | .TP | |
193 | .B -t [0-7,90,180,270] | |
194 | Flip the output image. By default, | |
dd32caf6 | 195 | .B dcraw |
1112078b PG |
196 | applies the flip specified by the camera. |
197 | .B -t 0 | |
198 | disables all flipping. | |
dd32caf6 | 199 | .TP |
1112078b PG |
200 | .B -s [0-99] |
201 | Select which raw image to decode if the file contains more than one. | |
202 | For example, Fuji\ Super\ CCD\ SR cameras generate a second image | |
203 | underexposed four stops to show detail in the highlights. | |
6e043b5b | 204 | .TP |
1112078b PG |
205 | .B -j |
206 | For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees. | |
207 | For cameras with non-square pixels, do not stretch the image to | |
208 | its correct aspect ratio. In any case, this option guarantees | |
209 | that each output pixel corresponds to one raw pixel. | |
6e043b5b PS |
210 | .TP |
211 | .B "" | |
1112078b | 212 | If they don't apply to your camera, |
dd32caf6 | 213 | .B -s |
1112078b PG |
214 | and |
215 | .B -j | |
6e043b5b | 216 | are silently ignored. |
1112078b | 217 | .SH FILES |
dd32caf6 | 218 | .TP |
1112078b PG |
219 | \:./.badpixels, ../.badpixels, ../../.badpixels, ... |
220 | List of your camera's dead pixels, so that | |
dd32caf6 | 221 | .B dcraw |
1112078b PG |
222 | can interpolate around them. Each line specifies the column, |
223 | row, and UNIX time of death for one pixel. For example: | |
224 | .sp 1 | |
225 | .nf | |
226 | 962 91 1028350000 # died between August 1 and 4, 2002 | |
227 | 1285 1067 0 # don't know when this pixel died | |
228 | .fi | |
229 | .sp 1 | |
230 | These coordinates are before any cropping or rotation, so use | |
231 | .B dcraw -j -t 0 | |
232 | to locate dead pixels. | |
ab7a4e6a | 233 | .SH "SEE ALSO" |
1112078b | 234 | .BR pgm (5), |
6e043b5b | 235 | .BR ppm (5), |
1112078b PG |
236 | .BR pam (5), |
237 | .BR pnmgamma (1), | |
6e043b5b PS |
238 | .BR pnmtotiff (1), |
239 | .BR pnmtopng (1), | |
240 | .BR gphoto2 (1), | |
1112078b | 241 | .BR cjpeg (1), |
6e043b5b | 242 | .BR djpeg (1) |
ab7a4e6a | 243 | .SH AUTHOR |
244 | Written by David Coffin, dcoffin a cybercom o net |