Struct TextTexturePipeline 

pub struct TextTexturePipeline {
    engine: FlexibleTextEngine,
    renderer: RefCell<FlexibleTextRenderer>,
    cache: RefCell<TextTextureCache>,
    format: TextureFormat,
}

High-level pipeline: text → RenderTexture, with caching.

Owns its own FlexibleTextEngine + FlexibleTextRenderer + TextTextureCache. The engine + renderer share an Arc<Mutex<FontSystem>> (M-TEXT.3 contract).

The pipeline is opt-in — callers construct it explicitly. It is not held by crate::render::Renderer, so apps that never render flexible text don’t pay glyphon + cache costs.

Fields

engine: FlexibleTextEngine

renderer: RefCell<FlexibleTextRenderer>

cache: RefCell<TextTextureCache>

format: TextureFormat

Implementations

impl TextTexturePipeline

pub fn new(app: &Application, format: TextureFormat) -> Self

Build a pipeline with a system-fonts FlexibleTextEngine.

pub fn from_font_paths<P: AsRef<Path>>( app: &Application, format: TextureFormat, paths: impl IntoIterator<Item = P>, ) -> Result<Self>

Build a pipeline with an engine seeded from explicit font files. See FlexibleTextEngine::from_font_paths.

Errors

Returns io::Error if any font path can’t be opened or parsed.

pub fn from_font_bytes( app: &Application, format: TextureFormat, bytes: impl IntoIterator<Item = Vec<u8>>, ) -> Self

Build a pipeline with an engine seeded from raw font bytes. See FlexibleTextEngine::from_font_bytes — designed for crates that ship their fonts via include_bytes! and want the same font set in native + wasm builds.

pub fn format(&self) -> TextureFormat

Color format the pipeline writes into (matches what was passed to Self::new / Self::from_font_paths).

pub fn stats(&self) -> (u64, u64)

(hits, misses) since construction. Useful in tests that verify the cache short-circuits on repeated lookups.

pub fn cache_len(&self) -> usize

Number of currently-resident cache entries.

pub fn clear_cache(&self)

Drop every cached entry.

pub fn engine(&self) -> &FlexibleTextEngine

Borrow the engine for direct layout queries (metrics, etc.).

pub fn render( &self, app: &Application, text: &WispText, width_px: u32, height_px: u32, ) -> Arc<RenderTexture>

Render text into a width_px × height_px RenderTexture, or return the cached version if text + dimensions match an earlier call.

The text is positioned with its top-left at the texture’s top-left (NDC (-1, +1)) and rendered with crate::color::Color WHITE as the default per-glyph color (the actual glyph color comes from crate::text::WispTextStyle::color).

Trait Implementations

impl Debug for TextTexturePipeline

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

Formats the value using the given formatter.