## NAME

         load - CVIPtools command to place an image  into  the  image
         queue

## SYNOPSIS

         load <filename>

         <filename> - path and name of the image to be loaded

## OPTIONS

         none

## DESCRIPTION

         In order to manipulate an image that exists as a disk  file,
         the  image must first be loaded into CVIPtools' image queue.
         If the path to the desired image is included in CVIP_IMGPATH
         in user's $HOME/.cshrc file, no path name need be specified.

## EXAMPLES

         If the path to the desired image is already included in  the
         image  search  path,  the  following  command  will load the
         image:
                              load cameraman.pgm

         If the path to the desired image  is  NOT  included  in  the
         image search path, use the full path:
                      load /opt/cvipimages/Gray/lena.pgm

         The current image search paths can be easily be viewed:

          Type "home" at any CVIPtools>> prompt to return to the
          top-level menu
          Select "9) CVIPtools Utilities"
          Select "10) Add temorary image path"

          Your current image paths will be  displayed,  and  you  may
         temporarily  add  a path by entering it at the prompt.  This
         path will be searched during the current  CVIPtools  session
         only.  Permanent  path  additions  must  be made within your
         .cshrc file.

## FILES

         builtin.c, image_queue.c

## DIAGNOSTICS

         "file error: can't open <filename>" if path or  filename  is
         incorrect

         An attempt to load an image more than one time  will  appear
         to  work, but the image queue will show only one instance of
         the image

## BUGS

         None at this time

## SEE ALSO

         pq(1)

## AUTHOR

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