Struct fj_math::Line

#[repr(C)]
pub struct Line<const D: usize> { /* private fields */ }

An n-dimensional line, defined by an origin and a direction

The dimensionality of the line is defined by the const generic D parameter.

Implementations

impl<const D: usize> Line<D>

pub fn from_origin_and_direction(origin: Point<D>, direction: Vector<D>) -> Self

Create a line from a point and a vector

Panics

Panics, if direction has a length of zero.

pub fn from_points(points: [impl Into<Point<D>>; 2]) -> (Self, [Point<1>; 2])

Create a line from two points

Also returns the lines coordinates of the provided points on the new line.

Panics

Panics, if the points are coincident.

pub fn from_points_with_line_coords( points: [(impl Into<Point<1>>, impl Into<Point<D>>); 2] ) -> Self

Create a line from two points that include line coordinates

Panics

Panics, if the points are coincident.

pub fn origin(&self) -> Point<D>

Access the origin of the line

The origin is a point on the line which, together with the direction field, defines the line fully. The origin also defines the origin of the line’s 1-dimensional coordinate system.

pub fn direction(&self) -> Vector<D>

Access the direction of the line

The length of this vector defines the unit of the line’s curve coordinate system. The coordinate 1. is always where the direction vector points, from origin.

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

Determine if this line is coincident with another line

Implementation Note

This method only returns true, if the lines are precisely coincident. This will probably not be enough going forward, but it’ll do for now.

pub fn reverse(self) -> Self

Create a new instance that is reversed

pub fn point_to_line_coords(&self, point: impl Into<Point<D>>) -> Point<1>

Convert a D-dimensional point to line coordinates

Projects the point onto the line before the conversion. This is done to make this method robust against floating point accuracy issues.

Callers are advised to be careful about the points they pass, as the point not being on the line, intentional or not, will never result in an error.

pub fn vector_to_line_coords(&self, vector: impl Into<Vector<D>>) -> Vector<1>

Convert a D-dimensional vector to line coordinates

pub fn point_from_line_coords(&self, point: impl Into<Point<1>>) -> Point<D>

Convert a point in line coordinates into a D-dimensional point

pub fn vector_from_line_coords(&self, vector: impl Into<Vector<1>>) -> Vector<D>

Convert a vector in line coordinates into a D-dimensional vector

Trait Implementations

impl<const D: usize> AbsDiffEq for Line<D>

type Epsilon = <Scalar as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_eq(&self, other: &Self, epsilon: Self::Epsilon) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.

fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

impl<const D: usize> Clone for Line<D>

fn clone(&self) -> Line<D>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const D: usize> Debug for Line<D>

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

Formats the value using the given formatter.

impl<const D: usize> Default for Line<D>

fn default() -> Line<D>

Returns the “default value” for a type.

impl<const D: usize> Hash for Line<D>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<const D: usize> Ord for Line<D>

fn cmp(&self, other: &Line<D>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl<const D: usize> PartialEq for Line<D>

fn eq(&self, other: &Line<D>) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<const D: usize> PartialOrd for Line<D>

fn partial_cmp(&self, other: &Line<D>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<const D: usize> Copy for Line<D>

impl<const D: usize> Eq for Line<D>

impl<const D: usize> StructuralPartialEq for Line<D>