![interreality.org [VOS]](/wwwvos/banner5.jpg)
| Creating Interreality: The Virtual Object System: Version 0.23.0 | ||
|---|---|---|
| Prev | Appendix A. Building VOS from Source | Next |
A.6. Compiling Ter'Angreal
The following section explains how to compile the Ter'Angreal 3D world browser application. Ter'Angreal is distributed separately in the "vos-browser" package. This means to get Ter'Angreal you will want to download either the release file vos-browser-0.23.0.tar.gz, or check out the "vos-browser" CVS repository.
You should have already downloaded and compiled the main VOS distribution (discussed in the previous section) before attempting to build Ter'Angreal. Also, because both the configure scripts for both Crystal Space and vos-browser use pkg-config to detect VOS, you should have pkg-config installed.
A.6.1. Crystal Space
Ter'Angreal depends on the Crystal Space 3D engine, so first you must download and install Crystal Space separately. If you are building the 0.23.0 stable release, you can download a Crystal Space snapshot from the VOS web page. However, if you compiling a CVS version of VOS, you must also use the CVS version of Crystal Space.
Unpack or check out Crystal Space and follow the directions in CS/docs/html/manual/cs_2.html ( directions online) to compile Crystal Space. You may install it globally on your system after compiling if you wish, but this is not required.
Make sure that the Crystal Space configure script detects VOS. You may have it link against VOS build tree directly (as opposed to a global install) by using the "--with-metaobject_a3dl=PATH" paramater, where PATH is an absolute path leading to the root VOS directory.
A.6.2. wxWidgets
To compile wxTer'Angreal, you will need the wxWidgets library. On Windows this library is provided with the vos-win32-libs package. In Debian you may install the "libwxgtk2.6-dev" package. For other platforms, you may download wxWidgets here. Instructions on how to compile wxWidgets for your platform may be found at the aformentioned link.
A.6.3. Configuring and Building Ter'Angreal
There are three command line paramaters of interest to help the vos-browser configure script detect the required components. Typically these paramaters are only needed if VOS, Crystal Space and/or wxWidgets have not been installed globally on the system.
- --with-vos=PATH
Look for VOS pkg-config files at PATH. This can point to the root of the VOS build tree, in which case it will link against the libraries in the build tree.
- --with-crystal=PATH
Look for the cs-config script at PATH. This can point to the root of the CS build tree, in which case it will link against the libraries in the build tree.
- --with-wxwidgets=PATH
Look for the wx-config script at PATH. This can point to the root of the wxWidgets build tree, in which case it will link against the libraries in the build tree.
Now run configure:
$ ./configure
Assuming configure succeeds, you can now run make:
$ make all
Optionally you may now install Ter'Angreal:
$ make install