XCEngine/docs/api/math/transform/inverse-transform-direction.md

# Transform::InverseTransformDirection

```cpp
Vector3 InverseTransformDirection(const Vector3& direction) const;
```

将一个方向向量从世界空间逆变换到本地空间。计算结果为 `rotation.Inverse() * direction / scale`。

此方法是 `TransformDirection` 的逆操作。

**参数：**
- `direction` - 世界空间中的方向向量

**返回：** `Vector3` - 本地空间中的逆变换后方向

**线程安全：** ❌（无锁，非线程安全）

**复杂度：** O(1)

**示例：**

```cpp
#include "XCEngine/Core/Math/Transform.h"
#include "XCEngine/Core/Math/Vector3.h"

using namespace XCEngine::Math;

void InverseTransformDirectionExample() {
    Transform transform;
    transform.position = Vector3(10.0f, 0.0f, 0.0f);
    transform.rotation = Quaternion::Identity();
    transform.scale = Vector3(2.0f, 2.0f, 2.0f);

    Vector3 worldDir(0.0f, 2.0f, 0.0f);
    Vector3 localDir = transform.InverseTransformDirection(worldDir);
}
```

## 相关文档

- [Transform](transform.md) - 返回类总览
- [TransformDirection](transform-direction.md) - 正向变换方向