atdunbg/HelloVulkan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 引入 RenderGraph、Application 框架、ECS 与资产句柄系统

Browse Source 
架构分层（自上而下）：
  App(SandboxApp) → Application(生命周期+事件) → Scene(ECS) / AssetManager(句柄) → Renderer → RenderGraph → Vulkan 模块

- RenderGraph：声明式帧图。虚拟资源+生成号句柄、死 pass 剔除、
  拓扑排序、资源生命周期、barrier 编译期预算（Synchronization2）、
  物理镜像池按帧槽位隔离（帧间竞争从根上消除）
- 帧同步修复：per-frame-slot 命令缓冲与 UBO ring（原先单份存在
  数据竞争）；统一 kMaxFramesInFlight / FrameContext
- Application：生命周期钩子（OnInit/OnUpdate/OnRender/OnShutdown）
  + 事件系统（GLFW 回调 → POD 事件 → 类型化钩子）；main 只 new 派生类
- ECS：自研稀疏集 Registry（Entity=(index,generation) 防悬空，
  O(1) 增删查，Each 取最小池遍历）；Scene 延迟销毁队列；
  IdComponent{UUID} 稳定外部身份
- Assets：AssetManager + AssetHandle。组件存句柄不存裸指针/Ref
  （单一所有者 + 多使用者），Renderer 删除 LoadModel 改为纯消费
- 修复退出析构：成员析构前 GPU waitIdle（资产层先于 Renderer
  析构导致 VUID-00922 资源销毁时仍在使用）
- 引入 entt 子模块备用

