Debian Codegraph @

upstream/debian-unstable/man1/cameratopam.1

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