- updated (source, manpage, license, desc).
[packages/dcraw.git] / dcraw.1
CommitLineData
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.\"
6e043b5b 12.TH dcraw 1 "August 30, 2005"
ab7a4e6a 13.LO 1
14.SH NAME
15dcraw - 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 21converts raw digital photos to
ab7a4e6a 22.BR ppm (5)
dd32caf6 23format.
ab7a4e6a 24.SH OPTIONS
25.TP
6e043b5b
PS
26.B -v
27Print verbose messages. The default is to print only warnings
28and errors.
29.TP
30.B -z
31Change the access and modification times of a JPEG or raw file to
32when the photo was taken, assuming that the camera clock was set
33to Universal Time.
34.TP
ab7a4e6a 35.B -i
36Identify files but don't decode them.
37Exit status is 0 if
38.B dcraw
39can decode the last file, 1 if it can't.
40.TP
6e043b5b
PS
41.B ""
42.B dcraw
43cannot decode JPEG files!!
44.TP
ab7a4e6a 45.B -c
46Write binary image data to standard output.
dd32caf6 47By default,
ab7a4e6a 48.B dcraw
49creates files with a ".ppm" extension.
50.TP
ab7a4e6a 51.B -d
52Show the raw data as a grayscale image with no interpolation.
53Good for photographing black-and-white documents.
54.TP
55.B -q
56Use simple bilinear interpolation for quick results. The
57default is to use a slow, high-quality adaptive algorithm.
58.TP
59.B -h
60Half-size the output image. Instead of interpolating, reduce
61each 2x2 block of sensors to one pixel. Much faster than
62.BR -q .
63.TP
dd32caf6 64.B -f
6e043b5b
PS
65Interpolate RGB as four colors. This blurs the image a little,
66but it eliminates false 2x2 mesh patterns.
ab7a4e6a 67.TP
68.B -a
69Automatic color balance. The default is to use a fixed
70color balance based on a white card photographed in sunlight.
71.TP
72.B -w
73Use the color balance specified by the camera.
74If this can't be found,
75.B dcraw
76prints a warning and reverts to the default.
77.TP
78.B -r red_mul -l blue_mul
dd32caf6
JB
79Further adjust the color balance by multiplying the red and
80blue channels by these values. Both default to 1.0.
81.TP
82.B -b brightness
83Change the output brightness. Default is 1.0.
84.TP
6e043b5b
PS
85.B -k black
86Change the black point. Default depends on the camera.
87.TP
dd32caf6
JB
88.B -n
89By default,
90.B dcraw
91clips all colors to prevent pink hues in the highlights.
92Combine this option with
93.B -b 0.25
94to leave the image data completely unclipped.
95.TP
96.B -m
97Write raw camera colors to the output file. By default,
98.B dcraw
99converts to sRGB colorspace.
100.TP
6e043b5b
PS
101.B -j
102For Fuji\ Super\ CCD cameras, show the image tilted 45 degrees
103so that each output pixel corresponds to one raw pixel.
104.TP
dd32caf6 105.B -s
6e043b5b
PS
106For Fuji\ Super\ CCD\ SR cameras, use the secondary sensors, in
107effect underexposing the image by four stops to reveal detail
108in the highlights.
109.TP
110.B ""
111For all other cameras,
112.B -j
113and
dd32caf6 114.B -s
6e043b5b 115are silently ignored.
dd32caf6
JB
116.TP
117.B -t [0-7]
118Flip the output image. The most common flips are 5
119(90 degrees CCW) and 6 (90 degrees clockwise). By default,
120dcraw tries to use the flip specified by the camera.
121.RB \^" -t\ 0 \^"
122forces
123.B dcraw
124not to flip images.
ab7a4e6a 125.TP
126.B -2
dd32caf6
JB
127Write eight bits per color value with a 99th-percentile white
128point and the standard 0.45 gamma curve. Double the height if
129necessary to correct the aspect ratio. This is the default.
ab7a4e6a 130.TP
131.B -4
dd32caf6
JB
132Write sixteen bits per color value. Output is linear with
133input -- no white point, no gamma, same aspect ratio.
ab7a4e6a 134.TP
135.B -3
136Same image as
137.BR -4 ,
138written in Adobe PhotoShop format. File extension is ".psd".
139.SH "SEE ALSO"
6e043b5b
PS
140.BR ppm (5),
141.BR ppm2tiff (1),
142.BR pnmtotiff (1),
143.BR pnmtopng (1),
144.BR gphoto2 (1),
145.BR djpeg (1)
ab7a4e6a 146.SH BUGS
147The
148.B -w
149option does not work with many cameras.
150.P
151No attempt is made to save camera settings or thumbnail images.
152.P
6e043b5b 153The author stubbornly refuses to add more output formats.
ab7a4e6a 154.P
155Don't expect
156.B dcraw
157to produce the same images as software provided by the camera
158vendor. Sometimes
159.B dcraw
160gives better results!
ab7a4e6a 161.SH AUTHOR
162Written by David Coffin, dcoffin a cybercom o net
This page took 0.062223 seconds and 4 git commands to generate.