atdunbg/HelloVulkan
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
35 Commits 1 Branch 0 Tags
57ab8901a9fe64e253e7dc7ca29102ae3e378ba5
Commit Graph
20 Commits
Author SHA1 Message Date
atdunbg 57ab8901a9 refactor: transform world 矩阵改由帧循环统一重算，删除手动 Compose 
- Scene::UpdateTransforms()：渲染前全量 Compose（UE transform-update
  阶段模式），Application::Run 在 FlushDestroyQueue 后调用
- 用户代码永远不需要手动 Compose——Set*/直接写字段均安全；
  Compose 降级为引擎内部调用
- 选择全量而非 dirty 标记：字段直接写（t.rotation.y = x）无法可靠
  追踪脏，无条件重算零脚枪；万级实体内成本可忽略，更大规模再引入
  dirty+封装
- main.cpp/Camera 所有手动 Compose 调用点删除
 2026-09-23 15:26:58 +08:00
atdunbg 1bc44e261b refactor: Camera 位姿统一到 TransformComponent（单一事实源） 
- Camera 删除内部 position/yaw/pitch 状态：Update 把鼠标旋转与 WASD
  移动直接写回实体 Transform（rotation.y=yaw / rotation.x=pitch，
  移动基向量由实体旋转推导，有变更才 Compose）
- GetView(transform) = 实体世界矩阵的逆——相机即实体，视图矩阵无
  第二来源；Scene::GetPrimaryCamera 可选带出实体 Transform
- 默认朝向约定变化：rotation.y=0 = 看向 -Z（与旧 yaw=-90 等价）
- 消除 CameraComponent 位置与 Transform 脱节的遗留债
 2026-09-23 15:14:29 +08:00
atdunbg 019c17c7e7 feat: 实体出生即挂 TransformComponent（UUID + Transform 固有化） 
- CreateEntity 自动挂 IdComponent（已有）+ TransformComponent（identity），
  对齐 UE/Unity 语义（GameObject↔Transform 不可分离 / AActor 必有
  RootComponent）——游戏实体的本质是"空间中存在的东西"
- 调用点 AddComponent<Transform> 改 GetComponent（重复 emplace 会断言）
- 遗留不一致记录在案：CameraComponent 位置存于 Camera 内部而非
  Transform，后续统一
 2026-09-23 15:07:00 +08:00
atdunbg a0c92af5db feat: DDS 纹理加载器（BC 压缩直传 + mip 链，参考 Horizon 实现） 
- Assets::Dds 解析器：中性 DdsFormat 枚举（Assets 层禁 Vulkan 头铁律），
  支持 legacy fourcc（DXT1/3/5/ATI1/2）+ DX10 头（BC1..BC7/RGBA8/BGRA8）
  + 未压缩 32bpp + 2D mip 链；数据不解码，直接上传由硬件采样解码
- Texture：按扩展名分发（.dds → InitFromDds）；渲染侧负责格式映射与
  sRGB 语义（颜色图走 SRGB 变体，BC4/5/6H 数据图保持线性）；view/sampler
  覆盖完整 mip 链；逐 mip copyBufferToImage（紧凑排布）
- Model::GetOrLoadTexture：FBX/DCC 路径反斜杠归一化（否则 Linux 全挂）
- DescriptorManager 池 1000 → 4096（SunTemple 1056 材质集打爆过；
  材质去重属材质系统任务）
- main.cpp 临时挂 SunTemple 场景验证：48 张 DDS 全部加载（2048²、12 mips），
  1056 mesh 渲染正常，validation 零警告
 2026-09-23 14:21:39 +08:00
atdunbg a29aed2803 feat: Pause Animation 开关（帧历史 diff 冻结验证用） 2026-09-23 13:11:29 +08:00
atdunbg c75832e73e feat: RenderGraph 帧历史资源（ReadHistory）+ TemporalDiff 验证 pass 
- PassBuilder::ReadHistory：读上一帧槽位 ((slot-1+F) mod F) 的物理镜像，
  TAA/运动模糊等时域效果的前置能力，RG 最后一个已知边界补齐
- 历史读不建拓扑边（跨帧依赖由同队列提交序保证）、不入本帧状态链、
  不改生命周期；剔除照常参与（生产者存活判定）
