Colors

README.md

@@ -22,6 +22,11 @@ graph TD
         sdl_wrapper
         logos
     end
+
+    subgraph sdl_wrapper
+        lifecycle
+        sdl_raii
+    end
 
     glslang --> shaderc
     SPIRVTools --> shaderc
@@ -44,17 +49,23 @@ graph TD
 
 ## Track
 
-- [ ] Getting started
+- [x] Getting started
     - [x] OpenGL
     - [x] Creating a window
     - [x] Hello Window
     - [x] Hello Triangle
     - [x] Shaders
     - [x] Textures
     - [x] Transformations
-    - [ ] Coordinate Systems
-    - [ ] Camera
+    - [x] Coordinate Systems
+    - [x] Camera
 - [ ] Lighting
+    - [x] Colors
+    - [ ] Basic Lighting
+    - [ ] Materials
+    - [ ] Lighting maps
+    - [ ] Light casters
+    - [ ] Multiple lights
 - [ ] Model Loading
 - [ ] Advanced OpenGL
 - [ ] Advanced Lighting

sdl_wrapper/CMakeLists.txt

@@ -7,9 +7,14 @@ add_library(sdl_wrapper STATIC)
 target_sources(sdl_wrapper
         PUBLIC
         FILE_SET cxx_modules TYPE CXX_MODULES FILES
+        modules/lifecycle.ixx
+        modules/sdl_raii/sdl_raii.ixx
+        modules/sdl_raii/sdl_raii.bound_raii.ixx
+        modules/sdl_raii/sdl_raii.bound_traits.ixx
+        modules/sdl_raii/sdl_raii.pure_raii.ixx
+        modules/sdl_raii/sdl_raii.pure_traits.ixx
         modules/sdl_wrapper.ixx
         modules/sdl_wrapper.buffer.ixx
-        modules/sdl_wrapper.app.ixx
         modules/sdl_wrapper.render_procedural.ixx
         modules/sdl_wrapper.render_data.ixx
         modules/sdl_wrapper.render_data_impl.ixx
@@ -20,13 +25,14 @@ target_sources(sdl_wrapper
         modules/sdl_wrapper.transfer_buffer.ixx
         modules/sdl_wrapper.texture.ixx
         PRIVATE
+        src/lifecycle.cpp
         src/sdl_wrapper.buffer.cpp
         src/sdl_wrapper.render_procedural.cpp
         src/sdl_wrapper.gpu.cpp
-        src/sdl_callback_implement.cpp
         src/sdl_wrapper.texture.cpp
         src/sdl_wrapper.transfer_buffer.cpp
         src/sdl_wrapper.render_data.cpp
+        src/sdl_wrapper.renderable.cpp
 )
 
-target_link_libraries(sdl_wrapper PUBLIC SDL3::SDL3 shaderc glsl_reflector data_type)
+target_link_libraries(sdl_wrapper PUBLIC SDL3::SDL3 shaderc glsl_reflector data_type logos)

sdl_wrapper/modules/sdl_wrapper.app.ixx → sdl_wrapper/modules/lifecycle.ixx

@@ -3,7 +3,7 @@
 //
 module;
 #include "SDL3/SDL_init.h"
-export module sdl_wrapper:app;
+export module lifecycle;
 export namespace sopho
 {
     class App

sdl_wrapper/modules/sdl_raii/sdl_raii.bound_raii.ixx

@@ -0,0 +1,65 @@
+// sdl_raii.bound_raii.ixx
+// Created by sophomore on 11/28/25.
+//
+
+export module sdl_raii:bound_raii;
+import :bound_traits;
+namespace sopho
+{
+    export template <typename T>
+    struct BoundRaii
+    {
+        using Traits = BoundTraits<T>;
+        using Device = typename Traits::Device;
+
+    private:
+        Device* m_gpu_device{};
+        T* m_raw{};
+
+    public:
+        BoundRaii() noexcept = default;
+
+        explicit BoundRaii(Device* device, T* resource) noexcept : m_gpu_device(device), m_raw(resource) {}
+
+        BoundRaii(const BoundRaii&) = delete;
+        BoundRaii& operator=(const BoundRaii&) = delete;
+
+        BoundRaii(BoundRaii&& other) noexcept : m_gpu_device(other.m_gpu_device), m_raw(other.m_raw)
+        {
+            other.m_gpu_device = nullptr;
+            other.m_raw = nullptr;
+        }
+
+        BoundRaii& operator=(BoundRaii&& other) noexcept
+        {
+            if (this != &other)
+            {
+                reset();
+
+                m_gpu_device = other.m_gpu_device;
+                m_raw = other.m_raw;
+
+                other.m_gpu_device = nullptr;
+                other.m_raw = nullptr;
+            }
+            return *this;
+        }
+
+        ~BoundRaii() noexcept { reset(); }
+
+        void reset(Device* device = nullptr ,T* resource = nullptr) noexcept
+        {
+            if (m_raw && m_gpu_device)
+            {
+                Traits::release(m_gpu_device, m_raw);
+            }
+
+            m_gpu_device = device;
+            m_raw = resource;
+        }
+
+        [[nodiscard]] T* raw() const noexcept { return m_raw; }
+        [[nodiscard]] bool valid() const noexcept { return m_gpu_device != nullptr && m_raw != nullptr; }
+        [[nodiscard]] explicit operator bool() const noexcept { return valid(); }
+    };
+} // namespace sopho

sdl_wrapper/modules/sdl_raii/sdl_raii.bound_traits.ixx

@@ -0,0 +1,71 @@
+// sdl_raii.bound_traits.ixx
+// Created by wsqsy on 11/28/2025.
+//
+module;
+#include <SDL3/SDL_gpu.h>
+export module sdl_raii:bound_traits;
+namespace sopho
+{
+    template <typename T>
+    struct BoundTraits;
+
+    // Due to Windows msvc problem, we need to put all template in one module partition.
+
+    template <>
+    struct BoundTraits<SDL_GPUBuffer>
+    {
+        using Device = SDL_GPUDevice;
+
+        static void release(Device* device, SDL_GPUBuffer* buffer) noexcept { SDL_ReleaseGPUBuffer(device, buffer); }
+    };
+    template <>
+    struct BoundTraits<SDL_GPUGraphicsPipeline>
+    {
+        using Device = SDL_GPUDevice;
+
+        static void release(Device* device, SDL_GPUGraphicsPipeline* raw) noexcept
+        {
+            SDL_ReleaseGPUGraphicsPipeline(device, raw);
+        }
+    };
+    template <>
+    struct BoundTraits<SDL_GPUSampler>
+    {
+        using Device = SDL_GPUDevice;
+
+        static void release(Device* device, SDL_GPUSampler* raw) noexcept { SDL_ReleaseGPUSampler(device, raw); }
+    };
+    template <>
+    struct BoundTraits<SDL_GPUShader>
+    {
+        using Device = SDL_GPUDevice;
+
+        static void release(Device* device, SDL_GPUShader* raw) noexcept { SDL_ReleaseGPUShader(device, raw); }
+    };
+    template <>
+    struct BoundTraits<SDL_GPUTexture>
+    {
+        using Device = SDL_GPUDevice;
+
+        static void release(Device* device, SDL_GPUTexture* raw) noexcept { SDL_ReleaseGPUTexture(device, raw); }
+    };
+    template <>
+    struct BoundTraits<SDL_GPUTransferBuffer>
+    {
+        using Device = SDL_GPUDevice;
+
+        static void release(Device* device, SDL_GPUTransferBuffer* buffer) noexcept
+        {
+            SDL_ReleaseGPUTransferBuffer(device, buffer);
+        }
+    };
+    template <>
+    struct BoundTraits<SDL_Window>
+    {
+        using Device = SDL_GPUDevice;
+
+        static void release(Device* device, SDL_Window* raw) noexcept { SDL_ReleaseWindowFromGPUDevice(device, raw); }
+    };
+
+
+} // namespace sopho

sdl_wrapper/modules/sdl_raii/sdl_raii.ixx

@@ -0,0 +1,25 @@
+// sdl_raii.ixx
+// Created by wsqsy on 11/28/2025.
+//
+module;
+#include <SDL3/SDL_gpu.h>
+export module sdl_raii;
+
+export import :bound_traits;
+export import :bound_raii;
+export import :pure_traits;
+export import :pure_raii;
+
+export namespace sopho
+{
+    using GpuBufferRaii = BoundRaii<SDL_GPUBuffer>;
+    using GPUGraphicsPipelineRaii = BoundRaii<SDL_GPUGraphicsPipeline>;
+    using GPUSamplerRaii = BoundRaii<SDL_GPUSampler>;
+    using GpuShaderRaii = BoundRaii<SDL_GPUShader>;
+    using GpuTextureRaii = BoundRaii<SDL_GPUTexture>;
+    using GpuTransferBufferRaii = BoundRaii<SDL_GPUTransferBuffer>;
+    using ClaimWindowRaii = BoundRaii<SDL_Window>;
+    using GpuCommandBufferRaii = PureRaii<SDL_GPUCommandBuffer>;
+    using GpuDeviceRaii = PureRaii<SDL_GPUDevice>;
+    using WindowRaii = PureRaii<SDL_Window>;
+} // namespace sopho

sdl_wrapper/modules/sdl_raii/sdl_raii.pure_raii.ixx

@@ -0,0 +1,53 @@
+// sdl_raii.pure_raii.ixx
+// Created by sophomore on 11/29/25.
+//
+
+export module sdl_raii:pure_raii;
+import :pure_traits;
+namespace sopho
+{
+    export template <typename T>
+    struct PureRaii
+    {
+        using Traits = PureTraits<T>;
+
+    private:
+        T* m_raw{};
+
+    public:
+        PureRaii() noexcept = default;
+
+        explicit PureRaii(T* raw) noexcept : m_raw(raw) {}
+
+        PureRaii(const PureRaii&) = delete;
+        PureRaii& operator=(const PureRaii&) = delete;
+
+        PureRaii(PureRaii&& other) noexcept : m_raw(other.m_raw) { other.m_raw = nullptr; }
+        PureRaii& operator=(PureRaii&& other) noexcept
+        {
+            if (this != &other)
+            {
+                reset();
+                m_raw = other.m_raw;
+                other.m_raw = nullptr;
+            }
+            return *this;
+        }
+
+        ~PureRaii() noexcept { reset(); }
+
+        void reset(T* raw = nullptr) noexcept
+        {
+            if (m_raw)
+            {
+                Traits::release(m_raw);
+            }
+
+            m_raw = raw;
+        }
+
+        [[nodiscard]] T* raw() const noexcept { return m_raw; }
+        [[nodiscard]] bool valid() const noexcept { return m_raw != nullptr; }
+        [[nodiscard]] explicit operator bool() const noexcept { return valid(); }
+    };
+} // namespace sopho

sdl_wrapper/modules/sdl_raii/sdl_raii.pure_traits.ixx

@@ -0,0 +1,29 @@
+// sdl_raii.pure_traits.ixx
+// Created by sophomore on 11/29/25.
+//
+module;
+#include <SDL3/SDL_gpu.h>
+export module sdl_raii:pure_traits;
+namespace sopho
+{
+    template <typename T>
+    struct PureTraits;
+
+    // Due to Windows msvc problem, we need to put all template in one module partition.
+
+    template <>
+    struct PureTraits<SDL_GPUCommandBuffer>
+    {
+        static void release(SDL_GPUCommandBuffer* raw) noexcept { SDL_SubmitGPUCommandBuffer(raw); }
+    };
+    template <>
+    struct PureTraits<SDL_GPUDevice>
+    {
+        static void release(SDL_GPUDevice* raw) noexcept { SDL_DestroyGPUDevice(raw); }
+    };
+    template <>
+    struct PureTraits<SDL_Window>
+    {
+        static void release(SDL_Window* raw) noexcept { SDL_DestroyWindow(raw); }
+    };
+} // namespace sopho

sdl_wrapper/modules/sdl_wrapper.buffer.ixx

@@ -11,6 +11,7 @@ module;
 
 export module sdl_wrapper:buffer;
 import data_type;
+import sdl_raii;
 import :decl;
 import :transfer_buffer;
 
@@ -19,15 +20,15 @@ namespace sopho
     class BufferWrapper
     {
         std::shared_ptr<GpuWrapper> m_gpu{}; // Owns the device lifetime
-        SDL_GPUBuffer* m_gpu_buffer{}; // Target GPU buffer
+        GpuBufferRaii m_gpu_buffer{}; // Target GPU buffer
         TransferBufferWrapper m_transfer_buffer; // Staging/transfer buffer
         std::uint32_t m_buffer_size{}; // Total size of the GPU buffer
         std::vector<std::byte> m_cpu_buffer{};
 
         // Only GpuWrapper is allowed to construct this type.
-        BufferWrapper(std::shared_ptr<GpuWrapper> gpu, SDL_GPUBuffer* gpu_buffer, TransferBufferWrapper transfer_buffer,
+        BufferWrapper(std::shared_ptr<GpuWrapper> gpu, GpuBufferRaii gpu_buffer, TransferBufferWrapper transfer_buffer,
                       std::uint32_t size) noexcept :
-            m_gpu(std::move(gpu)), m_gpu_buffer(gpu_buffer), m_transfer_buffer(std::move(transfer_buffer)),
+            m_gpu(std::move(gpu)), m_gpu_buffer(std::move(gpu_buffer)), m_transfer_buffer(std::move(transfer_buffer)),
             m_buffer_size(size)
         {
             m_cpu_buffer.resize(m_buffer_size);
@@ -64,10 +65,10 @@ namespace sopho
         [[nodiscard]] std::expected<std::monostate, GpuError> upload();
 
         /// Returns the underlying SDL_GPUBuffer pointer.
-        [[nodiscard]] SDL_GPUBuffer* gpu_buffer() const noexcept { return m_gpu_buffer; }
+        [[nodiscard]] SDL_GPUBuffer* gpu_buffer() const noexcept { return m_gpu_buffer.raw(); }
         [[nodiscard]] std::byte* cpu_buffer() noexcept { return m_cpu_buffer.data(); }
 
-        ~BufferWrapper() noexcept;
+        ~BufferWrapper() noexcept = default;
 
         friend class GpuWrapper;
     };

sdl_wrapper/modules/sdl_wrapper.decl.ixx

@@ -6,8 +6,8 @@ export module sdl_wrapper:decl;
 
 export namespace sopho
 {
-    class App;
     class GpuWrapper;
     class RenderProcedural;
     class RenderData;
+    class TextureWrapper;
 }