Home

Awesome

Low Level Graphics Library (LLGL)

<p align="center"> <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.com/channels/1257440130021457941"><img alt="Discord" src="https://img.shields.io/discord/1257440130021457941?logo=discord&logoColor=white"></a?> </p> <p align="center"><img src="docu/LLGL_Logo.png"/></p>

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

Platform Support

PlatformCID3D12D3D11VulkanOpenGLMetal
<img src="docu/Icons/windows.svg" height="20" /> Windows<p>MSVC16+ CI</p> <p>MSVC14 CI</p>:heavy_check_mark::heavy_check_mark::heavy_check_mark::heavy_check_mark:N/A
<img src="docu/Icons/uwp.svg" height="20" /> UWPUWP CI:heavy_check_mark::heavy_check_mark:N/AN/AN/A
<img src="docu/Icons/linux.svg" height="20" /> GNU/LinuxGNU/Linux CIN/AN/A:heavy_check_mark::heavy_check_mark:N/A
<img src="docu/Icons/macos.svg" height="20" /> macOSmacOS CIN/AN/AN/A:heavy_check_mark::heavy_check_mark:
<img src="docu/Icons/ios.svg" height="20" /> iOSiOS CIN/AN/AN/A:heavy_check_mark::heavy_check_mark:
<img src="docu/Icons/android.svg" height="20" /> AndroidAndroid CIN/AN/A:construction::heavy_check_mark:N/A
<img src="docu/Icons/wasm.svg" height="20" /> WasmWebAssembly CIN/AN/AN/A:heavy_check_mark:N/A

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

<p align="center"> <img src="examples/Cpp/PostProcessing/Example.png" alt="Screenshot missing: Post processing example" style="width:300px;height:auto;"> <img src="examples/Cpp/ShadowMapping/Example.png" alt="Screenshot missing: Shadow mapping example" style="width:300px;height:auto;"> </p> <p align="center"> <img src="examples/Cpp/PBR/Example.png" alt="Screenshot missing: PBR example" style="width:300px;height:auto;"> <img src="examples/Cpp/ClothPhysics/Example.gif" alt="Screenshot missing: Cloth physics example" style="width:300px;height:auto;"> </p> <p align="center"> <img src="examples/Cpp/Fonts/Example.iOS.png" alt="Screenshot missing: Fonts example (iOS)" style="height:400px;width:auto;"> <img src="examples/Cpp/ClothPhysics/Example.iOS.png" alt="Screenshot missing: Cloth physics example (iOS)" style="height:400px;width:auto;"> </p>