 atdunbg
|
2c4efc5165
|
feat: 多光源——点光源类型（距离衰减，位置来自 Transform）
- LightComponent 加 Type（Directional/Point）+ radius；点光位置取
实体 Transform（固有组件首次实际受益）
- LightData shader 契约扩为 4×vec4（color/direction/position/params，
每灯 64B，未用字段置零）；UBO 688→816B
- 光照循环按类型分支：方向光无衰减；点光 L 指向光源 + 平方距离衰减，
衰减半径外跳过；CSM 阴影只来自第 0 盏方向光
- main.cpp：SunTemple 场景加暖橙火坑光 + 冷蓝填充光（点光）；
KeyLight/FillLight 改 designated initializer
|
2026-09-23 17:46:25 +08:00 |
|
|
atdunbg
|
b6982d426f
|
feat: Tracy profiler 接入（CPU 帧时间线）
- vendored tracy 子模块；TRACY_ENABLE 全局生效，宏关闭时零开销
- 插桩：Application::Run FrameMark（帧边界）、Renderer::Render、
SceneRenderer::BuildFrame（ZoneScopedN）+ GPUDriven Collect
（ZoneNamedN——同作用域第二个 zone 不能用 ZoneScopedN，变量名
固定会重声明）、Scene::UpdateTransforms
- 覆盖 CPU 侧关键路径：帧时间线 / 场景收集 / transform 重算 / 录制提交
- 用法：游戏运行时打开 Tracy GUI（release 下载）即自动连接（8086 端口）
|
2026-09-23 16:10:46 +08:00 |
|
|
atdunbg
|
7d137fa9b1
|
refactor: Transform 字段封装 + dirty 标记（对齐 UE USceneComponent 真实现）
- 修正上一版"全量暴力重算"：UE 实为 dirty 标记 + 惰性计算，前提是
字段私有（SetRelativeLocation 等 setter 标脏 + 子级传播）
- TransformComponent：SRT 字段私有化，Set/Get/World()/IsDirty 访问器；
Set* 变更才标脏；AddRotationY 便捷接口
- Scene::UpdateTransforms 只重算脏实体——静止实体零成本；
层级（父子）传播在脏标记基础上扩展
- 迁移 Camera/SceneRenderer/main.cpp 到封装 API
|
2026-09-23 15:35:20 +08:00 |
|
|
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 |
|