validation 全程零错误零警告（RTX 5060 实测）
This commit is contained in:
atdunbg
2026-09-22 13:46:05 +08:00
parent 7d628f8d8a
commit 8afdd9b245
33 changed files with 3013 additions and 561 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Engine/src/Core/Application.cpp
+115
View File
@@ -0,0 +1,115 @@
//
// Created by atdunbg on 2026/9/22.
//
#include <Engine/Core/Application.h>
#include <Engine/Core/Window.h>
#include <Engine/Core/Log.h>
#include <Engine/ECS/Scene.h>
#include <Engine/Renderer/Renderer.h>
#include <Engine/Assets/AssetManager.h>
#include <Engine/Vulkan/Device.h>
#include <algorithm>
namespace Engine {
Application::Application(std::string title, u32 width, u32 height)
{
m_Window = CreateScope<Window>(std::move(title), width, height);
// 事件通道：GLFW 回调 → 本类 DispatchEvent → 派生类钩子
m_Window->SetEventCallback(
[this](const Event& e) { DispatchEvent(e); });
// 场景（ECS 世界）+ 渲染器
m_Scene = CreateScope<ECS::Scene>();
m_Renderer = CreateScope<Renderer>(*m_Window);
// 资产层：复用渲染器的 GPU 上下文；
// 声明在 Renderer 之后 → 析构先于 Renderer（它引用其子模块）
m_Assets = CreateScope<Assets::AssetManager>(
m_Renderer->GetDevice(),
m_Renderer->GetAllocator(),
m_Renderer->GetDescriptorManager(),
m_Renderer->GetTextureSetLayout());
}
Application::~Application()
{
// 关键：必须在成员析构之前等 GPU 空闲。
//
// 成员析构序（后声明先析构）是 m_Assets → m_Renderer → m_Scene → m_Window：
// 资产层持有全部 GPU buffer/texture/sampler，会先于 Renderer 析构，
// 而 Renderer 的 waitIdle 在它自己的析构里——那时资产已经销毁了。
// 若最后一帧命令缓冲仍在 GPU 上执行，就会出现
// VUID-vkDestroyBuffer-buffer-00922（资源销毁时仍在使用）。
// 这里显式等待，保证成员按任意顺序析构都是安全的。
if (m_Renderer) {
m_Renderer->GetDevice().GetDevice().waitIdle();
}
}
void Application::Run()
{
ENGINE_INFO("Application starting");
m_Running = true;
m_LastFrameTime = std::chrono::steady_clock::now();
OnInit();
while (m_Running && !m_Window->ShouldClose()) {
m_Window->PollEvents();
auto now = std::chrono::steady_clock::now();
f32 dt = std::chrono::duration<f32>(now - m_LastFrameTime).count();
// 钳制卡顿（断点/窗口拖动导致的超大 dt），避免物理/动画穿模
m_DeltaTime = std::clamp(dt, 0.0f, 0.25f);
m_LastFrameTime = now;
OnUpdate(m_DeltaTime);
// 延迟销毁在渲染前统一 flush，保证渲染遍历时池结构不变
m_Scene->FlushDestroyQueue();
OnRender();
++m_FrameCount;
}
OnShutdown();
ENGINE_INFO("Application stopped ({} frames)", m_FrameCount);
}
void Application::OnRender()
{
m_Renderer->Render(*m_Scene, *m_Assets);
}
void Application::DispatchEvent(const Event& event)
{
OnEvent(event);
switch (event.type) {
case EventType::WindowClose: OnWindowClose(event); break;
case EventType::WindowResize: OnWindowResize(event); break;
case EventType::WindowFocus: OnWindowFocus(event); break;
case EventType::WindowLostFocus: OnWindowLostFocus(event); break;
case EventType::KeyPress: OnKeyPress(event); break;
case EventType::KeyRelease: OnKeyRelease(event); break;
case EventType::MouseButtonPress: OnMouseButtonPress(event); break;
case EventType::MouseButtonRelease: OnMouseButtonRelease(event); break;
case EventType::MouseMove: OnMouseMove(event); break;
case EventType::MouseScroll: OnMouseScroll(event); break;
default: break;
}
}
void Application::OnWindowClose(const Event& event)
{
// 默认行为：直接退出。需要"退出确认"的程序覆写本钩子。
Close();
}
} // namespace Engine
Engine/src/Core/Window.cpp
+72
View File
@@ -14,6 +14,73 @@ namespace Engine
{
auto* self = static_cast<Window*>(glfwGetWindowUserPointer(window));
self->m_FramebufferResized = true;
if (self->m_EventCallback) {
Event e;
e.type = EventType::WindowResize;
e.width = width;
e.height = height;
self->m_EventCallback(e);
}
}
void Window::KeyCallback(GLFWwindow* window, int key, int scancode, int action, int mods)
{
auto* self = static_cast<Window*>(glfwGetWindowUserPointer(window));
if (!self->m_EventCallback || key == GLFW_KEY_UNKNOWN) return;
Event e;
e.key = key;
e.type = (action == GLFW_PRESS) ? EventType::KeyPress
: (action == GLFW_RELEASE) ? EventType::KeyRelease
: EventType::None; // GLFW_REPEAT 暂不透出
if (e.type != EventType::None) self->m_EventCallback(e);
}
void Window::MouseButtonCallback(GLFWwindow* window, int button, int action, int mods)
{
auto* self = static_cast<Window*>(glfwGetWindowUserPointer(window));
if (!self->m_EventCallback) return;
Event e;
e.button = button;
e.type = (action == GLFW_PRESS) ? EventType::MouseButtonPress
: EventType::MouseButtonRelease;
self->m_EventCallback(e);
}
void Window::CursorPosCallback(GLFWwindow* window, double xpos, double ypos)
{
auto* self = static_cast<Window*>(glfwGetWindowUserPointer(window));
if (!self->m_EventCallback) return;
Event e;
e.type = EventType::MouseMove;
e.x = static_cast<f32>(xpos);
e.y = static_cast<f32>(ypos);
self->m_EventCallback(e);
}
void Window::ScrollCallback(GLFWwindow* window, double xoffset, double yoffset)
{
auto* self = static_cast<Window*>(glfwGetWindowUserPointer(window));
if (!self->m_EventCallback) return;
Event e;
e.type = EventType::MouseScroll;
e.deltaX = static_cast<f32>(xoffset);
e.deltaY = static_cast<f32>(yoffset);
self->m_EventCallback(e);
}
void Window::WindowFocusCallback(GLFWwindow* window, int focused)
{
auto* self = static_cast<Window*>(glfwGetWindowUserPointer(window));
if (!self->m_EventCallback) return;
Event e;
e.type = focused ? EventType::WindowFocus : EventType::WindowLostFocus;
self->m_EventCallback(e);
}
Window::Window(const std::string& title, u32 width, u32 height)
@@ -42,6 +109,11 @@ namespace Engine
glfwSetWindowUserPointer(m_Window, this);
glfwSetFramebufferSizeCallback(m_Window, FramebufferResizeCallback);
glfwSetKeyCallback(m_Window, KeyCallback);
glfwSetMouseButtonCallback(m_Window, MouseButtonCallback);
glfwSetCursorPosCallback(m_Window, CursorPosCallback);
glfwSetScrollCallback(m_Window, ScrollCallback);
glfwSetWindowFocusCallback(m_Window, WindowFocusCallback);
}
Window::~Window()