Copyright / Disclaimer :
------------------------

This software/documentation was produced as part of the INDEX project
(Intelligent Data Extraction) which is funded under contract ESPRIT EP22745 of 
the European Community. For further details see
http://www.man.ac.uk/MVC/research/INDEX/Public/. 

Copyright (c) June 1998, Manchester Visualisation Centre, UK. 
All Rights Reserved.

Permission to use, copy, modify and distribute this software and its 
documentation is hereby granted without fee, provided that the above copyright
notice and this permission notice appear in all copies of this software / 
documentation.

This software/documentation is provided with no warranty, express or implied, 
including, without limitation, warrant of merchantability or fitness for a 
particular purpose.


Examine_Field Project
---------------------

This directory ( iac_proj/examfld/ ) contains all the V code, source 
code, HTML documentation, and installation information for an AVS/Express 
field examination tool "Examine_Field".

The directory should be placed into your existing project directory, which
should already contain the IAC Project File structure, i.e., the iac_proj/,
iac_lib/ and v/ directories.

The file INSTALL contains information on how to edit the existing IAC
files: a single line addition to the iac_proj/iac_proj.v file, to add the
new Examine_Field project, and two single line additions to some of the 
iac_lib/ files (in this instance misc.v and examples.v) to add a link to the 
User Macro and the Example Application from the new top-level IAC library page.

It should be noted that the utils_xp IAC utility library project is a
pre-requisite. See the doc_mod.html and doc_umac.html files for full details.

Once the files have been correctly installed, the low-level module of the new
project may be compiled. If you opt to leave the process unspecified, it will
by default use the "express" process. Doing so means the module may be
compiled by using one of the following commands in the top-level directory of
your project (whilst AVS/Express is not running):

	base -comp_proc express -exit

or	make -f express.mk

Using the 'make' command, requires that the express.mk file already exists,
and has been updated accordingly.

If you modify the Examine_Field project, and elect to specify the process
as "user" or a user-defined process, then the module may be compiled without
having to exit the AVS/Express application. Use the following command in the
VCP to compile the module:

	$compile IAC_PROJ.Examine_Field.Examine_FieldMods

Users of the Developer's Edition may select the module in the relevant
Templates library, and choose 'compile' from the Project menu.

If both the Examine_Field project and the Compress project are required, then
the cxx_src_files line in either the examine_field_mods.v file or the
compress_mods.v file should be removed or commented out (these cxx_src_files
are common to both projects, which causes errors/warnings when linking if
they are specified twice). 


Files
-----

The following files can be found in the iac_proj/examfld/ directory.

INSTALL 		Contains installation instructions for editing the 
			iac_proj.v and iac_lib/ misc.v and examples.v files.
			This file should not be edited as the future 
			installation script will use this file.

examfld.v		Creates the IAC_PROJ.Examine_Field library.

efldmods.v		Creates the Examine_FieldMods library containing the 
			low-level module Examine_Field_Prim and the parameter
			group Examine_Field_Param.

efldmacs.v		Creates the Examine_FieldMacs library containing the 
			high-level macros Examine_Field_UI, Examine_Field,
			examine_field and the example appplication 
			Examine_Field_Eg.

examfld.cxx		The C++ source code for the Examine_Field_Prim module.

doc_mod.html		HTML documentation for the Examine_Field_Prim module.

doc_umac.html		HTML documentation for the examine_field User Macro.

README			This file.

Generated Files
---------------

When the project is compiled, the following files will be generated. Once
completed, you may safely remove these files; any future recompilations
will regenerate these files.

out_hdr.h	AVS/Express generated header file.

out_src.cxx	AVS/Express generated source code.




