1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it! If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Cameratopam User Manual" 0 "12 April 2005" "netpbm documentation"
.SH NAME
cameratopam - convert raw camera image to PAM
.UN synopsis
.SH SYNOPSIS
\fBcameratopam\fP
[\fIinput_file_name\fP]
[\fB-identify_only\fP]
[\fB-quick_interpolate\fP]
[\fB-half_size\fP]
[\fB-four_color_rgb\fP]
[\fB-document_mode\fP]
[\fB-balance_auto\fP]
[\fB-balance_camera\fP]
[\fB-red_scale=\fP\fIfloat\fP]
[\fB-blue_scale=\fP\fIfloat\fP]
[\fB-brightness=\fP\fIfraction\fP]
[\fB-no_clip_color\fP]
[\fB-rgb\fP]
[\fB-secondary\fP]
[\fB-linear\fP]
[\fB-verbose\fP]
.PP
All options can be abbreviated to their shortest unique prefix. You
may use two hyphens instead of one to designate an option. You may
use either white space or an equals sign between an option name and
its value.
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBcameratopam\fP converts from any of dozens of raw camera image
formats to PAM.
.PP
Digital still cameras often can produce images in a special raw
format in addition to something more standard such as TIFF or JFIF
(JPEG). Software supplied with the camera allows you to manipulate
the image using information which is lost when the camera converts to
the common format. A particular camera model often has a unique raw
format.
.UN options
.SH OPTIONS
.TP
\fB-identify_only\fP
Report to Standard Error the format of the input image but don't
generate an output image. Program fails if it cannot recognize the
format.
.TP
\fB-verbose\fP
Report to Standard Error details of the processing.
.TP
\fB-quick_interpolate\fP
Use simple bilinear interpolation for quick results. The default
is to use a slow, high-quality adaptive algorithm.
.TP
\fB-half_size\fP
Half-size the output image. Instead of interpolating, reduce
each 2x2 block of sensors to one pixel. Much faster than
\fB-quick_interpolate\fP.
.TP
\fB-four_color_rgb\fP
Interpolate RGB as four colors. This causes a slight loss of
detail, so use this only if you see false 2x2 mesh patterns in blue
sky.
.TP
\fB-document_mode\fP
Show the raw data as a grayscale image with no interpolation.
This is good for photographing black and white documents.
.TP
\fB-balance_auto\fP
Automatic color balance. The default is to use a fixed
color balance based on a white card photographed in sunlight.
.TP
\fB-balance_camera\fP
Use the color balance specified by the camera. If
\fBcameratopam\fP can't find this, it prints a warning and reverts to
the default.
.TP
\fB-red_scale=\fP\fIfloat\fP
.TP
\fB-blue_scale\fP\fIfloat\fP
Further adjust the color balance by multiplying the red and blue
channels by these values. Both default to 1.0.
.TP
\fB-brightness=\fP\fIfloat\fP
Change the output brightness. Default is 1.0.
.TP
\fB-no_clip_color\fP
By default, \fBcameratoapm\fP clips all colors to prevent pink
hues in the highlights. Combine this option with
\fB-brightness=0.25\fP to leave the image data completely unclipped.
.TP
\fB-rgb\fP
Write raw camera colors to the output file. By default,
\fBcameratoapm\fP converts to sRGB colorspace.
.TP
\fB-secondary\fP
For cameras based on the Fuji Super CCD SR, this option causes
\fBcameratopam\fP to use the secondary sensors, in effect
underexposing the image by four stops to reveal detail in the
highlights. \fBcameratopam\fP silently ignores this option for all
other cameras.
.TP
\fB-linear\fP
This option causes \fBcameratopam\fP to generate a variation on
PAM that has "linear" color samples. In true PAM, each
sample in the image raster is gamma-corrected; i.e. it is essentially
proportional to brightness. With the \fBlinear\fP option,
\fBcameratopam\fP generates an image in which the samples are instead
proportional to light intensity.
.sp
Without \fB-linear\fP, the image maxval is 255, so the image
contains one byte per sample. With \fB-linear\fP, the maxval is
65535, so the image contains two bytes per sample.
.sp
Without \fB-linear\fP, \fBcameratopam\fP uses a 99th percentile
white point. With \fB-linear\fP, it doesn't. I don't know what that
means.
.UN seealso
.SH SEE ALSO
.BR "411toppm" (1)\c
\&,
.BR "pamflip" (1)\c
\&,
.BR "pam" (5)\c
\&,
.UN history
.SH HISTORY
.PP
\fBcameratopam\fP was new in Netpbm 10.28 (June 2005).
.PP
It was derived from the program
.UR http://www.cybercom.net/~dcoffin/dcraw/
\fBdcraw\fP by Dave Coffin
.UE
\&, by Bryan Henderson in April 2005. Bryan replaced the part
that generates the Netpbm output image and removed the Adobe Photoshop
output function. Bryan changed the command syntax and made other
small changes to make the program consistent with Netpbm. He also
split the source code into manageable pieces (\fBdcraw\fP has a
single 5000 line source file).
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/cameratopam.html
.PP
|
