wgpu_text 0.2.1

Simple library for rendering text with wgpu
Documentation

wgpu-text

Build Status Licence crates.io Documentation

wgpu-text is a wrapper over glyph-brush for easier text rendering in wgpu.

This project was inspired by and is similar to wgpu_glyph, but has additional features and is simpler. Also there is no need to include glyph-brush in your project.

Some features are directly implemented from glyph-brush so you should go trough Section docs and Section examples for better understanding of adding and managing text.

Example:

use wgpu_text::BrushBuilder;
use wgpu_text::section::{Section, Text, Layout, HorizontalAlign};
let brush = BrushBuilder::using_font_bytes(font).unwrap()
 /* .initial_cache_size((1024, 1024))) */ // use this to avoid resizing cache texture
    .build(&device, format, width, height);
let section = Section::default()
    .add_text(Text::new("Hello World"))
    .with_layout(Layout::default().h_align(HorizontalAlign::Center));

// window event loop:
    winit::event::Event::RedrawRequested(_) => {
        // Has to be queued every frame.
        brush.queue(&section);
        let text_buffer = brush.draw(&device, &view, &queue);
        // Has to be submitted last so text won't be overlapped.
        queue.submit([app_encoder.finish(), text_buffer]);
        frame.present();
    }

Examples

Look trough examples for more.

  • cargo run --example <example-name>

Run examples with --release for true performance.

Goals

  • improve docs
  • add more examples
  • maybe some new features

Contributing

All contributions are welcome.