wgpu-font-renderer 0.1.0

About The Project

Render glyphs by extracting their outlines from TTF files and draw them directly from GPU. No signed distance field cache of any sort. This is based on Eric Lengyel's Slug algorithm.

Built With

Swash for text shaping - https://github.com/dfrg/swash
TTF Parser to read TTF files - https://github.com/RazrFalcon/ttf-parser
WGPU as graphic API - https://wgpu.rs/

Getting Started

This is an example of how you use this crate to generate paragraphs programatically and render them with WGPU.

Installation

Add dependency to you cargo.toml

[dependencies]
wgpu-font-renderer = "0.1.0"

Usage

First you need to load the TTF file in the FontStore by passing the file path and and preset string that will define the list of characters used by your app.

let mut font_store = FontStore::new(&device, &config);
let cache_preset = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789,;:!ù*^$=)àç_è-('\"é&²<>+°§/.? ";
let font_key = font_store.load(&device, &queue, "examples/Roboto-Regular.ttf", cache_preset).expect("Couldn't load the font");

Then during the runtime you can create new paragraphs to be rendered. Those can be defined with:

Specific font name
Position on the screen
Font size
Linear RGBA color
Text content

let mut paragraphs = Vec::new();
let mut type_writer = TypeWriter::new();
if let Some(paragraph) = type_writer.shape_text(&font_store, font_key, [100., 100.], 72, [0.68, 0.5, 0.12, 1.], "Salut, c'est cool!") {
    paragraphs.push(paragraph);
}

Then you can initialize the predefined font rendering middleware:

let mut text_renderer = TextRenderer::new(&device, &config, font_store.atlas());

Call prepare to pass the paragraphs you want to render to the middleware:

text_renderer.prepare(&device, &paragraphs, &font_store);

Call render with an existing render pass to build the command buffer necessary to render your paragraphs:

text_renderer.render(&mut pass, [config.width, config.height]);

To see concrete example, please check here

Roadmap

Separe glyph outlines into bands
Sort curves per band
Optimize data-layout
Anti-aliasing

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. Don't forget to give the project a star! Thanks again!

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.

Contact

Project Link: https://github.com/ValentinRio/wgpu-font-renderer