Files
XCEngine/docs/api/math/ray/intersects-plane.md
2026-03-20 02:35:15 +08:00

42 lines
946 B
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Ray::Intersects (plane)
```cpp
bool Intersects(const Plane& plane, float& t) const
```
检测射线是否与平面相交。通过计算射线与平面法线的点积判断平行,通过求交公式计算交点。
**参数:**
- `plane` - 要检测的平面
- `t` - 输出交点的参数距离(仅在返回 true 时有效)
**返回:** `bool` - 相交返回 truet >= 0否则返回 false
**线程安全:**
**复杂度:** O(1)
**异常:**
**示例:**
```cpp
#include <XCEngine/Math/Ray.h>
#include <XCEngine/Math/Plane.h>
#include <XCEngine/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) - 平面类型