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