Struct Rectangle 

pub struct Rectangle { /* private fields */ }

A rectangle (quad) in 3D space, defined by a corner and two edge vectors.

The four vertices are:

• origin
• origin + u
• origin + u + v
• origin + v

Implementations

impl Rectangle

pub fn new(origin: Point3<f32>, u: Vector3<f32>, v: Vector3<f32>) -> Self

Creates a new rectangle from an origin corner and two edge vectors.

The vertices will be: origin, origin+u, origin+u+v, origin+v (counter-clockwise).

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

Creates a rectangle from four corner points.

The winding order should be: a -> b -> c -> d (counter-clockwise).

Internally computes u = b - a and v = d - a.

Panics (debug builds only)

Panics if the points are not coplanar.

pub fn origin(&self) -> Point3<f32>

Returns the origin corner of the rectangle.

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

Returns the first edge vector.

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

Returns the second edge vector.

pub fn vertices(&self) -> [Point3<f32>; 4]

Returns the four vertices of the rectangle.

Order: origin, origin+u, origin+u+v, origin+v (counter-clockwise).

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

Computes the (unnormalized) normal vector of the rectangle.

The direction follows the right-hand rule: u × v.

pub fn unit_normal(&self) -> Option<Vector3<f32>>

Computes the unit normal vector of the rectangle.

Returns None if the rectangle is degenerate (zero area).

pub fn plane(&self) -> Plane3D

Returns the plane that this rectangle lies on.

Panics

Panics if the rectangle is degenerate (u and v are parallel).

pub fn centroid(&self) -> Point3<f32>

Computes the centroid (center) of the rectangle.

pub fn area(&self) -> f32

Computes the area of the rectangle.

pub fn classify(&self, plane: &Plane3D) -> Classification

Classifies this rectangle relative to a plane.

Returns:

• Front if all vertices are in front of the plane
• Back if all vertices are behind the plane
• Coplanar if all vertices lie on the plane
• Spanning if vertices are on both sides

Trait Implementations

impl Clone for Rectangle

fn clone(&self) -> Rectangle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Cuttable for Rectangle

fn cut(&self, plane: &Plane3D) -> (Option<Polygon>, Option<Polygon>)

Cuts the geometry by a plane.

impl Debug for Rectangle

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

Formats the value using the given formatter.

impl From<&Rectangle> for Polygon

fn from(rectangle: &Rectangle) -> 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<Rectangle> for Polygon

fn from(rectangle: Rectangle) -> 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 PartialEq for Rectangle

fn eq(&self, other: &Rectangle) -> 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 Rectangle