2018-05-19 21:41:58 +08:00
|
|
|
use approx::{AbsDiffEq, RelativeEq, UlpsEq};
|
2016-12-05 05:44:42 +08:00
|
|
|
use num::One;
|
|
|
|
use std::cmp::Ordering;
|
2018-05-19 21:41:58 +08:00
|
|
|
use std::fmt;
|
|
|
|
use std::hash;
|
2018-07-20 21:25:55 +08:00
|
|
|
#[cfg(feature = "abomonation-serialize")]
|
|
|
|
use std::io::{Result as IOResult, Write};
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2017-05-04 10:02:30 +08:00
|
|
|
#[cfg(feature = "serde-serialize")]
|
2017-08-03 01:37:44 +08:00
|
|
|
use serde;
|
2017-05-04 10:02:30 +08:00
|
|
|
|
2017-08-14 18:18:47 +08:00
|
|
|
#[cfg(feature = "abomonation-serialize")]
|
|
|
|
use abomonation::Abomonation;
|
|
|
|
|
2018-05-19 23:15:15 +08:00
|
|
|
use base::allocator::Allocator;
|
|
|
|
use base::dimension::{DimName, DimNameAdd, DimNameSum, U1};
|
|
|
|
use base::iter::{MatrixIter, MatrixIterMut};
|
|
|
|
use base::{DefaultAllocator, Scalar, VectorN};
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2017-02-13 01:17:09 +08:00
|
|
|
/// A point in a n-dimensional euclidean space.
|
2016-12-05 05:44:42 +08:00
|
|
|
#[repr(C)]
|
2017-08-03 01:37:44 +08:00
|
|
|
#[derive(Debug)]
|
|
|
|
pub struct Point<N: Scalar, D: DimName>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
{
|
2017-02-13 01:17:09 +08:00
|
|
|
/// The coordinates of this point, i.e., the shift from the origin.
|
2018-02-02 19:26:35 +08:00
|
|
|
pub coords: VectorN<N, D>,
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar + hash::Hash, D: DimName + hash::Hash> hash::Hash for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
<DefaultAllocator as Allocator<N, D>>::Buffer: hash::Hash,
|
|
|
|
{
|
2017-08-03 01:37:44 +08:00
|
|
|
fn hash<H: hash::Hasher>(&self, state: &mut H) {
|
|
|
|
self.coords.hash(state)
|
|
|
|
}
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar, D: DimName> Copy for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
<DefaultAllocator as Allocator<N, D>>::Buffer: Copy,
|
|
|
|
{
|
|
|
|
}
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar, D: DimName> Clone for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
<DefaultAllocator as Allocator<N, D>>::Buffer: Clone,
|
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
|
|
|
fn clone(&self) -> Self {
|
2017-08-03 01:37:44 +08:00
|
|
|
Point::from_coordinates(self.coords.clone())
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-05-04 10:02:30 +08:00
|
|
|
#[cfg(feature = "serde-serialize")]
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar, D: DimName> serde::Serialize for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
<DefaultAllocator as Allocator<N, D>>::Buffer: serde::Serialize,
|
|
|
|
{
|
2017-08-03 01:37:44 +08:00
|
|
|
fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
S: serde::Serializer,
|
|
|
|
{
|
|
|
|
self.coords.serialize(serializer)
|
|
|
|
}
|
2017-05-04 10:02:30 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
#[cfg(feature = "serde-serialize")]
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<'a, N: Scalar, D: DimName> serde::Deserialize<'a> for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
<DefaultAllocator as Allocator<N, D>>::Buffer: serde::Deserialize<'a>,
|
|
|
|
{
|
2017-08-03 01:37:44 +08:00
|
|
|
fn deserialize<Des>(deserializer: Des) -> Result<Self, Des::Error>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
Des: serde::Deserializer<'a>,
|
|
|
|
{
|
|
|
|
let coords = VectorN::<N, D>::deserialize(deserializer)?;
|
2017-08-03 01:37:44 +08:00
|
|
|
|
2018-02-02 19:26:35 +08:00
|
|
|
Ok(Point::from_coordinates(coords))
|
|
|
|
}
|
2017-05-04 10:02:30 +08:00
|
|
|
}
|
|
|
|
|
2017-08-14 18:18:47 +08:00
|
|
|
#[cfg(feature = "abomonation-serialize")]
|
2017-08-16 01:36:38 +08:00
|
|
|
impl<N, D> Abomonation for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
N: Scalar,
|
|
|
|
D: DimName,
|
|
|
|
VectorN<N, D>: Abomonation,
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
2017-08-14 18:18:47 +08:00
|
|
|
{
|
2018-07-20 21:25:55 +08:00
|
|
|
unsafe fn entomb<W: Write>(&self, writer: &mut W) -> IOResult<()> {
|
2017-08-14 18:18:47 +08:00
|
|
|
self.coords.entomb(writer)
|
|
|
|
}
|
|
|
|
|
2018-07-20 21:25:55 +08:00
|
|
|
fn extent(&self) -> usize {
|
|
|
|
self.coords.extent()
|
2017-08-14 18:18:47 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
unsafe fn exhume<'a, 'b>(&'a mut self, bytes: &'b mut [u8]) -> Option<&'b mut [u8]> {
|
|
|
|
self.coords.exhume(bytes)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar, D: DimName> Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
{
|
2017-08-03 01:37:44 +08:00
|
|
|
/// Clones this point into one that owns its data.
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
2017-08-03 01:37:44 +08:00
|
|
|
pub fn clone(&self) -> Point<N, D> {
|
|
|
|
Point::from_coordinates(self.coords.clone_owned())
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
/// Converts this point into a vector in homogeneous coordinates, i.e., appends a `1` at the
|
|
|
|
/// end of it.
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
2017-08-03 01:37:44 +08:00
|
|
|
pub fn to_homogeneous(&self) -> VectorN<N, DimNameSum<D, U1>>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
N: One,
|
|
|
|
D: DimNameAdd<U1>,
|
|
|
|
DefaultAllocator: Allocator<N, DimNameSum<D, U1>>,
|
|
|
|
{
|
|
|
|
let mut res = unsafe { VectorN::<_, DimNameSum<D, U1>>::new_uninitialized() };
|
2017-08-03 01:37:44 +08:00
|
|
|
res.fixed_slice_mut::<D, U1>(0, 0).copy_from(&self.coords);
|
|
|
|
res[(D::dim(), 0)] = N::one();
|
|
|
|
|
|
|
|
res
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
/// Creates a new point with the given coordinates.
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
2017-08-03 01:37:44 +08:00
|
|
|
pub fn from_coordinates(coords: VectorN<N, D>) -> Point<N, D> {
|
2018-02-02 19:26:35 +08:00
|
|
|
Point { coords: coords }
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
/// The dimension of this point.
|
|
|
|
#[inline]
|
|
|
|
pub fn len(&self) -> usize {
|
|
|
|
self.coords.len()
|
|
|
|
}
|
|
|
|
|
|
|
|
/// The stride of this point. This is the number of buffer element separating each component of
|
|
|
|
/// this point.
|
|
|
|
#[inline]
|
|
|
|
pub fn stride(&self) -> usize {
|
|
|
|
self.coords.strides().0
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Iterates through this point coordinates.
|
|
|
|
#[inline]
|
2017-08-03 01:37:44 +08:00
|
|
|
pub fn iter(&self) -> MatrixIter<N, D, U1, <DefaultAllocator as Allocator<N, D>>::Buffer> {
|
2016-12-05 05:44:42 +08:00
|
|
|
self.coords.iter()
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Gets a reference to i-th element of this point without bound-checking.
|
|
|
|
#[inline]
|
|
|
|
pub unsafe fn get_unchecked(&self, i: usize) -> &N {
|
2017-08-03 01:37:44 +08:00
|
|
|
self.coords.vget_unchecked(i)
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
/// Mutably iterates through this point coordinates.
|
|
|
|
#[inline]
|
2018-02-02 19:26:35 +08:00
|
|
|
pub fn iter_mut(
|
|
|
|
&mut self,
|
|
|
|
) -> MatrixIterMut<N, D, U1, <DefaultAllocator as Allocator<N, D>>::Buffer> {
|
2016-12-05 05:44:42 +08:00
|
|
|
self.coords.iter_mut()
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Gets a mutable reference to i-th element of this point without bound-checking.
|
|
|
|
#[inline]
|
|
|
|
pub unsafe fn get_unchecked_mut(&mut self, i: usize) -> &mut N {
|
2017-08-03 01:37:44 +08:00
|
|
|
self.coords.vget_unchecked_mut(i)
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
/// Swaps two entries without bound-checking.
|
|
|
|
#[inline]
|
|
|
|
pub unsafe fn swap_unchecked(&mut self, i1: usize, i2: usize) {
|
|
|
|
self.coords.swap_unchecked((i1, 0), (i2, 0))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-05-19 21:41:58 +08:00
|
|
|
impl<N: Scalar + AbsDiffEq, D: DimName> AbsDiffEq for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
N::Epsilon: Copy,
|
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
type Epsilon = N::Epsilon;
|
|
|
|
|
|
|
|
#[inline]
|
|
|
|
fn default_epsilon() -> Self::Epsilon {
|
|
|
|
N::default_epsilon()
|
|
|
|
}
|
|
|
|
|
|
|
|
#[inline]
|
2018-05-19 21:41:58 +08:00
|
|
|
fn abs_diff_eq(&self, other: &Self, epsilon: Self::Epsilon) -> bool {
|
|
|
|
self.coords.abs_diff_eq(&other.coords, epsilon)
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
2018-05-19 21:41:58 +08:00
|
|
|
}
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2018-05-19 21:41:58 +08:00
|
|
|
impl<N: Scalar + RelativeEq, D: DimName> RelativeEq for Point<N, D>
|
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
N::Epsilon: Copy,
|
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
2018-05-19 21:41:58 +08:00
|
|
|
fn default_max_relative() -> Self::Epsilon {
|
|
|
|
N::default_max_relative()
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
#[inline]
|
2018-02-02 19:26:35 +08:00
|
|
|
fn relative_eq(
|
|
|
|
&self,
|
|
|
|
other: &Self,
|
|
|
|
epsilon: Self::Epsilon,
|
|
|
|
max_relative: Self::Epsilon,
|
|
|
|
) -> bool {
|
|
|
|
self.coords
|
|
|
|
.relative_eq(&other.coords, epsilon, max_relative)
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
2018-05-19 21:41:58 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
impl<N: Scalar + UlpsEq, D: DimName> UlpsEq for Point<N, D>
|
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
N::Epsilon: Copy,
|
|
|
|
{
|
|
|
|
#[inline]
|
|
|
|
fn default_max_ulps() -> u32 {
|
|
|
|
N::default_max_ulps()
|
|
|
|
}
|
2016-12-05 05:44:42 +08:00
|
|
|
|
|
|
|
#[inline]
|
|
|
|
fn ulps_eq(&self, other: &Self, epsilon: Self::Epsilon, max_ulps: u32) -> bool {
|
|
|
|
self.coords.ulps_eq(&other.coords, epsilon, max_ulps)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar + Eq, D: DimName> Eq for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
{
|
|
|
|
}
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar, D: DimName> PartialEq for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
|
|
|
fn eq(&self, right: &Self) -> bool {
|
|
|
|
self.coords == right.coords
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar + PartialOrd, D: DimName> PartialOrd for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
|
|
|
fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
|
|
|
|
self.coords.partial_cmp(&other.coords)
|
|
|
|
}
|
|
|
|
|
|
|
|
#[inline]
|
|
|
|
fn lt(&self, right: &Self) -> bool {
|
|
|
|
self.coords.lt(&right.coords)
|
|
|
|
}
|
|
|
|
|
|
|
|
#[inline]
|
|
|
|
fn le(&self, right: &Self) -> bool {
|
|
|
|
self.coords.le(&right.coords)
|
|
|
|
}
|
|
|
|
|
|
|
|
#[inline]
|
|
|
|
fn gt(&self, right: &Self) -> bool {
|
|
|
|
self.coords.gt(&right.coords)
|
|
|
|
}
|
|
|
|
|
|
|
|
#[inline]
|
|
|
|
fn ge(&self, right: &Self) -> bool {
|
|
|
|
self.coords.ge(&right.coords)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
*
|
|
|
|
* Display
|
|
|
|
*
|
|
|
|
*/
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Scalar + fmt::Display, D: DimName> fmt::Display for Point<N, D>
|
2018-02-02 19:26:35 +08:00
|
|
|
where
|
|
|
|
DefaultAllocator: Allocator<N, D>,
|
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
|
|
try!(write!(f, "{{"));
|
|
|
|
|
|
|
|
let mut it = self.coords.iter();
|
|
|
|
|
|
|
|
try!(write!(f, "{}", *it.next().unwrap()));
|
|
|
|
|
|
|
|
for comp in it {
|
|
|
|
try!(write!(f, ", {}", *comp));
|
|
|
|
}
|
|
|
|
|
|
|
|
write!(f, "}}")
|
|
|
|
}
|
|
|
|
}
|