Struct SdfTextRenderer 

pub struct SdfTextRenderer { /* private fields */ }

SDF-only text renderer.

Uses only an SDF glyph atlas for rendering, with no bitmap support. This provides scalable text rendering with effects (~8 MB with default atlas).

Best for large text, titles, and text that needs effects like shadows/outlines.

Implementations

impl SdfTextRenderer

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

Create a new SDF text renderer with default configuration.

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

Create a new SDF 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.

Note: SDF atlas doesn’t need to be cleared on scale factor change because SDF glyphs are resolution-independent.

pub fn set_sdf_config(&mut self, config: SdfConfig)

Set SDF configuration.

pub fn sdf_config(&self) -> &SdfConfig

Get the current SDF configuration.

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 (without effects).

pub fn draw_text_with_effects( &mut self, buffer: &mut TextBuffer, position: Vec2, effects: &TextEffects, )

Draw text with effects 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.

Trait Implementations

impl TextRender for SdfTextRenderer

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.