xuanchi/XCEngine
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
450 Commits 1 Branch 0 Tags
da1f8cfb5829dda717d0ea366e0162b9c7d17ad0
Commit Graph

450 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
ssdfasd
a9f882f233 docs: 修正 API 文档准确性 (第二轮检查) 
修复的问题:
- math: 修复 Quaternion::Normalize 链接错误
- containers: HashMap 迭代器示例使用不存在的 cbegin/cend，删除冗余构造函数声明
- core: RefCounted 析构函数访问级别修正 (protected)
- debug: LogLevelToString 示例返回值大小写修正
- memory: 修正 LinearAllocator::Reallocate 返回 nullptr，ProxyAllocator 统计描述，头文件路径 IAllocator.h -> Allocator.h
- resources: Texture::Create mipLevels 参数描述修正
- rhi: 修复多处链接错误，新增缺失的方法文档
- threading: TaskSystem 配置项未实现状态标注，Wait 方法空实现标注
 2026-03-19 00:31:14 +08:00
ssdfasd
dc850d7739 docs: 重构 API 文档结构并修正源码准确性 
- 重组文档目录结构: 每个模块的概述页移动到模块子目录
- 重命名 index.md 为 main.md
- 修正所有模块文档中的错误:
  - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式
  - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节
  - core: 修复 types 链接错误
  - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI
  - memory: 修复头文件路径, malloc vs operator new, 新增方法文档
  - resources: 修复 Shader/Texture 链接错误
  - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接
- 验证: fix_links.py 确认 0 个断裂引用
 2026-03-19 00:22:30 +08:00
ssdfasd
d0e16962c8 docs: update README and project docs to reflect game engine scope 2026-03-18 17:58:01 +08:00
ssdfasd
9bad996ecf refactor: reorganize docs into plan/ and add skills/ 2026-03-18 17:49:22 +08:00
ssdfasd
fc7c8f6797 feat: 完成资源系统导入设置类实现 
- 新增 ImportSettings 基类
- 新增 TextureImportSettings 纹理导入设置类
- 新增 MeshImportSettings 网格导入设置类
- 新增 ResourcePath 资源路径类
- 完善 CMakeLists.txt 配置
- 新增对应单元测试 (45个测试用例)
 2026-03-18 13:39:32 +08:00
ssdfasd
3196261e9b fix(RHI): 添加 OpenGL 源文件到 CMakeLists 并修复编译错误 
- 添加 OpenGL RHI 所有源文件到 engine/CMakeLists.txt
- 修复 OpenGLPipelineState 结构体重定义问题
- 修复 BufferDesc/TextureDesc/ShaderCompileDesc API 不匹配
- 添加 OpenGLShader 缺少的基类纯虚函数实现
- 修复 HashMap 迭代器支持和 ResourceManager API 调用
 2026-03-18 03:37:34 +08:00
ssdfasd
8344057886 feat(resources): add LoadGroup and UnloadGroup for batch resource loading 2026-03-18 03:20:18 +08:00
ssdfasd
87835c5f7a Add build2/ to gitignore 2026-03-18 03:07:29 +08:00
ssdfasd
508d8b165b feat(RHI): 添加 RHIPipelineLayout 抽象类 2026-03-18 03:04:13 +08:00
ssdfasd
17e71218e7 feat(OpenGL): 初始化 RHICapabilities 
- 在 OpenGLDevice 初始化时查询 GL 扩展和硬件限制
- 设置 majorVersion、minorVersion
- 设置几何着色器、计算着色器、细分着色器支持标志
- 设置最大纹理尺寸、最大渲染目标数、最大视口数、各向异性最大值、顶点属性最大数
 2026-03-18 02:36:40 +08:00
ssdfasd
65ce9c84c6 feat(RHI): 在 RHIBuffer 基类中添加资源状态接口 
- 添加 GetState() 和 SetState() 纯虚函数到 RHIBuffer 抽象基类
- D3D12Buffer 已有实现，现在通过基类接口可用
- OpenGLBuffer 添加空实现（OpenGL 无资源状态概念）
 2026-03-18 02:34:17 +08:00
ssdfasd
60c8461be3 refactor(RHI): 将窗口管理接口从 RHIDevice 移至 RHISwapChain 
- 从 RHIDevice 抽象基类中移除 PollEvents/SwapBuffers/ShouldClose/SetShouldClose 接口
- 这些功能现在应该通过 RHISwapChain 访问
- 符合设计文档中定义的分层架构
 2026-03-18 02:32:31 +08:00
