Struct Polygon 

pub struct Polygon { /* private fields */ }

A convex polygon in 3D space, defined by an ordered list of vertices.

Vertices should be coplanar and in counter-clockwise winding order when viewed from the front (the direction the normal points).

Implementations

impl Polygon

pub fn new(vertices: Vec<Point3<f32>>) -> Self

Creates a new polygon from a list of vertices.

Panics (debug builds only)

• Panics if fewer than 3 vertices are provided.
• Panics if vertices are not coplanar.

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

Returns the vertices of the polygon.

pub fn len(&self) -> usize

Returns the number of vertices.

pub fn is_empty(&self) -> bool

Returns true if the polygon has no vertices (always false for valid polygons).

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

Computes the (unnormalized) normal vector of the polygon.

Uses the first three vertices to compute the normal via cross product. The direction follows the right-hand rule based on vertex winding.

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

Computes the unit normal vector of the polygon.

Returns None if the first three vertices are collinear.

pub fn plane(&self) -> Plane3D

Returns the plane that this polygon lies on.

Panics

Panics if the first three vertices are collinear.

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

Computes the centroid (center of mass) of the polygon.

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

Classifies this polygon 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 Polygon

fn clone(&self) -> Polygon

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Cuttable for Polygon

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

Cuts the geometry by a plane.

impl Debug for Polygon

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 Polygon

fn from(rectangle: &Rectangle) -> Self

Converts to this type from the input type.

impl From<&Triangle> for Polygon

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 Polygon

fn from(rectangle: Rectangle) -> Self

Converts to this type from the input type.

impl From<Triangle> for Polygon

fn from(triangle: Triangle) -> Self

Converts to this type from the input type.

impl PartialEq for Polygon

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