Enum zng::layout::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> Add<L> for Length

where L: Into<Length>,

type Output = Length

The resulting type after applying the + operator.

fn add(self, rhs: L) -> <Length as Add<L>>::Output

Performs the + operation.

impl<L> AddAssign<L> for Length

where L: Into<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<(), Error>

Formats the value using the given formatter.

impl Default for Length

fn default() -> Length

Length::Default

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

fn deserialize<__D>( __deserializer: __D, ) -> Result<Length, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Length

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

Formats the value using the given formatter.

impl<F> Div<F> for Length

where F: Into<Factor>,

type Output = Length

The resulting type after applying the / operator.

fn div(self, rhs: F) -> <Length as Div<F>>::Output

Performs the / operation.

impl<F> DivAssign<F> for Length

where F: Into<Factor>,

fn div_assign(&mut self, rhs: F)

Performs the /= operation.

impl From<&Length> for WidgetLength

fn from(value: &Length) -> WidgetLength

Converts to this type from the input type.

impl From<Dip> for Length

fn from(l: Dip) -> Length

Conversion to Length::Dip

impl From<Factor> for Length

fn from(norm: Factor) -> Length

Conversion to Length::Factor

impl From<FactorPercent> for Length

fn from(percent: FactorPercent) -> Length

Conversion to Length::Factor

impl From<Length> for CornerRadius

fn from(all: Length) -> CornerRadius

All corners same length.

impl From<Length> for GradientRadius

fn from(radius: Length) -> GradientRadius

Ellipse GradientRadius::farthest_corner.

impl From<Length> for GradientStop

fn from(color_hint: Length) -> GradientStop

Converts to this type from the input type.

impl From<Length> for GridSpacing

fn from(all: Length) -> GridSpacing

Same spacing for both columns and rows.

impl From<Length> for Point

fn from(all: Length) -> Point

Splat.

impl From<Length> for SideOffsets

fn from(all: Length) -> SideOffsets

All sides equal.

impl From<Length> for Size

fn from(all: Length) -> Size

Splat.

impl From<Length> for Vector

fn from(length: Length) -> Vector

Use the length for x and y.

impl From<Px> for Length

fn from(l: Px) -> Length

Conversion to Length::Px

impl From<f32> for Length

fn from(f: f32) -> Length

Conversion to Length::DipF32

impl From<i32> for Length

fn from(i: i32) -> Length

Conversion to Length::Dip

impl IntoVar<CornerRadius> for Length

fn into_var(self) -> <Length as IntoVar<CornerRadius>>::Var

All corners same length.

type Var = LocalVar<CornerRadius>

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<GradientRadius> for Length

fn into_var(self) -> <Length as IntoVar<GradientRadius>>::Var

Ellipse GradientRadius::farthest_corner.

type Var = LocalVar<GradientRadius>

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<GradientStop> for Length

type Var = LocalVar<GradientStop>

Variable type that will wrap the T value.

fn into_var(self) -> <Length as IntoVar<GradientStop>>::Var

Converts the source value into a var.

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

where Self: Sized,

Converts into BoxedVar<T>.

impl IntoVar<GridSpacing> for Length

fn into_var(self) -> <Length as IntoVar<GridSpacing>>::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) -> <Dip as IntoVar<Length>>::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) -> <Factor as IntoVar<Length>>::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) -> <FactorPercent as IntoVar<Length>>::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) -> <Px as IntoVar<Length>>::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) -> <f32 as IntoVar<Length>>::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) -> <i32 as IntoVar<Length>>::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) -> <Length as IntoVar<Point>>::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) -> <Length as IntoVar<SideOffsets>>::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) -> <Length as IntoVar<Size>>::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) -> <Length as IntoVar<Vector>>::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> Mul<F> for Length

where F: Into<Factor>,

type Output = Length

The resulting type after applying the * operator.

fn mul(self, rhs: F) -> <Length as Mul<F>>::Output

Performs the * operation.

impl<F> MulAssign<F> for Length

where F: Into<Factor>,

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) -> <Length as Neg>::Output

Performs the unary - operation.

impl PartialEq for Length

fn eq(&self, other: &Length) -> 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 SelectorValue for Length

fn to_selector( value: Box<dyn VarBoxed<Length>>, min: Length, max: Length, ) -> Selector

Make the selector.

impl Serialize for Length

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<L> Sub<L> for Length

where L: Into<Length>,

type Output = Length

The resulting type after applying the - operator.

fn sub(self, rhs: L) -> <Length as Sub<L>>::Output

Performs the - operation.

impl<L> SubAssign<L> for Length

where L: Into<Length>,

fn sub_assign(&mut self, rhs: L)

Performs the -= operation.

impl Transitionable for Length

fn lerp(self, to: &Length, step: Factor) -> Length

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

impl IntoValue<CornerRadius> for Length

impl IntoValue<GradientRadius> for Length

impl IntoValue<GradientStop> for Length

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