OpenGL Model Loader

A Windows only OpenGL model loader written in C++. The project uses GLFW, GLAD, GLM, stb, and fastgltf, with CMake and vcpkg handling the build and dependencies.

Demo

demo.mp4

Download And Run

If you only want to use the application, go to the GitHub Releases page and download one of these files:

• Installer: OpenGL-Model-Loader-Installer.exe installs the application and creates shortcuts.
• ZIP: final_build.zip is a portable version. Extract it and run OpenGL-Model-Loader.exe.

Requirements

Install these tools before building:

• Windows 10 or later
• Git
• CMake 3.20 or newer
• MinGW GCC
• LLVM, including clang-format and clang-tidy
• PowerShell

Setup

Clone the repository:

git clone https://github.com/Daniel-Gia/OpenGL-model-loader.git

Set up vcpkg:

.\scripts\Setup-vcpkg.ps1

This script clones vcpkg, checks out the project’s pinned version, and bootstraps it. The dependencies in vcpkg.json are installed automatically by CMake during configuration.

Build And Run

Configure the Debug build:

.\scripts\Configure.ps1

Build the project:

.\scripts\Build.ps1

Run the application:

.\scripts\Run.ps1

To build and run in one step:

.\scripts\BuildAndRun.ps1

The Debug executable is generated at:

build\debug\OpenGL-Model-Loader.exe

Release Build

.\scripts\Release.ps1

The final release build is inside:

final_build\

Code Quality

Install LLVM with WinGet:

This is only needed for formatting and linting if you do not plan to do this skip this step

winget install --id LLVM.LLVM --exact

Restart your terminal after installing the tools so the updated PATH is available.

Code Quality Scripts

Run the formatting check:

.\scripts\CheckFormat.ps1

Run the clang-tidy check:

.\scripts\CheckLint.ps1

Apply Automatic Fixes

Format:

.\scripts\Format.ps1

Lint:

.\scripts\FixLint.ps1

Cleaning Build Files

.\scripts\Clean.ps1