Struct Triangle3d

pub struct Triangle3d {
    pub vertices: [Vec3; 3],
}

A 3D triangle primitive.

Fields

vertices: [Vec3; 3]

The vertices of the triangle.

Implementations

impl Triangle3d

pub fn new(a: Vec3, b: Vec3, c: Vec3) -> Self

Create a new Triangle3d from points a, b, and c.

pub fn normal(&self) -> Result<Dir3, InvalidDirectionError>

Get the normal of the triangle in the direction of the right-hand rule, assuming the vertices are ordered in a counter-clockwise direction.

The normal is computed as the cross product of the vectors ab and ac.

Errors

Returns Err(InvalidDirectionError) if the length of the given vector is zero (or very close to zero), infinite, or NaN.

pub fn is_degenerate(&self) -> bool

Checks if the triangle is degenerate, meaning it has zero area.

A triangle is degenerate if the cross product of the vectors ab and ac has a length less than 10e-7. This indicates that the three vertices are collinear or nearly collinear.

pub fn is_acute(&self) -> bool

Checks if the triangle is acute, meaning all angles are less than 90 degrees

pub fn is_obtuse(&self) -> bool

Checks if the triangle is obtuse, meaning one angle is greater than 90 degrees

pub fn reverse(&mut self)

Reverse the triangle by swapping the first and last vertices.

pub fn reversed(self) -> Triangle3d

This triangle but reversed.

pub fn centroid(&self) -> Vec3

Get the centroid of the triangle.

This function finds the geometric center of the triangle by averaging the vertices: centroid = (a + b + c) / 3.

pub fn largest_side(&self) -> (Vec3, Vec3)

Get the largest side of the triangle.

Returns the two points that form the largest side of the triangle.

pub fn circumcenter(&self) -> Vec3

Get the circumcenter of the triangle.

Trait Implementations

impl Bounded3d for Triangle3d

fn aabb_3d(&self, translation: Vec3, rotation: Quat) -> Aabb3d

Get the bounding box of the triangle.

fn bounding_sphere(&self, translation: Vec3, _rotation: Quat) -> BoundingSphere

Get the bounding sphere of the triangle.

The Triangle3d implements the minimal bounding sphere calculation. For acute triangles, the circumcenter is used as the center of the sphere. For the others, the bounding sphere is the minimal sphere that contains the largest side of the triangle.

impl Clone for Triangle3d

fn clone(&self) -> Triangle3d

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Triangle3d

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

Formats the value using the given formatter.

impl Default for Triangle3d

fn default() -> Self

Returns the default Triangle3d with the vertices [0.0, 0.5, 0.0], [-0.5, -0.5, 0.0], and [0.5, -0.5, 0.0].

impl<'de> Deserialize<'de> for Triangle3d

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromReflect for Triangle3d

where Self: Any + Send + Sync, [Vec3; 3]: FromReflect + TypePath + RegisterForReflection,

fn from_reflect(reflect: &dyn Reflect) -> Option<Self>

Constructs a concrete instance of Self from a reflected value.

fn take_from_reflect( reflect: Box<dyn Reflect>, ) -> Result<Self, Box<dyn Reflect>>

Attempts to downcast the given value to Self using, constructing the value using from_reflect if that fails.

impl GetTypeRegistration for Triangle3d

where Self: Any + Send + Sync, [Vec3; 3]: FromReflect + TypePath + RegisterForReflection,

fn get_type_registration() -> TypeRegistration

Returns the default TypeRegistration for this type.

fn register_type_dependencies(registry: &mut TypeRegistry)

Registers other types needed by this type.

impl Measured2d for Triangle3d

fn area(&self) -> f32

Get the area of the triangle.

fn perimeter(&self) -> f32

Get the perimeter of the triangle.

impl PartialEq for Triangle3d

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

where Self: Any + Send + Sync, [Vec3; 3]: FromReflect + TypePath + RegisterForReflection,

fn get_represented_type_info(&self) -> Option<&'static TypeInfo>

Returns the TypeInfo of the type represented by this value.

fn into_any(self: Box<Self>) -> Box<dyn Any>

Returns the value as a Box<dyn Any>.

fn as_any(&self) -> &dyn Any

Returns the value as a &dyn Any.

fn as_any_mut(&mut self) -> &mut dyn Any

Returns the value as a &mut dyn Any.

fn into_reflect(self: Box<Self>) -> Box<dyn Reflect>

Casts this type to a boxed reflected value.

fn as_reflect(&self) -> &dyn Reflect

