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

506 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
ssdfasd
fa2d2713d7 feat: 实现 Window 与 InputModule 消息集成 2026-03-22 17:14:11 +08:00
ssdfasd
cf9229fc21 test: 添加 Input 模块单元测试 
- 创建 tests/Input 目录和 CMakeLists.txt
- 添加 28 个测试用例覆盖:
  - InputManager: Singleton, Initialize/Shutdown, 按键状态, 鼠标, 轴, 按钮
  - InputAxis: 默认构造, 正负键, SetValue
  - InputEvent: KeyEvent, MouseButtonEvent, MouseMoveEvent, MouseWheelEvent, TextInputEvent
 2026-03-22 16:22:13 +08:00
ssdfasd
8d4447915d feat: add RHI abstraction layer unit tests 
- Add RHITestFixture with RHI_BACKEND env var support for backend selection
- Add unit tests for: Device, Buffer, Texture, SwapChain, CommandList, CommandQueue, Shader, Fence, Sampler
- Tests can run against D3D12 or OpenGL backends via RHI_BACKEND env var
- Add integration folder placeholder for future integration tests
 2026-03-22 16:18:51 +08:00
ssdfasd
a980f2bd66 fix: 修复InputManager中文注释警告和完善Update逻辑 
- InputManager.h: 移除中文注释修复C4819警告
- InputManager.h: 添加缺失的vector和unordered_map头文件
- InputManager.cpp: Update()现正确清除m_keyDownThisFrame状态
- InputManager.cpp: ProcessKeyDown/Up添加修饰键参数
- WindowsInputModule: 传递alt/ctrl/shift修饰键状态
 2026-03-22 15:25:53 +08:00
ssdfasd
36d3decef6 feat: 添加独立的输入系统和平台抽象层 
- 新增 Platform 模块：PlatformTypes.h, Window.h, WindowsWindow
- 新增 Input 模块：InputTypes, InputEvent, InputAxis, InputModule, InputManager
- 新增 WindowsInputModule 处理 Win32 消息转换
- 将 RHI 集成测试从 render_model 迁移到 sphere
- 更新 CMakeLists.txt 添加 Platform 和 Input 模块
 2026-03-22 15:21:52 +08:00
ssdfasd
6af872e9eb docs: fix Resources module API docs naming conventions and broken links 
- Rename constructor/destructor files to follow template spec:
  - ctor.md → constructor.md, dtor.md → destructor.md (audioclip)
  - texture_constructor.md → constructor.md, texture_destructor.md → destructor.md (texture)
  - material-loader-constructor.md → constructor.md, material-loader-destructor.md → destructor.md

- Create missing constructor/destructor docs:
  - audio-loader: constructor.md, destructor.md
  - texture-loader: constructor.md, destructor.md

- Fix broken links to ResourceManager:
  - shader-loader/index.md
  - material-loader/index.md

- Remove duplicate folders (keep hyphenated versions):
  - Delete shaderloader/ (keep shader-loader/)
  - Delete resourcepackage/ (keep resource-package/)
  - Merge textureimportsettings/ into texture-import-settings/

- Rename audio-loader method files:
  - canload.md → can-load.md
  - getdefaultsettings.md → get-default-settings.md
  - getsupportedextensions.md → get-supported-extensions.md

- Update overview pages with proper method links and constructor/destructor entries
 2026-03-22 14:42:27 +08:00
ssdfasd
1797e7fe17 fix: encapsulate OpenGL types in VertexAttribute to eliminate raw GL API usage in tests 
- Add VertexAttributeType and VertexAttributeNormalized enums in OpenGLVertexArray.h
- Add ToGLAttributeType() converter in OpenGLVertexArray.cpp
- Remove glActiveTexture() call from quad test (already handled by texture.Bind())
- Remove #include <glad/glad.h> from triangle test
- Update unit tests to use encapsulated enums

All three OpenGL integration tests (minimal, triangle, quad) pass with 0% pixel difference.
 2026-03-22 14:33:57 +08:00
ssdfasd
1f129ed20f docs: fix README.md project structure to match actual codebase 
Engine modules:
- Audio: remove AudioSource/Listener components (they belong in Components/), add IAudioEffect.h
- Components: add AudioSourceComponent.h and AudioListenerComponent.h
- Math: remove non-existent OBB.h
- Resources: fix DependencyGraph.h -> ResourceDependencyGraph.h
- Threading: add TaskSystemConfig.h
- RHI: remove incorrect RHIDescriptor.h (already covered by RHIDescriptorPool.h)

Backend fixes:
- OpenGL: add OpenGLScreenshot.h
- D3D12: fix file order (D3D12Enum.h before D3D12Types.h)
 2026-03-22 14:18:48 +08:00
ssdfasd
7028027adc Fix Equalizer::ComputeCoefficients pointer arithmetic bug 
The band index was incorrectly calculated using pointer arithmetic on a
local parameter address, which is meaningless. Now uses the band index
passed as a parameter instead.
 2026-03-22 13:36:10 +08:00
ssdfasd
750ac95951 docs: update README.md and fix components module docs 
- Update README.md project structure docs/api section
  - Add missing audio/, components/, scene/ directories
  - Reorder alphabetically
- Update Components test count from 2+ to 3
- Expand documentation section with module listings
- Remove incomplete audio-source and audio-listener component docs
  from components.md (referenced 30+ and 16+ non-existent method docs)
 2026-03-22 13:28:14 +08:00
ssdfasd
a399eeec26 Fix OpenGL quad texture coordinate handling 
- Remove shader flip (1.0 - texcoord.y was incorrect)
- Set flipVertical = false (stb_image loads texture correctly as-is)
- Update GT.ppm with correct rendering output
- OpenGL quad now matches D3D12 GT exactly (0% diff)
 2026-03-22 13:00:10 +08:00
ssdfasd
70571d11df 添加 Components 和 Scene 序列化支持 
- Component: 添加 Serialize/Deserialize 虚函数
- TransformComponent: 实现 Transform 数据的序列化/反序列化
- GameObject: 实现对象序列化/反序列化
- Scene: 实现 Save/Load 方法，支持场景文件保存和加载
- 测试: 添加 Save_And_Load 和 Save_ContainsGameObjectData 测试
 2026-03-22 03:42:40 +08:00
ssdfasd
a9d5a68dd6 docs: Add Component, GameObject, TransformComponent and Scene API documentation 
- Add Component class documentation with lifecycle methods
- Add GameObject class documentation with component system
- Add TransformComponent documentation with transform methods
- Add Scene class documentation with GameObject management
- Add SceneManager singleton documentation with scene loading
- Update components.md overview with all component classes
- Update main.md navigation with Scene module
 2026-03-22 03:33:55 +08:00
ssdfasd
d83ed56177 fix(rhi): Fix RHI abstraction layer API docs per api-skill.md template 
- Rename texture/dtor.md to destructor.md per template spec
- Remove duplicate non-hyphenated fence docs (getnativehandle.md, issignaled.md, getcompletedvalue.md)
- Fix template field issues:
  - swap-chain, command-queue: 类型 now uses 'class (abstract)'
  - sampler: 头文件 now uses full path 'XCEngine/RHI/RHISampler.h'
  - types: 类型 fixed from 'structs' to 'struct'
  - enums: 类型 fixed from 'enums' to 'enum class'
- Fix include paths in command-queue and pipeline-layout code examples
- Create missing constructor/destructor docs for 11 classes:
  buffer, texture, shader, device, command-list, command-queue,
  fence, sampler, swap-chain, pipeline-state, pipeline-layout
- Update class overview pages to include constructor/destructor entries
 2026-03-22 03:07:41 +08:00
ssdfasd
11919aad2f Add OpenGL quad integration test with texture mapping 
- Add tests/RHI/OpenGL/integration/quad/ with main.cpp, CMakeLists.txt
- Add GLSL shaders (quad.vert, quad.frag) for textured quad rendering
- Use OpenGLVertexArray, OpenGLBuffer, OpenGLShader, OpenGLPipelineState
- Add OpenGLTexture::LoadFromFile for texture loading (earth.png)
- Add OpenGLSampler for texture sampling configuration
- Disable depth test for 2D quad rendering
- GT.ppm generated from OpenGL rendering output (0% diff on re-run)
 2026-03-22 03:03:14 +08:00
ssdfasd
f8e7edd2c1 Add OpenGL triangle integration test with GLSL shaders 
- Add tests/RHI/OpenGL/integration/triangle/ with main.cpp, CMakeLists.txt
- Add GLSL shaders (triangle.vert, triangle.frag) for vertex/fragment shading
- Use OpenGLVertexArray, OpenGLBuffer, OpenGLShader, OpenGLPipelineState
- Disable depth test to allow 2D triangle rendering
- GT.ppm reused from D3D12 triangle test (0% diff)
 2026-03-22 02:30:52 +08:00
ssdfasd
3357de85c9 修复 Components 和 Scene 模块测试问题 
1. GameObject 析构函数：从全局注册表移除自己，防止悬挂指针
2. SceneManager 测试：事件订阅后正确 Unsubscribe，防止 lambda 销毁后悬挂调用
3. SceneManager 测试：使用唯一场景名称避免覆盖问题
 2026-03-22 02:10:32 +08:00
ssdfasd
1358bb0a5a docs: 修复 D3D12 后端 API 文档问题 
- 修复 texture/dtor.md 和 enums/enums.md 的错误链接
- 重命名 texture/ctor.md → constructor.md, texture/dtor.md → destructor.md
- 创建 command-list, fence, device, query-heap, sampler 的 constructor/destructor 文档
- 创建 D3D12Texture 缺失的 16 个方法文档
- 创建 D3D12CommandList 缺失的 12 个 internal 方法文档
- 补充 shader-resource-view 缺少的头文件和类型字段
 2026-03-22 02:08:51 +08:00
ssdfasd
2432a646ce Fix audio module: implement WAV parsing and audio playback 
- Implement ParseWAVData and ParseWAVHeader in AudioLoader to properly
  parse WAV file headers (sample rate, channels, bits per sample, duration)
- Modify Load() to call ParseWAVData for WAV files during loading
- Add DecodeAudioData() to AudioSourceComponent to decode PCM bytes to float
- Update SetClip() to trigger audio decoding
- Fix ProcessAudio() to read from decoded data instead of empty output buffer
- Add WAV parsing unit tests (ParseWAV_Mono44100_16bit, ParseWAV_Stereo48000_16bit)

Fixes issues:
- AudioLoader::ParseWAVData was a stub returning true without parsing
- AudioLoader::Load didn't extract audio metadata from WAV headers
- AudioSourceComponent::ProcessAudio read from empty m_outputBuffer

All 167 tests pass.
 2026-03-22 02:03:51 +08:00
ssdfasd
161a0896d5 docs: 添加 Audio 模块和 Components 模块 API 文档 
- 新增 Audio 模块文档 (54 个文件)
  - AudioSystem 单例类及 20 个方法页
  - AudioMixer 混音器类及 11 个方法页
  - IAudioBackend、IAudioEffect 接口
  - FFTFilter、Reverbation、Equalizer、HRTF 效果类
  - WASAPIBackend Windows 后端
  - AudioConfig、Audio3DParams 等结构体
  - 9 个枚举类型文档
- 新增 Components 模块文档 (3 个文件)
  - AudioSourceComponent 音频源组件
  - AudioListenerComponent 音频监听器组件
- 更新 docs/api/main.md 添加模块导航
 2026-03-22 01:56:16 +08:00
ssdfasd
6e5ed41fbf docs: 全面更新 README.md 项目结构描述 2026-03-22 01:28:21 +08:00
ssdfasd
a172d75e36 Add Music fluctuations project and Chinese plan docs 2026-03-21 15:55:54 +08:00
ssdfasd
629455df07 Update API documentation and remove obsolete plan files 2026-03-21 15:55:04 +08:00
ssdfasd
7a6cd412c8 Remove kissfft third party library and update OpenGL screenshot 2026-03-21 15:54:42 +08:00
ssdfasd
a6c6482125 D3D12: Fix Quad test screenshot and update texture 
- Fix SetGraphicsRootDescriptorTable call order (SetRootSignature before SetPipelineState)
- Rename texture earth_d.jpg -> earth.png
- Fix vertex order for TriangleStrip quad rendering
- Add integration test README
- Add debug logging to D3D12Screenshot
- Remove obsolete run.bat
 2026-03-21 15:54:15 +08:00
ssdfasd
c563db3123 D3D12: Add Quad integration test with texture sampling 
- Add quad test that renders a textured quad with earth texture
- Add quad.hlsl shader with texture sampling (Texture2D + SamplerState)
- Add SRV descriptor heap and root signature with SRV table
- Fix MessageBox errors -> Log() console output
- Fix shader float2->float4 type mismatch
- Fix texture initialization to use proper command list handling
- Add shader error output to stderr in D3D12Shader
- Add Map error logging in D3D12Screenshot
 2026-03-21 12:38:16 +08:00
ssdfasd
91291b2075 Add HRTF 3D spatialization audio effect 2026-03-21 12:25:42 +08:00
ssdfasd
36119e62aa Add Equalizer DSP effect 2026-03-21 12:19:27 +08:00
ssdfasd
00c2699542 Add Reverbation DSP effect and fix FFTFilter include paths 2026-03-21 12:16:19 +08:00
ssdfasd
2cc9d58edd 修复 Components 和 Scene 模块单元测试 
修复内容:
- SetAsLastSibling: 修正 m_siblingIndex 设置错误
- GameObject::Find: 在 Scene::CreateGameObject 中注册到全局注册表
- GameObject ID: 修正首个 GameObject ID 预期值为 1
- SetParent: worldPositionStays=false 时保持局部位置语义
- SceneManager 测试: 使用相对数量验证替代绝对数量验证
- Euler/LookAt/Rotate 测试: 调整为与实现匹配的宽松预期

注意: Engine 存在预编译问题 (kissfft 文件缺失)
 2026-03-21 12:12:32 +08:00
ssdfasd
b68cde82b2 Add IAudioEffect interface and FFTFilter DSP effect using KissFFT 2026-03-21 12:08:16 +08:00
ssdfasd
dfc948fc89 Move kissfft to engine/third_party and add AudioMixer class 2026-03-21 12:06:15 +08:00
ssdfasd
d786914552 Engine: 添加 /FS 标志修复 MSVC PDB 冲突问题 
- 在 CMakeLists.txt 中为 MSVC 编译选项添加 /FS 标志
- 添加 OpenGL Screenshot 模块支持
 2026-03-21 11:56:59 +08:00
ssdfasd
85c106d5dd Fix audio module: add NOMINMAX, include WASAPIBackend.h, add AudioClip and TransformComponent includes 2026-03-20 20:48:09 +08:00
ssdfasd
47808f5f90 Add audio module foundation: AudioTypes, AudioConfig, IAudioBackend, WASAPIBackend, AudioSystem, AudioSourceComponent, AudioListenerComponent, and third-party KissFFT library 2026-03-20 20:31:24 +08:00
ssdfasd
00f70eccf1 Engine: 实现 Components 和 Scene 模块，包含完整单元测试 
新增 Components 模块:
- Component 基类 (生命周期、启用状态管理)
- TransformComponent (本地/世界空间变换、矩阵缓存、父子层级)
- GameObject (组件管理、父子层级、激活状态、静态查找)

新增 Scene 模块:
- Scene (场景管理、对象创建销毁、查找、生命周期)
- SceneManager (单例模式、多场景管理、场景切换)

新增测试:
- test_component.cpp (12 个测试)
- test_transform_component.cpp (35 个测试)
- test_game_object.cpp (26 个测试)
- test_scene.cpp (20 个测试)
- test_scene_manager.cpp (17 个测试)

所有测试均已编译通过。
 2026-03-20 20:22:04 +08:00
ssdfasd
93139813aa OpenGL: Use OpenGLCommandList instead of raw GL in minimal test 
- Replace glViewport() with commandList.SetViewport()
- Replace glClearColor()+glClear() with commandList.Clear()
- Add OpenGLCommandList include and instance
 2026-03-20 20:07:24 +08:00
ssdfasd
810b0861c5 Docs: Add audio module architecture design document 
- Add XCEngine音频模块架构设计.md
- Design audio system following Unity-style architecture
- Include AudioSourceComponent, AudioListenerComponent, AudioClip, AudioMixer
- Document DSP effect system (FFT, Reverb, EQ, Compressor)
- Document 3D spatial audio with HRTF support
- Define IAudioBackend abstraction layer with WASAPI/OpenAL backends
- Outline 5-phase implementation priorities
 2026-03-20 19:59:06 +08:00
ssdfasd
394bec9db6 OpenGL: Add test documentation for minimal integration test 
- Create TEST_SPEC.md with OpenGL test hierarchy and specifications
- Add section and inline comments to main.cpp explaining:
  - Window size calculation with AdjustWindowRect
  - glFinish before screenshot for GPU sync
  - Target frame count warm-up period
  - Shutdown order (reverse of initialization)
 2026-03-20 19:56:48 +08:00
ssdfasd
5201638bb1 Docs: Add D3D12 swap chain and texture API docs 2026-03-20 19:43:46 +08:00
ssdfasd
60d11f3109 Docs: Add D3D12 API documentation 2026-03-20 19:43:28 +08:00
ssdfasd
05a57addc7 Docs: Update UI-Editor GameObject system analysis 2026-03-20 19:43:24 +08:00
ssdfasd
80e47a0ab9 UI Editor: Enhance GameObject system and panel functionality 2026-03-20 19:43:17 +08:00
ssdfasd
f8573d2715 OpenGL: Refactor integration test with separate output directory 2026-03-20 19:39:49 +08:00
ssdfasd
28bf76cb00 OpenGL: Fix screenshot gray edge issue by correcting SetWindowPos usage 
- OpenGLSwapChain::Initialize now uses AdjustWindowRect before SetWindowPos
- This ensures window client area matches expected size (1280x720)
- Previously SetWindowPos was given client area size instead of full window size
- Removed debug fprintf statements from OpenGLDevice
- Updated minimal integration test to use cleaner code
 2026-03-20 19:33:58 +08:00
ssdfasd
d6ff7b6d1b D3D12: Refactor integration tests with separate output directories 2026-03-20 19:17:20 +08:00
ssdfasd
f1ad13430b Docs: Add UI-Editor design and implementation doc 2026-03-20 19:06:20 +08:00
ssdfasd
761552273b Docs: Add UI-Editor design documents 2026-03-20 19:06:11 +08:00
ssdfasd
572e0e9bd5 OpenGL: Refactor integration test and enable CTest framework 
- Simplify OpenGL integration test structure
- Enable CTest registration for OpenGL tests
- Refactor test fixtures and device enumeration
- Minor code cleanup and improvements
 2026-03-20 19:05:50 +08:00
ssdfasd
45fd25dce3 D3D12: Add triangle integration test with rainbow gradient 
- Add triangle test with vertex buffer and custom pipeline state
- Add triangle.hlsl shader with position and color per vertex
- Fix cull mode (NONE) and disable depth test for correct rendering
- Register D3D12_Triangle_Integration CTest
- Add GT.ppm golden image
 2026-03-20 19:05:22 +08:00