Requirements
and
Implementation
|
The Unix distribution for FLUDViz in source code format requires
certain supporting software. FLUDViz -
-
depends on common Web Metrics resource code; you must install these resources
before compiling the FLUDViz source.
-
is written in standard C; therefore you will need
an ANSI standard C compiler.
-
is written as a GLUT/Tk application and as such requires the GLUT/Tk
API for compilation and run-time support for OpenGL. See the GLUT/Tk website for more
details.
-
launches a Tcl/Tk process for the control menu. Thus you need
a Tcl/Tk implementation
installed on your system.
-
uses a few Unix system calls (system, getenv).
-
uses Netscape
for text display and to show pages of website.
|
Download
|
On your machine, create the standard
directory structure for WebMetrics if it does not already exist.
Code specific to FLUDViz will be stored in $WEB_TOOLS/FLUDViz/; its
lib-flud subdirectory contains application-specific functions used by
FLUDViz.
Go to our NIST Web
Metrics download page to download the FLUDViz software. Copy
FLUDViz-source.tar.gz into the $WEBMET_TOOLS/ directory and then do:
gunzip FLUDViz-source.tar.gz
(to produce FLUDViz-source.tar)
tar -xvf FLUDViz-source.tar
(to generate the FLUDViz tree)
|
FLUDViz Files
|
The following explains the purpose of the various files in the
FLUDViz directory. Most of these can be used as is, but a few may
require minor editing. The file that will most likely need some
modification is Makefile (see below).
- FLUDViz directory
-
contains the main code needed for FLUDViz
- Makefile
- Should build your system with a little editing - read it for
self-documentation. The file contains absolute directory names for
various resources which should be changed to reflect their new
location on your machine. Look for commented lines containing
"MODIFY?" as likely places to edit. Note especially that the
RESOURCES variable must be set to the name of your resource directory
and the DIR_GLUT variable must contain to the location of your GLUT/Tk
directory.
The current version of the makefile is interpretable by GNU/make (see
http://www.gnu.ai.mit.edu/home.html).
For other implementations of make, YMMV.
- fludviz.c
- source code for FLUDViz
- fludviz.tk
- tk code for FLUDViz control window
- README
- Very general overview documentation
- big-picture.prt
- Documentation file that relates the functions of the program
to the OpenGL display lists being generated. You will need
big-picture.prt only if you are trying to figure out the
internal logic of the code - it is not necessary for
compilation.
- lib-flud subdirectory
-
has application-specific functions used by FLUDViz
- f-*.c
- various functions used by FLUDViz
- defs.h
- application-specific definitions used by these functions
- meta.h
- all definitions used by the lib-flud functions
|
Compilation
and
Cleanup
|
Here are the steps for building the executable from source code:
-
Compilation of FLUDViz depends on the prior download and compilation
of the generic graphics functions, as described on the Web Metrics resources page.
-
Compilation of FLUDViz depends on the prior download and compilation
of GLUT/Tk, as described in the GLUT/Tk website.
-
Make sure GNU make is installed (see
http://www.gnu.ai.mit.edu/home.html if you need to download it).
-
Go to the FLUDViz directory and edit the Makefile there.
Look for the lines with a "MODIFY?" comment and make sure
that they point to the proper directories.
-
Execute the make command (the GNU version) to build the
executable fludviz.
-
FLUDViz needs the environment variable CHAR_GEOM set to
$WEB_TOOLS/resources/ogl/char-geom.dat. If FLUDViz cannot find this
file it will produce lots of error messages.
-
You can delete the original FLUDViz-source.tar file
to save room, if desired.
|
NIST Web Metrics