]>
Commit | Line | Data |
---|---|---|
ab7a4e6a | 1 | .\" |
2 | .\" Man page for dcraw (Raw Photo Decoder) | |
3 | .\" | |
dd32caf6 | 4 | .\" Copyright (c) 2005 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 | .\" | |
dd32caf6 | 12 | .TH dcraw 1 "April 28, 2005" |
ab7a4e6a | 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 | |
dd32caf6 | 21 | converts raw digital photos to |
ab7a4e6a | 22 | .BR ppm (5) |
dd32caf6 | 23 | format. |
ab7a4e6a | 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. | |
dd32caf6 | 34 | By default, |
ab7a4e6a | 35 | .B dcraw |
36 | creates files with a ".ppm" extension. | |
37 | .TP | |
38 | .B -v | |
dd32caf6 | 39 | Print verbose messages. Default is to print only warnings and errors. |
ab7a4e6a | 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 | |
dd32caf6 JB |
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. | |
ab7a4e6a | 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 | |
dd32caf6 JB |
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. | |
ab7a4e6a | 105 | .TP |
106 | .B -2 | |
dd32caf6 JB |
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. | |
ab7a4e6a | 110 | .TP |
111 | .B -4 | |
dd32caf6 JB |
112 | Write sixteen bits per color value. Output is linear with |
113 | input -- no white point, no gamma, same aspect ratio. | |
ab7a4e6a | 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! | |
ab7a4e6a | 136 | .SH AUTHOR |
137 | Written by David Coffin, dcoffin a cybercom o net |