LearnOpenGL

• The tutorials are deployed at printfdebugging.in (check out the graphics section)
• Following Learn OpenGL tutorials

Project Structure

The project uses external libraries cloned as git submodules in /libs directory. Common project assets like logo are stored in /assets, CMake specific files live in /cmake and these include header only projects, config template files, graph generation steps etc. /source contains all the source files

The project is organized into modules like source/core, source/loader, source/tutorials. core provides the core functionality like windowing and logging while loader as the name suggests, provids the loading functionality. core and loader are built as libraries used by executable modules in the tutorials module.

Note

The libraries are built as static libraries for now. It's because I don't know how to link shared objects to build wasm binaries yet (soon). Also building static libraries on windows makes the executable standalone as the C runtime is also embedded into the executable. This is not the case when building and linking dlls, I get 'ms-win-crt-x.dll' not found errors & I don't want to spend time on this problem now (but quite soon).

 assets
 cmake
 libs
 scripts
 source
│  core
│ │  include
│ │  source
│ │  CMakeLists.txt
│  loader
│ │  include
│ │  source
│ │  CMakeLists.txt
│ ...
│  tutorials
│ │  hello-triangle
│ │ │  assets
│ │ │  source
│ │ │  CMakeLists.txt
│ │ │ 󰂺 README.md
│ │ ...
 CMakeLists.txt

Emscripten Specific Details

The cmake build files use if (EMSCRIPTEN) conditional blocks to separate normal build commands from wasm specific commands. Each tutorial generates three files index.{html,js,wasm}. These are copied over to prefix/bin/${tutorial} directory during installation.

Tutorial specific asset files live in the tutorial's local assets directory while common assets live in the /assets directory. Both can be accessed from within the build tutorials using ASSETS_DIR and COMMON_ASSETS_DIR definitions respectively. This way asset location can be changed just by changing the build files.

Code Usage:

shader = shCreateFromFile(
    ASSETS_DIR "shaders/shader.vert",
    ASSETS_DIR "shaders/shader.frag"
);

Wasm builds use the scripts/index.html shell file by default unless USE_GENERATED_INDEX_HTML:BOOLEAN GENERATED_GRAPHICS_DIR_PATH:STRING are defined. These allow us to use a different shell file. You can also see each tutorial has a README.md file with a similar header.

---
title: Hello Triangle
date: 2025-12-17
---

{{ include(path="/canvas.md") }}

This is some dummy text, should be removed later.

This README.md file is copied over to my [website] which then uses zola (a static site generator) to generate a new shell file. Then the wasm/html files are generated using the generated shell file & finally everything is copied & deployed on the website. See scripts and the gitlab-ci file for more details.

Dependencies

See dependencies.sh, it's a shell script to install all the required dependencies on archlinux and MSYS2 (Winodws). I will later create a dependencies.bat file to install dependencies on windows.

How to Build

cd learnopengl
cmake -B build -S .                    # for normal build
emcmake cmake -B build -S .            # for wasm build
cmake --build build -j $(nproc)        # build
cmake --install build --prefix install # install