Struct TextStyle 

pub struct TextStyle {
    pub font_size: FontSize,
    pub line_height: LineHeight,
    pub font_color: FontColor,
    pub horizontal_alignment: HorizontalTextAlignment,
    pub vertical_alignment: VerticalTextAlignment,
    pub wrap: Option<TextWrap>,
    pub font_family: FontFamily,
    pub weight: Weight,
    pub letter_spacing: Option<LetterSpacing>,
}

Comprehensive text styling configuration.

TextStyle combines all visual aspects of text rendering, including font properties, colors, alignment, and wrapping behavior

Fields

font_size: FontSize

The font size in points.

line_height: LineHeight

The line height is a multiplier of the font size.

font_color: FontColor

The color of the text.

horizontal_alignment: HorizontalTextAlignment

Horizontal text alignment within the container.

vertical_alignment: VerticalTextAlignment

Vertical text alignment within the container.

wrap: Option<TextWrap>

Text wrapping behavior.

font_family: FontFamily

The font family to use for rendering. Can be a generic family created with an enum, or you can use a CSS-like font family query string to specify custom fonts: "Helvetica, 'Segoe UI', sans-serif".into().

weight: Weight

The font weight to use for rendering.

letter_spacing: Option<LetterSpacing>

The spacing between characters as a multiplier of the font size.

Implementations

impl TextStyle

pub const DEFAULT: Self

pub const fn new(font_size: f32, font_color: Color) -> Self

Creates a new TextStyle with the specified font size and color.

Other properties are set to their default values.

Arguments

• font_size - The font size in points
• font_color - The text color

Examples

use protextinator::style::TextStyle;
use cosmic_text::Color;

let style = TextStyle::new(14.0, Color::rgb(0, 0, 0));

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

Sets the font size and returns the modified style.

Arguments

• font_size - The font size in points

Examples

use protextinator::style::TextStyle;

let style = TextStyle::default().with_font_size(18.0);

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

Sets the line height and returns the modified style.

Arguments

• line_height - The line height as a multiplier of font size

Examples

use protextinator::style::TextStyle;

let style = TextStyle::default().with_line_height(1.2);

pub const fn with_font_color(self, font_color: FontColor) -> Self

Sets the font color and returns the modified style.

Arguments

• font_color - The text color

Examples

use protextinator::style::{TextStyle, FontColor};

let style = TextStyle::default().with_font_color(FontColor::rgb(255, 0, 0));

pub const fn with_horizontal_alignment( self, alignment: HorizontalTextAlignment, ) -> Self

Sets the horizontal alignment and returns the modified style.

Arguments

• alignment - The horizontal alignment

Examples

use protextinator::style::{TextStyle, HorizontalTextAlignment};

let style = TextStyle::default().with_horizontal_alignment(HorizontalTextAlignment::Center);

pub const fn with_vertical_alignment( self, alignment: VerticalTextAlignment, ) -> Self

Sets the vertical alignment and returns the modified style.

Arguments

• alignment - The vertical alignment

Examples

use protextinator::style::{TextStyle, VerticalTextAlignment};

let style = TextStyle::default().with_vertical_alignment(VerticalTextAlignment::Center);

pub const fn with_alignment( self, horizontal: HorizontalTextAlignment, vertical: VerticalTextAlignment, ) -> Self

Sets both horizontal and vertical alignment and returns the modified style.

Arguments

• horizontal - The horizontal alignment
• vertical - The vertical alignment

Examples

use protextinator::style::{TextStyle, HorizontalTextAlignment, VerticalTextAlignment};

let style = TextStyle::default().with_alignment(
    HorizontalTextAlignment::Center,
    VerticalTextAlignment::Center
);

pub const fn with_wrap(self, wrap: TextWrap) -> Self

Sets the text wrapping behavior and returns the modified style.

Arguments

• wrap - The text wrapping behavior

Examples

use protextinator::style::{TextStyle, TextWrap};

let style = TextStyle::default().with_wrap(TextWrap::Wrap);

pub const fn line_height_pt(&self) -> f32

Calculates the line height in points based on the font size and line height multiplier.

Returns

The line height in points (font_size * line_height_multiplier)

Examples

use protextinator::style::TextStyle;

let style = TextStyle::default().with_font_size(16.0).with_line_height(1.5);
assert_eq!(style.line_height_pt(), 24.0); // 16.0 * 1.5

Trait Implementations

impl Clone for TextStyle

fn clone(&self) -> TextStyle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextStyle

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

Formats the value using the given formatter.

impl Default for TextStyle

fn default() -> Self

Creates a default text style with standard settings.

Default values:

• Font size: 16.0 points
• Line height: 1.5x font size
• Font color: White (255, 255, 255)
• No overflow handling
• Start horizontal alignment
• Start vertical alignment
• No text wrapping
• Sans-serif font family

impl Eq for TextStyle

impl Hash for TextStyle

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TextStyle

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