1Cameratopam User Manual(0) Cameratopam User Manual(0)
2
6 cameratopam - convert raw camera image to PAM
7
10 cameratopam
11 [input_file_name]
13 [-identify_only] [-quick_interpolate] [-half_size] [-four_color_rgb]
15 [-document_mode] [-balance_auto] [-balance_camera] [-red_scale=float]
16 [-blue_scale=float] [-bright=fraction] [-no_clip_color] [-rgb]
17 [-use_secondary] [-linear] [-verbose]
18 All options can be abbreviated to their shortest unique prefix. You
20 may use two hyphens instead of one to designate an option. You may use
21 either white space or an equals sign between an option name and its
22 value.
23
26 This program is part of Netpbm(1).
27 cameratopam converts from any of dozens of raw camera image formats to
29 PAM.
30 Digital still cameras often can produce images in a special raw format
32 in addition to something more standard such as TIFF or JFIF (JPEG).
33 Software supplied with the camera allows you to manipulate the image
34 using information which is lost when the camera converts to the common
35 format. A particular camera model often has a unique raw format.
36
41 In addition to the options common to all programs based on libnetpbm
42 (most notably -quiet, see
43 Common Options ⟨index.html#commonoptions⟩ ), cameratopam recognizes
44 the following command line options:
45 -identify_only
49 Report to Standard Error the format of the input image but don't
50 generate an output image. Program fails if it cannot recognize
51 the format.
52 -verbose
55 Report to Standard Error details of the processing.
56 -quick_interpolate
59 Use simple bilinear interpolation for quick results. The
60 default is to use a slow, high-quality adaptive algorithm.
61 -half_size
64 Half-size the output image. Instead of interpolating, reduce
65 each 2x2 block of sensors to one pixel. Much faster than
66 -quick_interpolate.
67 -four_color_rgb
70 Interpolate RGB as four colors. This causes a slight loss of
71 detail, so use this only if you see false 2x2 mesh patterns in
72 blue sky.
73 -document_mode
76 Show the raw data as a grayscale image with no interpolation.
77 This is good for photographing black and white documents.
78 -balance_auto
81 Automatic color balance. The default is to use a fixed color
82 balance based on a white card photographed in sunlight.
83 -balance_camera
86 Use the color balance specified by the camera. If cameratopam
87 can't find this, it prints a warning and reverts to the default.
88 -red_scale=float
91 -blue_scalefloat
93 Further adjust the color balance by multiplying the red and blue
94 channels by these values. Both default to 1.0.
95 -bright=float
98 Change the output brightness. Default is 1.0.
99 -no_clip_color
102 By default, cameratoapm clips all colors to prevent pink hues in
103 the highlights. Combine this option with -bright=0.25 to leave
104 the image data completely unclipped.
105 -rgb Write raw camera colors to the output file. By default, camera‐
108 toapm converts to sRGB colorspace.
109 -use_secondary
112 For cameras based on the Fuji Super CCD SR, this option causes
113 cameratopam to use the secondary sensors, in effect underexpos‐
114 ing the image by four stops to reveal detail in the highlights.
115 cameratopam silently ignores this option for all other cameras.
116 -linear
119 This option causes cameratopam to generate a variation on PAM
120 that has "linear" color samples. In true PAM, each sample in
121 the image raster is gamma-corrected; i.e. it is essentially pro‐
122 portional to brightness. With the linear option, cameratopam
123 generates an image in which the samples are instead proportional
124 to light intensity.
125 Without -linear, the image maxval is 255, so the image contains
127 one byte per sample. With -linear, the maxval is 65535, so the
128 image contains two bytes per sample.
129 Without -linear, cameratopam uses a 99th percentile white point.
131 With -linear, it doesn't. I don't know what that means.
132
138 411toppm(1), pamflip(1), pam(1),
139
142 cameratopam was new in Netpbm 10.28 (June 2005).
143 It was derived from the program dcraw by Dave Coffin
145 ⟨http://www.cybercom.net/~dcoffin/dcraw/⟩ , by Bryan Henderson in April
146 2005. Bryan replaced the part that generates the Netpbm output image
147 and removed the Adobe Photoshop output function. Bryan changed the
148 command syntax and made other small changes to make the program consis‐
149 tent with Netpbm. He also split the source code into manageable pieces
150 (dcraw has a single 5000 line source file).
151
153 This manual page was generated by the Netpbm tool 'makeman' from HTML
154 source. The master documentation is at
155 http://netpbm.sourceforge.net/doc/cameratopam.html
157netpbm documentation 12 April 2005 Cameratopam User Manual(0)