Struct TextRasterRequest 

pub struct TextRasterRequest {

    pub text: String,
    pub font_size: f32,
    pub max_width: f32,
    pub line_height: f32,
    pub align: TextAlign,
    pub fill: TextFill,
    pub emoji_policy: EmojiPolicy,
    pub content_version: u64,
    pub strokes: Vec<TextStroke>,
    pub background: Option<TextBackground>,
    pub split_background: bool,
    pub font_family: Option<String>,
    pub letter_spacing: f32,
    pub font_weight: u16,
}

One text layout request.

Fields

text: String

UTF-8 text shaped by the selected font fallback stack.

font_size: f32

Logical font size in pixels.

max_width: f32

Maximum layout width. Non-positive values disable wrapping.

line_height: f32

Baseline-to-baseline distance in font sizes. The em box (0.8 above the baseline, 0.2 below) is centered in lines taller than an em.

align: TextAlign

Per-line horizontal alignment.

fill: TextFill

Glyph paint. Color glyphs keep their own colors except for text-color parts, which use TextFill::foreground, whose alpha is also their opacity.

emoji_policy: EmojiPolicy

Whether color glyphs are drawn in color, and which fonts emoji take.

content_version: u64

Caller-managed version. Change it whenever content/style/font inputs change.

strokes: Vec<TextStroke>

Outlines, innermost first, each drawn behind the previous. At most 4, reaching at most 64 pixels together.

background: Option<TextBackground>

A box behind each line, drawn behind the strokes.

split_background: bool

Draws the background into TextRasterResult::background instead of under the glyphs, so a caller can draw something (a shadow) between them.

font_family: Option<String>

Preferred family, matched against any font_family_names entry after NFC and lowercasing; the fallback stack fills missing glyphs. An unknown family keeps the fallback order and is listed by TextRasterizer::unmatched_families.

letter_spacing: f32

Space after each grapheme cluster, like CSS letter-spacing, in [-0.5, 1] font sizes. Not applied after a line’s last cluster or within cursive scripts. Non-zero values disable optional ligatures.

font_weight: u16

Weight in [1, 1000], matched per CSS Fonts 4 and applied to a variable face’s wght axis. Faces are never synthetically emboldened.

Implementations

impl TextRasterRequest

pub fn decoration_margin(&self) -> u32

Whole pixels the strokes or background reach past the layout box. The texture margin (TextTexture::layout_x) adds room for ink overflow to this.

Trait Implementations

impl Clone for TextRasterRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextRasterRequest

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

Formats the value using the given formatter.

impl PartialEq for TextRasterRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TextRasterRequest