https://github.com/elnormous/ouzel
C++ game engine for Windows, macOS, Linux, iOS, tvOS, Android, and web browsers
https://github.com/elnormous/ouzel
android direct3d emscripten game game-development game-engine glsl hlsl linux macos metal multiplatform openal opengl opengles opensles raspbian tvos windows xaudio2
Last synced: about 1 month ago
JSON representation
C++ game engine for Windows, macOS, Linux, iOS, tvOS, Android, and web browsers
- Host: GitHub
- URL: https://github.com/elnormous/ouzel
- Owner: elnormous
- License: unlicense
- Created: 2015-12-20T12:40:52.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-03-01T00:28:07.000Z (about 1 year ago)
- Last Synced: 2024-07-31T22:45:35.651Z (9 months ago)
- Topics: android, direct3d, emscripten, game, game-development, game-engine, glsl, hlsl, linux, macos, metal, multiplatform, openal, opengl, opengles, opensles, raspbian, tvos, windows, xaudio2
- Language: C++
- Homepage:
- Size: 42.1 MB
- Stars: 989
- Watchers: 71
- Forks: 113
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- awesome-game-engine-dev - Ouzel - Public domain, targeted for development of 2D games. (Libraries / C++)
README
# Ouzel v0.40
[](https://travis-ci.com/github/elnormous/ouzel) [](https://ci.appveyor.com/project/elnormous/ouzel) [](https://sonarcloud.io/dashboard?id=Ouzel) [](https://gitter.im/elnormous/ouzel?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Ouzel is a C++ game engine mainly targeted for development of 2D games.
Supported platforms:
* Windows 7, 8, 10
* macOS 10.8+
* GNU/Linux
* iOS 8+
* tvOS 9+
* Android 3.0+
* Emscripten ([sample](http://www.ouzel.org/samples/))Supported rendering backends:
* Direct3D 11
* OpenGL 2, OpenGL 3 and OpenGL 4
* OpenGL ES 2 and OpenGL ES 3
* MetalSupported audio backends:
* XAudio 2
* CoreAudio
* OpenAL
* OpenSL ES
* ALSA## Features
* Cross-platform (Windows, macOS, iOS, tvOS, Android, Linux, and Emscripten targets supported)
* Multi-threaded (separate threads for rendering, sound, and game)
* 2D and 3D scene management
* GUI helper classes and management
* Bitmap and true-type font support
* Multiple side-by-side viewport support
* XInput, DirectInput, IOKit, Apple GameController, and Linux evdev gamepad support
* Actor animation (including tweening) system
* Particle systems
* Resource caching system
* Localization support via loading string translations and UTF-8 string support
* Software audio mixer for sound effect playback
* High DPI support on Windows, macOS, and iOS
* Easy to install (just pull the repository and build it)## Example app
The following code will open create a scene with a sprite in the center of it:
```cpp
#include "assets/Bundle.hpp"
#include "core/Engine.hpp"
#include "scene/Camera.hpp"
#include "scene/Layer.hpp"
#include "scene/Scene.hpp"
#include "scene/SpriteRenderer.hpp"class Example: public ouzel::Application
{
public:
Example():
assets{ouzel::engine->getCache(), ouzel::engine->getFileSystem()}
{
assets.loadAsset(ouzel::assets::Loader::Image, "player", "player.png");
ouzel::engine->getSceneManager().setScene(&scene);
scene.addLayer(&layer);
cameraActor.addComponent(&camera);
layer.addChild(&cameraActor);
playerSprite.init("player");
player.addComponent(&playerSprite);
layer.addChild(&player);
}private:
ouzel::scene::Scene scene;
ouzel::scene::Layer layer;
ouzel::scene::Camera camera;
ouzel::scene::Actor cameraActor;
ouzel::scene::SpriteRenderer playerSprite;
ouzel::scene::Actor player;
ouzel::assets::Bundle assets;
};std::unique_ptr ouzel::main(const std::vector& args)
{
return std::make_unique();
}
```## Showcase
2D platformer [Bearslayer](http://store.steampowered.com/app/460210) is being developed using Ouzel engine.
[](https://www.youtube.com/watch?v=q-O8-hpvJ5A)
## Compilation
GNU makefile, Xcode project, and Visual Studio project files are located in the "build" directory. Makefile and project files for sample project are located in the "samples" directory.
You will need to download OpenGL (e.g. Mesa), ALSA, and OpenAL drivers installed in order to build Ouzel on Linux. For x86 Linux also libx11, libxcursor, libxi, libxrandr, and libxss are required.
To build Ouzel with Emscripten, pass "PLATFORM=emscripten" to "make" command, but make sure that you have Emscripten SDK installed before doing so:
```shell
$ make PLATFORM=emscripten
```You can build Android samples and run them on an Android device by executing the following commands in "samples/android" directory (Android SDK and NDK must be installed and added to PATH):
```shell
$ gradle assembleDebug
$ gradle installDebug
$ adb shell am start -n org.ouzel/org.ouzel.MainActivity
```To build Ouzel on Raspberry Pi, you will have to install Raspberry Pi development library (`libraspberrypi-dev`) and kernel headers (`raspberrypi-kernel-headers`)
Because on Raspbian Stretch libEGL.so was renamed to libbrcmEGL.so and libGLESv2.so to libbrcmGLESv2.so you will have to run the following commands before building the samples on Raspbian 8 (Jessie) or older:
```shell
$ sudo ln -s /opt/vc/lib/libEGL.so /opt/vc/lib/libbrcmEGL.so
$ sudo ln -s /opt/vc/lib/libGLESv2.so /opt/vc/lib/libbrcmGLESv2.so
```## System requirements
* Windows 7+ with Visual Studio 2017 or newer
* macOS 10.10+ with Xcode 10+
* Any reasonable new Linux distro (x86 and ARM are supported) with gcc 7+ or clang 5+## Getting help
You can ask question in the following locations:
* Ouzel Twitter account: https://twitter.com/ouzelengine
* Ouzel server on Discord: https://discord.gg/4sWuJE8
* Author of the Ouzel engine: https://twitter.com/elnormous
* Development roadmap: https://trello.com/b/5tRlUXKR/ouzel-roadmap## License
Ouzel codebase is released to the Public Domain
