Setting up your Development Environment
[This is ripped from the README and edited slightly for (hopefully) clarity]
Please note this document needs to be reviewed.
Orx's core is basically platform-independent. All the platform/OS-dependent features are implemented via plugins. These plugins can be loaded at runtime (hotplug) or they can be embedded at link-time.
If you use the non-embedded versions, you'll have to specify which plugins to use. This is more flexible but also requires additional files (the plugins themselves). The embedded version will store everything in Orx's library, meaning you won't be able to choose which plugin to use at runtime, but in exchange, Orx will be more compact and will also run considerably faster.
From the download page you'll find pre-compiled dynamic embedded binaries for Windows (32bit), Linux (x86) and MacOS X (ppc/x86). If you want to use the non-embedded versions (to use your own plugins) or the static ones, you will need to compile Orx yourself from the source. Everything compiles out-of-the-box for the hardware platforms cited above.
The embedded versions currently use:
You will require one of the orx-dev-* files, depending on your IDE/OS from the download page. This will give you a copy of the pre-compiled Orx binary, as a dynamic library, with everything you need to get started, compiled in.
Extract the compress file.
Quick and Dirty SVN + VS2010 Users Start Here!
You will be presented with a number of folders: bin, include and lib.
For now I'm going to create the project in a specific location, feel free to substitute your own in as you see fit.
My project on Windows will be in “C:\MyProject\” and “~/MyProject/” or “/home/grey/MyProject/” on Linux. Move the three folders previously mentioned, into this directory.
Attention Linux Users! Please be aware the files inside the archive are built with an older version of gcc and g++, so they will be incompatible with current releases. (And you are certain to get an error when attempting to link against them in this case.) I am not sure if Iarwain was planning on updating the 1.2 release, if not, you may be required to build all the required files from the svn yourself. I plan to write up a tutorial for this later.
Just 'click' these blue things for the IDE you're using!
From this point on, all of our directory structures will use these places as the “base” level. ( “C:\MyProject\” and ”~/MyProject/” )
Next, add a new file to the project:
Then, it's time to change the project properties:
We set up the general options:
Next compiler options:
The linker needs to be configured too: