Enum text_layout::Item

pub enum Item {
    Box {
        width: f32,
    },
    Glue {
        width: f32,
        stretch: f32,
        shrink: f32,
    },
    Penalty {
        width: f32,
        cost: f32,
        flagged: bool,
    },
}

A single item in a paragraph.

Variants

Box

Fields

width: f32

The width of the box.

An unbreakable box containing paragraph content. Typically represents a glyph or sequence of glyphs. Lines may not be broken at boxes.

Glue

Fields

width: f32

The normal width of the whitespace.

stretch: f32

The stretch parameter. If this item needs to be stretched in order to lay out a line, the stretch amount will be proportional to this value.

shrink: f32

The shrink parameter. If this item needs to be shrunk in order to lay out a line, the shrink amount will be proportional to this value.

Whitespace that separates boxes. Lines may be broken at glue items.

Penalty

Fields

width: f32

The width of the penalty item.

cost: f32

The aesthetic cost of the penalty item. A high cost is a relatively undesirable breakpoint, while a low cost indicates a relatively desirable breakpoint.

flagged: bool

Whether or not this is a flagged penalty item. Some algorithms will attempt to avoid having multiple consecutive breaks at flagged penalty items.

A penalty item. Represents a possible breakpoint with a particular aesthetic cost that indicates the desirability or undesirability of such a breakpoint.

Trait Implementations

impl Debug for Item

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

Formats the value using the given formatter.