Struct TextState 

pub struct TextState { /* private fields */ }

Glyphon-backed text batching for a single frame.

Text is queued during crate::drawable::WgpuDrawable::draw execution and flushed once per frame. On glyphon prepare/render failure, a warning is logged and queued lines are cleared.

Implementations

impl TextState

pub fn new( device: &Device, queue: &Queue, pixel_format: TextureFormat, size: (u32, u32), dpi_scale: f32, ) -> Self

Creates glyphon font system, atlas, and text renderer for the given surface format.

pub fn set_dpi_scale(&mut self, dpi_scale: f32)

Updates the DPI scale factor used when measuring text.

pub fn font_system(&self) -> Arc<Mutex<FontSystem>>

Returns a shared handle to the glyphon font system.

Used by crate::cotis_traits to provide layout-time text measurement.

pub fn queue_text( &mut self, text: &str, font_size: f32, line_height: f32, position: UIPosition, bounds: Option<(UIPosition, UIPosition)>, color: Color, draw_order: f32, )

Queues a line of text for rendering at the end of the current frame.

font_size and line_height should already include DPI scaling when called from crate::default_drawables. draw_order maps to glyphon depth metadata for z-ordering.

pub fn flush( &mut self, device: &Device, queue: &Queue, render_pass: &mut RenderPass<'_>, surface_config: &SurfaceConfiguration, )

Prepares and renders all queued text lines, then clears the queue.

On prepare failure, logs a warning and clears queued lines without rendering. On render failure, logs a warning but still clears the queue.

pub fn measure(&mut self, text: &str, config: &TextConfig) -> Dimensions

Measures the pixel dimensions of text using the given layout config.

Font size and line height are multiplied by the current DPI scale. Always uses Family::SansSerif; font_id is not consulted.