SvLis Home Page

Unix Installation

svlis@bath.ac.uk
 
 

Copyright © 1994, 1996, 1999 Information Geometers Ltd and The University of Bath


The first stage in the installation of svLis is to obtain OpenGL (if you're on an SG you should already have this) and GLUT (and maybe also some of the GLUT demonstration programs for testing). Get them all working, then start on svLis.

The compressed svLis distribution file for all Unix systems is a gzipped tar set. In the following svlis.tar.gz stands for one of linux_svlis.tar.gz, sun_svlis.tar.gz, or sg_svlis.tar.gz obtained by clicking on one of those highlights. The stages of the installation of svLis under Unix are:

  1. Log in as the super-user;
  2. Make the directory where you want svLis to be; usually /usr/local/Svlis;
  3. cd to that directory;
  4. mv svlis.tar.gz into that directory;
  5. gunzip svlis.tar.gz
  6. tar -xvf svlis.tar
  7. type make
Typing make will generate the whole of svLis.  Note that if the OpenGL include and library files on your system are not in the paths ordinarily searched by the compiler and linker, then you will have to edit the Makefile to incorporate these paths.  It is commented to help you to do this.

Under Linux you can conflate the unzip and tar (steps 5 and 6) to

tar -xvzf svlis.tar.gz
SvLis expects to find the xv utility in the search path; if it's not there you won't be able to see the results of interactive raytracing.

The files and directories that you will end up with in the svlis directory will be:

  1. Makefile
  2. bin - directory, contains executables
  3. data - directory, contains test data
  4. docs - directory containing HTML documentation
  5. include - directory, contains the svLis .h files
  6. lib - directory, contains the libraries
  7. obj - directory, contains compiled object modules
  8. programs - directory, contains test programs and other utilities
  9. results - directory, where the test programs store output
  10. svlis.tar - the .tar file created by gunzip
  11. sv_user - directory, contains the source code for the parts of svLis that are user-modifiable.
After you've done those 7 steps check if all is working by runing the program bin/sv_tst_1 from the main svLis directory. This will create a single file in the directory results called sv_tst.mod (cat it out if you like; it will start something like: 
SvLis(3)

# SvLis created this file on Sun Feb 21 15:59:16 1999

model
{
 268482224 L 0
 box\interval\0, 10/, interval\0, 10/, interval\0, 10//
 set_list
 [
  268482032 0
  set
  (
   268481656 7 0 &
   set
   (
    268481600 1 0
    primitive
    <
     268481528 3 0 -
     primitive
     <
.
.
.
.
though the numbers will be different). The file created is a svLis model of a cube intersected with a sphere. If you run bin/sv_tst_2, this will read the model, then divide and facet it, then print some statistics. Finally running bin/sv_tst_g should produce a picture of the model (the process forks, so you will probably get a `program finished' message before the graphics window appears). The faceting of this picture is deliberately crude; you can refine it by picking the `Facet quality' menu item with the right mouse button in the graphics window. Typing `?' in the graphics window gives a list of options. Also, if you turn texturing on from the menu, you should get the svLis logo tiled across the flat faces.

There are a number of other programs provided with svLis; for details of them see the svLis manual here.


 
 


PERFICTA PERFRACTA QVAERENDO PERFECTA