2026-03-26 01:50:27 +08:00
|
|
|
# TransformComponent::GetPosition
|
2026-03-22 03:33:55 +08:00
|
|
|
|
2026-03-26 01:50:27 +08:00
|
|
|
获取变换的世界空间位置。
|
2026-03-22 03:33:55 +08:00
|
|
|
|
|
|
|
|
```cpp
|
|
|
|
|
Math::Vector3 GetPosition() const;
|
|
|
|
|
```
|
|
|
|
|
|
2026-03-26 01:50:27 +08:00
|
|
|
返回变换的世界空间位置。如果变换有父对象,世界位置由局部位置与父对象世界位置组合计算得出。
|
2026-03-22 03:33:55 +08:00
|
|
|
|
2026-03-26 01:50:27 +08:00
|
|
|
**返回:** `Math::Vector3` - 世界空间位置向量
|
2026-03-22 03:33:55 +08:00
|
|
|
|
2026-03-26 01:50:27 +08:00
|
|
|
**线程安全:** ✅ (只读操作)
|
2026-03-22 03:33:55 +08:00
|
|
|
|
2026-03-26 01:50:27 +08:00
|
|
|
**示例:**
|
2026-03-22 03:33:55 +08:00
|
|
|
|
2026-03-26 01:50:27 +08:00
|
|
|
```cpp
|
|
|
|
|
#include <XCEngine/Components/TransformComponent.h>
|
2026-03-22 03:33:55 +08:00
|
|
|
|
2026-03-26 01:50:27 +08:00
|
|
|
using namespace XCEngine::Components;
|
2026-03-22 03:33:55 +08:00
|
|
|
|
|
|
|
|
void Example(TransformComponent* transform) {
|
|
|
|
|
Math::Vector3 worldPos = transform->GetPosition();
|
2026-03-26 01:50:27 +08:00
|
|
|
printf("World position: (%f, %f, %f)\n",
|
2026-03-22 03:33:55 +08:00
|
|
|
worldPos.x, worldPos.y, worldPos.z);
|
|
|
|
|
}
|
|
|
|
|
```
|
2026-03-26 01:50:27 +08:00
|
|
|
|
|
|
|
|
## 相关文档
|
|
|
|
|
|
|
|
|
|
- [TransformComponent 总览](transform-component.md) - 返回类总览
|
|
|
|
|
- [GetLocalPosition](get-local-position.md) - 获取局部位置
|
|
|
|
|
- [SetPosition](set-position.md) - 设置世界位置
|
|
|
|
|
- [SetLocalPosition](set-local-position.md) - 设置局部位置
|