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
This commit is contained in:
@@ -62,7 +62,7 @@ RHI 模块将上层渲染逻辑与底层图形 API 解耦,通过抽象接口
|
||||
|
||||
| 类 | 文档 | 描述 |
|
||||
|----|------|------|
|
||||
| [RHIFence](rhi-fence/fence.md) | `RHIFence.h` | 同步栅栏,CPU/GPU 同步原语 |
|
||||
| [RHIFence](fence/fence.md) | `RHIFence.h` | 同步栅栏,CPU/GPU 同步原语 |
|
||||
| [RHIPipelineState](pipeline-state/pipeline-state.md) | `RHIPipelineState.h` | 管线状态对象,封装渲染管线配置 |
|
||||
| [RHISampler](sampler/sampler.md) | `RHISampler.h` | 纹理采样器,配置纹理过滤和寻址模式 |
|
||||
| [RHIPipelineLayout](pipeline-layout/pipeline-layout.md) | `RHIPipelineLayout.h` | 管线布局,定义着色器资源绑定布局 |
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Scene 模块概览
|
||||
|
||||
**命名空间**: `XCEngine::Components`
|
||||
**命名空间**: `XCEngine::Scene`
|
||||
|
||||
**类型**: `module`
|
||||
|
||||
|
||||
@@ -23,9 +23,9 @@ Mutex 类是对 std::mutex 的封装,提供线程安全的互斥访问机制
|
||||
| [`Lock`](lock.md) | 获取互斥锁(非 const) |
|
||||
| [`Unlock`](unlock.md) | 释放互斥锁(非 const) |
|
||||
| [`TryLock`](trylock.md) | 尝试获取互斥锁(非 const) |
|
||||
| [`lock`](lock_const.md) | 获取互斥锁(const,STL 兼容) |
|
||||
| [`unlock`](unlock_const.md) | 释放互斥锁(const,STL 兼容) |
|
||||
| [`try_lock`](try_lock_const.md) | 尝试获取互斥锁(const,STL 兼容) |
|
||||
| [`lock`](lock-const.md) | 获取互斥锁(const,STL 兼容) |
|
||||
| [`unlock`](unlock-const.md) | 释放互斥锁(const,STL 兼容) |
|
||||
| [`try_lock`](try-lock-const.md) | 尝试获取互斥锁(const,STL 兼容) |
|
||||
|
||||
## 使用示例
|
||||
|
||||
@@ -58,6 +58,6 @@ int main() {
|
||||
## 相关文档
|
||||
|
||||
- [SpinLock](../spinlock/spinlock.md) - 自旋锁
|
||||
- [ReadWriteLock](../readwritelock/readwritelock.md) - 读写锁
|
||||
- [ReadWriteLock](../read-write-lock/read-write-lock.md) - 读写锁
|
||||
- [TaskSystem](../task-system/task-system.md) - 任务系统
|
||||
- [../threading/threading.md](../threading.md) - 模块总览
|
||||
|
||||
@@ -19,9 +19,9 @@
|
||||
| [`Lock`](lock.md) | 获取锁(忙等待) |
|
||||
| [`Unlock`](unlock.md) | 释放锁 |
|
||||
| [`TryLock`](trylock.md) | 尝试获取锁(非阻塞) |
|
||||
| [`lock`](lock_1.md) | STL 兼容的 Lock |
|
||||
| [`unlock`](unlock_1.md) | STL 兼容的 Unlock |
|
||||
| [`try_lock`](try_lock.md) | STL 兼容的 TryLock |
|
||||
| [`lock`](lock-stl.md) | STL 兼容的 Lock |
|
||||
| [`unlock`](unlock-stl.md) | STL 兼容的 Unlock |
|
||||
| [`try_lock`](try-lock.md) | STL 兼容的 TryLock |
|
||||
|
||||
## STL 兼容方法
|
||||
|
||||
@@ -52,5 +52,5 @@ void SafeIncrement() {
|
||||
## 相关文档
|
||||
|
||||
- [Mutex](../mutex/mutex.md) - 互斥锁
|
||||
- [ReadWriteLock](../readwritelock/readwritelock.md) - 读写锁
|
||||
- [ReadWriteLock](../read-write-lock/read-write-lock.md) - 读写锁
|
||||
- [../threading.md](../threading.md) - 模块总览
|
||||
|
||||
34
docs/api/threading/task-group/constructor.md
Normal file
34
docs/api/threading/task-group/constructor.md
Normal file
@@ -0,0 +1,34 @@
|
||||
# TaskGroup::TaskGroup
|
||||
|
||||
```cpp
|
||||
TaskGroup();
|
||||
```
|
||||
|
||||
默认构造函数。构造一个空的任务组。
|
||||
|
||||
**参数:** 无
|
||||
|
||||
**返回:** 无
|
||||
|
||||
**线程安全:** ✅
|
||||
|
||||
**复杂度:** O(1)
|
||||
|
||||
**注意:**
|
||||
- 构造后的任务组不包含任何任务。
|
||||
- 任务组创建后需要通过 TaskSystem::CreateTaskGroup() 实际创建。
|
||||
|
||||
**示例:**
|
||||
|
||||
```cpp
|
||||
#include "XCEngine/Threading/TaskGroup.h"
|
||||
|
||||
XCEngine::Threading::TaskGroup group;
|
||||
// 使用 group 添加任务...
|
||||
```
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [`TaskGroup`](task-group.md) - 返回类总览
|
||||
- [`AddTask`](add-task.md) - 添加任务
|
||||
- [`Wait`](wait.md) - 等待任务完成
|
||||
40
docs/api/threading/task-group/destructor.md
Normal file
40
docs/api/threading/task-group/destructor.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# TaskGroup::~TaskGroup
|
||||
|
||||
```cpp
|
||||
~TaskGroup();
|
||||
```
|
||||
|
||||
析构函数。销毁任务组。
|
||||
|
||||
**参数:** 无
|
||||
|
||||
**返回:** 无
|
||||
|
||||
**线程安全:** ⚠️
|
||||
|
||||
**复杂度:** O(n),n 为任务组中的任务数
|
||||
|
||||
**注意:**
|
||||
- 析构前会等待所有任务完成。
|
||||
- 如果有任务正在执行,会等待其完成。
|
||||
- 未执行的任务将被取消。
|
||||
|
||||
**示例:**
|
||||
|
||||
```cpp
|
||||
#include "XCEngine/Threading/TaskGroup.h"
|
||||
|
||||
{
|
||||
XCEngine::Threading::TaskGroup group;
|
||||
group.AddTask([]() {
|
||||
// 执行任务...
|
||||
});
|
||||
group.Wait();
|
||||
} // group 在这里销毁
|
||||
```
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [`TaskGroup`](task-group.md) - 返回类总览
|
||||
- [`Cancel`](cancel.md) - 取消任务
|
||||
- [`Wait`](wait.md) - 等待任务完成
|
||||
@@ -24,8 +24,8 @@ TaskGroup 用于将多个相关任务组织在一起,统一管理它们的执
|
||||
|
||||
| 方法 | 描述 |
|
||||
|------|------|
|
||||
| [`Task()`](task-group.md) | 默认构造函数 |
|
||||
| [`~Task()`](task-group.md) | 析构函数 |
|
||||
| [`Task()`](constructor.md) | 默认构造函数 |
|
||||
| [`~Task()`](destructor.md) | 析构函数 |
|
||||
| [`AddTask`](add-task.md) | 添加任务到组(支持 ITask 或 Callback) |
|
||||
| [`AddDependency`](add-dependency.md) | 添加任务依赖关系 |
|
||||
| [`Wait`](wait.md) | 阻塞等待所有任务完成 |
|
||||
|
||||
@@ -20,7 +20,7 @@ Threading 模块提供了一套完整的多线程编程工具,包括线程封
|
||||
|------|------|------|
|
||||
| [Mutex](mutex/mutex.md) | `Mutex.h` | 互斥锁 |
|
||||
| [SpinLock](spinlock/spinlock.md) | `SpinLock.h` | 自旋锁 |
|
||||
| [ReadWriteLock](readwritelock/readwritelock.md) | `ReadWriteLock.h` | 读写锁 |
|
||||
| [ReadWriteLock](read-write-lock/read-write-lock.md) | `ReadWriteLock.h` | 读写锁 |
|
||||
|
||||
### 线程
|
||||
|
||||
@@ -33,10 +33,10 @@ Threading 模块提供了一套完整的多线程编程工具,包括线程封
|
||||
| 组件 | 文件 | 描述 |
|
||||
|------|------|------|
|
||||
| [ITask](task/task.md) | `Task.h` | 任务基类 |
|
||||
| [LambdaTask](lambdatask/lambdatask.md) | `LambdaTask.h` | Lambda 任务封装模板 |
|
||||
| [LambdaTask](lambda-task/lambda-task.md) | `LambdaTask.h` | Lambda 任务封装模板 |
|
||||
| [TaskGroup](task-group/task-group.md) | `TaskGroup.h` | 任务组 |
|
||||
| [TaskSystem](task-system/task-system.md) | `TaskSystem.h` | 并行任务调度系统 |
|
||||
| [TaskSystemConfig](tasksystemconfig/tasksystemconfig.md) | `TaskSystemConfig.h` | 任务系统配置 |
|
||||
| [TaskSystemConfig](task-system-config/task-system-config.md) | `TaskSystemConfig.h` | 任务系统配置 |
|
||||
|
||||
## 同步原语对比
|
||||
|
||||
|
||||
Reference in New Issue
Block a user