Unix Object Code Installation and Usage

Files and Directories

To compile and link your programs with LEDA, the LEDA main directory should contain at least the following files and subdirectories:

Install/unix.txt	file describing installation and usage
incl/	the LEDA include directory
libL.a (libL.so)	basic library
libG.a (libG.so)	graph library
libP.a (libP.so)	plane geometry library
libD3.a (libD3.so)	3D geometry library
libW.a (libW.so)	window library
libGeoW.a (libGeoW.so)	GeoWin library

Static libraries have extension .a. If shared libraries are provided they have extension .so.

Preparations

To install and use the Unix object code of LEDA you have to modify your environment as follows:

• LEDAROOT: set the the environment variable LEDAROOT to the LEDA main directory <LEDA>:

  csh/tcsh:	setenv LEDAROOT <LEDA>
  sh/bash:	LEDAROOT=<LEDA>
  	export LEDAROOT

• Command Search Path: include $LEDAROOT/Manual/cmd into your command search path (environment variable path (csh) or PATH (sh)) and call rehash (if required by your system).

• Shared Libraries: (for solaris, linux, irix, osf1)
  If you are using shared libraries include $LEDAROOT into the LD_LIBRARY_PATH search path.

• xlman and demos: go to $LEDAROOT and type make xlman to compile and link LEDA's interactive manual reader xlman. make demos will compile all demo programs. Now you can start xlman for reading and printing manual pages, starting demo programs and browsing more release notes.

Compiling and linking application programs

1. Use the -I compiler flag to tell the compiler where to find the LEDA header files.

   
         CC (g++) -I$LEDAROOT/incl -c file.c
   

2. Use the -L compiler flag to tell the compiler where to find the libraries (libL.a/so, libG.a/so, ...)

   
         CC (g++)  -L$LEDAROOT file.o  <libs>
   

   <libs>:	-lL -lm	(basic data types)
   	-lG -lL -lm	(graph data types)
   	-lP -lG -lL -lm	(planar geometry)
   	-lD3 -lP -lG -lL -lm	(3d geometry)
   	-lW -lP -lG -lL -lX11 -lm	(windows)
   	-lGeoW -lD3 -lW -lP -lG -lL -lX11 -lm	(GeoWin)

   If using windows on Solaris systems you might have to link with the system socket library and the network services library as well:

   
         CC (g++)  ... -lW -lP -lG -lL -lX11 -lsocket -lnsl -lm
   

   Note: The libraries must be given in the above order.

3. Compile and link simultaneously with

   
         CC (g++)  -I$LEDAROOT/incl -L$LEDAROOT file.c  <libs>
   

You may want to ask your system administrator to install the header files and libraries in the system's default directories. Then you no longer have to specify header and library search paths on the compiler command line.

Example programs and demos

The source code of all example and demo programs can be found in $LEDAROOT/test and $LEDAROOT/demo. Goto $LEDAROOT/test or $LEDAROOT/demo and type make to compile and link all test or demo programs, respectively.