Low Level Graphics Library (LLGL)

<a href="https://github.com/LukasBanana/LLGL/blob/master/LICENSE.txt"><img alt="License" src="https://img.shields.io/badge/license-BSD--3%20clause-blue.svg" /></a>
<a href="https://discord.gg/JT4dZ3CgJZ"><img alt="Discord" src="https://img.shields.io/discord/1257440130021457941?logo=discord&logoColor=white"></a?>

Abstract

LLGL aims to be a thin abstraction layer for a wide variety of modern and legacy rendering APIs as well as a multitude of platforms targeting both desktop and mobile. LLGL provides close coupling with the underlying APIs for a rich feature set while also simplifying architectural hurdles. The library is written mostly in C++11 with the addition of a C99, C# 6.0, and Go wrapper.

Documentation

• Version: 0.04 Beta (see ChangeLog)
• Getting Started with LLGL (PDF) with Introduction, Hello Triangle Tutorial, and Extensibility Example with GLFW
• LLGL Reference Manual (PDF)
• LLGL Coding Conventions (PDF)
• C++ Examples and Tutorials
• C99 Examples
• C# Examples
• Go Examples
• WebGL Examples

Platform Support

Platform	CI	D3D12	D3D11	Vulkan	OpenGL	Metal
Windows

| :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | N/A | | UWP | | :heavy_check_mark: | :heavy_check_mark: | N/A | N/A | N/A | | GNU/Linux | | N/A | N/A | :heavy_check_mark: | :heavy_check_mark: | N/A | | macOS | | N/A | N/A | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | iOS | | N/A | N/A | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | | Android | | N/A | N/A | :construction: | :heavy_check_mark: | N/A | | Wasm | | N/A | N/A | N/A | :heavy_check_mark: | N/A | | CMake/Unity | | | | | | |

Build Notes

Build scripts are provided for CMake. See LLGL Build System for more details.

Windows

Visual Studio 2015 or later is required to build LLGL on Windows. The Windows SDK is also required to build D3D11 and D3D12 backends.

macOS, iOS

Xcode 9 or later is required to build LLGL on macOS and iOS. For older Macs, there is a legacy mode to build LLGL for Mac OS X 10.6 using MacPorts of Clang.

GNU/Linux

LLGL on GNU/Linux requires the development libraries for X11 and its Xrandr extension (see docs for details).

Android

Android NDK with at least API level 21 is required. The build script supports generating project files for Android Studio.

Installing (vcpkg)

Alternatively, you can build and install LLGL using vcpkg dependency manager:

    git clone https://github.com/Microsoft/vcpkg.git
    cd vcpkg
    ./bootstrap-vcpkg.sh
    ./vcpkg integrate install
    ./vcpkg install llgl

The LLGL port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please create an issue or pull request on the vcpkg repository.

Showcase

<img src="https://github.com/LukasBanana/LLGL/raw/Release-v0.04b/examples/Cpp/PostProcessing/Example.png" alt="Screenshot missing: Post processing example" style="width:300px;height:auto;">
<img src="https://github.com/LukasBanana/LLGL/raw/Release-v0.04b/examples/Cpp/ShadowMapping/Example.png" alt="Screenshot missing: Shadow mapping example" style="width:300px;height:auto;">







<img src="https://github.com/LukasBanana/LLGL/raw/Release-v0.04b/examples/Cpp/PBR/Example.png" alt="Screenshot missing: PBR example" style="width:300px;height:auto;">
<img src="https://github.com/LukasBanana/LLGL/raw/Release-v0.04b/examples/Cpp/ClothPhysics/Example.gif" alt="Screenshot missing: Cloth physics example" style="width:300px;height:auto;">







<img src="https://github.com/LukasBanana/LLGL/raw/Release-v0.04b/examples/Cpp/Fonts/Example.iOS.png" alt="Screenshot missing: Fonts example (iOS)" style="height:400px;width:auto;">
<img src="https://github.com/LukasBanana/LLGL/raw/Release-v0.04b/examples/Cpp/ClothPhysics/Example.iOS.png" alt="Screenshot missing: Cloth physics example (iOS)" style="height:400px;width:auto;">