grass/src/unit/mod.rs

318 lines
9.3 KiB
Rust
Raw Normal View History

use std::fmt;
2020-07-08 21:39:30 -04:00
use crate::interner::InternedString;
pub(crate) use conversion::{known_compatibilities_by_unit, UNIT_CONVERSION_TABLE};
mod conversion;
2022-12-27 19:09:43 -05:00
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub(crate) enum Unit {
// Absolute units
/// Pixels
Px,
/// Millimeters
Mm,
/// Inches
In,
/// Centimeters
Cm,
/// Quarter-millimeters
Q,
/// Points
Pt,
/// Picas
Pc,
2020-01-25 10:11:26 -05:00
// Font relative units
/// Font size of the parent element
Em,
/// Font size of the root element
Rem,
/// Line height of the element
Lh,
/// x-height of the element's font
Ex,
/// The advance measure (width) of the glyph "0" of the element's font
Ch,
/// Represents the "cap height" (nominal height of capital letters) of the element's font
Cap,
/// Equal to the used advance measure of the "水" (CJK water ideograph, U+6C34) glyph
/// found in the font used to render it
Ic,
/// Equal to the computed value of the line-height property on the root element
/// (typically <html>), converted to an absolute length
Rlh,
// Viewport relative units
/// 1% of the viewport's width
Vw,
/// 1% of the viewport's height
Vh,
/// 1% of the viewport's smaller dimension
Vmin,
/// 1% of the viewport's larger dimension
Vmax,
/// Equal to 1% of the size of the initial containing block, in the direction of the root
/// element's inline axis
Vi,
/// Equal to 1% of the size of the initial containing block, in the direction of the root
/// element's block axis
Vb,
// Angle units
/// Represents an angle in degrees. One full circle is 360deg
Deg,
/// Represents an angle in gradians. One full circle is 400grad
Grad,
/// Represents an angle in radians. One full circle is 2π radians which approximates to 6.283rad
Rad,
/// Represents an angle in a number of turns. One full circle is 1turn
Turn,
// Time units
/// Represents a time in seconds
S,
/// Represents a time in milliseconds
Ms,
// Frequency units
/// Represents a frequency in hertz
Hz,
/// Represents a frequency in kilohertz
Khz,
// Resolution units
/// Represents the number of dots per inch
Dpi,
/// Represents the number of dots per centimeter
Dpcm,
/// Represents the number of dots per px unit
Dppx,
2020-01-25 10:11:26 -05:00
// Other units
/// Represents a fraction of the available space in the grid container
Fr,
Percent,
2020-01-22 00:54:43 -05:00
/// Unknown unit
2020-07-08 21:39:30 -04:00
Unknown(InternedString),
/// Unspecified unit
None,
2020-03-16 21:29:00 -04:00
2022-12-27 19:09:43 -05:00
Complex(Box<ComplexUnit>),
}
#[derive(Clone, Debug, PartialEq, Eq, Hash)]
pub(crate) struct ComplexUnit {
pub(crate) numer: Vec<Unit>,
pub(crate) denom: Vec<Unit>,
}
pub(crate) fn are_any_convertible(units1: &[Unit], units2: &[Unit]) -> bool {
for unit1 in units1 {
for unit2 in units2 {
if unit1.comparable(unit2) {
return true;
}
}
}
2020-07-04 11:04:51 -04:00
false
}
#[derive(Debug, Copy, Clone, Eq, PartialEq)]
pub(crate) enum UnitKind {
Absolute,
FontRelative,
ViewportRelative,
Angle,
Time,
Frequency,
Resolution,
Other,
None,
}
impl Unit {
pub fn new(mut numer: Vec<Self>, denom: Vec<Self>) -> Self {
if denom.is_empty() && numer.is_empty() {
Unit::None
} else if denom.is_empty() && numer.len() == 1 {
numer.pop().unwrap()
2020-07-04 11:04:51 -04:00
} else {
2022-12-27 19:09:43 -05:00
Unit::Complex(Box::new(ComplexUnit { numer, denom }))
2020-07-04 11:04:51 -04:00
}
}
pub fn numer_and_denom(self) -> (Vec<Unit>, Vec<Unit>) {
match self {
2022-12-27 19:09:43 -05:00
Self::Complex(complex) => (complex.numer, complex.denom),
Self::None => (Vec::new(), Vec::new()),
v => (vec![v], Vec::new()),
2020-07-04 11:04:51 -04:00
}
}
pub fn invert(self) -> Self {
let (numer, denom) = self.numer_and_denom();
2020-07-04 11:04:51 -04:00
Self::new(denom, numer)
2020-07-04 11:04:51 -04:00
}
pub fn is_complex(&self) -> bool {
2022-12-27 19:09:43 -05:00
matches!(self, Unit::Complex(complex) if complex.numer.len() != 1 || !complex.denom.is_empty())
2020-07-04 11:04:51 -04:00
}
pub fn comparable(&self, other: &Unit) -> bool {
2020-03-31 02:10:22 -04:00
if other == &Unit::None {
return true;
}
match self.kind() {
UnitKind::FontRelative | UnitKind::ViewportRelative | UnitKind::Other => self == other,
UnitKind::None => true,
2020-03-31 02:10:22 -04:00
u => other.kind() == u,
}
}
/// Used internally to determine if two units are comparable or not
fn kind(&self) -> UnitKind {
match self {
2020-02-16 11:59:04 -05:00
Unit::Px | Unit::Mm | Unit::In | Unit::Cm | Unit::Q | Unit::Pt | Unit::Pc => {
UnitKind::Absolute
}
Unit::Em
| Unit::Rem
| Unit::Lh
| Unit::Ex
| Unit::Ch
| Unit::Cap
| Unit::Ic
| Unit::Rlh => UnitKind::FontRelative,
2020-02-16 11:59:04 -05:00
Unit::Vw | Unit::Vh | Unit::Vmin | Unit::Vmax | Unit::Vi | Unit::Vb => {
UnitKind::ViewportRelative
}
Unit::Deg | Unit::Grad | Unit::Rad | Unit::Turn => UnitKind::Angle,
Unit::S | Unit::Ms => UnitKind::Time,
Unit::Hz | Unit::Khz => UnitKind::Frequency,
Unit::Dpi | Unit::Dpcm | Unit::Dppx => UnitKind::Resolution,
Unit::None => UnitKind::None,
Unit::Fr | Unit::Percent | Unit::Unknown(..) | Unit::Complex { .. } => UnitKind::Other,
}
}
}
2020-05-06 12:01:40 -04:00
impl From<String> for Unit {
fn from(unit: String) -> Self {
match unit.to_ascii_lowercase().as_str() {
"px" => Unit::Px,
"mm" => Unit::Mm,
"in" => Unit::In,
"cm" => Unit::Cm,
"q" => Unit::Q,
"pt" => Unit::Pt,
"pc" => Unit::Pc,
"em" => Unit::Em,
"rem" => Unit::Rem,
"lh" => Unit::Lh,
"%" => Unit::Percent,
"ex" => Unit::Ex,
"ch" => Unit::Ch,
"cap" => Unit::Cap,
"ic" => Unit::Ic,
"rlh" => Unit::Rlh,
"vw" => Unit::Vw,
"vh" => Unit::Vh,
"vmin" => Unit::Vmin,
"vmax" => Unit::Vmax,
"vi" => Unit::Vi,
"vb" => Unit::Vb,
"deg" => Unit::Deg,
"grad" => Unit::Grad,
"rad" => Unit::Rad,
"turn" => Unit::Turn,
"s" => Unit::S,
"ms" => Unit::Ms,
"hz" => Unit::Hz,
"khz" => Unit::Khz,
"dpi" => Unit::Dpi,
"dpcm" => Unit::Dpcm,
"dppx" => Unit::Dppx,
"fr" => Unit::Fr,
2020-07-08 21:39:30 -04:00
_ => Unit::Unknown(InternedString::get_or_intern(unit)),
}
}
}
impl fmt::Display for Unit {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
match self {
Unit::Px => write!(f, "px"),
Unit::Mm => write!(f, "mm"),
Unit::In => write!(f, "in"),
Unit::Cm => write!(f, "cm"),
Unit::Q => write!(f, "q"),
Unit::Pt => write!(f, "pt"),
Unit::Pc => write!(f, "pc"),
Unit::Em => write!(f, "em"),
Unit::Rem => write!(f, "rem"),
Unit::Lh => write!(f, "lh"),
Unit::Percent => write!(f, "%"),
Unit::Ex => write!(f, "ex"),
Unit::Ch => write!(f, "ch"),
Unit::Cap => write!(f, "cap"),
Unit::Ic => write!(f, "ic"),
Unit::Rlh => write!(f, "rlh"),
Unit::Vw => write!(f, "vw"),
Unit::Vh => write!(f, "vh"),
Unit::Vmin => write!(f, "vmin"),
Unit::Vmax => write!(f, "vmax"),
Unit::Vi => write!(f, "vi"),
Unit::Vb => write!(f, "vb"),
Unit::Deg => write!(f, "deg"),
Unit::Grad => write!(f, "grad"),
Unit::Rad => write!(f, "rad"),
Unit::Turn => write!(f, "turn"),
Unit::S => write!(f, "s"),
Unit::Ms => write!(f, "ms"),
Unit::Hz => write!(f, "Hz"),
Unit::Khz => write!(f, "kHz"),
Unit::Dpi => write!(f, "dpi"),
Unit::Dpcm => write!(f, "dpcm"),
2020-01-17 14:44:55 -05:00
Unit::Dppx => write!(f, "dppx"),
Unit::Fr => write!(f, "fr"),
2020-01-22 00:54:43 -05:00
Unit::Unknown(s) => write!(f, "{}", s),
2020-05-06 12:01:40 -04:00
Unit::None => Ok(()),
2022-12-27 19:09:43 -05:00
Unit::Complex(complex) => {
let numer = &complex.numer;
let denom = &complex.denom;
debug_assert!(
numer.len() > 1 || !denom.is_empty(),
"unsimplified complex unit"
);
let numer_rendered = numer
.iter()
.map(ToString::to_string)
.collect::<Vec<String>>()
.join("*");
let denom_rendered = denom
.iter()
2020-03-18 20:11:14 -04:00
.map(ToString::to_string)
.collect::<Vec<String>>()
.join("*");
if denom.is_empty() {
write!(f, "{}", numer_rendered)
} else if numer.is_empty() && denom.len() == 1 {
write!(f, "{}^-1", denom_rendered)
} else if numer.is_empty() {
write!(f, "({})^-1", denom_rendered)
} else {
write!(f, "{}/{}", numer_rendered, denom_rendered)
}
}
}
}
}