$darkmode
Suckless OGL 1.0.0
A lean, high-performance C11 PBR Renderer
app.h
Go to the documentation of this file.
1 #ifndef APP_H
2 #define APP_H
3 
4 #include "action_notifier.h"
5 #include "adaptive_sampler.h"
6 #include "app_binding.h"
7 #include "app_ui.h"
8 #include "async/async_coordinator.h"
9 #include "async_loader.h"
10 #include "camera.h"
11 #include "effect_benchmark.h"
12 #include "env_manager.h"
13 #include "fps.h"
14 #include "gl_common.h"
15 #include "gpu_profiler.h"
16 #include "gpu_profiler_ui.h"
17 #include "perf_mode.h"
18 #include "postprocess.h"
19 #include "scene.h"
20 #include "tracy_manager.h"
21 #include "ui.h"
22 #include <cglm/cglm.h>
23 
24 #ifdef USE_SSBO_RENDERING
25 #include "ssbo_rendering.h"
26 #endif
27 
28 typedef struct AsyncLoader
29  AsyncLoader;
35 typedef struct App {
36  /* --- Pointers and Dynamic Objects --- */
37  Scene scene;
38  PostProcess postprocess;
39  GLFWwindow* window;
40  double last_frame_time;
41  double delta_time;
42  uint64_t frame_count;
43  float* lum_histogram_buffer;
45  /* --- Sub-Modules (RAII/In-Place) --- */
46  FpsCounter fps_counter;
47  AdaptiveSampler fps_sampler;
48  GPUProfiler gpu_profiler;
49  GPUProfilerUI timeline_ui;
50  AppUIOverlay overlay;
51  AppBindingRegistry binding_registry;
52 
53  Camera camera;
55  /* --- App State Flags and Values --- */
56  int width;
57  int height;
58  int is_fullscreen;
59  int saved_x, saved_y;
60  int saved_width, saved_height;
61  int resize_pending;
62  int pending_width;
63  int pending_height;
64  int camera_enabled;
65  EnvManager env_mgr;
66  int perf_mode_active;
67  PerfModeContext perf_context;
68  ActionNotifier notifier;
69  EffectBenchmark effect_bench;
70  int log_gpu_metrics;
72  /* --- Global GPU Resources --- */
73  GLuint lum_ssbo[2];
74  TracyManager tracy_mgr;
76  /* --- Global Configuration Uniforms --- */
77  float u_metallic;
78  float u_roughness;
79  float u_ao;
80  float u_exposure;
82  AsyncLoader* async_loader;
83  AsyncCoordinator
84  async_coord;
86 } App;
87 
88 /* --- Core Control Flow --- */
89 
93 int app_init(App* app, int width, int height, const char* title);
94 
98 void app_cleanup(App* app);
99 
103 void app_run(App* app);
104 
108 void app_update(App* app);
109 
110 #include "app_input.h"
111 
112 enum { TRACY_SCREENSHOT_WIDTH = 320, TRACY_SCREENSHOT_HEIGHT = 180 };
113 
114 #endif /* APP_H */
action_notifier.h
Temporary on-screen notification system for user actions.
adaptive_sampler.h
Adaptive sampling utility for performance metrics.
TRACY_SCREENSHOT_WIDTH
@ TRACY_SCREENSHOT_WIDTH
Definition: app.h:112
TRACY_SCREENSHOT_HEIGHT
@ TRACY_SCREENSHOT_HEIGHT
Definition: app.h:112
app_run
void app_run(App *app)
Enters the main application rendering and event loop.
Definition: app.c:186
app_cleanup
void app_cleanup(App *app)
Safely releases all GPU and CPU resources held by the application.
Definition: app.c:147
app_init
int app_init(App *app, int width, int height, const char *title)
Fully initializes the application state, window, and OpenGL context.
Definition: app.c:29
app_update
void app_update(App *app)
One-frame logic update (physics, timers, camera).
Definition: app.c:327
app_binding.h
app_input.h
User input orchestration and application state toggles.
app_ui.h
UI rendering module for the application.
async_loader.h
Threaded asynchronous file loader for heavy assets (HDR, textures).
camera.h
First-person camera module with realistic physics and head-bobbing.
effect_benchmark.h
Automated A/B GPU cost measurement for individual postprocess effects.
env_manager.h
Environment and IBL management module.
gl_common.h
Common OpenGL definitions, RAII helpers, and utilities.
gpu_profiler.h
gpu_profiler_ui.h
perf_mode.h
Runtime performance optimization module.
postprocess.h
High-level post-processing pipeline and effects.
ssbo_rendering.h
Buffer-backed instancing for ultra-large-scale rendering.
ActionNotifier
Manager for action notifications.
Definition: action_notifier.h:41
AdaptiveSampler
Collector for performance samples within a rolling or fixed window.
Definition: adaptive_sampler.h:38
AppBindingRegistry
Central registry that holds application key bindings.
Definition: app_binding.h:48
AppUIOverlay
Definition: app_ui.h:199
App
The central state container for the entire application.
Definition: app.h:35
App::u_roughness
float u_roughness
Definition: app.h:78
App::camera
Camera camera
Definition: app.h:53
App::saved_height
int saved_height
Definition: app.h:60
App::overlay
AppUIOverlay overlay
Definition: app.h:50
App::tracy_mgr
TracyManager tracy_mgr
Definition: app.h:74
App::resize_pending
int resize_pending
Definition: app.h:61
App::log_gpu_metrics
int log_gpu_metrics
Definition: app.h:70
App::saved_x
int saved_x
Definition: app.h:59
App::pending_width
int pending_width
Definition: app.h:62
App::width
int width
Definition: app.h:56
App::last_frame_time
double last_frame_time
Definition: app.h:40
App::lum_ssbo
GLuint lum_ssbo[2]
Definition: app.h:73
App::effect_bench
EffectBenchmark effect_bench
Definition: app.h:69
App::saved_y
int saved_y
Definition: app.h:59
App::height
int height
Definition: app.h:57
App::u_metallic
float u_metallic
Definition: app.h:77
App::u_ao
float u_ao
Definition: app.h:79
App::fps_counter
FpsCounter fps_counter
Definition: app.h:46
App::lum_histogram_buffer
float * lum_histogram_buffer
Definition: app.h:43
App::env_mgr
EnvManager env_mgr
Definition: app.h:65
App::postprocess
PostProcess postprocess
Definition: app.h:38
App::window
GLFWwindow * window
Definition: app.h:39
App::delta_time
double delta_time
Definition: app.h:41
App::is_fullscreen
int is_fullscreen
Definition: app.h:58
App::pending_height
int pending_height
Definition: app.h:63
App::timeline_ui
GPUProfilerUI timeline_ui
Definition: app.h:49
App::binding_registry
AppBindingRegistry binding_registry
Definition: app.h:51
App::async_coord
AsyncCoordinator async_coord
Definition: app.h:84
App::camera_enabled
int camera_enabled
Definition: app.h:64
App::frame_count
uint64_t frame_count
Definition: app.h:42
App::scene
Scene scene
Definition: app.h:37
App::u_exposure
float u_exposure
Definition: app.h:80
App::perf_context
PerfModeContext perf_context
Definition: app.h:67
App::saved_width
int saved_width
Definition: app.h:60
App::perf_mode_active
int perf_mode_active
Definition: app.h:66
App::fps_sampler
AdaptiveSampler fps_sampler
Definition: app.h:47
App::async_loader
AsyncLoader * async_loader
Definition: app.h:82
App::gpu_profiler
GPUProfiler gpu_profiler
Definition: app.h:48
App::notifier
ActionNotifier notifier
Definition: app.h:68
AsyncLoader
Opaque handle to the asynchronous loader context.
Definition: async_loader.c:17
Camera
Represents a 3D camera with orientation, movement, and physical properties.
Definition: camera.h:40
EffectBenchmark
State for the automated benchmark sweep.
Definition: effect_benchmark.h:64
EnvManager
Encapsulates state for environment loading, transitions, and IBL.
Definition: env_manager.h:26
FpsCounter
Definition: fps.h:4
GPUProfilerUI
Manages the visual state and animations for the GPU timeline.
Definition: gpu_profiler_ui.h:12
GPUProfiler
Manages GPU timing using double-buffered queries to avoid stalls.
Definition: gpu_profiler.h:86
PerfModeContext
State container for performance mode.
Definition: perf_mode.h:52
PostProcess
Main pipeline state for post-processing.
Definition: postprocess.h:353
Scene
Encapsulates all 3D scene data, geometry, and rendering state.
Definition: scene.h:138
TracyManager
Handles Tracy-specific instrumentation and asynchronous GPU screenshots.
Definition: tracy_manager.h:20
tracy_manager.h
ui.h
Minimal immediate-mode User Interface (UI) library.
GLFWwindow
struct GLFWwindow GLFWwindow
Definition: window.h:4