XCEngine/docs/api/math/ray/intersects-plane.md

# Ray::Intersects (plane)

```cpp
bool Intersects(const Plane& plane, float& t) const
```

检测射线是否与平面相交。通过计算射线与平面法线的点积判断平行，通过求交公式计算交点。

**参数：**
- `plane` - 要检测的平面
- `t` - 输出交点的参数距离（仅在返回 true 时有效）

**返回：** `bool` - 相交返回 true（t >= 0），否则返回 false

**线程安全：** ✅

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

**异常：** 无

**示例：**

```cpp
#include <XCEngine/Core/Math/Ray.h>
#include <XCEngine/Core/Math/Plane.h>
#include <XCEngine/Core/Math/Vector3.h>

using namespace XCEngine::Math;

Ray ray(Vector3(0.0f, 1.0f, 0.0f), Vector3(0.0f, -1.0f, 0.0f));
Plane groundPlane(Vector3(0.0f, 1.0f, 0.0f), 0.0f);
float t;
if (ray.Intersects(groundPlane, t)) {
    Vector3 hitPoint = ray.GetPoint(t);
}
```

## 相关文档

- [Ray 类总览](ray.md) - 返回类总览
- [Plane](../plane/plane.md) - 平面类型