INSTALL: Installation of PTW, the Pseudo-Triangulation Workbench ====================================================================== Supported Platforms: -------------------- Limiting factor is probably the use of CGAL, which supports Linux, SGI Irix, Sun Solaris, Windows PC, with the corresponding compilers g++, SGI CC, Kai KCC, Microsoft Visual C++, and Borland C++. However, I have only tested it with g++ on Linux and SGI CC on Irix. Required Libraries: ------------------- The following libraries are required and need to be installed (if not already present on your system) before installing PTW. Note that only CGAL is required for all programs, the other libraries are only used for the visualization part in PTW. 1. OpenGL. It comes usually with the system, such as Irix, Windows PC, and also the new Linux XFree server. For other platforms, Mesa is a free good alternative to install, see: http://www.mesa3d.org/ 2. Glut. This is a C library interfacing OpenGL with the window system. It is also usually installed on systems that come with OpenGL. See: http://reality.sgi.com/mjk/glut3/glut3.html 3. Glui 2.0 or higher. This is a C++ library providing a GUI toolkit, e.g., buttons. Its foundation on OpenGL and Glut makes it platform independent. However, it is a small toolkit and not widespread. It just happened that I used it at that time. It is almost certain that you need to install it on your machine. See: http://www.cs.unc.edu/~rademach/glui/ I patched a couple of files to fix some errors and suppress some warnings. After unpacking the Glui distribution, copy the files that I provide with the ptw.tar.gz tar-ball in ptw/glui_*_patch/* into the Glui distribution before compiling it. 4. CGAL 2.3 or higher. See: http://www.cgal.org/ Installing PTW: --------------- 1. Get the tar-ball from (I guess you have it already ;-): http://www.cs.unc.edu/~kettner/proj/PseudoT/ 2. Unpack the tar-ball, e.g., using 'gtar zxf ptw.tar.gz'. That creates a directory 'ptw' in your local directory. 3. Go to the 'ptw/src/' subdirectory. 4. Prepare the following environment variables, or set them in the Makefile: CGAL_MAKEFILE That comes usually with the CGAL installation. It is set to the include makefile in the CGAL tree in the /make/ directory corresponding to the machine platform. CPP_GLUI Compilation flags and linker flags respectively LIB_GLUI that are needed to find Glui, Glut, and OpenGL header files and libraries respectively. 5. The makefile creates by default a debugging version of the software that is extensively guarded with preconditions and assertions in the code. To create an optimized version (mainly recommended for the enumeration part), add the '-O3 -DNDEBUG' flags to the CXXFLAGS variable in the Makefile. 6. Use 'gmake' to compile all programs. Use 'gmake ptw' to compile the PTW only. See the README file for an overview of the programs provided. 7. The executables are created in the current directory. Move them to an appropriate place. 8. 'gmake clean' removes all executables and object files created. Feedback: --------- Let me know if there are problems with the installation so that I can refine the description here. Email: kettner@cs.unc.edu. Lutz Kettner Dept. of Computer Science University of North Carolina at Chapel Hill USA