#
#  $Id: README.txt,v 1.2 2007/04/05 02:11:59 wes Exp $
#  Version: $Name: May_21_2007 $
#  $Revision: 1.2 $
#  $Log: README.txt,v $
#  Revision 1.2  2007/04/05 02:11:59  wes
#  Misc updates
#
#  Revision 1.1.1.1  2007/03/27 16:03:56  wes
#  Initial checkin
#
#

March 2007
E. Wes Bethel
Lawrence Berkeley National Laboratory
Berkeley, CA, USA

The svPerfGL application is a very simple OpenGL graphics benchmark.
The motivation for svPerfGL, as opposed to an industry standard
like SPECviewperf, is that we are interested in benchmarking OpenGL
applications representative of large-model scientific visualization.

As such, svPerfGL loads disjoint triangle data from a netCDF file
created specially for this purpose (by a separate application).
That netCDF file contains at a minimum triangle vertices, and
optionally per-vertex normals and RGB color data. svPerfGL will
use all data it finds in the netCDF file; if normals are present,
it loads and uses them, same for per-vertex colors.

svPerfGL reports the number of triangles it loads upon initialization,
then upon conclusion of the application, performance in terms of
triangles/second and frames/second. Check the code for command-line
options.


Dependancies.


svPerfGL requires that you have the following third-party libraries:

1. netCDF version 3.6.0 or later. See 
http://www.unidata.ucar.edu/software/netcdf/

2. GLUT (GL Utility Toolkit), any version should work OK. This is freely 
available on most Linux distributions. Also, check freeglut.sf.net 
(we've not tested with FreeGLUT, but we're making very conservative use 
of GLUT so there should be no problems with any GLUT implementation).

3. OpenGL. You need an OpenGL implementation. svPerfGL makes use of vertex
arrays, which appear in OpenGL version 1.2 and later.


Input Data.

svPerfGL loads disjoint triangle data from a netCDF file. The netCDF
file contains several arrays of data: triangle vertices, optional per-vertex
normals and optional per-vertex colors. See the file netCDFdefs.h for
the variable and attribute names svPerfGL expects in the netCDF file.
Contact us for sample data.

Sample data files are located here:
<give URL of data files>

# EOF