docs: update math API docs

docs/api/math/matrix4/multiplypoint.md

@@ -1,21 +1,41 @@
-# Matrix4::MultiplyPoint
+# Matrix4x4::MultiplyPoint
 
 ```cpp
 Vector3 MultiplyPoint(const Vector3& v) const
 ```
 
-使用矩阵变换点（包含平移）。
+使用矩阵变换一个点。会自动处理 w=1 的齐次坐标变换，适用于位置变换。
 
 **参数：**
-- `v` - 要变换的点
+- `v` - 待变换的三维点
 
-**返回：** `Vector3` - 变换后的点
+**返回：** 变换后的三维点
+
+**线程安全：** ✅
 
 **复杂度：** O(1)
 
 **示例：**
 
 ```cpp
-Matrix4 model = Matrix4::TRS(pos, rot, scale);
-Vector3 worldPos = model.MultiplyPoint(localPos);
+#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) - 矩阵乘法