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

5.2 Simple Tutorial 1

This tutorial provides a step-by-step explanation on how you can use Crystal Space from within your application. This tutorial is mainly based on the `simple' application which you can compile and run to see what it does (type `make tutsimp1' if you use commandline based compilation).

When you downloaded the Crystal Space package it contains a `CS/include' directory. This directory contains all header files you need to be able to use the Crystal Space components and libraries in your own applications. On one hand, the include directory contains SCF interface definitions. These pure interface file names start with the letter `i' (as in `iengine/engine.h'). On the other hand we also have plain C++ include files for interfacing with the libraries of Crystal Space. When you install Crystal Space on your development system (for instance, by invoking `make install'), these headers are placed in a location where they can be easily accessed when writing new programs based on Crystal Space. On Unix systems, for instance, these files usually end up in `/usr/local/crystal/include'.

Crystal Space also has a reference manual and API documentation. The manual is included in HTML form Crystal Space itself and is also available online. The API documentation can be generated locally or viewed online. See section 1.5 Where to Get Crystal Space.

5.2.1 Basic Crystal Space Concepts  
5.2.2 Minimum Application Requirements  
5.2.3 Simple Header File  
5.2.4 Event Handling  
5.2.5 Creating a "World"  
5.2.6 The Camera  
5.2.7 Locomotion (Moving Around)  



This document was generated using texi2html