Installation Instructions for DAP --------------------------------- Notes for the impatient :) Essentially to build the sources you'll have to ensure a few things: * You must have a full gcc/g++ installation (or CC on IRIX). * On everything other than SGI you'll need OSS drivers and headers to be installed correctly (these normally come as standard on Linux). * You must have XForms 1.0 installed correctly. This means: + The XForms include file (forms.h) must be in your include path. + The XForms library files (libforms*) must be in your library path. Note that on my system I found that I needed to manually add /usr/X11R6/lib to my LD_LIBRARY_PATH environment variable. * You must define OTHER_INCLUDE_DIR and OTHER_LIBRARY_DIR environment variables. On my home setup, where everything is installed correctly I simply set these to "." but at work (where I don't have root access to install XForms properly) I set these to the appropriate directories housing the XForms include and library directories respectively. * You should then type 'make -f Makefile.[architecture]' in the top level DAP directory to build DAP. On my setup I type "make -f Makefile.linux". * This should result in an executable called DAP being generated in the main directory. 1/. Building the Sources If you have downloaded a binary release you will not need to build DAP from its sources so jump straight to the next section. If not then you've got some work ahead of you before you see DAP appearing on your lovely big monitor screen !! First off you'll need an ANSI C/C++ compiler such as gcc/g++ (or CC on IRIX). If you are using gcc make sure you have installed the C++ libraries contained in the libg++ distribution in addition to gcc. These will normally be installed already. If you plan to use gcc/g++ on IRIX you'll need to edit all the Makefile.sg files. You'll see commented out sections for gcc - simply copy the relevant entries from the commented out section to the actual definition section at the top (let me know if you have problems). Now you'll need the XForms distribution to be installed. I heartily recommend using the latest release version (1.0) although newer versions should be OK as well. There have been problems in the past with the tooltips system employed by DAP and certain versions of XForms but you can always turn the tooltips off if they prove to be problematic. Follow the instructions provided with XForms to install the package. See http://world.std.com/~xforms and http://savannah.nongnu.org/projects/xforms/ for further details on XForms. Note that on my system I found that I needed to manually add /usr/X11R6/lib to my LD_LIBRARY_PATH environment variable. In addition you may have to install the XPM library to get XForms to run correctly. See the XForms documentation for further details. The XPM library can normally be found at ftp://src.doc.ic.ac.uk/unix/Linux/sunsite.unc-mirror/libs/X If you are compiling on Linux, NetBSD or Solaris you will also require the Open Sound System (OSS) audio drivers and headers to be installed on your machine. These drivers are normally supplied with Linux but NetBSD and Solaris users may have to install them manually. The older VoxWare drivers (upon which the OSS drivers are based) may also work but are untested. See http://www.opensound.com for further details on OSS. Now you're nearly there :) In each of the DAP directories there are five makefiles - one for each architecture on which DAP is currently supported. Note the makefiles in the sound directory are NOT directly used for the main DAP build. The five makefiles in each of the main directories are :- Makefile.alpha - makefile used for Linux/Alpha derivatives Makefile.linux - makefile used for Linux/i386 derivatives Makefile.netbsd - makefile used for NetBSD/i386 derivatives Makefile.sg - makefile used for IRIX derivatives Makefile.sun - makefile used for Solaris derivatives I really ought to set up imakefiles to generate these for you but until I work out how xmkmf actually works you're stuck with these more basic renditions :( However if anyone out there wants to have a go.... Also have a look at the makefiles for your architecture and check that you don't need to make any manual amendments (eg IRIX users may wish to use the gcc/g++ compiler rather than CC - see the Makefile.sg files for the settings). The more usual changes are the adding of extra include or library directories (to INCDIR and LIBDIR respectively). Now go to the top level DAP directory and type 'make -f Makefile.[architecture]'. I usually have the following aliases set :- alias m make -f Makefile.alpha (on Linux/Alpha) alias m make -f Makefile.linux (on Linux/i386) alias m make -f Makefile.netbsd (on NetBSD/i386) alias m make -f Makefile.sg (on IRIX) alias m make -f Makefile.sun (on Solaris) Hopefully DAP will now compile with no warnings and you'll be left with a DAP executable in the main directory. If anything goes wrong note in which directory the compilation failed and check the appropriate makefile in the relevant directory. Make sure you have modified any directory locations as necessary. If all else fails give me an email and I'll do my best to sort things out :) 2/. Installing the Software In the main directory there should be an executable called DAP. You should be able to run this directly. However I recommend copying this executable to /usr/local/bin (or somewhere else in the default PATH). Make sure any older versions of DAP aren't still hanging around somewhere - otherwise when you type DAP you might be running an old version :( Best way of checking is to type "which DAP" at the shell prompt and make sure the right DAP executable is listed. I also recommend copying the example effects (in the effects directory) to a globally visible directory such as /usr/local/dap/effects. If you have any trouble running DAP ensure that the correct version of XForms is installed correctly (1.0 for the precompiled binaries) which basically means having the libforms.so.089 file either in /usr/lib or somewhere in the environment variable LD_LIBRARY_PATH. There are further details about this in the previous section about building the sources. If you are still having troubles then let me know your exact configuration (machine, operating system, memory, version of XForms, compiler, etc) and I'll try my best to get things sorted out for you. Good luck !! TicH -------------------------------------------------------------------------------- Name - Richard Kent (Tich) EMail - richardk@cee.hw.ac.uk WWW - http://www.cee.hw.ac.uk/~richardk --------------------------------------------------------------------------------