mcsdf-font-tech-demo

Crates.iomcsdf-font-tech-demo
lib.rsmcsdf-font-tech-demo
version1.0.1
sourcesrc
created_at2019-06-07 08:18:35.618317
updated_at2021-07-02 19:43:36.317935
descriptionMulti-channel signed distance fields font tech demo
homepage
repository
max_upload_size
id139605
size1,497,857
Przemysław Lenart (Cierpliwy)

documentation

README

Multi-channel signed distance fields font - tech demo

Multi-channel signed distance fields is a technique, which rasterizes glyphs with distance information to low-resolution texture, which is then used to render high-quality text. You can find more information about it here and here.

Installation

Download and install Rust toolchain and type: cargo install mcsdf-font-tech-demo.

Goals

  • Create a Rust tech demo to showcase a technique.
  • Don't allocate memory during the rasterization phase.
  • Glyph rasterization is parallelized to multiple CPU cores.
  • All glyphs are rasterized only when needed.
  • Actual font rendering and glyph rasterization don't block each other. Synchronization point is a texture copy from CPU to GPU.
  • Rasterization code is separated to sdf library.

UI

Outline

  • red, green, blue - change colour of a text.
  • inner distance - distance from which we drawing font outline. By default, borders are in 0.5 distance. The inner side is smaller then that and outside is larger.
  • outer distance - distance to which we draw font outline.
  • sharpness - additional parameter, which smooths borders. High sharpness can lead to artifacts when texture's shadow size has a small value.

Shadow

  • red, green, blue - change colour of a shadow.
  • opacity - shadow's opacity.
  • position - distance of a center of a shadow.
  • size - shadow's size in distance units.

Texture

  • size - can be made larger to fit more glyphs into one texture. It is useful because fonts can be rendered in fewer passes. Currently, the whole texture is copied due to API limitations, which will delay the rendering process.
  • font size - the size of a rasterized glyph excluding a shadow. In principle, a higher value means higher quality, but rasterization time can grow substantially.
  • shadow size - how many pixels there are between 0.0 to 1.0 distance. Higher values increase the quality of a shadow but decrease the quality of an edge and vice-versa.

Render stats

You can see how the above settings impact performance.

Other

  • show animation - text under mouse cursor has more emphasized distance.

  • texture visibility - when set to 1.0 shows underlying texture instead of a rendered text.

Commit count: 0

cargo fmt