1Cameratopam User Manual(0)                          Cameratopam User Manual(0)
2
3
4

NAME

6       cameratopam - convert raw camera image to PAM
7
8

SYNOPSIS

10       cameratopam
11
12       [input_file_name]
13
14       [-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
19       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
24

DESCRIPTION

26       This program is part of Netpbm(1).
27
28       cameratopam  converts from any of dozens of raw camera image formats to
29       PAM.
30
31       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
37
38
39

OPTIONS

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
46
47
48       -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
53
54       -verbose
55              Report to Standard Error details of the processing.
56
57
58       -quick_interpolate
59              Use simple bilinear interpolation for quick  results.   The  de‐
60              fault is to use a slow, high-quality adaptive algorithm.
61
62
63       -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
68
69       -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
74
75       -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
79
80       -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
84
85       -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
89
90       -red_scale=float
91
92       -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
96
97       -bright=float
98              Change the output brightness.  Default is 1.0.
99
100
101       -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
106
107       -rgb   Write raw camera colors to the output file.  By default, camera‐
108              toapm converts to sRGB colorspace.
109
110
111       -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
117
118       -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
126              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
130              Without -linear, cameratopam uses a 99th percentile white point.
131              With -linear, it doesn't.  I don't know what that means.
132
133
134
135
136

SEE ALSO

138       411toppm(1), pamflip(1), pam(1),
139
140

HISTORY

142       cameratopam was new in Netpbm 10.28 (June 2005).
143
144       It    was   derived   from   the   program   dcraw   by   Dave   Coffin
145https://dechifro.org/dcraw/⟩ ,  by  Bryan  Henderson  in  April  2005.
146       Bryan  replaced the part that generates the Netpbm output image and re‐
147       moved the Adobe Photoshop output function.  Bryan changed  the  command
148       syntax and made other small changes to make the program consistent with
149       Netpbm.  He also split the source code into  manageable  pieces  (dcraw
150       had a single 5000 line source file).
151

DOCUMENT SOURCE

153       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
154       source.  The master documentation is at
155
156              http://netpbm.sourceforge.net/doc/cameratopam.html
157
158netpbm documentation             12 April 2005      Cameratopam User Manual(0)
Impressum