Plane

Represents a plane in 3D space.

Plane is stored in the implicit form , where normal is the plane normal and distance is the signed distance from the origin along that normal. It is commonly used for half-space tests, frustum planes, and simple clipping or culling operations.

Construction

Constructors

Plane() constexpr

Constructs a plane from a normal and distance.

Plane::Plane(const Vector3& normal, float distance);

Parameter	Description
normal	Plane normal.
distance	Signed distance from the origin along the normal.

Properties

distance float

Signed distance from the origin to the plane along the normal.

float distance {0.0f};

normal Vector3

Plane normal vector.

Vector3 normal {Vector3::Up()};

Functions

DistanceToPoint() float

Computes the signed distance from the plane to a point.

Positive values are on the side pointed to by the normal, negative values are behind the plane, and zero lies on the plane.

float Plane::DistanceToPoint(const Vector3& point) const;

Parameter	Description
point	Point to test.

DistanceToSphere() float

Computes the signed distance from the plane to a sphere surface.

The value is the distance from the plane to the closest point on the sphere. A negative value means the sphere penetrates the plane.

float Plane::DistanceToSphere(const Sphere& sphere) const;

Parameter	Description
sphere	Sphere to test.

Normalize() void

Normalizes the plane.

Scales normal to unit length and adjusts distance to preserve the plane equation.

void Plane::Normalize();