ssdfasd
83c2426830 fix(OpenGL): 修复工厂方法返回 nullptr 的问题 
- OpenGLDevice::CreateBuffer 现在创建并返回 OpenGLBuffer 对象
- OpenGLDevice::CreateTexture 现在创建并返回 OpenGLTexture 对象
- OpenGLDevice::CreateSwapChain 现在创建并返回 OpenGLSwapChain 对象
- OpenGLDevice::CreateCommandList 现在创建并返回 OpenGLCommandList 对象
- OpenGLDevice::CreateCommandQueue 现在创建并返回 OpenGLCommandQueue 对象
- OpenGLDevice::CompileShader 现在创建并返回 OpenGLShader 对象
- OpenGLDevice::CreatePipelineState 现在创建并返回 OpenGLPipelineState 对象
- OpenGLDevice::CreateFence 现在创建并返回 OpenGLFence 对象
- OpenGLDevice::CreateSampler 现在创建并返回 OpenGLSampler 对象
 2026-03-18 02:29:12 +08:00
ssdfasd
a532cabf92 feat(RHI): 添加 RHIDescriptorPool 抽象类 
- 新增 RHIDescriptorPool 抽象基类，定义描述符池统一接口
- D3D12DescriptorHeap 现在继承自 RHIDescriptorPool
- 添加 DescriptorPoolDesc 结构体，包含设备指针、类型、数量等信息
- 添加 Initialize(const DescriptorPoolDesc&) 统一初始化方法
 2026-03-18 01:46:01 +08:00
ssdfasd
a220638298 fix(D3D12): 修复 D3D12Fence::IsSignaled() 实现错误 
- 原来实现假设 GetCompletedValue() > 0 即为 signaled，这是错误的
- 添加 m_signalValue 成员变量跟踪最后一次 signal 的值
- IsSignaled() 现在正确检查 GetCompletedValue() >= m_signalValue
 2026-03-18 01:37:55 +08:00
ssdfasd
70571316da feat(RHI): 添加 RHIFactory 工厂类 
- 新增 RHIFactory 头文件和实现，支持通过 RHIType 或字符串创建设备
- 修复 D3D12Buffer 缺失的 Map/Unmap/SetData 实现
- 添加 RHI 工厂测试用例
- 更新 CMakeLists.txt 添加新文件
 2026-03-18 01:33:15 +08:00
ssdfasd
d2585f14b3 feat(Resources): Add ResourceDependencyGraph for resource dependency tracking 
- Implement dependency graph for resource management
- Add/remove nodes and dependencies
- Reference counting support
- Circular dependency detection
- Add unit tests
 2026-03-18 01:13:02 +08:00
ssdfasd
bd69c3e124 feat(Resources): Add ResourcePackage system for asset bundling 
- Implement ResourcePackageBuilder for creating .xcp packages
- Implement ResourcePackage for reading packaged assets
- Add unit tests for package builder and package reader
 2026-03-18 00:49:22 +08:00
ssdfasd
02ca59edf6 test(Resources): Add comprehensive resource system tests (8 new test files, +48 test cases) 
- Add Shader tests (8 test cases)
- Add Material tests (13 test cases)
- Add FileArchive tests (7 test cases)
- Add Loader tests for Texture, Mesh, Audio, Shader, Material (4 tests each)
- Implement IResourceLoader.cpp with ReadFileData and GetExtension
- Update CMakeLists.txt to include new test files and source
 2026-03-18 00:09:06 +08:00
ssdfasd
640557cbb5 test(Resources): Add ResourceFileSystem tests (4 test cases) 2026-03-17 23:46:46 +08:00
ssdfasd
e71edc2f46 test(Resources): Add AudioClip tests (2 test cases) 2026-03-17 23:45:06 +08:00
ssdfasd
8cc4322d22 test(Resources): Add Texture and Mesh tests (8 test cases) 2026-03-17 23:38:29 +08:00
ssdfasd
2325b4ba7d test(Resources): Add IResourceLoader/LoadResult tests (4 test cases) 2026-03-17 23:36:12 +08:00
ssdfasd
b7feca59c4 fix(test): zero-initialize state structs to avoid stack corruption 2026-03-17 23:29:31 +08:00
ssdfasd
6fe21710e8 test(RHI): add rendering state tests for CommandList 
- Add tests for SetPrimitiveTopology
- Add tests for SetDepthStencilState
- Add tests for SetBlendState
- Add tests for SetBlendFactor
- OpenGL tests now have 45 test cases
 2026-03-17 23:25:40 +08:00
