gfx_glyph

Fast GPU cached text rendering using gfx-rs & rusttype.

Makes use of three kinds of caching to optimise frame performance.

• Caching of glyph positioning output to avoid repeated cost of identical text rendering on sequential frames.
• Caches draw calculations to avoid repeated cost of identical text rendering on sequential frames.
• GPU cache logic to dynamically maintain a GPU texture of rendered glyphs.

extern crate gfx_glyph;
use gfx_glyph::{Section, Layout, GlyphBrushBuilder};

let arial: &[u8] = include_bytes!("examples/Arial Unicode.ttf");
let mut glyph_brush = GlyphBrushBuilder::using_font(arial)
    .build(gfx_factory.clone());

let section = Section {
    text: "Hello gfx_glyph",
    ..Section::default() // color, position, etc
};

glyph_brush.queue(section, &Layout::default());
glyph_brush.queue(some_other_section, &Layout::default());

glyph_brush.draw_queued(&mut gfx_encoder, &gfx_target).unwrap();

Limitations

The current implementation only supports OpenGL 3.0 or later. But other rendering languages (that are supported by gfx) should be easy enough to add. Send in your PRs!

Examples

Have a look at

• cargo run --example paragraph --release
• cargo run --example performance --release

Changelog

0.3.2

• Move fixed GPU caching logic into crate rather than use rusttype::gpu_cache

0.3

• Use Into<SharedBytes> instead of explicit &[u8] for font byte input to improve flexibility.

0.2

• Adopt default line breaking logic according to the Unicode Standard Annex #14 with StandardLineBreaker (included in Layout::default()). A LineBreaker implementation can be provided instead of using one of these.