Updated: 12 April 2005
   Table Of Contents


   cameratopam - convert raw camera image to PAM


   cameratopam   [input_file_name]  [-identify_only]  [-quick_in-
   [-half_size]    [-four_color_rgb]   [-document_mode]    [-bal-
   [-balance_camera]                           [-red_scale=float]
   [-brightness=fraction]  [-no_clip_color]  [-rgb]  [-secondary]

   All  options  can be abbreviated to their shortest unique pre-
fix. 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.


   This program is part of Netpbm.

   cameratopam converts from any of dozens of  raw  camera  image
formats to PAM.

   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 im-
age using
   information which is lost when the camera converts to the com-
mon format. A
   particular camera model often has a unique raw format.


          Report  to Standard Error the format of the input image
but don’t
          generate an output image. Program fails  if  it  cannot
recognize the

          Report to Standard Error details of the processing.

          Use  simple  bilinear  interpolation for quick results.
The default is
          to use a slow, high-quality adaptive algorithm.

          Half-size the output image. Instead  of  interpolating,
reduce each 2x2
          block  of  sensors  to  one  pixel.  Much  faster  than

          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.

          Show the raw data as a grayscale image with no interpo-
lation. This is
          good for photographing black and white documents.

          Automatic  color balance. The default is to use a fixed
color balance
          based on a white card photographed in sunlight.

          Use the color balance specified by the camera. If  cam-
eratopam can’t
          find  this,  it prints a warning and reverts to the de-

          Further adjust the color balance by multiplying the red
and blue
          channels by these values. Both default to 1.0.

          Change the output brightness. Default is 1.0.

          By  default,  cameratoapm  clips  all colors to prevent
pink hues in the
          highlights. Combine this option  with  -brightness=0.25
to leave the
          image data completely unclipped.

          Write raw camera colors to the output file. By default,
          converts to sRGB colorspace.

          For  cameras based on the Fuji Super CCD SR,  this  op-
tion causes
          cameratopam to use the secondary sensors, in effect un-
derexposing the
          image by four stops to reveal detail in the highlights.
          silently ignores this option for all other cameras.

          This  option causes cameratopam 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 pro-
portional to
          brightness. With the linear option, cameratopam  gener-
ates an image in
          which the samples are instead proportional to light in-

          Without -linear, the image maxval is 255, so the  image
contains one
          byte  per sample. With -linear, the maxval is 65535, so
the image
          contains two bytes per sample.

          Without -linear, cameratopam  uses  a  99th  percentile
white point. With
          -linear, it doesn’t. I don’t know what that means.


   411toppm, pamflip, pam,


   cameratopam was new in Netpbm 10.28 (June 2005).

   It was derived from the program dcraw by Dave Coffin, 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 and made other small changes to  make  the  program
consistent with
   Netpbm.  He  also split the source code into manageable pieces
(dcraw has a
   single 5000 line source file).

Table Of Contents

     * NAME
     * OPTIONS
     * SEE ALSO
     * HISTORY

Man(1) output converted with man2html