Struct Unit 

pub struct Unit {
    pub values: Vec<f64>,
    pub units: Vec<UnitType>,
}

A grid unit — one or more (value, type) pairs representing a measurement.

Like R’s unit(), a Unit can contain multiple values with different types. Arithmetic on units produces compound units: unit(1, "cm") + unit(2, "mm") becomes a single Unit with two entries that are summed at resolution time.

Fields

values: Vec<f64>

The numeric values.

units: Vec<UnitType>

The unit type for each value (parallel to values).

Implementations

impl Unit

pub fn new(value: f64, unit_type: UnitType) -> Self

Create a unit with a single value and type.

pub fn npc(value: f64) -> Self

Shorthand: normalized parent coordinates.

pub fn cm(value: f64) -> Self

Shorthand: centimeters.

pub fn inches(value: f64) -> Self

Shorthand: inches.

pub fn mm(value: f64) -> Self

Shorthand: millimeters.

pub fn points(value: f64) -> Self

Shorthand: points (1/72 inch).

pub fn lines(value: f64) -> Self

Shorthand: text line heights.

pub fn null(value: f64) -> Self

Shorthand: null (flexible/proportional) unit.

pub fn value(&self) -> f64

Get the first scalar value (for simple single-value units like unit(7, "cm")).

pub fn len(&self) -> usize

Number of (value, type) pairs in this unit.

pub fn is_empty(&self) -> bool

Whether this unit contains no values.

pub fn is_absolute(&self) -> bool

Whether all component unit types are absolute (no viewport/data dependency).

pub fn to_cm(&self, ctx: &UnitContext, axis: Axis) -> Vec<f64>

Resolve all values to centimeters along the given axis.

For a compound unit (created by + or -), the result is a single value: the sum of all component values converted to cm. For a simple unit, returns a one-element vector.

pub fn to_cm_scalar(&self, ctx: &UnitContext, axis: Axis) -> f64

Resolve to a single cm value by summing all components.

This is the most common usage: a compound unit like unit(1, "cm") + unit(5, "mm") resolves to 1.5 cm.

pub fn scale(self, factor: f64) -> Self

Scalar multiply: scale all values by a factor.

Trait Implementations

impl Add for Unit

type Output = Unit

The resulting type after applying the + operator.

fn add(self, rhs: Unit) -> Unit

Performs the + operation.

impl Clone for Unit

fn clone(&self) -> Unit

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Unit

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Sub for Unit

type Output = Unit

The resulting type after applying the - operator.

fn sub(self, rhs: Unit) -> Unit

Performs the - operation.