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.