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

## 2.2 Requirements

To utilize Crystal Space you need at least the following resources.

Hardware: To fully utilize the 3D engine a 3D-accelerated graphics card is highly recommended, however you can get by without it by using the software renderer if you have a fast enough system. The minimum recommended processor on the x86 architecture is one of the i586 family (Pentium).

Operating System: You will need to be running a supported Operating System. Currently Crystal Space supports: Windows (32 bit), Unix (GNU/Linux, FreeBSD, etc.), and MacOS/X.

Development Environment: You may build Crystal Space yourself, or you may download a pre-built SDK package. If you are using the CVS version of Crystal Space, then you will need to build it yourself. To do so you will need a supported C++ compiler such as the GNU Compiler Collection (GCC) or Microsoft Visual C++. If you plan to use the scripting capabilities of Crystal Space you will also need an interpreter for each scripting language you use.

Crystal Space Package: The latest release of Crystal Space can be downloaded from:

http://www.crystalspace3d.org/tikiwiki/tiki-index.php?page=Download

The release includes all of the source code, some pre-generated documentation, and a few example data files. Alternately, you can download the latest CVS snapshot, which is often a great improvement over the latest release, and often as, or more, stable.

http://www.crystalspace3d.org/cvs-snapshots/

You can also checkout the source directly from the CVS repository. Directions for doing this can be found here:

http://sourceforge.net/cvs/?group_id=649

External Dependencies: Crystal Space can use a number of optional libraries and tools to provide a more robust set of features. A brief list of the most important dependencies is presented here. See section External Libraries.

Z Library

  zlib is used for compression and archiving.

  http://www.gzip.org/zlib/

PNG Library

  libpng is used for loading Portable Network Graphics image files.

  http://www.libpng.org/pub/png/libpng.html

JPEG Library

  libjpeg is used for loading Joint Photographics Experts Group image files.

  http://www.ijg.org/files/

Jam

  Jam is a ``make'` replacement with a much more intuitive and expressive file format. Internally, the Crystal Space build system is predicated upon Jam, however Crystal Space also features a ``make'` emulation layer which allows you to build and install the project using ``make'`, so there is no strict need to download or install Jam. If, however, you plan to work on the Crystal Space build system or create your own external project based upon Jam, then you can download it from this location:

  ftp://ftp.perforce.com/jam/

  Jam documentation can be found at the Jam home page; see ``Jam.html'`, ``Jambase.html'`, and ``Jamfile.html'`.

  http://www.perforce.com/jam/jam.html

  Jam is included pre-built in the ``cs-win32libs'` convenience package (see cs-win32libs), so Mingw and Cygwin users who use that package get Jam for free. Other users will want to build it from source code. For such users, once Jam has been downloaded, follow these simple steps to build and install it. These instructions illustrate Jam 2.5, which is current as of this writing.

      unzip jam-2.5.zip
      cd jam-2.5
      make
      ./jam0 install

  If you are a Unix user, then you will probably need to have administrator privilege to install the executable since it will be installed as ``/usr/local/bin/jam'`. To gain administrator privilege, you can use the ``sudo'` command:

      sudo ./jam0 install

  If you want to install Jam at a location other than the default, then set the ``BINDIR'` variable to the directory in which you want it installed (this example shows it being installed in the user's private ``$HOME/bin'` directory):

      ./jam0 -sBINDIR=$HOME/bin install

[ < ] | [ > ] |  | [ << ] | [ Up ] | [ >> ]

This document was generated using texi2html 1.76.