Struct Plane3D 

pub struct Plane3D { /* private fields */ }

A plane in 3D space, represented as normal · point = offset.

Implementations

impl Plane3D

pub fn new(normal: Vector3<f32>, offset: f32) -> Self

Creates a new plane from a normal vector and offset. The normal will be normalized automatically.

Panics

Panics if the normal vector has zero length.

pub fn from_point_and_normal(point: Point3<f32>, normal: Vector3<f32>) -> Self

Creates a plane from a point on the plane and a normal vector. The normal will be normalized automatically.

Panics

Panics if the normal vector has zero length.

pub fn from_three_points(a: Point3<f32>, b: Point3<f32>, c: Point3<f32>) -> Self

Creates a plane from three non-collinear points. The normal direction follows the right-hand rule: (b - a) × (c - a).

Panics

Panics if the points are collinear (or nearly so).

pub fn normal(&self) -> Vector3<f32>

Returns the unit normal vector of the plane.

pub fn offset(&self) -> f32

Returns the signed distance from the origin to the plane along the normal.

pub fn signed_distance(&self, point: Point3<f32>) -> f32

Computes the signed distance from a point to the plane.

• Positive: point is in front (same side as normal)
• Negative: point is behind (opposite side from normal)
• Zero: point is on the plane

pub fn classify_point(&self, point: Point3<f32>) -> PlaneSide

Classifies which side of the plane a point lies on. Uses the default PLANE_EPSILON tolerance.

pub fn classify_point_with_epsilon( &self, point: Point3<f32>, epsilon: f32, ) -> PlaneSide

Classifies which side of the plane a point lies on, with a custom epsilon.

pub fn flipped(&self) -> Self

Returns a new plane with the normal flipped (facing the opposite direction).

pub fn project_point(&self, point: Point3<f32>) -> Point3<f32>

Projects a point onto the plane (finds the closest point on the plane).

pub fn intersect_segment( &self, start: Point3<f32>, end: Point3<f32>, ) -> Option<(f32, Point3<f32>)>

Computes the intersection of a line segment with the plane.

Returns Some((t, point)) where:

• t is the interpolation parameter (0.0 = start, 1.0 = end)
• point is the intersection point

Returns None if the segment is parallel to the plane or doesn’t intersect.

Trait Implementations

impl Clone for Plane3D

fn clone(&self) -> Plane3D

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Plane3D

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&Polygon> for Plane3D

fn from(polygon: &Polygon) -> Self

Converts to this type from the input type.

impl From<&Rectangle> for Plane3D

fn from(rectangle: &Rectangle) -> Self

Converts to this type from the input type.

impl From<&Triangle> for Plane3D

fn from(triangle: &Triangle) -> Self

Converts to this type from the input type.

impl From<Polygon> for Plane3D

fn from(polygon: Polygon) -> Self

Converts to this type from the input type.

impl From<Rectangle> for Plane3D

fn from(rectangle: Rectangle) -> Self

Converts to this type from the input type.

impl From<Triangle> for Plane3D

fn from(triangle: Triangle) -> Self

Converts to this type from the input type.

impl PartialEq for Plane3D

fn eq(&self, other: &Plane3D) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Plane3D