- 历史 barrier：首帧走 first（old=Undefined），之后走 steady 且
  src=ALL_COMMANDS|MEMORY_WRITE 显式闭合跨帧可用性+可见性；
  有历史读的资源，常规 entry steady 的 src 同样升级（历史读打破了
  同槽位 fence 全等保前提）
- TemporalDiff 调试 pass：|上一帧−当前帧|×增益，静止=黑/运动边缘发光
  即链路正确；Tonemap binding2 经 push 开关切调试视图
- 编译零错误、validation 零警告、8 秒冒烟通过（9 pass 全活跃）
 2026-09-23 13:05:10 +08:00
atdunbg 91880d88fe fix: tonemap 输出预乘 alpha 匹配 PRE_MULTIPLIED 合成模式 + 调整地面位置 2026-09-23 11:35:05 +08:00
atdunbg fa9082706b feat: 双视图视锥剔除（相机/光源各自剔除） 
- Frustum（Gribb-Hartmann）：从 view-proj 行组合提取 6 平面，
  包围球相交测试；按 Vulkan [0,1] 深度约定取 near=row2
- Mesh 构造时缓存局部空间包围球（顶点包围盒 → 中心+半径）
- 实例收集重写：单趟遍历，每个 (实体, mesh 部件) 对相机视锥与
  光源视锥分别做剔除——相机外实体仍可投影子进视野，Shadow 必须用
  光源视锥独立剔除，不能用相机结果
- 实例矩阵数组 = [主视图段 | 阴影视图段]，batch.first 全局下标；
  两视图共享同一份 ObjectBuffer SSBO
- 聚合改哈希（unordered_map），单趟填充替代原两趟遍历
- 面板显示 instances main/shadow 计数（剔除效果实时可见）

实测：1 背包 80 main / 80 shadow（修复前 shadow=21——near 平面
按 [-1,1] 矩阵误用 [0,1] 公式，光锥近半段被误剔）
 2026-09-23 11:21:28 +08:00
atdunbg df4871a49b feat: 透明窗口支持 + 退出确认流程 + ImGui 总开关 
用户自主改进批次：
- 透明窗口：GLFW_TRANSPARENT_FRAMEBUFFER + 窗口 opacity 0.5，
  swapchain composite alpha 按能力自适应（Opaque/Pre/PostMultiplied），
  Forward 清屏 alpha=0，tonemap 透传 HDR alpha——物体实体、背景透明
- 退出确认：Window 挂 WindowCloseCallback 发事件，App 侧 OnWindowClose
  置确认标记，OnRenderOverlay 弹 ImGui 确认框后 Close()；
  主循环退出条件改为 m_Running（close 事件驱动）
