Enum Length

pub enum Length {
    Default,
    Dip(Dip),
    Px(Px),
    Pt(f32),
    Factor(Factor),
    Leftover(Factor),
    Em(Factor),
    RootEm(Factor),
    ViewportWidth(Factor),
    ViewportHeight(Factor),
    ViewportMin(Factor),
    ViewportMax(Factor),
    DipF32(f32),
    PxF32(f32),
    Expr(Box<LengthExpr>),
}

1D length units.

See LengthUnits for more details.

Equality

Two lengths are equal if they are of the same variant and if:

• Dip and px lengths uses Dip and Px equality.
• Relative, Em, RootEm lengths use the Factor equality.
• Viewport lengths uses about_eq with 0.00001 epsilon.

Variants

Default

The default (initial) value.

Dip(Dip)

The exact length in device independent units.

Px(Px)

The exact length in device pixel units.

Pt(f32)

The exact length in font points.

Factor(Factor)

Relative to the fill length.

Leftover(Factor)

Relative to the leftover fill length.

Em(Factor)

Relative to the font-size of the widget.

RootEm(Factor)

Relative to the font-size of the root widget.

ViewportWidth(Factor)

Relative to the width of the nearest viewport ancestor.

ViewportHeight(Factor)

Relative to the height of the nearest viewport ancestor.

ViewportMin(Factor)

Relative to the smallest of the nearest viewport ancestor’s dimensions.

ViewportMax(Factor)

Relative to the smallest of the nearest viewport ancestor’s dimensions.

DipF32(f32)

The exact length in device independent units, defined using a f32 value.

This value will be rounded to the nearest pixel after layout, but it will be used as is in the evaluation of length expressions.

PxF32(f32)

The exact length in device pixel units, defined using a f32 value.

This value will be rounded to the nearest pixel after layout, but it will be used as is in the evaluation of length expressions.

Expr(Box<LengthExpr>)

Expression.

Implementations

impl Length

pub const fn zero() -> Length

Length of exact zero.

pub const fn fill() -> Length

Length that fills the available space.

pub const fn half() -> Length

Length that fills 50% of the available space.

pub fn max(&self, other: impl Into<Length>) -> Length

Returns a length that resolves to the maximum layout length between self and other.

pub fn min(&self, other: impl Into<Length>) -> Length

Returns a length that resolves to the minimum layout length between self and other.

pub fn clamp(&self, min: impl Into<Length>, max: impl Into<Length>) -> Length

Returns a length that constraints the computed layout length between min and max.

pub fn abs(&self) -> Length

Returns a length that computes the absolute layout length of self.

pub fn is_zero(&self) -> Option<bool>

If this length is zero in any finite layout context.

Returns None if the value depends on the default value.

pub fn pt_to_px(pt: f32, scale_factor: Factor) -> Px

Convert a pt unit value to Px given a scale_factor.

pub fn pt_to_px_f32(pt: f32, scale_factor: Factor) -> f32

Same operation as pt_to_px but without rounding to nearest pixel.

pub fn px_to_pt(px: Px, scale_factor: Factor) -> f32

Convert a Px unit value to a Pt value given a scale_factor.

pub fn is_default(&self) -> bool

If is Length::Default.

pub fn replace_default(&mut self, overwrite: &Length)

Replaces self with overwrite if self is Default.

pub fn round_exact(&mut self)

Convert PxF32 to Px and DipF32 to Dip.

pub fn memory_used(&self) -> ByteLength

Gets the total memory allocated by this length.

This includes the sum of all nested Length::Expr heap memory.

pub fn heap_memory_used(&self) -> ByteLength

Sum total memory used in nested Length::Expr heap memory.

Trait Implementations

impl<L: Into<Length>> Add<L> for Length

type Output = Length

The resulting type after applying the + operator.

fn add(self, rhs: L) -> Self::Output

Performs the + operation.

impl<L: Into<Length>> AddAssign<L> for Length

fn add_assign(&mut self, rhs: L)

Performs the += operation.

impl Clone for Length

fn clone(&self) -> Length

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Length

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

Formats the value using the given formatter.

impl Default for Length

fn default() -> Self

Length::Default

impl<'de> Deserialize<'de> for Length

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Length

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

Formats the value using the given formatter.

impl<F: Into<Factor>> Div<F> for Length

type Output = Length

The resulting type after applying the / operator.

fn div(self, rhs: F) -> Self::Output

Performs the / operation.

impl<F: Into<Factor>> DivAssign<F> for Length

fn div_assign(&mut self, rhs: F)

Performs the /= operation.

impl From<Dip> for Length

fn from(l: Dip) -> Self

Conversion to Length::Dip

impl From<Factor> for Length

fn from(norm: Factor) -> Self

Conversion to Length::Factor

impl From<FactorPercent> for Length

fn from(percent: FactorPercent) -> Self

Conversion to Length::Factor

impl From<Length> for GridSpacing

fn from(all: Length) -> Self

Same spacing for both columns and rows.

impl From<Length> for Point

fn from(all: Length) -> Self

Splat.

impl From<Length> for SideOffsets

fn from(all: Length) -> Self

All sides equal.

impl From<Length> for Size

fn from(all: Length) -> Self

Splat.

