The aim of this guide is to show you how to install the GCC compiler onto a fresh version of Linux and how prepare it for using Orx.

There is a more concise version of the document here, for more experienced Linux users who just want the short overview.

We'll begin with a new Linux distribution. The one I've chosen is Lubuntu 18.04 Bionic. It comes in both 32-bit and 64-bit versions. The reason I chose this is because it is a reasonably small version of Ubuntu Linux, that ships with the bare essentials.

You can download the ISO here. There are many guides to installing Lubuntu onto a PC or as a Virtual Machine, so I'll leave that as an exercise for the reader.

Once you boot into the Linux desktop, open a Terminal window so that you can download the GCC compiler.

If you have a 64-bit processor and OS, do you want a system that can compile both 64-bit and 32-bit? If so, you'll need to get the multi-arch version of gcc and g++. If you only want the compiler for your current OS architecture, then you can install a regular gcc and g++.

If you want the ability to compile both 32-bit and 64-bit binaries (and your OS is 64-bit), then you can choose to install the multi-arch version by doing this:

sudo apt install gcc-multilib g++-multilib

If you just want to compile for your current OS architecture (32-bit or 64-bit), then you can install with:

sudo apt install gcc g++

Regardless of what GCC you installed, you need to get make so that you can compile Orx:

sudo apt install make

There are four development libraries that Orx uses that are not usually included in Linux by default.

Install these with:

sudo apt install libsndfile1-dev libopenal-dev libxrandr-dev

There is already a guide available to help you to clone Orx to your PC. Once you followed this, come back here after.

Once complete, you now have everything you need in order to compile Orx and your own Orx-based projects.

For the actual compiling of the Orx library, there is already a guide to help you using GCC/gmake (a mac version, but it is pretty much the same). You can follow that to help you compile the Orx library in either 32-bit or 64-bit (depending what CPU and OS you are running). But do return here for some extra notes on multi-arch compiling.

Hopefully you have been successful compiling Orx. On a 64-bit system, you would have been able to compile 64-bit versions of the library and vice-versa for a 32-bit system. However, if you have installed the multi-arch GCC and G++, you can also compile for 32-bit on a 64-bit system.

In order to do that, you must first install the 32-bit versions of the development libraries that Orx depends on with:

sudo apt install libsndfile1-dev:i386 libopenal-dev:i386 libxrandr-dev:i386

Now you will be able to compile with configs such as:

make config=debug32

There is a very small gotcha. Because the libsndfile1-dev library does not yet contain multi-arch support (at least on Ubuntu), you cannot usually keep both the 32-bit and 64-bit versions of libsndfile1-dev on your system at the same time with apt or apt-get. You can work around this by doing the following:

sudo apt install libsndfile1-dev
cd /usr/lib/x86_64-linux-gnu
sudo cp libsndfile.so libsndfile.so_
sudo cp libsndfile.a libsndfile.a_
sudo apt install libsndfile1-dev:i386
sudo cp libsndfile.so_ libsndfile.so
sudo cp libsndfile.a_ libsndfile.a

Then you will be able compile 32 or 64-bit config at any time such as:

make config=release32
make config=release64

Read more about this at this post on the forum.