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       -identify_only
42              Report to Standard Error the format of the input image but don't
43              generate  an output image.  Program fails if it cannot recognize
44              the format.
45
46
47       -verbose
48              Report to Standard Error details of the processing.
49
50
51       -quick_interpolate
52              Use  simple  bilinear  interpolation  for  quick  results.   The
53              default is to use a slow, high-quality adaptive algorithm.
54
55
56       -half_size
57              Half-size  the  output  image.  Instead of interpolating, reduce
58              each 2x2 block of  sensors  to  one  pixel.   Much  faster  than
59              -quick_interpolate.
60
61
62       -four_color_rgb
63              Interpolate  RGB  as  four colors.  This causes a slight loss of
64              detail, so use this only if you see false 2x2 mesh  patterns  in
65              blue sky.
66
67
68       -document_mode
69              Show  the  raw  data as a grayscale image with no interpolation.
70              This is good for photographing black and white documents.
71
72
73       -balance_auto
74              Automatic color balance.  The default is to use  a  fixed  color
75              balance based on a white card photographed in sunlight.
76
77
78       -balance_camera
79              Use  the  color balance specified by the camera.  If cameratopam
80              can't find this, it prints a warning and reverts to the default.
81
82
83       -red_scale=float
84
85       -blue_scalefloat
86              Further adjust the color balance by multiplying the red and blue
87              channels by these values.  Both default to 1.0.
88
89
90       -bright=float
91              Change the output brightness.  Default is 1.0.
92
93
94       -no_clip_color
95              By default, cameratoapm clips all colors to prevent pink hues in
96              the highlights.  Combine this option with -bright=0.25 to  leave
97              the image data completely unclipped.
98
99
100       -rgb   Write raw camera colors to the output file.  By default, camera‐
101              toapm converts to sRGB colorspace.
102
103
104       -use_secondary
105              For cameras based on the Fuji Super CCD SR, this  option  causes
106              cameratopam  to use the secondary sensors, in effect underexpos‐
107              ing the image by four stops to reveal detail in the  highlights.
108              cameratopam silently ignores this option for all other cameras.
109
110
111       -linear
112              This  option  causes  cameratopam to generate a variation on PAM
113              that has 'linear' color samples.  In true PAM,  each  sample  in
114              the image raster is gamma-corrected; i.e. it is essentially pro‐
115              portional to brightness.  With the  linear  option,  cameratopam
116              generates an image in which the samples are instead proportional
117              to light intensity.
118
119              Without -linear, the image maxval is 255, so the image  contains
120              one  byte per sample.  With -linear, the maxval is 65535, so the
121              image contains two bytes per sample.
122
123              Without -linear, cameratopam uses a 99th percentile white point.
124              With -linear, it doesn't.  I don't know what that means.
125
126
127
128
129

SEE ALSO

131       411toppm(1), pamflip(1), pam(1),
132
133

HISTORY

135       cameratopam was new in Netpbm 10.28 (June 2005).
136
137       It    was   derived   from   the   program   dcraw   by   Dave   Coffin
138http://www.cybercom.net/~dcoffin/dcraw/⟩ , by Bryan Henderson in April
139       2005.   Bryan  replaced the part that generates the Netpbm output image
140       and removed the Adobe Photoshop output  function.   Bryan  changed  the
141       command  syntax  and  and  made other small changes to make the program
142       consistent with Netpbm.  He also split the source code into  manageable
143       pieces (dcraw has a single 5000 line source file).
144
145
146
147netpbm documentation             12 April 2005      Cameratopam User Manual(0)
Impressum