- ImGui 总开关：` 键切换 ImGuiLayer::SetEnabled，禁用时跳过
  NewFrame/OnRenderOverlay/BuildDrawData 整段
- 帧率控制简化：去掉 LimitFps 开关，非 vsync 时恒按 target 限帧
  （默认 60，可调 ≥24）；m_VSync 默认 false（Mailbox 不限速）
- 清理：Model.cpp const 修正，swapchain 日志带 present mode，
  GPU 遥测暂时注释

验证：0 error 0 warning，composite alpha 实测选 PreMultiplied(0x2)，
present=Mailbox
 2026-09-23 10:57:48 +08:00
atdunbg d8274e8bdc feat: 帧率控制——手动限帧 + VSync 开关 
- Application 帧率控制 API：SetLimitFps/SetTargetFps/SetVSync。
  限帧目标最低 24fps（防止过低刷新导致交互卡死），无上限；
  vsync 开启时 present 自带节奏，手动限帧不生效
- 限帧策略：sleep 到剩 ~2ms 后自旋，精度高且不烧 CPU
- Swapchain 加 VSync 开关：ChoosePresentMode 按开关选
  Mailbox（低延迟垂直同步）/ Immediate（不限速可撕裂），
  FIFO 兜底；切换经 SetVSync → 重建 swapchain（复用 HandleResize）
- Scene Debug 面板新增 Frame 区块（vsync/limit/目标滑条）
- Run 循环新增 CPU 归属遥测（update/ui/render/total，每 120 帧）
 2026-09-22 20:33:10 +08:00
atdunbg 41e4cc85d5 feat: RenderGraph GPU timestamp profiling 
- RG::SetQueryPool 可选注入；Execute 期每 pass 前后各写一枚
  writeTimestamp2(BOTTOM_OF_PIPE)，索引按帧槽位分区 + 执行序排布
- 每帧录制开头 reset 本槽位查询区间（上一轮结果已在 fence 等待后读取）
- Renderer 在 WaitFence 后读 64bit 结果换算毫秒（timestampPeriod 缓存），
  经 GetPassNames/GetPassGpuMs 透出给 ImGui 面板显示
- 每槽位首帧跳过读取（查询尚未 primed，避免 VUID-09401）
 2026-09-22 19:25:42 +08:00
atdunbg 908e688178 feat: ACES tonemap + Bloom 后处理链（Extract/BlurH/BlurV 半分辨率） 
- ACES(Narkowicz) 经 push 开关启用，exposure 接 ImGui 滑条
- RG: TextureDesc 支持 sizeScale 相对尺寸；per-pass 渲染尺寸解析
  （半分辨率 pass 的 viewport 由此决定）
- RG Toposort 重写：RAW+WAR+WAW 按声明序逐资源建边，支持多写者
  ping-pong 资源（旧逻辑对 reader 连接所有 writer，ping-pong 成环）
- GetPhysicalView 缺物理镜像时 throw（ENGINE_FATAL 只记日志不中止）
- 全屏 pass 通用 16B push + 公共录制 lambda，Extract/Blur/Tonemap 复用
 2026-09-22 19:18:51 +08:00
atdunbg 952ba8135d feat: HDR 管线 + Tonemap pass，显示变换显式建模 
管线：Shadow → Forward(写 HDRColor R16G16B16A16F) → Tonemap →
ImGui(loadOp=Load) → Present。对齐 UE/Unity 结构：场景线性值
进 HDR 离屏图，Tonemap（全屏三角，exposure push + gamma 编码）
显式完成显示变换，Backbuffer 只接收显示空间颜色。

- Swapchain 改 B8G8R8A8Unorm：Srgb 附件会硬件二次提亮，UI 泛白
  （#4296FA→#8CCBFC）；Unorm 下写什么显示什么，编码责任归 Tonemap
- Shader object push range 规则落地：程序级声明——同一 pass 的
  全部 shader EXT range 定义必须一致（VUID-08878），layout 同样
  按 vertex|fragment 声明，push 调用点覆盖全部声明 stage（VUID-01796）
- Tonemap 装配：Set0 = HDR 图（per-frame-slot 描述符 + GetPhysicalView），
  clamp 占位待 ACES 替换，bloom/FXAA 等后处理在 HDR 域插 pass
- CMake 加 imgui_demo.cpp（ShowDemoWindow 链接）
- 修复：m_TonemapDescriptorSets 未 resize 即下标写入（启动即崩）

验证：5 pass 全活，validation 0 error 0 warning，UI 原生色彩无泛白
 2026-09-22 19:00:56 +08:00
atdunbg 07792c34d7 feat: ImGui 叠加层接入 RenderGraph（docking 分支，dynamic rendering） 
框架与 UI 的职责边界：
- ImGuiLayer（Engine/ImGui）：只做管线桥接——上下文初始化、
  NewFrame/BuildDrawData、draw data 录入 cmd；框架自身永不绘制
  任何 ImGui 控件，UI 内容全部由派生类在 OnRenderOverlay() 定义
- 每帧顺序：NewFrame → OnRenderOverlay（声明控件）→ BuildDrawData →
  Renderer.Render（RG: Forward → ImGui(loadOp=Load 叠加) → Present）
- ImGui pass 常驻 RG，未启用叠加层时空转，无图结构开销
- 后端共存：VK_EXT_shader_object 引擎无 vk::Pipeline，ImGui 用
  UseDynamicRendering + PipelineInfoMain.PipelineRenderingCreateInfo
  （swapchain 格式），不需要 RenderPass
- 析构序：ImGuiLayer 在 Application 成员序中后声明（先于 Renderer
  析构），析构内 waitIdle 保证后端资源安全销毁

App 示例（证明职责边界）：Scene Debug 面板实时拖动阴影光方向，
` 键反折叠加层
 2026-09-22 17:09:55 +08:00
atdunbg 07a3b87001 feat: Shadow pass 接入 RenderGraph，支持 SRT 变换与程序化平面 
阴影（本修正的核心根因）：
- Shadow pass 光源正交写深度（2048 D32），Forward 采样比较；
  写入与采样共用同一 lightSpace 矩阵，杜绝姿态/镜像不一致
