Struct BitmapTextRenderer 

pub struct BitmapTextRenderer { /* private fields */ }

Bitmap-only text renderer.

Uses only a bitmap glyph atlas for rendering, with no SDF support. This provides the lowest memory footprint (~8 MB with default atlas).

Best for UI text, labels, and other small text that doesn’t need effects.

Implementations

impl BitmapTextRenderer

pub fn new(context: Arc<GraphicsContext>, font_system: FontSystem) -> Self

Create a new bitmap text renderer with default configuration.

pub fn with_config( context: Arc<GraphicsContext>, font_system: FontSystem, config: TextRendererConfig, ) -> Self

Create a new bitmap text renderer with custom configuration.

pub fn measure_text(&self, text: &Text) -> (f32, f32)

Measure text dimensions without rendering.

pub fn buffer_bounds(&self, buffer: &TextBuffer) -> (f32, f32)

Get the logical (unscaled) bounds of a prepared text buffer.

pub fn get_text_metrics(&self, text: &Text) -> TextMetrics

Get font metrics for the given text style.

pub fn set_viewport(&mut self, viewport: Viewport)

Set the viewport for rendering.

pub fn prepare(&mut self, text: &Text) -> TextBuffer

Prepare text for rendering.

pub fn draw_text(&mut self, buffer: &mut TextBuffer, position: Vec2)

Draw text at a position.

pub fn render(&mut self, render_pass: &mut RenderPass<'_>)

Render all queued text to the given render pass.

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

Get the font system.

pub fn swash_cache(&self) -> Arc<RwLock<SwashCache>>

Get the swash cache.

pub fn atlas_size(&self) -> u32

Get the atlas size in pixels.

pub fn atlas_texture_view(&self) -> &TextureView

Get the atlas texture view for binding.

pub fn atlas_sampler(&self) -> &Sampler

Get the atlas sampler for binding.

pub fn is_atlas_dirty(&self) -> bool

Check if the atlas has pending changes.

pub fn upload_atlas_if_dirty(&mut self)

Upload atlas data to GPU if dirty.

pub fn ensure_glyph_in_atlas( &mut self, cache_key: CacheKey, ) -> Option<&AtlasEntry>

Ensure a glyph is in the atlas using a cache key.

pub fn get_glyph_placement( &mut self, cache_key: CacheKey, ) -> Option<GlyphPlacement>

Get glyph placement information.

pub fn ensure_glyph_with_placement( &mut self, cache_key: CacheKey, ) -> Option<(AtlasEntry, GlyphPlacement)>

Ensure a glyph is in the atlas and get its placement info.

pub fn get_atlas_entry(&self, cache_key: CacheKey) -> Option<&AtlasEntry>

Get an atlas entry by cache key (if it exists).

Trait Implementations

impl TextRender for BitmapTextRenderer

fn prepare(&mut self, text: &Text) -> TextBuffer

Prepare text for rendering.

fn draw_text(&mut self, buffer: &mut TextBuffer, position: Vec2)

Draw text at a position.

fn render(&mut self, render_pass: &mut RenderPass<'_>)

Render all queued text to the given render pass.

fn measure_text(&self, text: &Text) -> (f32, f32)

Measure text dimensions without rendering.

fn set_viewport(&mut self, viewport: Viewport)

Set the viewport for rendering.

fn buffer_bounds(&self, buffer: &TextBuffer) -> (f32, f32)

Get the logical (unscaled) bounds of a prepared text buffer.