doxygen/html/scene_8h_source.html

 #ifndef SCENE_H

 #define SCENE_H


 #include "app_settings.h"

 #include "billboard_rendering.h"

 #include "billboard_sorting.h"

 #include "icosphere.h"

 #include "instanced_rendering.h"

 #include "scene_config.h"

 #include "scene_lighting.h"

 #include <cglm/cglm.h>


 #ifdef USE_SSBO_RENDERING

 #include "ssbo_rendering.h"

 #endif


 typedef struct PostProcess PostProcess;

 typedef struct GPUProfiler GPUProfiler;

 typedef struct SceneSimulation SceneSimulation;

 typedef struct SceneShaders SceneShaders;

 typedef struct SceneGPUResources SceneGPUResources;

 typedef struct SceneVisuals SceneVisuals;


 typedef struct Scene {

     /* --- Geometry & Meshes --- */

     IcosphereGeometry geometry;

     InstancedGroup

         instanced_group;

     BillboardGroup billboard_group;

 #ifdef USE_SSBO_RENDERING

     SSBOGroup ssbo_group;

 #endif


 #ifdef USE_TRANSPARENT_BILLBOARDS

     BillboardSorter billboard_sorter;

     SphereInstance*

         billboard_instances;

     int billboard_instance_count;

 #endif


     /* --- Domain Sub-Structs (opaque, heap-allocated) --- */

     SceneSimulation* simulation;

     SceneGPUResources* gpu;

     SceneShaders* shaders;

     SceneVisuals* visuals;

     /* --- Domain Sub-Structs (by-value) --- */

     SceneLighting lighting;

     SceneConfig config;

     /* --- HDR Environment --- */

     char** hdr_files;

     int hdr_count;

     int current_hdr_index;

 } Scene;


 int scene_init(Scene* scene);


 void scene_cleanup(Scene* scene);


 const char* aa_mode_to_string(AAMode mode);


 void scene_render(Scene* scene, GPUProfiler* profiler, mat4 view, mat4 proj,

                   vec3 camera_pos, mat4 previous_view_proj, int width,

                   int height);


 void scene_update_gpu_buffers(Scene* scene);


 void scene_toggle_nbody(Scene* scene);


 void scene_nbody_update(Scene* scene, float delta_time);


 #endif /* SCENE_H */

app_settings.h
Global application constants, configuration macros, and default values.

billboard_rendering.h
View-aligned quad rendering (billboarding) for optimized sphere drawing.

billboard_sorting.h
Back-to-front sorting for transparent geometry.

icosphere.h
Procedural icosphere geometry generation.

instanced_rendering.h
Mesh-based instanced rendering for spheres.

scene_render
void scene_render(Scene *scene, GPUProfiler *profiler, mat4 view, mat4 proj, vec3 camera_pos, mat4 previous_view_proj, int width, int height)
Renders the scene.
Definition: scene_render.c:292

scene_cleanup
void scene_cleanup(Scene *scene)
Cleans up scene resources.
Definition: scene_cleanup.c:80

scene_update_gpu_buffers
void scene_update_gpu_buffers(Scene *scene)
Updates GPU buffers for dynamic geometry (e.g. LOD changes).
Definition: scene_render.c:36

scene_toggle_nbody
void scene_toggle_nbody(Scene *scene)
Toggles N-body simulation mode on/off.
Definition: scene_nbody.c:16

scene_nbody_update
void scene_nbody_update(Scene *scene, float delta_time)
Advances the N-body simulation by one frame.
Definition: scene_nbody.c:79

scene_init
int scene_init(Scene *scene)
Initializes the scene resources.
Definition: scene_init.c:416

aa_mode_to_string
const char * aa_mode_to_string(AAMode mode)
Returns a string representation of the AA mode.
Definition: scene_render.c:24

scene_config.h
Render configuration flags extracted from Scene.

AAMode
AAMode
Specular Anti-Aliasing modes.
Definition: scene_config.h:35

scene_lighting.h
IBL, probes, and materials sub-struct extracted from Scene.

ssbo_rendering.h
Buffer-backed instancing for ultra-large-scale rendering.

BillboardGroup
Manages a set of billboarded instances on the GPU.
Definition: billboard_rendering.h:21

BillboardSorter
Reusable memory context for sorting operations.
Definition: billboard_sorting.h:28

GPUProfiler
Manages GPU timing using double-buffered queries to avoid stalls.
Definition: gpu_profiler.h:86

IcosphereGeometry
Container for procedural mesh data.
Definition: icosphere.h:40

InstancedGroup
Manages mesh-based instanced spheres on the GPU.
Definition: instanced_rendering.h:20

PostProcess
Main pipeline state for post-processing.
Definition: postprocess_internal.h:46

SSBOGroup
GPU resources for an SSBO-based render group.
Definition: ssbo_rendering.h:35

SceneConfig
Render configuration flags and toggles.
Definition: scene_config.h:45

SceneGPUResources
All GPU resource handles owned by the scene.
Definition: scene_gpu_resources.h:23

SceneLighting
IBL, probes, and materials grouped to reduce Scene fan-out.
Definition: scene_lighting.h:17

SceneShaders
All shader pointers and uniform caches owned by the scene.
Definition: scene_shaders.h:16

SceneSimulation
N-body simulation state grouped to reduce Scene fan-out.
Definition: scene_simulation.h:15

SceneVisuals
Visual effects grouped into a sub-struct to reduce Scene fan-out.
Definition: scene_visuals.h:17

Scene
Encapsulates all 3D scene data, geometry, and rendering state.
Definition: scene.h:28

Scene::billboard_group
BillboardGroup billboard_group
Definition: scene.h:33

Scene::shaders
SceneShaders * shaders
Definition: scene.h:48

Scene::current_hdr_index
int current_hdr_index
Definition: scene.h:58

Scene::billboard_instances
SphereInstance * billboard_instances
Definition: scene.h:41

Scene::config
SceneConfig config
Definition: scene.h:53

Scene::hdr_count
int hdr_count
Definition: scene.h:57

Scene::lighting
SceneLighting lighting
Definition: scene.h:52

Scene::billboard_sorter
BillboardSorter billboard_sorter
Definition: scene.h:39

Scene::gpu
SceneGPUResources * gpu
Definition: scene.h:47

Scene::geometry
IcosphereGeometry geometry
Definition: scene.h:30

Scene::visuals
SceneVisuals * visuals
Definition: scene.h:49

Scene::hdr_files
char ** hdr_files
Definition: scene.h:56

Scene::simulation
SceneSimulation * simulation
Definition: scene.h:46

Scene::instanced_group
InstancedGroup instanced_group
Definition: scene.h:32

Scene::billboard_instance_count
int billboard_instance_count
Definition: scene.h:42

SphereInstance
Per-instance data sent to the shader via an instanced VBO.
Definition: sphere_types.h:25
Suckless OGL 1.0.0 A lean, high-performance C11 PBR Renderer