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

1.4 A Guide to This Documentation

In this section we guide you through some of the more useful sections of the documentation related to creating your own project using Crystal Space. This guide can help you find the information you want more quickly, but it is recommended that you scan through the entire documentation (just browsing the table of contents should be enough) so that you have a better idea of what is explained where.

One of the most useful sections for creating your own project is of course the tutorial section (see section 5. Tutorials and HOWTO's). Here you will find six tutorials which can help you to write your own Crystal Space game along with the very important introductory tutorial (see section 5.1 Developing a Crystal Space Application). You should certainly read this if you want to have a good idea on some of the basic concepts of Crystal Space.

Additionally, the tutorial section contains the HOWTO section (see section 5.8 HOWTO). The HOWTOs are small documents explaining how to solve small problems. They usually contain example code. Most of the HOWTOs are related to solving problems with the Crystal Space engine (like collision detection, mesh lighting and animation, mesh movement, loading a level, etc), but there are also two explaining how you can set up your own application outside of the Crystal Space application tree (one for Unix/MinGW and another for Microsoft Visual C++).

The section of the manual that talks about the engine (see section 7.6 The 3D Engine (csEngine)) is very important. If you want to know how the 3D engine works internally (which is important if you want to build your own 3D worlds) then you should read the section explaining the world components (see section 7.6.1 Components of a World) and the section explaining portals (see section 7.6.2 Portal Engine). There is a HOWTO about render priorities (see section 5.8.12 Render Priorities and Objects in Sectors) which should assist greatly in that area.

The section about the Map File Parser (see section 7.7 The Map File Parser (csParser)) is useful if you want to create your map files manually.

The mesh object section (see section 7.9 Mesh Object Plug-In System) is a recommended read. Mesh objects are objects that represent geometry in Crystal Space. If you want to display something in your world you will have to know how to use them. The tutorials and HOWTOs contain information about mesh objects but this section contains the complete documentation.


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

This document was generated using texi2html