How berachem/computer_graphics works
Project Type and Purpose
• This is a C++ OpenGL‐based graphics application (“Système Solaire”) intended to render a 3D scene (solar system) with multiple objects, shaders, environment maps, camera navigation, and optional GUI.
• It uses GLFW/SDL for window/context, GLAD/GLEW for OpenGL loading, TinyOBJLoader for .obj models, IMGUI for UI, and standard CMake for builds.
High‐Level File Structure Analysis
• Top‐level: CMakeLists.txt, README.md, SETUP.md, TODO.md
• extern/imgui: immediate‐mode GUI library
• /: public headers for all subsystems (AudioSource, Camera, Scene, ShaderManager, SoundManager, etc.)
• src/: implementation of each subsystem plus main.cpp
• shaders/: GLSL programs (Lambert, Phong, environment, skybox, etc.)
• models/, skybox/, textures/, sound/: asset directories
• libs/: single‐header utilities (stb_image)
Core Components
• Window & GL Context
• GLFW/SDL + GLAD/GLEW initialization
• Resource Managers (Singleton‐style)
• ShaderManager: compiles/links GLSL from shaders/
• TextureLoader & SkyboxManager: loads textures, cubemaps from textures/ & skybox/
• Mesh/Model Loader: TinyOBJLoader + Mesh class (OBJ → VAO/VBO)
• SoundManager & AudioSource: loads and plays WAV from sound/
• Scene Management
• SceneManager or MainScene: holds Scene objects, Lights, Cameras, Skybox
• Objects: Model, Sphere, UIHelpers overlays
• Rendering Pipeline
• Mat4, UBO: handles projection/view/model matrices via uniform blocks
• Input & Camera
• Camera class + MainScene navigation (orbit or free‐fly)
• GUI
• IMGUI integration under extern/imgui + UIHelpers for tweaking parameters
• Build & Deployment
• CMake → compiles src/, links extern/imgui, stb_image, TinyOBJLoader
Relationships and Data Flow
• App Init → Window/Context → Load Managers (ShaderManager, TextureLoader, SoundManager)
• Load Scene: SceneManager reads assets → creates Model & Mesh instances → associates shaders & textures
• Main Loop:
• Input → Camera updates → UBO updates → SceneManager update
• Audio pass → AudioSource playback
• Shutdown: release Managers, destroy Window
Architectural Patterns & Principles
• Manager/Factory pattern for resource loading & caching
• Single Responsibility: separate classes for Camera, Shader, Mesh, Sound
• Uniform Buffer Objects (UBOs) for grouping global GPU data (projection/view)
• Plug‐in‐style shaders: each effect lives in its own shader program
• Immediate‐mode GUI overlay decoupled from render pipeline
Essential Elements
• Clear labels (e.g., “ShaderManager”, “SceneManager”, “AudioSource”)
• File paths (e.g., include/for headers, shaders/ for GLSL, src/ for cpp)