//! Points on the 2D character grid. use XY; use direction::Orientation; 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 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: T) -> Self { Vec2::min(self, other) } /// Returns the maximum of `self` and `other`. pub fn or_max>(self, other: T) -> Self { Vec2::max(self, other) } /// Returns a vector with the X component of self, and y=0. pub fn keep_x(&self) -> Self { Vec2::new(self.x, 0) } /// Returns a vector with the Y component of self, and x=0. pub fn keep_y(&self) -> Self { Vec2::new(0, self.y) } /// Alias for `Vec2::new(0,0)`. pub fn zero() -> Self { Vec2::new(0, 0) } /// Returns (max(self.x,other.x), self.y+other.y) pub fn stack_vertical(&self, other: &Vec2) -> Vec2 { Vec2::new(max(self.x, other.x), self.y + other.y) } /// Returns (self.x+other.x, max(self.y,other.y)) pub fn stack_horizontal(&self, other: &Vec2) -> Vec2 { Vec2::new(self.x + other.x, max(self.y, other.y)) } /// Returns `true` if `self` could fit inside `other`. /// /// Shortcut for `self.x <= other.x && self.y <= other.y`. pub fn fits_in>(&self, other: T) -> bool { let other = other.into(); self.x <= other.x && self.y <= other.y } /// Returns a new `Vec2` with the axis `o` set to `value`. pub fn with_axis(&self, o: Orientation, value: usize) -> Self { let mut new = *self; *o.get_ref(&mut new) = value; new } /// Returns a new `Vec2` with the axis `o` set to the value from `other`. pub fn with_axis_from(&self, o: Orientation, other: &Vec2) -> Self { let mut new = *self; new.set_axis_from(o, other); new } /// Sets the axis `o` on `self` to the value from `other`. pub fn set_axis_from(&mut self, o: Orientation, other: &Vec2) { *o.get_ref(self) = o.get(other); } } 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> Add for XY { type Output = Vec2; fn add(self, other: T) -> Vec2 { self.zip_map(other.into(), Add::add) } } impl> Sub for XY { type Output = Vec2; fn sub(self, other: T) -> Vec2 { self.zip_map(other.into(), Sub::sub) } } impl Div for XY { type Output = Vec2; fn div(self, other: usize) -> Vec2 { self.map(|s| s / other) } } 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> 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); } }