Struct TextTextures 

pub struct TextTextures { /* private fields */ }

Fonts and the texts rasterized with them, keyed by content and render size.

Implementations

impl TextTextures

pub fn new() -> Self

No fonts and no texts.

pub fn add_font( &mut self, family: impl Into<String>, bytes: impl Into<Arc<[u8]>>, face_index: u32, ) -> Result<(), TextError>

Appends an OpenType font to the fallback stack and drops rasterized texts.

Errors

Returns TextError::Raster for malformed font bytes.

pub fn font_count(&self) -> usize

Fonts in the fallback stack.

pub fn unmatched_font_families(&self) -> Vec<String>

Requested families no registered font has, sorted (alpha2_text::TextRasterizer::unmatched_families).

pub fn prepare( &mut self, renderer: &dyn TextUpload, frame: &FrameDesc<'_>, size: RenderSize, ) -> Result<(), TextError>

Rasterizes and uploads every text and resolves every layout frame shows at size that is not already held, evicting the least recently shown beyond a small number.

Errors

Returns TextError when a text cannot be rasterized or uploaded; with no fonts registered, only if the frame shows one.

pub fn layout(&self, key: u128) -> Option<Arc<PreparedLayout>>

The prepared layout with key, as layout_key names it.

pub fn measure_layout( &self, root: &LayoutNode, time: MediaTime, size: RenderSize, canvas: (u32, u32), ) -> Result<LayoutBounds, TextError>

crate::measure_layout with these fonts.

Errors

Returns TextError::Raster as Self::prepare would.

pub fn prepare_at( &mut self, renderer: &dyn TextUpload, project: &EngineProject, time: MediaTime, size: RenderSize, ) -> Result<(), EngineError>

Self::prepare for project at time; skips evaluation when the project draws no text (crate::EngineProject::draws_text).

Errors

Returns crate::EngineError::Evaluate or crate::EngineError::Text.

pub fn measure( &self, text: &str, style: &TextStyle, size: RenderSize, ) -> Result<TextBounds, TextError>

crate::measure_text with these fonts.

Errors

Returns TextError::Raster as Self::prepare would for the text.

pub fn get(&self, key: u64) -> Option<TextTexture<'_>>

The prepared text with key, as crate::text_key names it.

Trait Implementations

impl Debug for TextTextures

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

Formats the value using the given formatter.

impl Default for TextTextures

fn default() -> Self

Returns the “default value” for a type.