Updated Working on Raspberry Pi (markdown)

master
Ray 7 years ago
parent
commit
8d7e02c042
1 changed files with 21 additions and 11 deletions
  1. +21
    -11
      Working-on-Raspberry-Pi.md

+ 21
- 11
Working-on-Raspberry-Pi.md

@ -1,24 +1,22 @@
To build your raylib game for Raspberry Pi you need to download raylib git repository (develop branch recommended) and install some dependencies. raylib already comes with ready-to-use makefiles to compile source code and examples.
To build your raylib game for Raspberry Pi you just need to download raylib git repository. All required libraries come with the raylib, **no additional dependencies are required**. raylib also comes with ready-to-use makefiles to compile source code and examples.
### Supported Devices and OS
Currently ALL Raspberry Pi devices are supported by raylib (1, 2, 3, Zero and variants). OS supported is [Raspbian Stretch](https://www.raspberrypi.org/downloads/raspbian/).
Currently ALL Raspberry Pi devices are supported by raylib (1, 2, 3, Zero and variants). OS supported is [Raspbian Stretch](https://www.raspberrypi.org/downloads/raspbian/). If you're still using Raspbian Jessie, you should update to Raspbian Stretch.
### Supported OpenGL backends
- OpenGL ES 2.0 in native mode, not X11 (any RPI version with the legacy driver)
- OpenGL 1.1 on X11 desktop mode, (**only RPI 2 and 3**)
- OpenGL 2.1 on X11 desktop mode, (**only RPI 2 and 3**)
- OpenGL ES 2.0 in **native mode** (no X11 required)
- OpenGL 1.1 on X11 desktop mode
- OpenGL 2.1 on X11 desktop mode
More detailed information is available on the [raylib platforms and graphics](https://github.com/raysan5/raylib/wiki/raylib-platforms-and-graphics) wiki page.
By default, raylib is prepared to be used in native mode, it means, right from the command line, not depending on any windowing system (no X11 required), accessing Broadcom Video driver directly... but some users could prefer to use raylib from a classic X11-based Linux desktop, that's also possible, thanks to the `OpenGL desktop drivers`.
### Install required libraries
All required libraries come with the system, no additional dependencies are required.
OpenGL desktop mode requires the GL desktop driver and supposedly it only works for RPI 2 and higher, that limit is set for performance reasons... but, if required, GL desktop driver can be also enabled on RPI B/B+ or Zero, [just follow this guide](https://www.raspberrypi.org/forums/viewtopic.php?f=66&t=166495) to enable it.
### Compiling raylib source code
Before compiling your game, raylib library must be recompiled for Raspbian. To do that, just navigate to `raylib\src\` directory and run one of the following options depending on your needs:
Just navigate to `raylib\src\` directory and run one of the following options depending on your needs:
1. To use OpenGL ES 2.0 in native mode (no X11):
```
@ -28,6 +26,16 @@ make PLATFORM=PLATFORM_RPI
```
make PLATFORM=PLATFORM_DESKTOP GRAPHICS=GRAPHICS_API_OPENGL_21
```
NOTE: To use raylib on Raspbian desktop, you need to had previously installed all desktop windowin system libraries, if you just downloaded [Raspbian Desktop](https://www.raspberrypi.org/downloads/raspberry-pi-desktop/), it comes with all required libraries installed but if you're using a plain (no desktop) Raspbian system, you need to install the following components first:
```
sudo apt-get install --no-install-recommends raspberrypi-ui-mods lxterminal gvfs
sudo apt-get install mesa-common-dev
sudo apt-get install libgl1-mesa-dev
sudo apt-get install libxcursor
sudo apt-get install libxinerama
sudo apt-get install libxrandr-dev
sudo apt-get install libxi-dev
```
### Compiling raylib examples
@ -51,4 +59,6 @@ make core/core_basic_window PLATFORM=PLATFORM_RPI
2. To use desktop OpenGL 1.1 or 2.1 (X11 window)
```
make core/core_basic_window PLATFORM=PLATFORM_DESKTOP GRAPHICS=GRAPHICS_API_OPENGL_21
```
```
Easy.

Loading…
Cancel
Save