kfields / bigsaddle

bigsaddle 🐴

An opinionated, object oriented, minimalistic framework/starter kit for:

bgfx

SDL

Dear ImGui

⚠️ This is pre-alpha software. Do not use it for production.

Motivation

I wanted to take the pain out of cross platform 3D development for my personal projects

Features

Uses ImGui docking branch with support for docking and viewports

Quick Start

git clone --recursive https://github.com/kfields/bigsaddle
cd bigsaddle
mkdir build
cd build
cmake ..

Debug Build

mkdir build-debug
cd build-debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
# or
cmake -G Ninja -DCMAKE_BUILD_TYPE=Debug ..
# or
cmake -G "Visual Studio 17 2022" -DCMAKE_BUILD_TYPE=Debug ..

Shader Compilation

• Build bgfx with the --with-tools option as described here
• shadercRelease needs to be on your path
• pass -DCOMPILE_SHADERS to cmake

OpenGL

sudo apt install freeglut3-dev

Wayland

sudo apt install libwayland-dev
sudo apt install libxkbcommon-dev
sudo apt install libdecor-0-dev

#sudo add-apt-repository ppa:christianrauch/libdecoration

cmake -DBIG_WM_WAYLAND=ON -DCMAKE_BUILD_TYPE=Debug ..