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 text draws with. Texts already rasterized are dropped.

Errors

Returns TextError::Raster for malformed font bytes.

pub fn font_count(&self) -> usize

Fonts in the fallback stack.

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

Rasterizes and uploads every text frame shows at size that is not already held: its captions and the text generators its clips draw. Resolves every layout it draws that is not already held, and rasterizes its texts. Forgets 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>

Where each node of root lies on a picture of size at picture time time, its pixels those of a canvas canvas, laid out with these fonts: crate::measure_layout.

Errors

Returns TextError::Raster as Self::prepare would for its texts.

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

Self::prepare for the frame of project at time, rendered at size; nothing to do, and no 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>

Where text in style lies on a canvas of size, drawn with these fonts: measure_text.

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 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.