XCEngine/docs/api/XCEngine/Debug/Profiler/SetMarker.md

# Profiler::SetMarker

设置一个可视化 marker。

```cpp
void SetMarker(const char* name, uint32_t color);
```

## 行为说明

当前实现是空函数，不会保存 marker，也不会改变任何采样结果。

从接口设计看，这更像是为后续调试 UI 或时间线着色预留的扩展点，而不是现阶段可依赖的功能。

## 参数

- `name` - marker 名称。当前实现不会使用。
- `color` - marker 颜色。当前实现不会使用。

## 返回值

- 无。

## 线程语义

- 当前为空实现，无额外线程语义。

## 示例

```cpp
XCEngine::Debug::Profiler::Get().SetMarker("ShadowPass", 0xff00ff00u);
```

## 相关文档

- [返回类型总览](Profiler.md)
- [MarkEvent](MarkEvent.md)