[packages/dcraw.git] / dcraw.1

.\"
.\" Man page for dcraw (Raw Photo Decoder)
.\"
.\" Copyright (c) 2003 by David Coffin
.\"
.\" You may distribute without restriction.
.\"
.\" David Coffin
.\" dcoffin a cybercom o net
.\" http://www.cybercom.net/~dcoffin
.\"
.TH dcraw 1 "March 6, 2004"
.LO 1
.SH NAME
dcraw - convert raw digital photos to PPM format
.SH SYNOPSIS
.B dcraw 
[\fIOPTION\fR]... [\fIFILE\fR]...
.SH DESCRIPTION
.B dcraw
converts a list of raw digital camera files to
.BR ppm (5)
format.  Dozens of cameras are supported, and new ones are
added as they reach the market.
.SH OPTIONS
.TP
.B -i
Identify files but don't decode them.
Exit status is 0 if
.B dcraw
can decode the last file, 1 if it can't.
.TP
.B -c
Write binary image data to standard output.
Otherwise,
.B dcraw
creates files with a ".ppm" extension.
.TP
.B -v
Print verbose messages.  Otherwise,
.B dcraw
prints only warnings and errors.
.TP
.B -f
Interpolate RGB as four colors.  The default is to assume that
all green pixels are the same.  If even-row green pixels are
more sensitive to ultraviolet light than odd-row green pixels,
this difference causes a mesh pattern in the output.
.B -f
solves this problem with minimal loss of detail.
.TP
.B -d
Show the raw data as a grayscale image with no interpolation.
Good for photographing black-and-white documents.
.TP
.B -q
Use simple bilinear interpolation for quick results.  The
default is to use a slow, high-quality adaptive algorithm.
.TP
.B -h
Half-size the output image.  Instead of interpolating, reduce
each 2x2 block of sensors to one pixel.  Much faster than
.BR -q .
.TP
.B -g gamma
Specify the gamma value for eight-bit output.  Default is 0.6.
.TP
.B -b brightness
Specify the output brightness.  Default is 1.0.
.TP
.B -a
Automatic color balance.  The default is to use a fixed
color balance based on a white card photographed in sunlight.
.TP
.B -w
Use the color balance specified by the camera.
If this can't be found,
.B dcraw
prints a warning and reverts to the default.
.TP
.B -r red_mul -l blue_mul
After all other color adjustments, multiply the red and blue
channels by these values.  Default is 1.0.
.TP
.B -2
Write eight bits per color value with gamma correction and
automatic brightness adjustment.  Double the height
if necessary to correct the aspect ratio.  This is the default.
.TP
.B -4
Write sixteen bits per color value, with no gamma correction,
no brightness adjustment, and no changes to the aspect ratio.
.TP
.B -3
Same image as
.BR -4 ,
written in Adobe PhotoShop format.  File extension is ".psd".
.SH "SEE ALSO"
ppm(5), ppm2tiff(1), pnmtotiff(1), pnmtopng(1), gphoto2(1).
.SH BUGS
The
.B -w
option does not work with many cameras.
.P
No attempt is made to save camera settings or thumbnail images.
.P
Author stubbornly refuses to add more output formats.
.P
Don't expect
.B dcraw
to produce the same images as software provided by the camera
vendor.  Sometimes
.B dcraw
gives better results!
.SH TIPS
First raise the brightness if the highlights are too dark,
then lower the gamma if the lowlights are too dark.
Use
.B -q
or
.B -h
until you get it right.
.P
To balance the color, do
.RB \^" dcraw\ -q\ -g\ 1\ -b\ 0.5 \^"
and select a rectangle of something that you know is white.
Compute the average R, G, and B values for this area, then
set red_mul and blue_mul to G/R and G/B.
.SH AUTHOR
Written by David Coffin, dcoffin a cybercom o net
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