API Overview

Filter

SafiEngine API

SafiEngine is a pure-C game engine built on SDL3 (with the SDL_gpu API), flecs for ECS, cglm for math, MicroUI for the debug overlay, and cgltf for model loading. Every subsystem below ships as part of the engine and is available by including <safi/safi.h> (umbrella header) or individual <safi/…/…> headers.

Zero setup

All dependencies are pulled in by CMake FetchContent. You only need CMake and a C/C++ compiler — no manual brew install, no submodules, no shader toolchains.

Subsystems

Area	Header prefix	Description	Status
Core	`<safi/core/…>`	`SafiApp`, logging, frame timing	Implemented
Scheduler	`<safi/ecs/…>`	Startup, update, fixed-update, render stages	Partial
ECS	`<safi/ecs/…>`	flecs world, stock components, systems	Implemented
Transform	`<safi/ecs/…>`	Local/global transform, hierarchy propagation	Partial
Camera	`<safi/ecs/…>`	Pose (eye/forward/up), active-camera tag, screen-ray	Implemented
Visibility	—	Visibility flags, frustum culling, render layers	WIP
Render	`<safi/render/…>`	SDL_gpu renderer, meshes, materials, shaders, glTF	Implemented
Primitives	`<safi/render/…>`	Procedural plane/box/sphere/capsule with color + texture	Implemented
Lighting	`<safi/render/…>`	Directional, point, ambient lights	WIP
Gizmos	`<safi/render/…>`	Frame-lifetime line/wireframe overlay for editor tools	Implemented
Assets	`<safi/render/…>`	Asset handles, caching, hot-reload stub	Implemented
Scene	`<safi/scene/…>`	JSON save/load/clear, in-memory snapshot/restore	Implemented
Editor	`<safi/editor/…>`	Edit/Play toolbar, fly-cam, translate/rotate/scale gizmo	Partial
Input	`<safi/input/…>`	Keyboard/mouse/scroll/modifiers snapshot singleton	Implemented
UI	`<safi/ui/…>`	MicroUI debug overlay	Implemented
Physics	—	Colliders, rigid bodies, raycasts, overlap queries	Partial
Audio	`<safi/audio/…>`	2D/3D playback, mixer buses, streaming	Implemented

Feature status

See the full Feature Roadmap for a detailed breakdown of every feature's implementation status.

Quickstart

main.c

#include <safi/safi.h>

int main(void) {
    SafiApp app;
    safi_app_init(&app, &(SafiAppDesc){
        .title = "Hello SafiEngine",
        .width = 1280,
        .height = 720,
        .vsync = true,
        .enable_debug_ui = true,
    });

    // register components, systems, spawn entities...

    safi_app_run(&app);
    safi_app_shutdown(&app);
}

See the full runnable example at SafiEngine/examples/gltf_viewer/main.c.

Core

ECS

Render

Scene

Scene Serialization

Editor

Project

Project I/O

Audio

Audio (miniaudio)

Input

SafiInput

UI

Debug UI (MicroUI)

Hub UI

API Overview#

#SafiEngine API

#Subsystems

#Quickstart

Core#

ECS#

Render#

Scene#

Editor#

Project#

Audio#

Input#

UI#