- updated to 2005/11/06.
[packages/dcraw.git] / dcraw.1
1 .\"
2 .\" Man page for dcraw (Raw Photo Decoder)
3 .\"
4 .\" Copyright (c) 2005 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 "September 29, 2005"
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 raw digital photos to
22 .BR ppm (5)
23 format.
24 .SH OPTIONS
25 .TP
26 .B -v
27 Print verbose messages.  The default is to print only warnings
28 and errors.
29 .TP
30 .B -z
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
33 to Universal Time.
34 .TP
35 .B -i
36 Identify files but don't decode them.
37 Exit status is 0 if
38 .B dcraw
39 can decode the last file, 1 if it can't.
40 .TP
41 .B ""
42 .B dcraw
43 cannot decode JPEG files!!
44 .TP
45 .B -c
46 Write binary image data to standard output.
47 By default,
48 .B dcraw
49 creates files with a ".ppm" extension.
50 .TP
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
55 .B -q [0-3]
56 Set the interpolation quality (default is 3):
57
58 .B \t0
59 \ \ Bilinear (very fast, low quality)
60 .br
61 .B \t1
62 \ \ Reserved
63 .br
64 .B \t2
65 \ \ Variable Number of Gradients (VNG)
66 .br
67 .B \t3
68 \ \ Adaptive Homogeneity-Directed (AHD)
69 .TP
70 .B -h
71 Output a half-size image.  Twice as fast as
72 .BR -q\ 0 .
73 .TP
74 .B -f
75 Interpolate RGB as four colors.  This blurs the image a little,
76 but it eliminates false 2x2 mesh patterns.
77 .TP
78 .B -B sigma_domain sigma_range
79 Use a bilateral filter to smooth noise while preserving edges.
80 .B sigma_domain
81 is in units of pixels, while
82 .B sigma_range
83 is in units of CIELab colorspace.
84 Try
85 .B -B\ 2\ 4
86 to start.
87 .TP
88 .B -a
89 Automatic color balance.  The default is to use a fixed
90 color balance based on a white card photographed in sunlight.
91 .TP
92 .B -w
93 Use the color balance specified by the camera.
94 If this can't be found,
95 .B dcraw
96 prints a warning and reverts to the default.
97 .TP
98 .B -r red_mul -l blue_mul
99 Further adjust the color balance by multiplying the red and
100 blue output channels by these values.  Both default to 1.0.
101 .TP
102 .B -b brightness
103 Change the output brightness.  Default is 1.0.
104 .TP
105 .B -k black
106 Set the black point.  Default depends on the camera.
107 .TP
108 .B -n
109 By default,
110 .B dcraw
111 clips all colors to prevent pink hues in the highlights.
112 Combine this option with
113 .B -b 0.25
114 to leave the image data completely unclipped.
115 .TP
116 .B -m
117 Write raw camera colors to the output file.  By default,
118 .B dcraw
119 converts to sRGB colorspace.
120 .TP
121 .B -j
122 For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees
123 so that each output pixel corresponds to one raw pixel.
124 .TP
125 .B -s
126 For Fuji\ Super\ CCD\ SR cameras, use the secondary sensors, in
127 effect underexposing the image by four stops to reveal detail
128 in the highlights.
129 .TP
130 .B ""
131 For all other cameras,
132 .B -j
133 and
134 .B -s
135 are silently ignored.
136 .TP
137 .B -t [0-7]
138 Flip the output image.  The most common flips are 5
139 (90 degrees CCW) and 6 (90 degrees clockwise).  By default,
140 dcraw tries to use the flip specified by the camera.
141 .RB \^" -t\ 0 \^"
142 forces
143 .B dcraw
144 not to flip images.
145 .TP
146 .B -2
147 Write eight bits per color value with a 99th-percentile white
148 point and the standard 0.45 gamma curve.  Double the height if
149 necessary to correct the aspect ratio.  This is the default.
150 .TP
151 .B -4
152 Write sixteen bits per color value.  Output is linear with
153 input -- no white point, no gamma, same aspect ratio.
154 .TP
155 .B -3
156 Same image as
157 .BR -4 ,
158 written in Adobe PhotoShop format.  File extension is ".psd".
159 .SH "SEE ALSO"
160 .BR ppm (5),
161 .BR ppm2tiff (1),
162 .BR pnmtotiff (1),
163 .BR pnmtopng (1),
164 .BR gphoto2 (1),
165 .BR djpeg (1)
166 .SH BUGS
167 The
168 .B -w
169 option does not work with many cameras.
170 .P
171 No attempt is made to save camera settings or thumbnail images.
172 .P
173 The author stubbornly refuses to add more output formats.
174 .P
175 Don't expect
176 .B dcraw
177 to produce the same images as software provided by the camera
178 vendor.  Sometimes
179 .B dcraw
180 gives better results!
181 .SH AUTHOR
182 Written by David Coffin, dcoffin a cybercom o net
This page took 0.051053 seconds and 3 git commands to generate.