


IMGRAY(1IM)                IMAGE TOOLS                IMGRAY(1IM)



NAME
     imgray  -  Convert an image to grayscale

SYNOPSIS
     imgray [_o_p_t_i_o_n_s] _i_n_f_i_l_e_n_a_m_e _o_u_t_f_i_l_e_n_a_m_e

DESCRIPTION
     imgray converts an input image to grayscale, then writes  it
     to  an output image file.  If the input file contains multi-
     ple images, imgray converts each one and writes  it  to  the
     output file.  The input and output image file formats may be
     different.

OPTIONS
     imgray has a  variety  of  options  in  the  following  four
     categories:

          File Selection     What input and output files to use
          Format Selection   What image file format to use
          Format Control     What variant of a file format to generate
          Standard           Standard generic options on all SDSC tools

     _F_i_l_e _S_e_l_e_c_t_i_o_n, _F_o_r_m_a_t _S_e_l_e_c_t_i_o_n, _F_o_r_m_a_t _C_o_n_t_r_o_l, and  _S_t_a_n_-
     _d_a_r_d options are common to all SDSC image tools and are dis-
     cussed in depth in the man page for imconv(1IM).

     All options can be abbreviated to the first few unique char-
     acters.

NOTES
     Conversion from color to grayscale computes the  gray  value
     for each pixel using the NTSC Y equation:

               Gray ~~=~~ 0.30*R ~+~ 0.59*G ~+~ 0.11*B

     For notes regarding  file  format  conversion  and  standard
     image tool options, see the man page on imconv(1IM).

     Error messages are reported to stderr.

EXAMPLES
     To convert an RGB Alias pix  file  image  to  grayscale  and
     store  it in an hdf file, enter any of the following command
     lines:

          imgray picture.pix picture.hdf
              or
          imgray -pix picture.pix -hdf picture.hdf
              or
          imgray -pix - picture.hdf < picture.pix
              or
          imgray -pix picture.pix -hdf - > picture.hdf



SDSC              Last change: August 26, 1992                  1






IMGRAY(1IM)                IMAGE TOOLS                IMGRAY(1IM)



              or
          imgray -pix - -hdf - < picture.pix > picture.hdf
              or
          cat picture.pix | imgray -pix - -hdf - | cat > picture.hdf

SEE ALSO
     imconv (1IM), imfile (1IM), imformats (1IM),  immono  (1IM),
     ImVfbToGray (3IM), ImVfbToGrey (3IM)

     For information on SDSC's image library, see imintro(3IM).

     For information on the individual image  file  formats,  see
     their  respective man pages: imbmp (3IM), imcur (3IM), imeps
     (3IM), imgif (3IM), imhdf (3IM), imico (3IM), imicon  (3IM),
     imiff  (3IM),  immpnt (3IM), impbm (3IM), impcx (3IM), impgm
     (3IM), impic (3IM), impict (3IM), impix (3IM), impnm  (3IM),
     imppm  (3IM),  imps  (3IM),  imras (3IM), imrgb (3IM), imrla
     (3IM), imrle  (3IM),  imrpbm  (3IM),  imrpgm  (3IM),  imrpnm
     (3IM),  imrppm  (3IM),  imsynu  (3IM),  imtga  (3IM), imtiff
     (3IM), imviff (3IM), imx (3IM), imxbm (3IM), imxwd (3IM)

AUTHOR
     Dave Nadeau
     San Diego Supercomputer Center

     See the individual file format man pages for the authors  of
     the  underlying  format  read  and write code.  The names of
     these man pages begin with the letters "im" followed by  the
     format  name.  For example, the name of the TIFF man page is
     imtiff.  To display it, enter man imtiff.

CONTACT
     SDSC consultants, (619)534-5100, consult@y1.sdsc.edu






















2                 Last change: August 26, 1992               SDSC



