XCEngine/docs/api/math/matrix4/multiplypoint.md

# Matrix4x4::MultiplyPoint

```cpp
Vector3 MultiplyPoint(const Vector3& v) const
```

使用矩阵变换一个点。会自动处理 w=1 的齐次坐标变换，适用于位置变换。

**参数：**
- `v` - 待变换的三维点

**返回：** 变换后的三维点

**线程安全：** ✅

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

**示例：**

```cpp
#include "XCEngine/Math/Matrix4.h"
#include "XCEngine/Math/Vector3.h"

using namespace XCEngine::Math;

Matrix4 transform = Matrix4::TRS(
    Vector3(1.0f, 2.0f, 3.0f),
    Quaternion::Identity(),
    Vector3(1.0f, 1.0f, 1.0f)
);

Vector3 point(1.0f, 0.0f, 0.0f);
Vector3 transformed = transform.MultiplyPoint(point);
// transformed = (2.0f, 2.0f, 3.0f)
```

## 相关文档

- [Matrix4](matrix4.md) - 返回类总览
- [MultiplyVector](multiplyvector.md) - 向量变换
- [operator*](operator_mul.md) - 矩阵乘法