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