impl From<Length> for Vector

fn from(length: Length) -> Self

Use the length for x and y.

impl From<Px> for Length

fn from(l: Px) -> Self

Conversion to Length::Px

impl From<f32> for Length

fn from(f: f32) -> Self

Conversion to Length::DipF32

impl From<i32> for Length

fn from(i: i32) -> Self

Conversion to Length::Dip

impl IntoVar<GridSpacing> for Length

fn into_var(self) -> Self::Var

Same spacing for both columns and rows.

type Var = LocalVar<GridSpacing>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Length> for Dip

fn into_var(self) -> Self::Var

Conversion to Length::Dip

type Var = LocalVar<Length>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Length> for Factor

fn into_var(self) -> Self::Var

Conversion to Length::Factor

type Var = LocalVar<Length>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Length> for FactorPercent

fn into_var(self) -> Self::Var

Conversion to Length::Factor

type Var = LocalVar<Length>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Length> for Px

fn into_var(self) -> Self::Var

Conversion to Length::Px

type Var = LocalVar<Length>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Length> for f32

fn into_var(self) -> Self::Var

Conversion to Length::DipF32

type Var = LocalVar<Length>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Length> for i32

fn into_var(self) -> Self::Var

Conversion to Length::Dip

type Var = LocalVar<Length>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Point> for Length

fn into_var(self) -> Self::Var

Splat.

type Var = LocalVar<Point>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<SideOffsets> for Length

fn into_var(self) -> Self::Var

All sides equal.

type Var = LocalVar<SideOffsets>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Size> for Length

fn into_var(self) -> Self::Var

Splat.

type Var = LocalVar<Size>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<Vector> for Length

fn into_var(self) -> Self::Var

Use the length for x and y.

type Var = LocalVar<Vector>

Variable type that will wrap the T value.

fn into_boxed_var(self) -> Box<dyn VarBoxed<T>>

where Self: Sized,

Converts into BoxedVar<T>.

impl Layout1d for Length

fn layout_dft(&self, axis: LayoutAxis, default: Px) -> Px

Compute the pixel value in the current LAYOUT context with default.

fn layout_f32_dft(&self, axis: LayoutAxis, default: f32) -> f32

Compute the pixel value in the current LAYOUT context with default.

fn affect_mask(&self) -> LayoutMask

Compute a LayoutMask that flags all contextual values that affect the result of layout.

fn layout(&self, axis: LayoutAxis) -> Px

Compute the pixel value in the current LAYOUT context.

fn layout_x(&self) -> Px

Compute the pixel value in the current LAYOUT context x axis.

fn layout_y(&self) -> Px

Compute the pixel value in the current LAYOUT context y axis.

fn layout_z(&self) -> Px

Compute the pixel value in the current LAYOUT context z axis.

fn layout_dft_x(&self, default: Px) -> Px

Compute the pixel value in the current LAYOUT context x axis with default.

fn layout_dft_y(&self, default: Px) -> Px

Compute the pixel value in the current LAYOUT context y axis with default.

fn layout_dft_z(&self, default: Px) -> Px

Compute the pixel value in the current LAYOUT context z axis with default.

fn layout_f32(&self, axis: LayoutAxis) -> f32

Compute the pixel value in the current LAYOUT context.

fn layout_f32_x(&self) -> f32

Compute the pixel value in the current LAYOUT context x axis.

fn layout_f32_y(&self) -> f32

Compute the pixel value in the current LAYOUT context y axis.

fn layout_f32_z(&self) -> f32

Compute the pixel value in the current LAYOUT context z axis.

fn layout_f32_dft_x(&self, default: f32) -> f32

Compute the pixel value in the current LAYOUT context x axis with default.

fn layout_f32_dft_y(&self, default: f32) -> f32

Compute the pixel value in the current LAYOUT context y axis with default.

fn layout_f32_dft_z(&self, default: f32) -> f32

Compute the pixel value in the current LAYOUT context z axis with default.

impl<F: Into<Factor>> Mul<F> for Length

type Output = Length

The resulting type after applying the * operator.

fn mul(self, rhs: F) -> Self::Output

Performs the * operation.

impl<F: Into<Factor>> MulAssign<F> for Length

fn mul_assign(&mut self, rhs: F)

Performs the *= operation.

impl Neg for Length

type Output = Length

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl PartialEq for Length

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Length

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<L: Into<Length>> Sub<L> for Length

type Output = Length

The resulting type after applying the - operator.

fn sub(self, rhs: L) -> Self::Output

Performs the - operation.

impl<L: Into<Length>> SubAssign<L> for Length

fn sub_assign(&mut self, rhs: L)

Performs the -= operation.

impl Transitionable for Length

fn lerp(self, to: &Self, step: EasingStep) -> Self

Sample the linear interpolation from self -> to by step.

impl IntoValue<GridSpacing> for Length

impl IntoValue<Length> for Dip

impl IntoValue<Length> for Factor

impl IntoValue<Length> for FactorPercent

impl IntoValue<Length> for Px

impl IntoValue<Length> for f32

impl IntoValue<Length> for i32

impl IntoValue<Point> for Length

impl IntoValue<SideOffsets> for Length

impl IntoValue<Size> for Length

impl IntoValue<Vector> for Length