Table of Contents

Tutorials

This section is dedicated to basic and advanced tutorials about orx, an opensource, portable, lightweight, data-driven & 2D-oriented game engine.

Setup

These tutorials show how to setup different coding environments (IDE) to work with orx. 1)

Community

These tutorials have been created by the community so as to give fast answer to simple question.
They're great resources for discovering how to do stuff with orx!

Basic

This section will introduce you to orx basics.
Please download the tutorial files (including projects files, data, executables and source code) for Windows (mingw, msvs2005 & msvs2008), Linux and MacOS X from this download link.

Here's the list of the currently available basic tutorials:

  1. [C] object
  2. [C] clock
  3. [C] frame
  4. [C] fx
  5. [C] physics

The nine first basic tutorials (#1 - #9) are using the default orx launcher program as an underlying layer. This has the advantage to allow very fast testing/prototyping 2).

They're compiled as dynamic libraries that are loaded at runtime (specifying their name on the command line 3), or through the config file).
Furthermore, the below text 4) explains which behavior is provided by the default orx.exe/orx launcher program.

This is a basic C tutorial.
As we are using the default executable for this tutorial, this code
will be loaded and executed as a runtime plugin.

In addition, some basics are handled for us by the main executable.
First of all, it will load all available plugins and modules. If you
require only some of those, then it's better to write your own executable
instead of a plugin. This will be covered in a later tutorial.

The main executable also handles some keys:

* F11 as vertical sync toggler
* Escape as exit key
* F12 to capture a screenshot
* Backspace to reload all configuration files (provided that config history is turned on)

The program also exits if the orxSYSTEM_EVENT_CLOSE signal is sent.

However, using orx as a traditionnal library and building your own executable is of course possible (and very easy to do).
This is covered by the tutorial #10 in C++ and the tutorial #11 in C / tutorial #12 in C.
The tutorial #10 also shows how to write C++ code using orx 5). In the same way, you can write your program in any language that can interface with C.

Wrappers will be provided for some common languages in a further release. If you want to contribute to orx by writing such wrappers, please contact us via the forum.

1) All these IDEs are free and can be downloaded from internet.
2) one line for the whole initialization, no main function to write, no loop to handle
3) hence the provided .bat/.sh scripts to easily launch all the tutorials
4) that you will see at the beginning of all tutorials' source files
5) which is coded in C
en/orx/tutorials/main.txt · Last modified: 2012/02/18 04:39 by faistoiplaisir
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki