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

81 Commits

Author SHA1 Message Date
ssdfasd
48b73a5045 fix(docs): fix remaining AudioClip setter broken references 2026-03-26 02:04:09 +08:00
ssdfasd
a2765a282e fix(docs): fix MeshLoader constructor and Fence doc references 2026-03-26 02:03:53 +08:00
ssdfasd
32cf6b8ced fix(docs): fix remaining AudioClip and MaterialLoader broken references 2026-03-26 02:03:38 +08:00
ssdfasd
4ca8773eef fix(docs): fix AudioClip links, ResourcePackage path, Fence and Scene broken references 2026-03-26 02:03:19 +08:00
ssdfasd
caa5d449fc fix(docs): fix AudioClip method doc links and ResourceTypes header path 2026-03-26 02:02:54 +08:00
ssdfasd
582ab2c730 docs: 更新多个模块文档 
- resources: 更新 audioclip 和 resourcepath 文档
- rhi: 更新 d3d12 和 opengl 文档
 2026-03-26 02:02:42 +08:00
ssdfasd
02e48b4766 fix(docs): correct D3D12 Fence cross-references to use local fence links instead of threading 2026-03-26 02:02:33 +08:00
ssdfasd
c2354530b9 docs: 新增 light-component 全部方法文档及更新其他模块 
- components: 新增 light-component 全部12个方法文档
- resources: 更新 audio-loader, resource-file-system 文档
- rhi: 更新 opengl/fence 文档
 2026-03-26 02:02:21 +08:00
ssdfasd
ab5ba1d57a docs: 更新 resources 模块多个文档 
- importsettings, material-loader, mesh-loader, resourcehandle, resources
 2026-03-26 02:01:55 +08:00
ssdfasd
ca83267992 docs: 更新 audio-loader 和 audioclip 文档 2026-03-26 02:01:37 +08:00
ssdfasd
c8da156352 docs: 更新 resource-package 文档 2026-03-26 02:01:14 +08:00
ssdfasd
a1804f4cb0 docs: 更新 resources, rhi, scene 模块及新增 camera-component 方法文档 
- resources: 更新 asyncloader, audioclip, mesh-import-settings, texture-loader 文档
- rhi: 更新 opengl render-target-view 文档
- components: 新增 camera-component 全部方法文档 (15个文件)
 2026-03-26 02:00:45 +08:00
ssdfasd
f778c76325 fix(docs): update Shader header path and RHI source link for engine restructure 2026-03-26 02:00:14 +08:00
ssdfasd
92939a85f8 fix(docs): update Material, Mesh, Texture header paths for engine restructure 2026-03-26 01:59:56 +08:00
ssdfasd
b849e9edc1 docs: 更新 iresource 文档 2026-03-26 01:59:37 +08:00
ssdfasd
5c3566774b docs: 更新 containers 和 threading 模块文档 
- containers: 更新 string 类的多个方法文档
- threading: 更新 mutex 和 task-group 方法文档
 2026-03-26 01:59:14 +08:00
ssdfasd
8df04c120f docs: 更新 API 文档 - 多模块修复和完善 
- audio: 更新 audio-system 方法文档
- components: 新增 audio-listener/audio-source 组件方法文档，新增 remove-component 方法
- core: 更新 filewriter, types 文档
- math: 更新 box 方法文档
- memory: 更新 proxy-allocator 文档
- resources: 更新 loader 和 texture 文档
- rhi: 更新 opengl 设备、shader、swap-chain 文档
- threading: 更新 mutex 和 task-system 文档
 2026-03-26 01:58:45 +08:00
ssdfasd
445876752c docs: 修复 containers 和 rhi 模块的头文件路径 
- containers: 修正 Containers.h, Array.h, String.h, HashMap.h 的路径为 Core/Containers/
- rhi: 修正 D3D12 和 OpenGL 后端文档路径
 2026-03-26 01:58:16 +08:00
ssdfasd
52d5e98f62 refactor(docs): fix Resources module links and add new ResourceManager/ResourceHandle docs 2026-03-26 01:57:22 +08:00
ssdfasd
56ee358b5c docs: 修复 RHI 模块中损坏的文档链接 
修正 d3d12 和 opengl 后端文档路径引用
 2026-03-26 01:57:12 +08:00
ssdfasd
efe4f30d85 refactor(docs): fix Resources module paths and cross-references for engine restructure 2026-03-26 01:56:18 +08:00
ssdfasd
4b7d05d22d refactor(docs): add AudioListenerComponent IsMute method doc 2026-03-26 01:55:48 +08:00
ssdfasd
5047d56080 refactor(docs): add GameObject UUID methods and Component serialization methods 2026-03-26 01:55:34 +08:00
ssdfasd
1326860e5d refactor(docs): fix Audio module documentation links and add missing getter docs 2026-03-26 01:54:45 +08:00
ssdfasd
1f97102f33 docs: 更新 audio 和 scene 模块文档 
- audio: 更新 i-audio-backend, i-audio-effect, wasapi-backend 方法文档
- scene: 更新 scene.md 模块总览
 2026-03-26 01:53:04 +08:00
ssdfasd
fae7362e9f docs: 更新 audio 和 resources 模块文档 
- audio: 更新 audio-mixer, equalizer, fft-filter, hrtf, reverbation 方法文档
- resources: 更新资源管理文档
- debug: 新增 renderdoc-capture 文档
 2026-03-26 01:52:36 +08:00
ssdfasd
14ffde371e docs: 修复 audio 模块中指向 components 的错误链接 
修复 AudioSourceComponent 和 AudioListenerComponent 的文档路径引用
 2026-03-26 01:51:43 +08:00
ssdfasd
f5a34f8adc docs: 重构 API 文档 - components 和 scene 模块 
- components: 修复英文标题为中文，添加缺失组件文档
  - 新增 camera-component, light-component, audio-source-component, audio-listener-component 类总览
  - 修复 get-position.md 格式
  - 更新 components.md 模块总览
- scene: 修复方法文档格式，新增缺失方法
  - 修复 find.md, create-game-object.md 英文标题
  - 新增 FindByID, SerializeToString, DeserializeFromString 方法文档
  - 更新 scene.md 类总览方法列表
 2026-03-26 01:50:27 +08:00
ssdfasd
7c3f304688 refactor(docs): D3D12模块文档重构 - 修复链接错误并新增Buffer/Texture/SwapChain方法文档 
- 新增32个方法文档（D3D12Buffer 13个，D3D12Texture 12个，D3D12SwapChain 6个）
- 修复11处跨模块引用错误（rhi-device.md, rhi-texture.md等路径错误）
- 清理d3d12-overview.md移除不存在的类引用
- 修复D3D12Device/D3D12CommandList/D3D12CommandQueue方法列表
- D3D12模块现无broken links
 2026-03-26 01:49:24 +08:00
ssdfasd
63d0271a5b Fix broken links in Math API docs 
Fix 30+ broken cross-references in docs/api/math/:
- viewport: viewport-getaspectratio/getrect -> getaspectratio/getrect
- matrix4: ../color/operator-mul -> operator_mul, operator-index -> operator_index
- matrix4/get-*: gettranslation/getscale/getrotation -> get-translation/-scale/-rotation
- vector3 operator links: operator_*_assign -> operator-*-assign
- vector3 operator links: operator_sub/add -> operator-sub/add
- vector3 operator-eq/neq: swap mutual references to use hyphen naming
- vector4: ../plane/constructor-default -> constructor_default
- Linter fixes: aabb and rectint relative paths corrected
 2026-03-26 01:43:14 +08:00
ssdfasd
d34d040563 Fix broken links in Threading API docs 
Fix 14 broken cross-references in docs/api/threading/:
- lambda-task path: lambdatask -> lambda-task (5 occurrences)
- task-system-config path: tasksystemconfig -> task-system-config (6 occurrences)
- read-write-lock self-ref: readwritelock -> read-write-lock (6 occurrences)
- task-system cross-method: createtaskgroup/destroytaskgroup -> create-task-group/destroy-task-group
- thread cross-method: getcurrentid/getid -> get-current-id/get-id

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-26 01:30:37 +08:00
ssdfasd
1cf744b755 refactor(docs): RHI模块文档重构 - 修复18处链接错误并新增RHIFramebuffer/RHIRenderPass文档 
- 修复opengl/下13个文件对overview.md的错误引用，改为opengl.md
- 修复opengl/shader/下2处get-native-handle.md的错误路径引用
- 修复rhi.md中rhifactory路径错误
- 修复opengl.md中对d3d12.md的错误引用
- 修复opengl/README.md中的overview.md引用
- 新增RHIFramebuffer完整文档(7个文件)
- 新增RHIRenderPass完整文档(7个文件)
- 更新rhi.md总览页，添加RHIFramebuffer和RHIRenderPass分类
 2026-03-26 01:29:00 +08:00
ssdfasd
f427699ac6 refactor: improve test infrastructure and fix OpenGL GLAD initialization 
- Rename D3D12Enum.h to D3D12Enums.h for naming consistency
- Fix OpenGL unit test GLAD initialization by using gladLoadGL()
  instead of gladLoadGLLoader(wglGetProcAddress) for fallback support
- Migrate remaining tests to use gtest_discover_tests for granular
  test discovery (math, core, containers, memory, threading, debug,
  components, scene, resources, input, opengl)
- Remove obsolete TEST_RESOURCES_DIR and copy_directory commands
  from OpenGL unit test CMakeLists (minimal/Res doesn't exist)
- Update TEST_SPEC.md with performance metrics and per-module
  build/test commands for faster development workflow
- Update CMake path references to use lowercase paths
 2026-03-23 00:43:02 +08:00
ssdfasd
0f0ab8922a docs: fix naming conventions across threading, math, memory, core, and debug modules 
threading/:
- Rename 19 camelCase method files to hyphenated names
- task-system: createtaskgroup→create-task-group, etc.
- tasksystemconfig: enabletaskprofiling→enable-task-profiling, etc.
- thread: getcurrentid→get-current-id, etc.
- task: addref→add-ref, getid→get-id, etc.

math/:
- Rename underscore operator files to hyphenated
- vector3: operator_add→operator-add, etc.
- matrix4: gettranslation→get-translation, etc.
- vector4: tovector3→to-vector3, constructor_vector3→constructor-vector3
- sphere: sphere_constructor→sphere-constructor, etc.

memory/:
- Remove duplicate memorymanager/ folder (kept manager/ which was correct)

core/:
- filewriter: Consolidate ctor-default.md and ctor-file.md into constructor.md
- Rename dtor.md→destructor.md

debug/:
- filelogsink: Rename construct.md→constructor.md, ~filelogsink.md→destructor.md

All overview pages updated with new file references.
 2026-03-22 23:09:29 +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
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
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
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
629455df07 Update API documentation and remove obsolete plan files 2026-03-21 15:55:04 +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
26fe3cd835 D3D12: Add bounds check to GetBackBuffer and update unit tests 
- Add assert() bounds check to GetBackBuffer() to catch invalid indices
- Include <cassert> in D3D12SwapChain.cpp
- Update test_swap_chain.cpp to use reference return type
- Mark InvalidIndex test as DISABLED (assert aborts on invalid index)
- Update get-back-buffer.md documentation
 2026-03-20 18:35:00 +08:00
ssdfasd
070b444f8f docs: update RHI API docs 2026-03-20 02:35:45 +08:00
ssdfasd
ea756c0177 docs: update resources API docs 2026-03-20 02:35:35 +08:00
ssdfasd
fd792b7df1 docs: update memory and threading API docs 2026-03-20 02:35:24 +08:00