//! Points on the 2D character grid. use XY; use num::traits::Zero; use std::cmp::{Ordering, max, min}; use std::ops::{Add, Div, Mul, Sub}; /// Simple 2D size, in cells. /// /// Note: due to a bug in rustdoc ([#32077]), the documentation for `Vec2` is /// currently shown on the [`XY`] page. /// /// [#32077]: https://github.com/rust-lang/rust/issues/32077 /// [`XY`]: ../struct.XY.html pub type Vec2 = XY; impl PartialOrd for XY { /// `a < b` <=> `a.x < b.x && a.y < b.y` fn partial_cmp(&self, other: &Vec2) -> Option { if self == other { Some(Ordering::Equal) } else if self.x < other.x && self.y < other.y { Some(Ordering::Less) } else if self.x > other.x && self.y > other.y { Some(Ordering::Greater) } else { None } } } impl XY { /// Returns `true` if `self` could fit inside `other`. /// /// Shortcut for `self.x <= other.x && self.y <= other.y`. pub fn fits_in>(&self, other: O) -> bool { let other = other.into(); self.x <= other.x && self.y <= other.y } /// Returns a new Vec2 that is a maximum per coordinate. pub fn max>, B: Into>>(a: A, b: B) -> Self { let a = a.into(); let b = b.into(); a.zip_map(b, max) } /// Returns a new Vec2 that is no larger than any input in both dimensions. pub fn min>, B: Into>>(a: A, b: B) -> Self { let a = a.into(); let b = b.into(); a.zip_map(b, min) } /// Returns the minimum of `self` and `other`. pub fn or_min>>(self, other: O) -> Self { Self::min(self, other) } /// Returns the maximum of `self` and `other`. pub fn or_max>>(self, other: O) -> Self { Self::max(self, other) } } impl + Clone> XY { /// Returns (max(self.x,other.x), self.y+other.y) pub fn stack_vertical(&self, other: &Self) -> Self { Self::new(max(self.x.clone(), other.x.clone()), self.y.clone() + other.y.clone()) } /// Returns (self.x+other.x, max(self.y,other.y)) pub fn stack_horizontal(&self, other: &Self) -> Self { Self::new(self.x.clone() + other.x.clone(), max(self.y.clone(), other.y.clone())) } } impl XY { /// Returns a vector with the X component of self, and y=0. pub fn keep_x(&self) -> Self { Self::new(self.x.clone(), T::zero()) } /// Returns a vector with the Y component of self, and x=0. pub fn keep_y(&self) -> Self { Self::new(T::zero(), self.y.clone()) } /// Alias for `Self::new(0,0)`. pub fn zero() -> Self { Self::new(T::zero(), T::zero()) } } impl>> From for XY { fn from(t: T) -> Self { let other = t.into(); Self::new(other.x as isize, other.y as isize) } } impl From<(i32, i32)> for XY { fn from((x, y): (i32, i32)) -> Self { (x as usize, y as usize).into() } } impl From<(u32, u32)> for XY { fn from((x, y): (u32, u32)) -> Self { (x as usize, y as usize).into() } } impl From<(u8, u8)> for XY { fn from((x, y): (u8, u8)) -> Self { (x as usize, y as usize).into() } } impl, O: Into>> Add for XY { type Output = Self; fn add(self, other: O) -> Self { self.zip_map(other.into(), Add::add) } } impl, O: Into>> Sub for XY { type Output = Self; fn sub(self, other: O) -> Self { self.zip_map(other.into(), Sub::sub) } } impl> Div for XY { type Output = Self; fn div(self, other: T) -> Self { self.map(|s| s / other.clone()) } } impl Mul for XY { type Output = Vec2; fn mul(self, other: usize) -> Vec2 { self.map(|s| s * other) } } /// Four values representing each direction. #[derive(Clone,Copy)] pub struct Vec4 { /// Left margin pub left: usize, /// Right margin pub right: usize, /// Top margin pub top: usize, /// Bottom margin pub bottom: usize, } impl Vec4 { /// Creates a new Vec4. pub fn new(left: usize, right: usize, top: usize, bottom: usize) -> Self { Vec4 { left: left, right: right, top: top, bottom: bottom, } } /// Returns left + right. pub fn horizontal(&self) -> usize { self.left + self.right } /// Returns top + bottom. pub fn vertical(&self) -> usize { self.top + self.bottom } /// Returns (left+right, top+bottom). pub fn combined(&self) -> Vec2 { Vec2::new(self.horizontal(), self.vertical()) } /// Returns (left, top). pub fn top_left(&self) -> Vec2 { Vec2::new(self.left, self.top) } /// Returns (right, bottom). pub fn bot_right(&self) -> Vec2 { Vec2::new(self.right, self.bottom) } } impl From<(usize, usize, usize, usize)> for Vec4 { fn from((left, right, top, bottom): (usize, usize, usize, usize)) -> Vec4 { Vec4::new(left, right, top, bottom) } } impl From<(i32, i32, i32, i32)> for Vec4 { fn from((left, right, top, bottom): (i32, i32, i32, i32)) -> Vec4 { (left as usize, right as usize, top as usize, bottom as usize).into() } } impl From<((i32, i32), (i32, i32))> for Vec4 { fn from(((left, right), (top, bottom)): ((i32, i32), (i32, i32))) -> Vec4 { (left, right, top, bottom).into() } } impl From<((usize, usize), (usize, usize))> for Vec4 { fn from(((left, right), (top, bottom)): ((usize, usize), (usize, usize))) -> Vec4 { (left, right, top, bottom).into() } } impl> Add for Vec4 { type Output = Vec4; fn add(self, other: T) -> Vec4 { let ov = other.into(); Vec4 { left: self.left + ov.left, right: self.right + ov.right, top: self.top + ov.top, bottom: self.bottom + ov.bottom, } } } impl> Sub for Vec4 { type Output = Vec4; fn sub(self, other: T) -> Vec4 { let ov = other.into(); Vec4 { left: self.left - ov.left, right: self.right - ov.right, top: self.top - ov.top, bottom: self.bottom - ov.bottom, } } } impl Div for Vec4 { type Output = Vec4; fn div(self, other: usize) -> Vec4 { Vec4 { left: self.left / other, right: self.right / other, top: self.top / other, bottom: self.bottom / other, } } } impl Mul for Vec4 { type Output = Vec4; fn mul(self, other: usize) -> Vec4 { Vec4 { left: self.left * other, right: self.right * other, top: self.top * other, bottom: self.bottom * other, } } } #[cfg(test)] mod tests { use super::Vec2; #[test] fn test_from() { let vi32 = Vec2::from((4i32, 5i32)); let vu32 = Vec2::from((4u32, 5u32)); let vusize = Vec2::from((4usize, 5usize)); let vvec = Vec2::from(Vec2::new(4, 5)); assert_eq!(vi32 - vu32, vusize - vvec); } }