Casts this type to a reflected value.

fn as_reflect_mut(&mut self) -> &mut dyn Reflect

Casts this type to a mutable reflected value.

fn clone_value(&self) -> Box<dyn Reflect>

Clones the value as a Reflect trait object.

fn set(&mut self, value: Box<dyn Reflect>) -> Result<(), Box<dyn Reflect>>

Performs a type-checked assignment of a reflected value to this value.

fn try_apply(&mut self, value: &dyn Reflect) -> Result<(), ApplyError>

Tries to apply a reflected value to this value.

fn reflect_kind(&self) -> ReflectKind

Returns a zero-sized enumeration of “kinds” of type.

fn reflect_ref(&self) -> ReflectRef<'_>

Returns an immutable enumeration of “kinds” of type.

fn reflect_mut(&mut self) -> ReflectMut<'_>

Returns a mutable enumeration of “kinds” of type.

fn reflect_owned(self: Box<Self>) -> ReflectOwned

Returns an owned enumeration of “kinds” of type.

fn reflect_partial_eq(&self, value: &dyn Reflect) -> Option<bool>

Returns a “partial equality” comparison result.

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

Debug formatter for the value.

fn apply(&mut self, value: &(dyn Reflect + 'static))

Applies a reflected value to this value.

fn reflect_hash(&self) -> Option<u64>

Returns a hash of the value (which includes the type).

fn serializable(&self) -> Option<Serializable<'_>>

Returns a serializable version of the value.

fn is_dynamic(&self) -> bool

Indicates whether or not this type is a dynamic type.

impl Serialize for Triangle3d

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ShapeSample for Triangle3d

Available on crate feature rand only.

type Output = Vec3

The type of vector returned by the sample methods, Vec2 for 2D shapes and Vec3 for 3D shapes.

fn sample_interior<R: Rng + ?Sized>(&self, rng: &mut R) -> Self::Output

Uniformly sample a point from inside the area/volume of this shape, centered on 0.

fn sample_boundary<R: Rng + ?Sized>(&self, rng: &mut R) -> Self::Output

Uniformly sample a point from the surface of this shape, centered on 0.

fn interior_dist(self) -> impl Distribution<Self::Output>

where Self: Sized,

Extract a Distribution whose samples are points of this shape’s interior, taken uniformly.

fn boundary_dist(self) -> impl Distribution<Self::Output>

where Self: Sized,

Extract a Distribution whose samples are points of this shape’s boundary, taken uniformly.

impl Struct for Triangle3d

where Self: Any + Send + Sync, [Vec3; 3]: FromReflect + TypePath + RegisterForReflection,

fn field(&self, name: &str) -> Option<&dyn Reflect>

Returns a reference to the value of the field named name as a &dyn Reflect.

fn field_mut(&mut self, name: &str) -> Option<&mut dyn Reflect>

Returns a mutable reference to the value of the field named name as a &mut dyn Reflect.

fn field_at(&self, index: usize) -> Option<&dyn Reflect>

Returns a reference to the value of the field with index index as a &dyn Reflect.

fn field_at_mut(&mut self, index: usize) -> Option<&mut dyn Reflect>

Returns a mutable reference to the value of the field with index index as a &mut dyn Reflect.

fn name_at(&self, index: usize) -> Option<&str>

Returns the name of the field with index index.

fn field_len(&self) -> usize

Returns the number of fields in the struct.

fn iter_fields(&self) -> FieldIter<'_>

Returns an iterator over the values of the reflectable fields for this struct.

fn clone_dynamic(&self) -> DynamicStruct

Clones the struct into a DynamicStruct.

impl TypePath for Triangle3d

where Self: Any + Send + Sync,

fn type_path() -> &'static str

Returns the fully qualified path of the underlying type.

fn short_type_path() -> &'static str

Returns a short, pretty-print enabled path to the type.

fn type_ident() -> Option<&'static str>

Returns the name of the type, or None if it is anonymous.

fn crate_name() -> Option<&'static str>

Returns the name of the crate the type is in, or None if it is anonymous.

fn module_path() -> Option<&'static str>

Returns the path to the module the type is in, or None if it is anonymous.

impl Typed for Triangle3d

where Self: Any + Send + Sync, [Vec3; 3]: FromReflect + TypePath + RegisterForReflection,

fn type_info() -> &'static TypeInfo

Returns the compile-time info for the underlying type.

impl Copy for Triangle3d

impl Primitive3d for Triangle3d

impl StructuralPartialEq for Triangle3d