NAME

     save - CVIPtools command to save an  image  from  the  image
     queue to disk

SYNOPSIS

     save # [type]

       # - image queue number of the image to save

       [type] - image format option for automatic type conversion

OPTIONS

     If a type is specified during the save  command,  the  image
     will be converted during the save operation.

     If no type is specified, a byte-type  image  will  be  saved
     with the current format; a non-byte image will be saved as a
     "vip" (Visualization in Image Processing) file.

DESCRIPTION

     The save command is needed to write a copy of the  image  to
     disk.  Images  will be saved to the current directory, which
     can be determined with a "pwd"  command.  CVIPtools  creates
     and  uses  ".cvip_temp/image/",  a  tempory directory in the
     user's home directory, for storage of  images  created  with
     CVIPtools.  All  images  in the temporary directory are lost
     during a normal or abnormal exit from the program.

     Images in the queue that have not been  saved  to  disk  are
     indicated  with  "(save needed)" following the image name in
     the queue.

EXAMPLES

     To save a byte-type image with its current extension, type

                                save #

     where # represents the image queue number. If  the  item  in
     the  queue  is not of type "byte", it will be saved with the
     "vip" extension.

     To save an image as a different type, enter

                             save # type

     where  #  represents  the  image  queue  number,  and   type
     represents  the  desired  file type. The available types are
     BIN, CCC, EPS, GIF, ITX, IRIS, PPM, PGM, PBM, RAS, and TIF.

FILES

     builtin.c, image_queue.c

DIAGNOSTICS

     "number_to_name: There is  no  queue  entry  for  #"  if  an
     attempt is made to save a non-existent queue number.

BUGS

     None at this time

SEE ALSO

     pq(1)

AUTHOR

     Copyright (C) 1995 SIUE - by Scott Umbaugh and Mark Zuke.