nfx::graphics

A lightweight, zero-dependency C++20 OpenGL graphics library. Provides the full OpenGL 1.0-4.6 API on Linux/X11 and Windows/WGL through a typed C++ wrapper.

Requirements

• C++20 compiler (GCC 12+, Clang 15+, MSVC 2022+)
• CMake 3.25+
• OpenGL 4.5+ (Linux/X11 or Windows/WGL)

Build

CMake options

Option	Default	Description
NFX_GRAPHICS_BUILD_TESTS	OFF	Build unit tests
NFX_GRAPHICS_BUILD_GL_RUNTIME_TESTS	OFF	Build tests requiring a real GL context
NFX_GRAPHICS_BUILD_SAMPLES	OFF	Build sample executables
NFX_GRAPHICS_WARNINGS_AS_ERRORS	OFF	Treat compiler warnings as errors

Example - build everything in debug:

cmake -B build -DCMAKE_BUILD_TYPE=Debug -DNFX_GRAPHICS_BUILD_TESTS=ON -DNFX_GRAPHICS_BUILD_GL_RUNTIME_TESTS=ON -DNFX_GRAPHICS_BUILD_SAMPLES=ON -DNFX_GRAPHICS_WARNINGS_AS_ERRORS=OFF
cmake --build build

Public API entry points

• include/nfx/Graphics.h
• include/nfx/Gl.h

Project Structure

nfx-graphics/
├── include/nfx/
│   ├── Graphics.h                        # top-level nfx::graphics API entry point
│   ├── Gl.h                              # low-level nfx::graphics::gl API entry point
│   └── graphics
│       ├── gl/
│       │   ├── core/
│       │   │   ├── buffers/              # Buffer objects (VBO/SSBO/UBO wrappers)
│       │   │   ├── framebuffers/         # Framebuffer and renderbuffer wrappers
│       │   │   ├── functions/            # Per-version function classes (Functions_1_0.h-Functions_4_6.h)
│       │   │   ├── Context.h             # Per-thread GL function table initialization
│       │   │   ├── Functions.h           # Full OpenGL 1.0-4.6 C++ wrapper
│       │   │   ├── shaders/              # Shader program wrappers and typed uniforms
│       │   │   ├── textures/             # Sampler and texture wrappers
│       │   │   ├── GlDefinitions.h       # All GL constants
│       │   │   └── GlTypes.h             # Core GL type aliases (GLuint, GLfloat, etc.), GLsync and GLDEBUGPROC
│       │   ├── material/                 # Material system (shaders, render state, uniforms, textures, IBL generators)
│       │   ├── mesh/                     # Mesh data, primitives
│       │   ├── pipeline/                 # High-level rendering pipeline
│       │   │   ├── frame/                # FrameData, RenderResources (camera/light payloads)
│       │   │   ├── passes/               # RenderPass base class for render pipeline stages
│       │   │   ├── queue/                # RenderCommand, RenderQueue, SortKey (draw ordering)
│       │   │   ├── raster/               # Viewport/scissor types and policy contracts
│       │   │   ├── shadows/              # Shadow map payloads
│       │   │   ├── Bindings.h            # Binding-point conventions
│       │   │   ├── ForwardRenderPath.h   # forward pipeline assembler
│       │   │   ├── Renderer.h            # Frame renderer orchestrating render passes
│       │   │   ├── RenderMode.h          # Primitive topology enum
│       │   │   ├── RenderState.h         # Pipeline state descriptor
│       │   │   └── RenderTarget.h        # High-level framebuffer wrapper
│       │   ├── resources/                # Resource caches (meshes, shaders, textures, fonts)
│       │   ├── scene/
│       │   │   ├── cameras/              # Camera types and orbit camera
│       │   │   └── lights/               # Camera Light descriptors
│       │   ├── strokes/                  # CPU stroke tessellation with miter/round/bevel joins
│       │   └── text/                     # Font and text rendering with TextPass overlay
│       ├── math/                         # Matrices, vectors, quaternions, geometry
│       └── EmbeddedResource.h            # Runtime access to resources embedded at build time
├── resources/                            # Pipeline GLSL sources
├── samples/                              # Sample applications and shared sample framework
├── src/                                  # Implementation
├── tests/                                # Unit tests
└── tools/                                # Build tools and resource generator

The function loader resolves GL 1.2+ entry points via glXGetProcAddress (X11) or wglGetProcAddress (Win32).

Changelog

See CHANGELOG.md.

License

MIT - see LICENSE.

Development dependencies

• doctest (MIT) - test framework, not shipped with the library.

Third-party sample dependencies

• stb_image by Sean Barrett and contributors (MIT)
• stb_truetype by Sean Barrett and contributors (MIT)
• LearnOpenGL resources by Joey de Vries (MIT)
• Polyhaven (CC0 / Public Domain)
• JetBrains Mono by JetBrains (SIL Open Font License 1.1)