Object Code on UNIX

Files and Directories

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

Readme.txt	Readme File
Install/unix.txt	txt-version of this section
incl/	the LEDA include directory
libleda.a (libleda.so)	the LEDA library

The static library has the extension .a. If a shared library is provided it has extension .so.

Preparations

Unpacking the LEDA distribution file LEDA-<ver>-<sys>-<cc>.tar.gz will create the LEDA root directory "LEDA-<ver>-<sys>-<cc>". You might want to rename it or move it to some different place. Let <LEDA> denote the final complete path name of the LEDA root directory.

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

• Set the environment variable LEDAROOT to the LEDA root directory:

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

• Shared Library: (for solaris, linux, irix, osf1)
  If you planning to use the shared library include $LEDAROOT into the LD_LIBRARY_PATH search path.

• Make sure that the development packages for X11 and Xft have been installed. On Ubuntu, for instance, you should have called
  sudo apt-get install libx11-dev
  sudo apt-get install libxft-dev
  

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.cpp
   

2. Use the -L compiler flag to tell the compiler where to find the library.

         CC (g++)  -L$LEDAROOT file.o -lleda -lX11 -lXft -lm
   

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

         CC (g++)  ... -lleda -lX11 -lXft -lsocket -lnsl -lm
   

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

3. Compile and link simultaneously with

         CC (g++)  -I$LEDAROOT/incl -L$LEDAROOT file.c  -lleda -lX11 -lXft -lm
   

When using the multi-threaded version of LEDA you also have to set the flags LEDA_MULTI_THREAD and pthread during compilation (-DLEDA_MULTI_THREAD -pthread) and you have to additionally link against the pthread library (-pthread). 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.

Important Remark: When using g++ version 4.x.x with optimization level 2 (-O2) or higher, you should always compile your sources setting the following flag:

-fno-strict-aliasing