[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ] [ Search: ]

2.6 Quick Start

Once you have built the Crystal Space system and its demonstration applications you may be eager to test them out. This section will give you the opportunity to do so without forcing you to wade through an over-abundance of explanations. Later sections will describe options and applications in more detail, but for now, sit back and have some fun.

Typically, the executable for each application and its support files will be located in the same directory, though this is not strictly necessary. The map files are generally placed in the ‘CS/data’ directory, but this not required. Please note that the map ZIP files should not be unpacked. Crystal Space can read these files directly.

On GNU Linux:

If you see the following error ‘error while loading shared libraries: libcrystalspace-2.x.so: cannot open shared object file: No such file or directory’

Crystal Space now creates and uses shared libraries. In order to run the demo applications you need to export the LD_LIBRARY_PATH to where the Crystal Space root folder is currently located e.g.

export LD_LIBRARY_PATH=/home/me/CS_latest

If you are running from the command line on GNU Linux or similar and in the root ‘CS’ folder which contains the shared objects and executables you can simply use.

export LD_LIBRARY_PATH=`pwd`

In the following examples we will run ‘walktest’, the quintessential Crystal Space demonstration program in various ways.

In this example, we will run ‘walktest’ and specify the map it should load and use.

On Windows:

walktest.exe map

On other Operating Systems:

./walktest map

Replace map with any map file name which you have downloaded and placed in your ‘CS/data’ directory. For instance:

walktest partsys

If your map is not one of those from the CS homepage, you may also have to add it to ‘vfs.cfg’. Look at the entries for the other maps to see how to do this.

You can use command line parameters when running Crystal Space applications. See section Common Command Line Options. Detailed setup can be done in the configuration file. See section Configuration File. For Walktest, in-game setup can be done via the console. See section Console Commands.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated using texi2html 1.76.