Struct DrawTextStyle 

pub struct DrawTextStyle {
    pub font_family: Option<String>,
    pub font_size: f32,
    pub font_weight: FontWeight,
    pub font_style: FontStyle,
    pub letter_spacing: f32,
    pub line_height: Option<f32>,
    pub line_height_style: Option<LineHeightStyle>,
    pub align: TextAlign,
    pub vertical_align: TextVerticalAlign,
}

Everything crate::DrawScope needs to measure and draw a run of text.

A style is a plain value: sizes are already in scope (logical) units, and every field is resolved — there is no inheritance or theme lookup at draw time. Build one once and reuse it; measurement is cached on the (text, style) pair, so a style rebuilt with identical values still hits the cache.

Fields

font_family: Option<String>

Family name to resolve against the fonts the app registered. None asks for the framework’s default family.

Only named families resolve: file-backed families are loaded by the app at startup and looked up by the name in their font tables.

font_size: f32

Size of the text, in scope units. A non-positive or non-finite value uses DEFAULT_FONT_SIZE.

font_weight: FontWeight

Weight of the face, from 1 to 1000.

font_style: FontStyle

Normal or italic face.

letter_spacing: f32

Extra advance inserted between characters, in scope units.

line_height: Option<f32>

Distance between consecutive baselines. None uses the font’s natural line height.

line_height_style: Option<LineHeightStyle>

How the line sits inside that height. None takes LineHeightStyle::default, as a composed Text does.

align: TextAlign

How the text block is placed horizontally inside its box.

vertical_align: TextVerticalAlign

How the text block is placed vertically inside its box.

Implementations

impl DrawTextStyle

pub const DEFAULT_FONT_SIZE: f32 = 14.0

The size used when a style carries a non-positive or non-finite one. Matches the framework-wide text default.

pub fn new(font_size: f32) -> DrawTextStyle

Creates a style with the given font size, in scope units, and defaults for every other field.

pub fn with_font_family(self, family: impl Into<String>) -> DrawTextStyle

Sets the font family by name. An empty name selects the framework default family.

pub fn with_font_size(self, font_size: f32) -> DrawTextStyle

Sets the font size, in scope units.

pub fn with_weight(self, weight: FontWeight) -> DrawTextStyle

Sets the font weight.

pub fn with_style(self, style: FontStyle) -> DrawTextStyle

Sets the font style.

pub fn with_letter_spacing(self, letter_spacing: f32) -> DrawTextStyle

Sets the extra advance between characters, in scope units.

pub fn with_line_height(self, line_height: f32) -> DrawTextStyle

Sets the distance between baselines, in scope units. A non-finite value clears it.

pub fn with_line_height_style( self, line_height_style: LineHeightStyle, ) -> DrawTextStyle

Asks for a line-height policy other than the default one.

pub fn with_align(self, align: TextAlign) -> DrawTextStyle

Sets how the text block is placed horizontally inside its box.

pub fn with_vertical_align( self, vertical_align: TextVerticalAlign, ) -> DrawTextStyle

Sets how the text block is placed vertically inside its box.

pub fn resolved_font_size(&self) -> f32

The font size a measurer/rasterizer will actually use. Non-finite and non-positive sizes fall back to DrawTextStyle::DEFAULT_FONT_SIZE instead of producing NaN geometry.

pub fn resolved_letter_spacing(&self) -> f32

The letter spacing a measurer will actually use.

pub fn resolved_line_height(&self, natural: f32) -> f32

The line height a measurer will actually use, given the font’s natural one. natural is only consulted when the style leaves it unset.

Trait Implementations

impl Clone for DrawTextStyle

fn clone(&self) -> DrawTextStyle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DrawTextStyle

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

Formats the value using the given formatter.

impl Default for DrawTextStyle

fn default() -> DrawTextStyle

Returns the “default value” for a type.

impl PartialEq for DrawTextStyle

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DrawTextStyle