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