]>
Commit | Line | Data |
---|---|---|
ab7a4e6a | 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 |