Directories:

src/		source files
    libvol/	source for my volume reader library
    libpic/	source for my picture I/O library (used by libvol)
    spin/	sample programs using Xforms and OpenGL to create a
		    primitive interactive viewer

include/	installed include files from libpic and libvol

lib.sgi_53/	archive files for libpic and libvol,
		    compiled for SGI running IRIX 5.3

pix/		contains Mandrill picture, which you can histogram to
		create interesting 128^3 or 256^3 volume data

data/
    mitosis/	109x92x37 volume data, 8 bits per voxel
		Each slice is a PGM picture file (view with xv).
		Data from Greg LaRocca, STC (Mellon Institute)
		This is a mouse skin cell undergoing mitosis.

    vdic/	512x380x67 volume data, 8 bits per voxel
		Each slice is an SGI .bw picture file
		    (view with ipaste or imgview)
		Data from Patty Feineigle, ECE Dept. and STC
		This is a mouse embryo.

		You might need to downsample this to lower resolution
		in x and y to make it fit in memory.  Or extract
		a subvolume of it (alter the arguments to vol_read_slice
		to do that).
    

---------------------------------

To test my volume reader, run
    src/libvol/voltest 'data/vdic/vdica-??.dat.bw'
    src/libvol/voltest 'data/mitosis/??.pgm'
    note: the quotes are necessary

    See src/libvol/vol.c to see how to call the volume reader.

---------------------------------

If you want to make your program interactive (this is optional),
then you might want to use OpenGL and XForms.

About OpenGL:
    OpenGL is SGI's graphics rendering library for drawing 2-D and 3-D objects.
    OpenGL is the successor to SGI's old graphics library, GL.
    OpenGL does output, but not input (e.g. mouse events) or window systems.
    It is layered on top of X Windows.
    Link with -lGL -lX11

    On an SGI machine, OpenGL will use the graphics hardware, and run fast.

    If not on an SGI, you can run the "Mesa" package, which is a port of
    OpenGL to other machines.  Talk to Andrew Willmott (ajw@cs) if you
    need help with this.

    documentation on an SGI:
	run "insight &"
	scroll to near bottom of list of manuals on top
	double click on OpenGL Programming Guide
    documentation if not on an SGI:
	buy the book "OpenGL Programming Guide", Addison-Wesley

About GL:
    SGI's old graphics library; being phased out over the next few years,
    probably.
    Does both output and input.
    Link with -lgl

About XForms:
    Xforms is a user interface toolkit layered on top of X Windows.
    It runs on many machine types.
    Libraries and examples in /usr/local/xforms on our SGI's.

    Documentation on XForms is available from bloch.phys.uwm.edu /pub/xforms
    via anonymous ftp.

    The entire XForms distribution is also accessible via
    http://bragg.phys.uwm.edu/xforms OR http://www.uwm.edu/~zhao 

Paul Heckbert, 13 Oct 1995