Struct plane_split::Plane

pub struct Plane<T, U> {
    pub normal: Vector3D<T, U>,
    pub offset: T,
}

An infinite plane in 3D space, defined by equation: dot(v, normal) + offset = 0 When used for plane splitting, it's defining a hemisphere with equation "dot(v, normal) + offset > 0".

Fields

normal: Vector3D<T, U>

Normalized vector perpendicular to the plane.

offset: T

Constant offset from the normal plane, specified in the direction opposite to the normal.

Implementations

impl<T: Copy + Zero + One + Float + ApproxEq<T> + Sub<T, Output = T> + Add<T, Output = T> + Mul<T, Output = T> + Div<T, Output = T>, U> Plane<T, U>

pub fn from_unnormalized(
    normal: Vector3D<T, U>,
    offset: T
) -> Result<Option<Self>, NegativeHemisphereError>

Construct a new plane from unnormalized equation.

pub fn contains(&self, other: &Self) -> bool

Check if this plane contains another one.

pub fn signed_distance_to(&self, point: &Point3D<T, U>) -> T

Return the signed distance from this plane to a point. The distance is negative if the point is on the other side of the plane from the direction of the normal.

pub fn distance_to_line(&self, line: &Line<T, U>) -> T where
    T: Neg<Output = T>, 

Compute the distance across the line to the plane plane, starting from the line origin.

pub fn signed_distance_sum_to<A>(&self, poly: &Polygon<T, U, A>) -> T

Compute the sum of signed distances to each of the points of another plane. Useful to know the relation of a plane that is a product of a split, and we know it doesn't intersect self.

pub fn are_outside(&self, points: &[Point3D<T, U>]) -> bool

Check if a convex shape defined by a set of points is completely outside of this plane. Merely touching the surface is not considered an intersection.

pub fn intersect(&self, other: &Self) -> Option<Line<T, U>>

Compute the line of intersection with another plane.

Trait Implementations

impl<T: Clone, U> Clone for Plane<T, U>

pub fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug, U: Debug> Debug for Plane<T, U>

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

Formats the value using the given formatter.

impl<T: PartialEq, U: PartialEq> PartialEq<Plane<T, U>> for Plane<T, U>

pub fn eq(&self, other: &Plane<T, U>) -> bool

This method tests for self and other values to be equal, and is used by ==.

pub fn ne(&self, other: &Plane<T, U>) -> bool

This method tests for !=.

impl<T, U> StructuralPartialEq for Plane<T, U>