NAME

       rasview - Raster file previewer for the X Window System.

SYNOPSIS

       rasview [ -toolkitoption ...  ] [ -ifmt format ] [ -movie ] [ -pal palette_file ] [ -quiet ] [ -Version ]
       [ file.ext | - ]

DESCRIPTION

       rasview displays raster imagery from a file into an X window.  By default rasview determines  the  format
       of an image file by looking at its file name extension.  For example, an xwd (X11 Window Dump) file might
       be named foo.xwd.

       Raster image file formats come in a variety of flavors.  rasview attempts to support  8-bit-indexed,  and
       24-bit-direct  encodings  of the image formats listed below. Similarly, only output devices with 8-bit or
       24-bit depth are supported.  rasview attempts to select an X11 Visual which best matches the encoding  of
       the  image  file.  A PseudoColor visual class is preferred for 8-bit-indexed imagery, while a DirectColor
       visual class is preferred for 24-bit-direct encoded imagery. In the case of 24-bit-direct  encodings,  if
       the output device only has 8-bit color the imagery is color-quantized down to 8 bits.

       In  general  raster  files contain only a single image.  rasview is able to display multiple-image raster
       files if they were created by the concatenation of single-image files with the rascat(1NCARG) utility  or
       if  they  were  generated  by  ctrans(1NCARG).   Multi-frame image files generated by other means are not
       guaranteed to be displayable by rasview.

       See ras_formats(5NCARG) for a list of supported image formats.

OPTIONS

       rasview accepts all of the standard X Toolkit command line options (see X11(7)).   rasview  also  accepts
       the following options:

       -ifmt format
              Specify  the input file format.  format is one of the aforementioned file name extensions (without
              the ".", e.g.  xwd).  When this option is specified file name extensions are not necessary and are
              ignored if present.  All input files must have the same format.

       -movie Normally  when  processing  multi-image  raster  files,  rasview  waits  for  a mouse click before
              proceeding to the next frame. When this option is used  rasview  immediately  advances  the  frame
              after rasview has completed drawing it.

       -pal palette_file
              Use  the  color  palette  contained in the file palette_file.  for displaying images. This palette
              will override the color palette stored with the image.

              See ras_palette(5NCARG) for a description of palette file forats.

       -quiet Operate in quiet mode.

       -Version
              Print the version number and then exit.

       -      Read rasterfile from standard input (-ifmt option required).

SEE ALSO

       ctrans(1NCARG), rascat(1NCARG), ras_formats(5NCARG), ras_palette(5NCARG), xwd(1), xwud(1) X11(7)

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version

BUGS/CAVEATS

       rasview does not respond to redraw events.

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.