use super::*; /// An absolute length. #[derive(Default, Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)] #[derive(Serialize, Deserialize)] #[serde(transparent)] pub struct Length(N64); impl Length { /// The zero length. pub fn zero() -> Self { Self(N64::from(0.0)) } /// The inifinite length. pub fn inf() -> Self { Self(N64::from(f64::INFINITY)) } /// Create a length from a number of points. pub fn pt(pt: f64) -> Self { Self::with_unit(pt, LengthUnit::Pt) } /// Create a length from a number of millimeters. pub fn mm(mm: f64) -> Self { Self::with_unit(mm, LengthUnit::Mm) } /// Create a length from a number of centimeters. pub fn cm(cm: f64) -> Self { Self::with_unit(cm, LengthUnit::Cm) } /// Create a length from a number of inches. pub fn inches(inches: f64) -> Self { Self::with_unit(inches, LengthUnit::In) } /// Create a length from a number of raw units. pub fn raw(raw: f64) -> Self { Self(N64::from(raw)) } /// Convert this to a number of points. pub fn to_pt(self) -> f64 { self.to_unit(LengthUnit::Pt) } /// Convert this to a number of millimeters. pub fn to_mm(self) -> f64 { self.to_unit(LengthUnit::Mm) } /// Convert this to a number of centimeters. pub fn to_cm(self) -> f64 { self.to_unit(LengthUnit::Cm) } /// Convert this to a number of inches. pub fn to_inches(self) -> f64 { self.to_unit(LengthUnit::In) } /// Get the value of this length in raw units. pub fn to_raw(self) -> f64 { self.0.into() } /// Create a length from a value in a unit. pub fn with_unit(val: f64, unit: LengthUnit) -> Self { Self(N64::from(val * unit.raw_scale())) } /// Get the value of this length in unit. pub fn to_unit(self, unit: LengthUnit) -> f64 { self.to_raw() / unit.raw_scale() } /// Whether the length is zero. pub fn is_zero(self) -> bool { self.0 == 0.0 } /// Whether the length is finite. pub fn is_finite(self) -> bool { self.0.into_inner().is_finite() } /// Whether the length is infinite. pub fn is_infinite(self) -> bool { self.0.into_inner().is_infinite() } /// The absolute value of the this length. pub fn abs(self) -> Self { Self::raw(self.to_raw().abs()) } /// The minimum of this and another length. pub fn min(self, other: Self) -> Self { Self(self.0.min(other.0)) } /// Set to the minimum of this and another length. pub fn set_min(&mut self, other: Self) { *self = (*self).min(other); } /// The maximum of this and another length. pub fn max(self, other: Self) -> Self { Self(self.0.max(other.0)) } /// Set to the maximum of this and another length. pub fn set_max(&mut self, other: Self) { *self = (*self).max(other); } /// Whether the other length fits into this one (i.e. is smaller). pub fn fits(self, other: Self) -> bool { self.0 + 1e-6 >= other.0 } /// Compares two lengths for whether they are approximately equal. pub fn approx_eq(self, other: Self) -> bool { self == other || (self - other).to_raw().abs() < 1e-6 } /// Perform a checked division by a number, returning `None` if the result /// is not finite. pub fn div_finite(self, number: f64) -> Option { let result = self.to_raw() / number; result.is_finite().then(|| Self::raw(result)) } } impl Debug for Length { fn fmt(&self, f: &mut Formatter) -> fmt::Result { use LengthUnit::*; // Format with the unit that yields the shortest output, preferring // larger / metric units when tied. let unit = [Cm, Mm, In, Pt] .iter() .copied() .min_by_key(|&unit| self.to_unit(unit).to_string().len()) .unwrap(); write!(f, "{}{:?}", self.to_unit(unit), unit) } } impl Neg for Length { type Output = Self; fn neg(self) -> Self { Self(-self.0) } } impl Add for Length { type Output = Self; fn add(self, other: Self) -> Self { Self(self.0 + other.0) } } sub_impl!(Length - Length -> Length); impl Mul for Length { type Output = Self; fn mul(self, other: f64) -> Self { Self(self.0 * other) } } impl Mul for f64 { type Output = Length; fn mul(self, other: Length) -> Length { other * self } } impl Div for Length { type Output = Self; fn div(self, other: f64) -> Self { Self(self.0 / other) } } impl Div for Length { type Output = f64; fn div(self, other: Self) -> f64 { self.to_raw() / other.to_raw() } } assign_impl!(Length += Length); assign_impl!(Length -= Length); assign_impl!(Length *= f64); assign_impl!(Length /= f64); impl Sum for Length { fn sum>(iter: I) -> Self { iter.fold(Length::zero(), Add::add) } } impl<'a> Sum<&'a Length> for Length { fn sum>(iter: I) -> Self { iter.copied().fold(Length::zero(), Add::add) } } /// Different units of length measurement. #[derive(Copy, Clone, Eq, PartialEq)] pub enum LengthUnit { /// Points. Pt, /// Millimeters. Mm, /// Centimeters. Cm, /// Inches. In, } impl LengthUnit { /// How many raw units correspond to a value of `1.0` in this unit. fn raw_scale(self) -> f64 { match self { LengthUnit::Pt => 1.0, LengthUnit::Mm => 2.83465, LengthUnit::Cm => 28.3465, LengthUnit::In => 72.0, } } } impl Debug for LengthUnit { fn fmt(&self, f: &mut Formatter) -> fmt::Result { f.pad(match self { LengthUnit::Mm => "mm", LengthUnit::Pt => "pt", LengthUnit::Cm => "cm", LengthUnit::In => "in", }) } } #[cfg(test)] mod tests { use super::*; #[test] fn test_length_unit_conversion() { assert!((Length::mm(150.0).to_cm() - 15.0) < 1e-4); } #[test] fn test_length_formatting() { assert_eq!(format!("{:?}", Length::pt(23.0)), "23pt"); assert_eq!(format!("{:?}", Length::pt(-28.3465)), "-1cm"); assert_eq!(format!("{:?}", Length::cm(12.728)), "12.728cm"); assert_eq!(format!("{:?}", Length::cm(4.5)), "45mm"); } }