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

架构分层(自上而下):
  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:
2026-09-22 13:46:05 +08:00
parent 7d628f8d8a
commit 8afdd9b245
33 changed files with 3013 additions and 561 deletions
+20 -7
View File
@@ -3,19 +3,25 @@ add_executable(HelloVulkan main.cpp)
target_link_libraries(HelloVulkan PRIVATE Engine)
###### 自动构建shader ######
###### 自动构建 shader ######
find_program(GLSLC glslc REQUIRED)
set(SHADER_SRC_DIR ${CMAKE_SOURCE_DIR}/shaders)
set(SHADER_OUT_DIR ${CMAKE_BINARY_DIR}/bin/shaders)
# 定义一个 shader 编译目标:<name>(glsl_file stage)
function(auto_compile_shader glsl_file stage)
# string(REGEX REPLACE "\\.glsl$" "" base "${glsl_file}")
function(auto_compile_shader glsl_file) # glsl_file 是相对 SHADER_SRC_DIR 的路径
# 推断 stage:'.vert' -> 'vert'
get_filename_component(stage ${glsl_file} EXT)
string(SUBSTRING ${stage} 1 -1 stage)
set(spv ${SHADER_OUT_DIR}/${glsl_file}.spv)
get_filename_component(spv_dir ${spv} DIRECTORY) # 保留子目录
add_custom_command(
OUTPUT ${spv}
COMMAND ${GLSLC} -fshader-stage=${stage} -o ${spv} ${SHADER_SRC_DIR}/${glsl_file}
COMMAND ${CMAKE_COMMAND} -E make_directory ${spv_dir}
COMMAND ${GLSLC} -fshader-stage=${stage}
-o ${spv} ${SHADER_SRC_DIR}/${glsl_file}
DEPENDS ${SHADER_SRC_DIR}/${glsl_file}
VERBATIM)
set_source_files_properties(${spv} PROPERTIES GENERATED TRUE)
@@ -23,5 +29,12 @@ function(auto_compile_shader glsl_file stage)
set_property(DIRECTORY APPEND PROPERTY HZ_SHADER_SPV_FILES ${spv})
endfunction()
auto_compile_shader(simple_shader.vert vert)
auto_compile_shader(simple_shader.frag frag)
file(GLOB_RECURSE SHADER_SOURCES
CONFIGURE_DEPENDS # 新增 shader 时自动重配
RELATIVE ${SHADER_SRC_DIR}
${SHADER_SRC_DIR}/*.vert
${SHADER_SRC_DIR}/*.frag)
foreach (f ${SHADER_SOURCES})
auto_compile_shader(${f})
endforeach()