Skip to content

Installation

Jump to bottom
h@di edited this page Jul 26, 2018 · 14 revisions

Install SDL2

In order to use RSDL you have to install SDL2 library on your system.

Mac OS users

  1. Download the latest SDL2 development library dmg file from the SDL website (currently latest version is 2.0.6)

  2. Download SDL2_image development library from this page

  3. Download SDL2_ttf development library from this page

  4. Now open these dmg files and copy SDL2.framework,SDL2_ttf.framework and SDL2_image.framework files to /Library/Frameworks

Install with brew

  1. Install the brew:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  1. Install SDL with brew:
brew install sdl2
brew install sdl2_image
brew install sdl2_ttf

Linux users

  1. Make sure you have the following apt-get repo:‍ http://us.archive.ubuntu.com/ubuntu and your apt-get packages list is up to date.

1.1. Open your repos list with the following command:

sudo nano /etc/apt/sources.list

1.2. Ensure that following line exists in the file, if it does not exists, add it to the file:

deb http://us.archive.ubuntu.com/ubuntu trusty main universe

1.3. Update your apt-get packages list:

sudo apt-get update
  1. Run command below to install SDL2, SDL2_image and SDL2_ttf packages
sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev

Test Installation

To test your installation download or clone the repository (from this link) and go into the downloaded directory, then run the make command to build the test file.
Finally running ./test should come up with a window with UT background.

cd RSDL   
make    
./test

Compile RSDL Library

RSDL library contains two files: rsdl.hpp and rsdl.cpp. In order to use this library you have to compile rsdl.cpp and include rsdl.hpp in your codes.

Mac OS users

At first you have to uncomment lines 9, 10 and 11 in rsdl.hpp. Also comment lines 4, 5 and 6.
To compile rsdl.cpp on mac, you have to compile it with -framework option to include SDL2, SDL2_image and SDL2_ttf libraries.Run the following command:

g++ [your cpp files] rsdl.cpp -framework SDL2 -framework SDL2_image -framework SDL2_ttf

Linux users

At first you have to uncomment lines 4, 5 and 6 in rsdl.hpp. Also comment lines 9, 10 and 11.
To compile rsdl.cpp on linux systems, you have to compile it with -l option to include SDL2, SDL2_image and SDL2_ttf libraries.Run the following command:

g++ [your cpp files] rsdl.cpp -l SDL2 -l SDL2_image -l SDL2_ttf
Clone this wiki locally