	QSDK 1.1 Documentation

Programmer Tutorials

Introduction
Prerequisites
Platform Specific Driver Configuration
Building the Tutorial Applications

Microsoft Windows

Tutorial Units

Basics
Game Objects
QScript Language

Reference Documentation

Introduction

The Programmer Tutorials provide an introduction to using the QSDK for programmers. The Tutorial Units are designed to build on previous Units to construct a fully featured application. Full source code is provided with each Unit, so advanced users can start at the desired step immediately.

Prerequisites

This tutorial assumes that the user knows:

The basic mathematics of 3D game engines, i.e. how transform matrices encoding position, rotation and scale are represented, camera frustum definitions etc.
How to compile and link C++ applications for the required platform.

Platform Specific Driver Configuration

Platform specific driver details are supplied here. The user should configure their platform before attempting to compile and run any tutorial units.

Building the Tutorial Applications

Microsoft Windows

If you have installed the Development Kit option of the windows installer package Microsoft Visual Studio 6 or Microsoft Visual Studio .NET 2003 project files (according to your download) have been supplied in the subdirectories of samples\tutorials. Prebuilt executables and Q files (where appropriate) have also been supplied.

Tutorial Units

Basics

Unit	Purpose
01	"Hello cube" sample. Creates a window containing a 3D scene. The scene will be viewed through a Camera and contain a simple cube-shaped Mesh.
02	Adding keyboard interaction. The keyboard is used to move a cube, quit the application and change light color.
03	Adding texture. Diffuse and Specular maps are added to the sample cube. This unit demonstrates how to import images into a Q database using batch tools and access those images within code. Message logging. This unit demonstrates how to log information, warning and error messages.
04	Building a UI: Images, Text and Stats.
05	Beyond the cube. Use the Mesh interface to build an object out of triangles.
06	Adding atmosphere. Shows use of the Environment object to add fogging and ambient light.

Game Objects

Unit	Purpose
78	Declaring and defining user game objects, or entities. Some entities are declared and created and their behaviors defined.
79	More about entities. Advanced features like ticking control, asset management and persistence.
80	Messaging.
81	Placing an authored EntityInstance within a scene. Coding a simple Entity. Playing an Animation, looping the Animation.

QScript Language

QScript Language tutorials are available here.


		Qube Software Limited © 2000-2004

Programmer Tutorials

Contents