ssdfasd
254f794cdc feat(RHI): add rendering state abstraction to RHICommandList 
- Add DepthStencilState and BlendState structs to RHICommandList
- Add SetPrimitiveTopology, SetDepthStencilState, SetStencilRef,
  SetBlendState, SetBlendFactor virtual methods
- Implement new methods in OpenGL backend with full state control
- Implement stub methods in D3D12 backend (states controlled via PSO)
 2026-03-17 23:17:43 +08:00
ssdfasd
0b50a57239 test(Resources): Add ResourceCache tests (8 test cases) 2026-03-17 23:07:33 +08:00
ssdfasd
6ca1487279 test(Resources): Add ResourceHandle tests (11 test cases) 2026-03-17 22:52:30 +08:00
ssdfasd
0e31cd804b test(Resources): Add IResource tests (3 test cases) 2026-03-17 22:50:21 +08:00
ssdfasd
417477c2ca feat: Implement resource system Phase 4.5 - ResourceFileSystem (4 files, +305 lines) 2026-03-17 22:43:59 +08:00
ssdfasd
967c64faf8 docs: update README with RHI abstraction layer documentation 2026-03-17 22:39:59 +08:00
ssdfasd
4710e6ba60 feat: Implement resource system Phase 2 - Concrete resource types 
- Add Material class with shader/texture bindings and property system
- Add MaterialLoader for .mat/.json format
- Add Shader class (Vertex/Fragment/Geometry/Compute)
- Add ShaderLoader for .vert/.frag/.glsl/.hlsl
- Add AudioClip class (WAV/OGG/MP3/FLAC support)
- Add AudioLoader for audio files
- Add Texture/Mesh classes and loaders (from design doc)
- Fix HashMap iterator and String API usage
- Fix Mutex compatibility with std::lock_guard
- Update CMakeLists.txt with new resource files
- All tests pass: 11 Resources + 51 Containers
 2026-03-17 22:32:27 +08:00
ssdfasd
05c879a818 fix(OpenGL): 修复 RHIDeviceInfo majorVersion/minorVersion 为0的问题 2026-03-17 19:44:50 +08:00
ssdfasd
0a2f8050e5 fix(RHI): 修复 OpenGL 测试接口不匹配问题 
- 修复 RHIDeviceInfo 缺少 majorVersion/minorVersion
- 修复 OpenGLTexture 使用 GetTextureType 替代 GetType
- 修复 OpenGLSampler 使用 OpenGLSamplerDesc
- 修复 BlendFactor::OneMinusSrcAlpha -> InvSrcAlpha
- 修复 OpenGLRenderTargetViewDesc/OpenGLDepthStencilViewDesc 重定义问题
- 恢复 OpenGL 测试文件到 CMakeLists
 2026-03-17 19:43:20 +08:00
ssdfasd
94bf04f06c feat(Resources): 添加资源系统基础框架 
- ResourceTypes: 资源类型枚举、ResourceGUID生成
- IResource: 资源基类接口
- ResourceHandle: 资源句柄智能指针
- IResourceLoader: 加载器接口
- ResourceManager: 资源管理器(单例模式)
- ResourceCache: LRU缓存实现
- AsyncLoader: 异步加载器
- 测试框架: test_resource_types, test_resource_guid

Note: 当前与现有容器API存在编译差异,需要后续修复
 2026-03-17 19:38:27 +08:00
ssdfasd
e138fb2075 fix(RHI): 修复 OpenGL/D3D12 后端编译问题 
- 修复 OpenGLCommandList 方法签名匹配 RHI 抽象接口
- 修复 OpenGLSwapChain Present/Resize 方法签名
- 添加 OpenGL 特有方法重载支持后端测试（底层逃逸）
- 暂时禁用不兼容的 Resources 模块
- 更新 OpenGL 测试 CMakeLists
 2026-03-17 19:35:51 +08:00
