[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 29, 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 [0-3]
Set the interpolation quality (default is 3):

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