Struct Plane 

pub struct Plane<T: Scalar> { /* private fields */ }

A plane defined by ax + by + cz + d = 0.

Implementations

impl<T: Scalar> Plane<T>

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

Returns the plane normal vector.

pub fn constant(&self) -> T

Returns the plane constant term (d).

impl<T: FloatScalar> Plane<T>

pub fn new(n: &Vector3<T>, p: &Vector3<T>) -> Self

Creates a plane from a normal and a point on the plane.

Panics

Panics if n is too small to normalize. Use Plane::try_new when the input may be degenerate.

pub fn try_new(n: &Vector3<T>, p: &Vector3<T>, epsilon: T) -> Option<Self>

Creates a plane from a normal and a point on the plane.

Returns None if n is too small to normalize.

pub fn from_tri(v0: &Vector3<T>, v1: &Vector3<T>, v2: &Vector3<T>) -> Self

Creates a plane from triangle vertices.

Panics

Panics if the triangle is degenerate. Use Plane::try_from_tri when the input may be degenerate.

pub fn try_from_tri( v0: &Vector3<T>, v1: &Vector3<T>, v2: &Vector3<T>, epsilon: T, ) -> Option<Self>

Creates a plane from triangle vertices.

Returns None if the triangle is degenerate.

pub fn from_quad( v0: &Vector3<T>, v1: &Vector3<T>, v2: &Vector3<T>, v3: &Vector3<T>, ) -> Self

Creates a plane from quad vertices.

Panics

Panics if the quad diagonals do not define a plane. Use Plane::try_from_quad when the input may be degenerate.

This routine does not validate that the four vertices are coplanar. For non-coplanar quads it returns the diagonal-derived representative plane described by Plane::try_from_quad.

pub fn try_from_quad( v0: &Vector3<T>, v1: &Vector3<T>, v2: &Vector3<T>, v3: &Vector3<T>, epsilon: T, ) -> Option<Self>

Creates a plane from quad vertices.

Returns None if the quad diagonals do not define a plane.

The plane normal is computed from the quad diagonals and anchored at the vertex centroid. This is a representative plane for the quad and does not validate coplanarity. For non-coplanar input, the returned plane is not guaranteed to pass through any of the vertices.

pub fn intersect_ray( &self, r: &Ray<T, Vector3<T>>, epsilon: T, ) -> Option<Vector3<T>>

Intersects the plane with a ray.

pub fn intersect_line( &self, line: &Line<T, Vector3<T>>, epsilon: T, ) -> Option<(T, Vector3<T>)>

Computes line-plane intersection.

Returns the parameter t and intersection point, or None if parallel.

Trait Implementations

impl<T: Clone + Scalar> Clone for Plane<T>

fn clone(&self) -> Plane<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Default + Scalar> Default for Plane<T>

fn default() -> Plane<T>

Returns the “default value” for a type.

impl<T: FloatScalar> Distance<T, Vector3<T>> for Plane<T>

Distance Queries

fn distance(&self, other: &Vector3<T>) -> Option<T>

Computes the distance to another value, or None if undefined.

impl<T: Copy + Scalar> Copy for Plane<T>