Struct TextShaper 

pub struct TextShaper {
    pub measurer: TextMeasurer,
    pub atlas: GlyphAtlas,
}

Combines the measurer and the atlas into a text shaper.

The shaper is the single place where text is turned into positioned glyphs, so the Canvas2D backend and the GPU backends lay text out identically — the same label lands on the same pixel no matter which backend is in use.

Fields

measurer: TextMeasurer

The measurer used to size the text.

atlas: GlyphAtlas

The atlas the glyphs are rasterised into.

Implementations

impl TextShaper

Inherent implementation of TextShaper.

pub fn new(measurer: TextMeasurer, atlas: GlyphAtlas) -> Self

Creates a shaper with the given measurer and atlas.

Arguments

• TextMeasurer - A TextMeasurer parameter.
• GlyphAtlas - A GlyphAtlas parameter.

pub fn measurer(&self) -> &TextMeasurer

Returns the measurer.

Returns

• &TextMeasurer - A TextMeasurer value.

pub fn atlas(&self) -> &GlyphAtlas

Returns the atlas.

Returns

• &GlyphAtlas - A GlyphAtlas value.

pub fn atlas_mut(&mut self) -> &mut GlyphAtlas

Returns the atlas as mutable, so a backend can upload it.

Returns

• &mut GlyphAtlas - A mut GlyphAtlas value.

pub fn shape( &mut self, text: &str, style: &TextStyle, x: f64, y: f64, ) -> TextRun

Shapes a run of text.

x and y are the anchor of the text; the alignment and the vertical alignment of the style decide which part of the text lands on the anchor.

A text that carries rich-text markup — {name|content} — is split into its runs, and each run is shaped with the style that the name refers to.

Arguments

• &str - Shared reference to a str.
• &TextStyle - Shared reference to a TextStyle.
• f64 - A 64-bit float (f64).

Returns

• TextRun - A TextRun value.

impl TextShaper

pub fn get_measurer(&self) -> &TextMeasurer

pub fn get_mut_measurer(&mut self) -> &mut TextMeasurer

pub fn set_measurer(&mut self, val: TextMeasurer) -> &mut Self

pub fn get_atlas(&self) -> &GlyphAtlas

pub fn get_mut_atlas(&mut self) -> &mut GlyphAtlas

pub fn set_atlas(&mut self, val: GlyphAtlas) -> &mut Self

Trait Implementations

impl Clone for TextShaper

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 TextShaper

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

Formats the value using the given formatter.