Struct Vertex2 

pub struct Vertex2<T: CoordsFloat>(pub T, pub T);

2D vertex structure

Attribute behavior

• binds to 0-cells,
• merge policy: the new vertex is placed at the midpoint between the two existing ones,
• split policy: the current vertex is duplicated,
• fallback policies: default implementations are used.

Generics

• T: CoordsFloat – Generic FP type for coordinates.

Example

use honeycomb_core::geometry::{Vector2, Vertex2};

let v1 = Vertex2(1.0, 0.0);
let v2 = Vertex2(1.0, 1.0);

assert_eq!(v1.x(), 1.0);
assert_eq!(v1.y(), 0.0);

let two: f64 = 2.0;
// vectorAB = vertexB - vertexA
let v2_minus_v1: Vector2<f64> = v2 - v1;

assert_eq!(v2_minus_v1.norm(), 1.0);
assert_eq!(v2_minus_v1.unit_dir()?, Vector2::unit_y());

let mut v3 = Vertex2(0.0, 1.0);
// vertexA + vectorB = vertexA'
v3 += v2_minus_v1;

assert_eq!(v3.x(), 0.0);
assert_eq!(v3.y(), 2.0);

Tuple Fields

0: T

1: T

Implementations

impl<T: CoordsFloat> Vertex2<T>

pub fn into_inner(self) -> (T, T)

Consume self to return inner values.

pub fn to_f32(self) -> Option<Vertex2<f32>>

Cast self to f32 coordinates.

pub fn to_f64(self) -> Option<Vertex2<f64>>

Cast self to f64 coordinates.

pub fn x(&self) -> T

Return the value of the x coordinate of the vertex.

pub fn y(&self) -> T

Return the value of the y coordinate of the vertex.

pub fn average(lhs: &Vertex2<T>, rhs: &Vertex2<T>) -> Vertex2<T>

Compute the mid-point between two vertices.

Panics

This function may panic if it cannot initialize an object T: CoordsFloat from the value 2.0. The chance of this happening when using T = f64 or T = f32 is most likely zero.

Example

use honeycomb_core::geometry::Vertex2;

let far_far_away: Vertex2<f64> = Vertex2(2.0, 2.0);
let origin: Vertex2<f64> = Vertex2::default();

assert_eq!(Vertex2::average(&origin, &far_far_away), Vertex2(1.0, 1.0));

pub fn cross_product_from_vertices(v1: &Self, v2: &Self, v3: &Self) -> T

Compute the scalar component of the v1v2 x v2v3 cross product.

Trait Implementations

impl<T: CoordsFloat> Add<&Vector2<T>> for Vertex2<T>

type Output = Vertex2<T>

The resulting type after applying the + operator.

fn add(self, rhs: &Vector2<T>) -> Self::Output

Performs the + operation.

impl<T: CoordsFloat> Add<Vector2<T>> for Vertex2<T>

type Output = Vertex2<T>

The resulting type after applying the + operator.

fn add(self, rhs: Vector2<T>) -> Self::Output

Performs the + operation.

impl<T: CoordsFloat> AddAssign<&Vector2<T>> for Vertex2<T>

fn add_assign(&mut self, rhs: &Vector2<T>)

Performs the += operation.

impl<T: CoordsFloat> AddAssign<Vector2<T>> for Vertex2<T>

fn add_assign(&mut self, rhs: Vector2<T>)

Performs the += operation.

impl<T: CoordsFloat> AttributeBind for Vertex2<T>

const BIND_POLICY: OrbitPolicy = OrbitPolicy::Vertex

OrbitPolicy determining the kind of topological entity to which the attribute is associated.

type StorageType = AttrSparseVec<Vertex2<T>>

Storage type used for the attribute.

type IdentifierType = u32

Identifier type of the entity the attribute is bound to.

impl<T: CoordsFloat> AttributeUpdate for Vertex2<T>

fn merge(attr1: Self, attr2: Self) -> Result<Self, AttributeError>

Merging routine, i.e. how to obtain a new value from two existing ones.

fn split(attr: Self) -> Result<(Self, Self), AttributeError>

Splitting routine, i.e. how to obtain the two new values from a single one.

fn merge_incomplete(attr: Self) -> Result<Self, AttributeError>

Fallback merging routine, i.e. how to obtain a new value from a single existing one.

fn merge_from_none() -> Result<Self, AttributeError>

Fallback merging routine, i.e. how to obtain a new value from no existing one.

fn split_from_none() -> Result<(Self, Self), AttributeError>

Fallback splitting routine, i.e. how to obtain two new values from no existing one.

impl<T: Clone + CoordsFloat> Clone for Vertex2<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + CoordsFloat> Debug for Vertex2<T>

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

Formats the value using the given formatter.

impl<T: Default + CoordsFloat> Default for Vertex2<T>

fn default() -> Vertex2<T>

Returns the “default value” for a type.

impl<T: CoordsFloat> From<(T, T)> for Vertex2<T>

fn from((x, y): (T, T)) -> Self

Converts to this type from the input type.

impl<T: CoordsFloat> From<Vertex2<T>> for Vertex3<T>

fn from(v: Vertex2<T>) -> Self

Converts to this type from the input type.

impl<T: PartialEq + CoordsFloat> PartialEq for Vertex2<T>

fn eq(&self, other: &Vertex2<T>) -> 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<T: CoordsFloat> Sub<&Vector2<T>> for Vertex2<T>

type Output = Vertex2<T>

The resulting type after applying the - operator.

fn sub(self, rhs: &Vector2<T>) -> Self::Output

Performs the - operation.

impl<T: CoordsFloat> Sub<Vector2<T>> for Vertex2<T>

type Output = Vertex2<T>

The resulting type after applying the - operator.

fn sub(self, rhs: Vector2<T>) -> Self::Output

Performs the - operation.

impl<T: CoordsFloat> Sub for Vertex2<T>

type Output = Vector2<T>

The resulting type after applying the - operator.

fn sub(self, rhs: Vertex2<T>) -> Self::Output

Performs the - operation.

impl<T: CoordsFloat> SubAssign<&Vector2<T>> for Vertex2<T>

fn sub_assign(&mut self, rhs: &Vector2<T>)

Performs the -= operation.

impl<T: CoordsFloat> SubAssign<Vector2<T>> for Vertex2<T>

fn sub_assign(&mut self, rhs: Vector2<T>)

Performs the -= operation.

impl<T: Copy + CoordsFloat> Copy for Vertex2<T>

impl<T: CoordsFloat> Send for Vertex2<T>

impl<T: CoordsFloat> StructuralPartialEq for Vertex2<T>

impl<T: CoordsFloat> Sync for Vertex2<T>