This directory contains the conversion library to convert from
and to khoros format to other formats.

	ascii2viff	- Converts an ascii file to an khoros image
	big2viff	- Converts a BIG image file to an khoros image
	gif2viff	- Converts a GIF image file to an khoros image
	rast2viff	- Converts a Sun Raster image to an khoros image
	targa2viff	- Converts a TARGA image file to an khoros image
	tiff2viff	- Converts a TIFF image file to an khoros image
	raw2viff	- Converts a raw floating point file to an khoros image
	xbm2viff	- Converts an X11 bitmap file to an khoros image
	xim2viff	- Converts an X11 image file to an khoros image
	xwd2viff	- Converts an X11 window dump to an khoros image
        fits2viff       - Converts a FITS image to a khoros image
        elas2viff       - Converts an ELAS image to a khoros image
        pbm2viff        - Converts a PBM image to a khoros image

	viff2ascii	- Converts a khoros image file to an ascii file
	viff2big	- Converts a khoros image file to a BIG image file
	viff2gif	- Converts a khoros image file to a GIF image file
	viff2rast	- Converts a khoros image file to Sun Raster image
	viff2targa	- Converts a khoros image file to a TARGA image file
	viff2tiff	- Converts a khoros image file to a TIFF image file
	viff2raw	- Converts a khoros image file to a raw floating point
	viff2xbm	- Converts a khoros image file to an X11 bitmap file
	viff2xim	- Converts a khoros image file to an X11 image file
	viff2xwd	- Converts a khoros image file to an X11 window dump
        viff2pbm        - Converts a khoros image file to a PBM image file

Layout Conventions:
For an example tiff/viff conversion routines:

1.  The layout convention is that all conversion library and utility routines
    are to be located in ~/src/file_format/Lib.

        ltiff2viff.c    - conversion program to convert tiff to viff
        lviff2tiff.c    - conversion program to convert viff to tiff
        tiff.c          - read, write, & misc utilities for tiff conversion
                          routines.

2.  Tiff conversion drivers are to be located in ~/src/vipl/file_formats.

        ~/src/file_formats/standard/tiff2viff
        ~/src/file_format/standard/viff2tiff

3.  Tiff structure definition (tiff.h include file) should
    be located in ~/include/file_formats.

        ~/include/file_formats/tiff.h

Procedure conventions:

1.  Just like ipl routines the drivers should read & write both the viff
    and tiff format, not the library routine.  The arguments to the library
    routines should be a pointer to a tiff structure and a pointer to a
    viff structure.


      ltiff2viff(tiffimage, image)
        struct tiff    *tiffimage;
        struct xvimage **image;

      lviff2tiff(image, tiffimage)
        struct xvimage *image;
        struct tiff    **tiffimage;

    Note:  there will be exceptions to this rule, such as postscript,
           imagen, or line printer output, where there is no real structure
           involved.  In this case the library must do the reading and writing.
                ie.
                      lpostscr2viff(fid, image)
                        int    fid;
                        struct xvimage **image;

2.  Conversion library and utilities are locaed in ~/lib/libfile_fromat.a
