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:
41
docs/api/threading/lambda-task/constructor.md
Normal file
41
docs/api/threading/lambda-task/constructor.md
Normal file
@@ -0,0 +1,41 @@
|
||||
# LambdaTask::LambdaTask
|
||||
|
||||
```cpp
|
||||
explicit LambdaTask(Func&& func, TaskPriority priority = TaskPriority::Normal)
|
||||
```
|
||||
|
||||
构造 Lambda 任务对象,将可调用对象包装为 ITask。
|
||||
|
||||
**模板参数:**
|
||||
- `Func` - 可调用对象类型
|
||||
|
||||
**参数:**
|
||||
- `func` - 要封装的可调用对象(lambda、函数指针、std::function 等)
|
||||
- `priority` - 任务优先级,默认值为 TaskPriority::Normal
|
||||
|
||||
**返回:** 无
|
||||
|
||||
**复杂度:** O(1)
|
||||
|
||||
**示例:**
|
||||
|
||||
```cpp
|
||||
// 使用 std::function lambda
|
||||
auto task = std::make_unique<LambdaTask<std::function<void()>>>(
|
||||
[]() { printf("Task executed\n"); },
|
||||
TaskPriority::High
|
||||
);
|
||||
TaskSystem::Get().Submit(std::move(task));
|
||||
|
||||
// 配合 TaskSystem::Submit 的重载直接使用
|
||||
TaskSystem::Get().Submit(
|
||||
std::make_unique<LambdaTask<std::function<void()>>>(
|
||||
[]() { ProcessData(); },
|
||||
TaskPriority::Critical
|
||||
)
|
||||
);
|
||||
```
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [LambdaTask 总览](lambdatask.md) - 返回类总览
|
||||
40
docs/api/threading/lambda-task/execute.md
Normal file
40
docs/api/threading/lambda-task/execute.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# LambdaTask::Execute
|
||||
|
||||
```cpp
|
||||
void Execute() override
|
||||
```
|
||||
|
||||
执行封装的可调用对象。调用时执行构造时传入的 lambda 或可调用函数。
|
||||
|
||||
**参数:** 无
|
||||
|
||||
**返回:** 无
|
||||
|
||||
**注意:**
|
||||
- 如果封装的可调用对象抛出异常,异常会向上传播到 TaskSystem。
|
||||
- 任务系统的工作线程不会捕获此类异常。
|
||||
|
||||
**示例:**
|
||||
|
||||
```cpp
|
||||
// 创建并提交 LambdaTask
|
||||
TaskSystem::Get().Submit(
|
||||
std::make_unique<LambdaTask<std::function<void()>>>(
|
||||
[]() {
|
||||
printf("Task executed!\n");
|
||||
},
|
||||
TaskPriority::Normal
|
||||
)
|
||||
);
|
||||
|
||||
// 使用便捷重载直接提交
|
||||
TaskSystem::Get().Submit([]() {
|
||||
int result = ComputeHeavyWork();
|
||||
printf("Result: %d\n", result);
|
||||
}, TaskPriority::High);
|
||||
```
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [LambdaTask 总览](lambdatask.md) - 返回类总览
|
||||
- [ITask::Execute](../task/execute.md) - 基类方法文档
|
||||
57
docs/api/threading/lambda-task/lambda-task.md
Normal file
57
docs/api/threading/lambda-task/lambda-task.md
Normal file
@@ -0,0 +1,57 @@
|
||||
# LambdaTask
|
||||
|
||||
**命名空间**: `XCEngine::Threading`
|
||||
|
||||
**类型**: `class` (template)
|
||||
|
||||
**头文件**: `XCEngine/Threading/LambdaTask.h`
|
||||
|
||||
**描述**: Lambda 任务封装模板类,允许使用 lambda 表达式创建任务,无需继承 ITask。
|
||||
|
||||
## 概述
|
||||
|
||||
`LambdaTask<Func>` 是一个模板封装类,将任意可调用对象(lambda、函数指针、std::function)包装为 `ITask`。这大大简化了简短任务的创建。
|
||||
|
||||
## 模板参数
|
||||
|
||||
| 参数 | 描述 |
|
||||
|------|------|
|
||||
| `Func` | 可调用对象类型 |
|
||||
|
||||
## 构造方法
|
||||
|
||||
| 方法 | 描述 |
|
||||
|------|------|
|
||||
| [`LambdaTask`](constructor.md) | 构造 Lambda 任务 |
|
||||
|
||||
## 继承方法
|
||||
|
||||
| 方法 | 描述 |
|
||||
|------|------|
|
||||
| [`Execute()`](execute.md) | 执行封装的可调用对象(继承自 ITask,纯虚方法重写) |
|
||||
|
||||
## 使用示例
|
||||
|
||||
```cpp
|
||||
// 使用 lambda 创建任务
|
||||
TaskSystem::Get().Submit(
|
||||
std::make_unique<LambdaTask<std::function<void()>>>(
|
||||
[]() {
|
||||
printf("Hello from task!\n");
|
||||
},
|
||||
TaskPriority::Normal
|
||||
)
|
||||
);
|
||||
|
||||
// 或者直接使用 Submit 的便捷重载
|
||||
TaskSystem::Get().Submit([]() {
|
||||
printf("Direct lambda task!\n");
|
||||
});
|
||||
```
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [ITask](../task/task.md) - 任务基类
|
||||
- [TaskGroup](../task-group/task-group.md) - 任务组
|
||||
- [TaskSystem](../task-system/task-system.md) - 任务系统
|
||||
- [../threading/threading.md](../threading.md) - 模块总览
|
||||
Reference in New Issue
Block a user