- 修复：push constant range 64B→128B（原 Shadow pass 推 {lightVP,model}
  超出 layout 声明范围 = UB，阴影中模型矩阵读到垃圾导致旋转错乱）
- 修复：ShadowFactor 缺少 NDC→UV 映射（*0.5+0.5），采样区域整体错位
- 修复：RG ShaderRead stage 位值直转（eFragment=0x10 在 PipelineStage2
  是 TESSELLATION_CONTROL），改为逐位显式映射
- Camera perspective 深度重映射到 Vulkan [0,1]（公式与 ortho 不同：
  M22=M22*0.5-0.5, M32*=0.5）；光源 ortho remap 用 M32=M32*0.5+0.5

引擎配套：
- TransformComponent 重构为 position/rotation/scale + Compose()
- Texture::CreateSolidColor / Model::CreatePlane 程序化资产
  （两段式上传公共路径），AssetManager.CreatePlane 带缓存入口
- RG 新增 GetPhysicalView(h, slot)：按帧槽位把 RG 资源绑进外部描述符
  （阴影图 per-slot 物理镜像各自绑定）

验证：validation 0 error 0 warning，阴影随实体旋转正确
 2026-09-22 16:40:54 +08:00
atdunbg 394bfd3d0c refactor: 实体句柄表皮——实体自己管理组件的 API 形态 
- 新增 EntityHandle：e.AddComponent<T>() / e.GetComponent<T>() /
  e.Destroy() / e.GetUUID()，转发 entt registry，零存储开销
- Scene::CreateEntity 返回 EntityHandle；Scene 层组件接口保留
  （给渲染器/系统批量遍历用）
- 语义分层：应用层"实体管组件"（句柄表皮），
  数据层组件存储仍集中在 registry（ECS 性能根基）
 2026-09-22 13:59:18 +08:00
atdunbg b73e197783 refactor: ECS 迁移到 entt，移除自研 Registry 
- Entity = entt::entity（内部自带版本号），Registry = entt::registry
- Scene 对外接口不变（AddComponent/GetComponent/Each/延迟销毁/UUID），
  Renderer 与 App 层零改动完成迁移
- Each 转发 entt view（自动最小池遍历），延迟销毁队列保留
- 删除自研 Registry.h/Entity.h
 2026-09-22 13:51:48 +08:00
atdunbg 8afdd9b245 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 实测）
 2026-09-22 13:46:05 +08:00
atdunbg 7d628f8d8a 添加多模型渲染，添加贴图渲染，添加平行光， 暂时不上传assets 2026-09-21 14:07:20 +08:00
atdunbg 381b7c0aa6 feat: 搭建 Vulkan 1.4 渲染器骨架，绘制旋转 3D 立方体 
使用 Vulkan 1.4 现代路径初始化引擎骨架：
- 用 Shader Object (VK_EXT_shader_object) 替代传统 VkPipeline
- 用 Dynamic Rendering 替代 RenderPass/Framebuffer
- 用 Synchronization2 管理 barrier

核心模块：
- Window：GLFW 封装，GLFW_NO_API 模式，兼容 Wayland
- Log：spdlog 封装
- Types：u32/u64/f32 类型别名

Vulkan 后端：
- Device：Instance、PhysicalDevice、LogicalDevice、Queue 及 feature 查询
- Swapchain：Image、ImageView、DepthBuffer、Recreate
- ShaderManager：SPIR-V 加载与 ShaderEXT 创建
- CommandManager：CommandPool 与主 CommandBuffer
- SyncManager：per-frame Fence 与 ImageAvailable semaphore，per-image RenderFinished semaphore，2 frames in flight
- MemoryAllocator：内存子分配器，256MB block，persistent mapping
- Buffer：VertexBuffer、IndexBuffer、UniformBuffer 封装
- UniformBuffer：每帧上传 MVP 矩阵
- DescriptorManager：DescriptorSetLayout、DescriptorPool、DescriptorSet 及更新

Renderer：
- 协调所有子系统
- 绘制每面不同颜色的旋转 3D 立方体
- 启用 depth test，MVP 矩阵由 GLM 计算

构建：
- CMake 组织 Engine 静态库与 App 可执行文件
- glfw、glm、spdlog 通过 add_subdirectory 引入
 2026-09-20 23:09:40 +08:00