ssdfasd
a257ff2d8b fix(RHI): 修复抽象基类编译问题 2026-03-17 18:24:08 +08:00
ssdfasd
20445999fc feat(RHI): 实现 RHIPipelineState 抽象基类 2026-03-17 18:09:34 +08:00
ssdfasd
354b6a5cfc feat(RHI): 实现 RHISwapChain 抽象基类 2026-03-17 18:05:40 +08:00
ssdfasd
55865a0252 feat(RHI): 实现 RHICommandList 抽象基类 2026-03-17 18:01:55 +08:00
ssdfasd
4638539f17 feat(RHI): 实现 RHICommandQueue 抽象基类 2026-03-17 17:54:44 +08:00
ssdfasd
14fb51e61e feat(RHI): 实现 RHIDevice 抽象基类 2026-03-17 17:45:01 +08:00
ssdfasd
af718279ff feat(RHI): 实现 RHIFence 抽象基类 
- 新增 RHIFence 抽象基类
- D3D12Fence 继承 RHIFence
- OpenGLFence 继承 RHIFence
- 文档更新 RHIFence 差异处理策略
 2026-03-17 17:36:17 +08:00
ssdfasd
f046e17ad6 feat(RHI): 实现 RHISampler 抽象基类 
- 新增 RHISampler 抽象基类
- D3D12Sampler 继承 RHISampler
- OpenGLSampler 继承 RHISampler，使用 OpenGLSamplerDesc
- 文档更新 RHISampler 差异处理策略
 2026-03-17 17:31:32 +08:00
ssdfasd
e38d5ccede feat(RHI): 实现 RHIBuffer, RHITexture, RHIShader 抽象基类 
- 新增 RHIBuffer, RHITexture, RHIShader 抽象基类
- D3D12Buffer/Texture/Shader 继承抽象基类
- OpenGLBuffer/Texture/Shader 继承抽象基类
- 添加 RHICapabilities, RHIDevice 头文件
- RHIEnums 添加 Fragment/TessControl/TessEvaluation
- 文档更新差异处理策略
 2026-03-17 17:26:41 +08:00
ssdfasd
f2ae95e0a7 Complete OpenGL test suite - 56 tests 
Added missing tests to reach planned 56:
- CommandList: EnableDisable_DepthTest, EnableDisable_Blending
- RTV: GetTexture, GetMipLevel
- DSV: Initialize_Texture, GetTexture, GetMipLevel

Final count: 56 tests across all 12 components
 2026-03-17 12:48:17 +08:00
ssdfasd
7bf586f6fa Add Phase 5: SwapChain tests (3 tests) 
- Add SwapChain tests: Initialize, Present, Resize

=== OpenGL Test Suite Complete ===
Total: 49 tests across all phases:
- Phase 1: Device, Buffer, Fence (17 tests)
- Phase 2: Texture, Sampler (9 tests)
- Phase 3: Shader, PipelineState, VertexArray (11 tests)
- Phase 4: CommandList, RTV, DSV (9 tests)
- Phase 5: SwapChain (3 tests)
 2026-03-17 12:41:29 +08:00
ssdfasd
4b14831c57 Add Phase 4: CommandList, RTV, DSV tests (13 tests) 
- Add CommandList tests: Clear (color/depth/stencil), SetIndexBuffer, Draw (VAO), SetViewport, SetScissor
- Add RTV tests: Initialize (Texture2D), Bind/Unbind
- Add DSV tests: Bind/Unbind
- Simplify tests to work with available GL context
 2026-03-17 12:40:07 +08:00
ssdfasd
276a9c476a Add Phase 3: Shader, PipelineState, VertexArray tests (11 tests) 
- Add Shader tests: VertexFragment, Geometry, InvalidSource, SetUniforms
- Add PipelineState tests: DepthStencilState, BlendState, Viewport/Scissor
- Add VertexArray tests: Initialize, AddVertexBuffer, SetIndexBuffer, Bind/Unbind
 2026-03-17 12:31:05 +08:00
ssdfasd
1d181f1109 Add Phase 2: Texture and Sampler tests (9 tests) 
- Add Texture tests: 2DTexture, CubeMap, Bind/Unbind, GenerateMipmap, SetFiltering/SetWrapping
- Add Sampler tests: Initialize (default/custom), Bind/Unbind, GetID
 2026-03-17 12:27:47 +08:00