System Description
Setting Up a Cluster
Configuring WireGL
Environment Variables
glHints for WireGL
Compiling WireGL
Known Bugs

Setting up the WireGL make system

These are instructions for building WireGL from source.

Directory Structure

work/
  bin/              (may be created by the make system)
  built/            (may be created by the make system)
  config/           Contains platform-specific build info
  humper.mk         The main make system
  scripts/          Scripts used during the build
  wiregl/
    Makefile
    wiregl.dsw
    appstub/        Parallel API library
    glcontext/      State tracking
    include/        Header files
    opengl_stub/    Client side OpenGL DLL
    pipe_server/    Rendering Server
    util/           Common utility functions/algorithms
    progs/
        wgl/        Client library loader
        march/      Example of Parallel API application

Support Software

  • Perl -- the perl binary should be in your path.  Perl is used for dependency generation and also for building the state tracking system. Available on the web at http://www.perl.com.
  • Python -- the python binary should be in your path.  Python is used for generating code in the client DLL and server. Available on the web at http://www.python.org
  • GM -- if compiling with Myrinet support. Available on the web at http://www.myri.com
  • Cygwin -- (Windows Only) Provides basic Unix command line tools for Windows. Required only for building WireGL from command line. Vis Studio 6 does not require Cygwin to build the source. Available on the web at http://www.cygnus.com/cygwin.

Environment variables

The following environment variables must be set to build WireGL from the command line. If building from Visual Studio 6, none of these are required:

WORK_ROOT Set to the full path of the "work" directory in the above structure.
Note: use forward slashes ("/") as directory separator in Windows, i.e. "c:/work" not "c:\work"
ARCH WINDOWS ONLY -- set to "WIN_NT".
MAKE_MODE WINDOWS ONLY -- set to "unix"

Building

To build WireGL from the command line, go to the "wiregl" directory, and run GNU make (by typing "make" or "gmake").

A Visual Studio 6 workspace file (wiregl.dsw) is also provided for compiling under Windows. Load the workspace file and select "Batch Build" from the Build menu. Select either the Debug or Release versions and press build.

Myrinet Support

Myrinet GM support is disabled by default. To enable GM, uncomment the GM_SUPPORT line in the Makefile located in the util directory for building using the make system. To enable GM in the Visual Studio project file, select the GM configuration under Build,Batch Build menu option. Myrinet drivers are available at http://www.myri.com