Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jhasse/jngl
Easy to use cross-platform 2D game library for C++
https://github.com/jhasse/jngl
android cross-platform game-engine game-engine-2d gamedev ios linux macos nintendo-switch openal opengl windows xbox
Last synced: 3 days ago
JSON representation
Easy to use cross-platform 2D game library for C++
- Host: GitHub
- URL: https://github.com/jhasse/jngl
- Owner: jhasse
- License: zlib
- Created: 2011-01-31T20:07:16.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2024-11-27T17:34:24.000Z (15 days ago)
- Last Synced: 2024-11-27T18:27:03.999Z (15 days ago)
- Topics: android, cross-platform, game-engine, game-engine-2d, gamedev, ios, linux, macos, nintendo-switch, openal, opengl, windows, xbox
- Language: C++
- Homepage: https://bixense.com/jngl/
- Size: 36.4 MB
- Stars: 270
- Watchers: 10
- Forks: 19
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-game-engine-dev - JNGL - 2D framework. Develop anywhere, deploy everywhere. (Libraries / C++)
- awesome-gamedev - JNGL
- AwesomeCppGameDev - JNGL
- awesome-game-engines - jngl - Easy to use cross-platform 2D game library for C++ (Uncategorized / Uncategorized)
README
# JNGL - Just a Neat Game Library
[🌐 Website](https://bixense.com/jngl/)
[🏃 Quickstart](https://github.com/jhasse/jngl/wiki/JNGL-Quickstart)
[🎓 Tutorial](https://github.com/pinguin999/my-jngl-starter)
[📚 Documentation](https://bixense.com/jngl/annotated.html)
[](https://discord.gg/254P43HvWJ)
An easy to use C++ game library for Linux, Windows, macOS, Android, iOS, Xbox, the Nintendo Switch,
LG webOS and the Web.
[](https://portaldogs.com/)
## Building
```
cmake -Bbuild
cmake --build build
./build/jngl-test
```
## Linux
### Ubuntu
```
sudo apt-get install libgl1-mesa-dev libfreetype6-dev libfontconfig1-dev libpng-dev \
libxxf86vm-dev libvorbis-dev cmake g++ libwebp-dev git libsdl2-dev
```
### Fedora
```
sudo dnf install fontconfig-devel freetype-devel libvorbis-devel libwebp-devel \
cmake SDL2-devel gcc-c++ libatomic
```
### Arch Linux
```
pacman -Syu --needed cmake gcc sdl2 pkg-config fontconfig libwebp libvorbis
```
## Windows
### MSYS2 / MinGW-w64
Set up [MSYS2](https://www.msys2.org/) and install the following in a MinGW-w64 Win64 Shell:
```
pacman -Syu --needed mingw-w64-x86_64-gcc \
mingw-w64-x86_64-freetype mingw-w64-x86_64-libvorbis mingw-w64-x86_64-libwebp \
mingw-w64-x86_64-dlfcn mingw-w64-x86_64-cmake make mingw-w64-x86_64-gdb \
mingw-w64-x86_64-libtheora mingw-w64-x86_64-SDL2
```
### Visual Studio 2017 or newer
```
cmake -Bbuild -DFETCHCONTENT_QUIET=0
```
and then open `build/jngl.sln`.
## Mac
Use [Homebrew](http://brew.sh/) to install the build dependencies:
```
brew install sdl2 freetype libvorbis webp pkg-config cmake
```
## Android
Install the Android SDK and let `ANDROID_HOME` point to it. In the Android SDK Manager install the
NDK build tools. Type the following to run the test app via ADB:
```
make -C android run
```
You can also open the `android/test` folder in Android Studio and build from there.
## iOS
Generate a Xcode project using CMake:
```
cmake -Bbuild-ios -GXcode -DCMAKE_TOOLCHAIN_FILE=cmake/iOS.toolchain.cmake -DIOS_PLATFORM=SIMULATOR
```
Open and build `build-ios/jngl.xcodeproj` in Xcode.
## Xbox
```
cmake -Bbuild-uwp -DCMAKE_SYSTEM_NAME=WindowsStore "-DCMAKE_SYSTEM_VERSION=10.0"
```
and then open `build-uwp/jngl.sln`.