doxygen/html/scene_8h_source.html

#ifndef SCENE_H

#define SCENE_H


#include "app_settings.h"

#include "billboard_renderer.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;

    BillboardRenderer billboard_renderer;

#ifdef USE_SSBO_RENDERING

    SSBOGroup ssbo_group;

#endif


#ifdef USE_TRANSPARENT_BILLBOARDS

    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);


/* --- Subsystem descriptor (alloc-only Phase 1) --- */

#include "app_subsystem.h"


int scene_subsys_init(struct App* app);

void scene_subsys_cleanup(struct App* app);


#define APP_SCENE_DESCRIPTOR {"scene", scene_subsys_init, scene_subsys_cleanup}


#endif /* SCENE_H */

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

app_subsystem.h
Subsystem descriptor pattern for structured init/cleanup.

billboard_renderer.h
Unified billboard sorting and rendering system.

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:315

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

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

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:42

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

scene_subsys_cleanup
void scene_subsys_cleanup(struct App *app)
Definition scene_init.c:527

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

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

scene_subsys_init
int scene_subsys_init(struct App *app)
Definition scene_init.c:508

scene_config.h
Render configuration flags extracted from Scene.

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

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

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

App
The central state container for the entire application.
Definition app.h:24

BillboardRenderer
Manages billboard rendering buffers, VAO state, and the internal sorter.
Definition billboard_renderer.h:48

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:47

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:27

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

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

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

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

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

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

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

Scene::billboard_renderer
BillboardRenderer billboard_renderer
Definition scene.h:32

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

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

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

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

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

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

SphereInstance
Per-instance data sent to the shader via an instanced VBO.
Definition sphere_types.h:25