3 Installation

3.1 System requirements

map3d is written in standard C/C++ and uses the OpenGL library, both choices made to ensure broad portability of the program. This first OpenGL version of map3d targets three platforms and we list the requirements and recommendations for each below. Additional platforms will follow--and follow even faster if you send us a machine to play on.

All platforms:

Requirements for all systems
OpenGL libraries (GL and GLU)	version 1.1 + 1
OpenGL/window interface library (GLX)
Glut	version 3.7 +

SGI:

map3d runs on virtually any SGI that will support Irix version 6.5+. We have tested it on Indigo2, O2, Octane, and Origin workstations running various flavors of Irix 6.5. If you need a version for a different SGI configuration, please let us know (map3d@sci.utah.edu)

Requirements
Operating System	Irix 6.5+
Architecture	mips3 or mips4 (maybe mips2)
Applications Binary Interface	n32 or 64
Recommendations
Hardware	Texture mapping hardware
	128 MB main memory

Linux (i386):

map3d requires the OpenGL library, which is available as the mesa library at www.mesa3d.org for any Linux platform. For better performance, graphics cards from companies such as nVidia (www.nvidia.com) usually provide OpenGL libraries.

Requirements
Operating System	kernel 2.2.x
Architecture	i386 (+ maybe PPC)
Applications Binary Interface	libc2.1
Recommendations
Window system	XFree86 version 4.0 +
Hardware	3D graphics card (nVidia, 3dfx, ati)
	128 MB main memory

LinuxPPC (PowerPC):

map3d requires the OpenGL library, which is available as the mesa library at www.mesa3d.org for any Linux platform.

Requirements
Operating System	kernel 2.2.x
Architecture	PowerPC (PPC)
Applications Binary Interface	libc
Recommendations
Window system	XFree86 version 3.3 +
Hardware	3D graphics card)
	128 MB main memory

Windows:

Requirements
Operating System	W2K/NT4.0/9x
Architecture	i386
Applications Binary Interface	win32
Recommendations
Hardware	3D graphics card (nVidia, 3dfx, ati)
	128 MB main memory

3.2 Installation

The process of installing map3d is quite simple and we provide the steps in README files that comes with the downloaded installation files.

To test the installation, use the test files that accompany this distribution. Each has some script files included that show how to call and execute map3d.

To download the software, use the URL

www.sci.utah.edu/software/map3d.html

3.3 Documentation

This document should have reached you either as a pdf file or via the map3d web site. If you would like more copies or the latest version, go to the same web site and look for the links under Documentation:

www.sci.utah.edu/software/map3d.html

3.4 Bug reporting

We want to hear your response to using map3d and especially to learn about any bugs you may find. They may be features, rather than bugs, but if so, we will be happy to hear your impressions.

To submit a bug report please send email to map3d@sci.utah.edu or point your browser at software.sci.utah.edu/bugzilla with the following information:

1. Type and version of the operating system and hardware you are using.
2. Version of map3d.
3. Description of the bug/feature you encountered.
4. Suggestions for fixing the bug or altering the program behavior.

3.5 How to reach us

We have established an email address for map3d, map3d@sci.utah.edu, and web pages within the website www.sci.utah.edu/ncrr dedicated to map3d. There is also a majordomo mailing list for map3d users called map3d-users@sci.utah.edu. To subscribe to this list, send email to majordomo@sci.utah.edu with the content

      subscribe map3d-users

Please let us know how you use map3d and how we can make it better for your purposes. We can only develop this program with continued support and the best way to achieve this is to show that others use the program and find it helpful.