man > cameratopam(1)

Cameratopam User Manual(1)             General Commands Manual            Cameratopam User Manual(1)

NAME
       cameratopam - convert raw camera image to PAM


SYNOPSIS
       cameratopam

       [input_file_name]

       [-identify_only]  [-quick_interpolate] [-half_size] [-four_color_rgb] [-document_mode] [-bal‐
       ance_auto] [-balance_camera]  [-red_scale=float]  [-blue_scale=float]  [-brightness=fraction]
       [-no_clip_color] [-rgb] [-secondary] [-linear] [-verbose]

       All  options can be abbreviated to their shortest unique prefix.  You may use two hyphens in‐
       stead of one to designate an option.  You may use either white space or an  equals  sign  be‐
       tween an option name and its value.


DESCRIPTION
       This program is part of Netpbm(1).

       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 some‐
       thing more standard such as TIFF or JFIF (JPEG).  Software supplied with  the  camera  allows
       you  to  manipulate the image using information which is lost when the camera converts to the
       common format.  A particular camera model often has a unique raw format.




OPTIONS
       In addition to the options common to all programs based on libnetpbm  (most  notably  -quiet,
       see ]8;;index.html#commonoptions\ Common Options]8;;\ ), cameratopam recognizes the following command line options:



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


       -verbose
              Report to Standard Error details of the processing.


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


       -half_size
              Half-size  the  output image.  Instead of interpolating, reduce each 2x2 block of sen‐
              sors to one pixel.  Much faster than -quick_interpolate.


       -four_color_rgb
              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.


       -document_mode
              Show the raw data as a grayscale image with no interpolation.  This is good  for  pho‐
              tographing black and white documents.


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


       -balance_camera
              Use  the  color  balance  specified by the camera.  If cameratopam can't find this, it
              prints a warning and reverts to the default.


       -red_scale=float

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


       -brightness=float
              Change the output brightness.  Default is 1.0.


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


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


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


       -linear
              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 proportional to brightness.  With the linear option, cameratopam generates
              an image in which the samples are instead proportional to light intensity.

              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.





SEE ALSO
       411toppm(1), pamflip(1), pam(1),


HISTORY
       cameratopam was new in Netpbm 10.28 (June 2005).

       It  was  derived  from  the  program ]8;;https://dechifro.org/dcraw/\dcraw by Dave Coffin]8;;\ , by Bryan Henderson in April 2005.
       Bryan replaced the part that generates the Netpbm output image and removed the  Adobe  Photo‐
       shop  output function.  Bryan changed the command syntax and made other small changes to make
       the program consistent with Netpbm.  He also split the source  code  into  manageable  pieces
       (dcraw had a single 5000 line source file).

DOCUMENT SOURCE
       This  manual  page  was  generated by the Netpbm tool 'makeman' from HTML source.  The master
       documentation is at

              http://netpbm.sourceforge.net/doc/cameratopam.html

netpbm documentation                        12 April 2005                 Cameratopam User Manual(1)