[packages/dcraw.git] / dcraw.1

.\"
.\" Man page for dcraw (Raw Photo Decoder)
.\"
.\" Copyright (c) 2005 by David Coffin
.\"
.\" You may distribute without restriction.
.\"
.\" David Coffin
.\" dcoffin a cybercom o net
.\" http://www.cybercom.net/~dcoffin
.\"
.TH dcraw 1 "April 28, 2005"
.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 raw digital photos to
.BR ppm (5)
format.
.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.
By default,
.B dcraw
creates files with a ".ppm" extension.
.TP
.B -v
Print verbose messages.  Default is to print only warnings and errors.
.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 -f
Interpolate RGB as four colors.  This causes a slight loss
of detail, so use
.B -f
only if you see false 2x2 mesh patterns in blue sky.
.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
Further adjust the color balance by multiplying the red and
blue channels by these values.  Both default to 1.0.
.TP
.B -b brightness
Change the output brightness.  Default is 1.0.
.TP
.B -n
By default,
.B dcraw
clips all colors to prevent pink hues in the highlights.
Combine this option with
.B -b 0.25
to leave the image data completely unclipped.
.TP
.B -m
Write raw camera colors to the output file.  By default,
.B dcraw
converts to sRGB colorspace.
.TP
.B -s
For cameras based on the Fuji Super CCD SR, use the secondary
sensors, in effect underexposing the image by four stops to
reveal detail in the highlights.  For all other cameras,
.B -s
is silently ignored.
.TP
.B -t [0-7]
Flip the output image.  The most common flips are 5
(90 degrees CCW) and 6 (90 degrees clockwise).  By default,
dcraw tries to use the flip specified by the camera.
.RB \^" -t\ 0 \^"
forces
.B dcraw
not to flip images.
.TP
.B -2
Write eight bits per color value with a 99th-percentile white
point and the standard 0.45 gamma curve.  Double the height if
necessary to correct the aspect ratio.  This is the default.
.TP
.B -4
Write sixteen bits per color value.  Output is linear with
input -- no white point, no gamma, same 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 AUTHOR
Written by David Coffin, dcoffin a cybercom o net
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
ab7a4e6a	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
ab7a4e6a	111	.B -4
dd32caf6 JB	112	Write sixteen bits per color value. Output is linear with
dd32caf6 JB	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
ab7a4e6a	137	Written by David Coffin, dcoffin a cybercom o net