For my work I had to install OSG on both Linux and Windows. It took me a while to figure things out for Windows platform. As a contrary, the installation on Linux was rather straightforward and went smooth. Here I will describe all the steps it took for me to install the OSG on Linux.
The official documentation and reference books provide the full steps on how to install the OSG library on different platforms. Although binary installation files available for older OSG version, I strongly recommend installation from the source - that way you will get the latest version, as well as will be able to refer to the source directly when needed.
I intend to provide a very brief guide for Linux that worked for my laptop (Lubuntu-14.04). It is supposed to be concise, however if you run into a difficulty, better to check with the official guide.
To download the latest stable version (or the latest development version if you wish), clone from the official OpenSceneGraph github repository:
Assuming you want to use the latest stable verion of OSG, switch the branch inside the local repository:
x.y.z with the numbers that correspond to the version you intend to use, e.g.,
Now it is the time to run the installation steps which are also specified in a corresponding
The above steps might take a while (from 20 minutes to several hours), depending on how powerful you PC is. In case if you are planning to do the compilation together with the OSG examples, refer below to “Example compilation” section.
After the installation, it is necessary to set certain environment variables that are used by the OSG. To do it, use a text editor of your choice and open
.zshrc or similar file which contains your shell environment information. Now add the following lines:
Make sure the
include file paths correspond to the path where your OSG libraries were installed (look through the
make install command output to see the destination of the libraries). In my case the
include files were installed to
/usr/local/include, and the
lib files were installed to
Before the usage of OSG, restart your bash environment.
The OSG supplies a bunch of useful examples. You may want to look through them, or compile against them. To install them, run the aforementioned
cmake command with the next argument:
Then follow the other steps as they are:
sudo make install (or you can try to run the examples from the
build directory directly).
To run the examples, download the data of models and textures that is supplied with OSG. It can be found at their official github repository. To clone the data using
git, run the following command:
Then copy the data to a folder designated for OpenSceneGraph data. For this, I created a folder at
/usr/local/OpenSceneGraph/data, and then copied the
osg-data folder content to the designated folder. As a last step, include the data path as an environment variable (edit the
.bashrc file again):
Do not forget to restart your bash environment. Now your OSG library is set up and ready to be used.