Skip to content
theZiz edited this page May 12, 2013 · 2 revisions

Requirements

First you need a couple of dev packages of some libs. As developing linux user, you should be able to install them on your own depending on your distribution. The needed libraries are:

  • libSDL-dev
  • libSDL-image-dev
  • libSDL-ttf2.0-dev
  • libSDL-mixer-dev (for sparrowSound)
  • libSDL-net-dev (for sparrowNet, which is however not implemented yet)
Furthermore you need git for the current version. But you can also use an older, but more stable version. In fact most of the times you are fine with the current version. But sometimes I fuck things up. ^^'

Compiling sparrow3d

Now download the current version in your developing folder with:

git clone https://github.com/theZiz/sparrow3d.git

A subfolder for sparrow3d will be created.

Here ( https://github.com/theZiz/sparrow3d/tags ) you find the stable versions. Just extract the zip file anywhere. However now enter the sparrow3d-folder, have a look at the Makefile (pretty easy, even if you don't know the Makefile-language), and type "make".

Now you should be able to run the test applications starting with "test" and always ending with ".sh". The Bashfile specifies the library path (in this case .). Unlike as in Windows, Linux doesn't search in the current folder for libraries for security reasons!

Making an own project

I would advise to download a simple project of mine (like Puzzletube ( https://github.com/theZiz/puzzletube )), and delete everything up to the puzzletube.c, the Makefile and maybe the starter-script. Rename the puzzletube.c as you like, change the Makefile and maybe copy some example code from one of the test….c-files from the sparrow3d folder in your renamed file to get a simple example. ;)

Of course you can use sparrow3d on your own, too. There is no need to use my Makefiles. However, their make it pretty easy to compile for different targets with: make TARGET=target The targets are in the "target"-folder of sparrow3d ending with .mk. Don't forget to change the paths to your paths!

If you got this to work, you are ready to start developing with sparrow3d. :)