This is an old revision of the document!
This is a new way to get a project going using orx. This largely may replace the IDE setup instructions by Grey:Setup tutorials by Grey
See here for instructions on getting orx downloaded.
You downloaded orx, but now you need to build it. And your project needs to use compiled files from that orx build. These steps are covered in this article. Follow steps: What is a build project?, Creating your build and Compiling orx from scratch. Then you will have a compiled version of orx for your chosen IDE / OS.
Ensure you have the following suggested folder structure:
In the windows folders above, if you are using linux, name your folders linux. Or have both if you are doing multiplatform.
Make sure this folder structure is sitting next to the downloaded orx folder. If it is not, then copy paste your myproject there now, so that orx and myproject are on the same level, ie:
/myproject/ /orx/
This will be required when the script is run. Parts of orx will be accessed to build out your project(s). Once your project is built, you won't need orx there anymore if you don't want it.
includedirs { "../include", }
libdirs { "../lib/windows" --or linux, whatever you're target platform is. }
files { "../src/myproject/file1.cpp", "../src/myproject/file1.h", "../src/myproject/file2.cpp", "../src/myproject/file2.h", } or files { "../src/*.cpp", "../src/*.h" }
targetname ("windows/mygame")
..\..\orx\extern\premake\bin\windows\premake4.exe --os=windows codelite or just: ..\..\orx\extern\premake\bin\windows\premake4.exe codelite
(..\..\orx\extern\premake\bin in this example is the folder where you downloaded orx, we need to get to the premake4.exe to do the work against our .lua file, and to save the result in our current folder)
If you wanted to build for linux (from within windows) you could do a:
..\..\orx\extern\premake\bin\windows\premake4.exe --os=linux codelite
I have used codelite for windows as the example throughout. However there are many more IDE/OS combos available. You can find a complete list from the latest premake here: http://industriousone.com/what-premake or see what the current list is from the premake that ships with orx by checking the “All operating systems, architectures, build projects” section here
1. If you get errors like… c:/mingw-4.6.1/bin/../lib/gcc/mingw32/4.6.1/../../../../mingw32/bin/ld.exe: cannot find -lorxd
Adjust your libfolder path in the premake4.lua file. You probably aren't pointing to the correct spot (myproject/lib can't be found). Or you have nothing in your lib folder at all. Did you build orx and copy the files from that lib folder to yours?
2. If you get errors like… undefined reference to `vtable for cxxabiv1::si_class_type_info
You set the wrong language. Check if you want C++, your haven't set your solution to C.