2 releases

0.7.1 Mar 30, 2024
0.7.0 Jan 13, 2024

#224 in Images

Download history 46/week @ 2024-01-07 96/week @ 2024-01-14 67/week @ 2024-01-21 67/week @ 2024-01-28 98/week @ 2024-02-04 182/week @ 2024-02-11 563/week @ 2024-02-18 349/week @ 2024-02-25 383/week @ 2024-03-03 406/week @ 2024-03-10 412/week @ 2024-03-17 477/week @ 2024-03-24 533/week @ 2024-03-31 308/week @ 2024-04-07 388/week @ 2024-04-14 429/week @ 2024-04-21

1,834 downloads per month
Used in 10 crates (3 directly)

MIT/Apache

1MB
4.5K SLoC

You are probably looking for the real cosmic-text crate.

Floem depends on cosmic-text changes that haven't been upstreamed. To make Floem publishable on crates.io, all its dependencies have to be published there - hence this unofficial crate.


lib.rs:

COSMIC Text

This library provides advanced text handling in a generic way. It provides abstractions for shaping, font discovery, font fallback, layout, rasterization, and editing. Shaping utilizes rustybuzz, font discovery utilizes fontdb, and the rasterization is optional and utilizes swash. The other features are developed internal to this library.

It is recommended that you start by creating a FontSystem, after which you can create a Buffer, provide it with some text, and then inspect the layout it produces. At this point, you can use the SwashCache to rasterize glyphs into either images or pixels.

use floem_cosmic_text::{Attrs, Color, FontSystem, SwashCache, Buffer, Metrics};

// A FontSystem provides access to detected system fonts, create one per application
let mut font_system = FontSystem::new();

// A SwashCache stores rasterized glyphs, create one per application
let mut swash_cache = SwashCache::new();

// Text metrics indicate the font size and line height of a buffer
let metrics = Metrics::new(14.0, 20.0);

// A Buffer provides shaping and layout for a UTF-8 string, create one per text widget
let mut buffer = Buffer::new(&mut font_system, metrics);

// Borrow buffer together with the font system for more convenient method calls
let mut buffer = buffer.borrow_with(&mut font_system);

// Set a size for the text buffer, in pixels
buffer.set_size(80.0, 25.0);

// Attributes indicate what font to choose
let attrs = Attrs::new();

// Add some text!
buffer.set_text("Hello, Rust! 🦀\n", attrs);

// Perform shaping as desired
buffer.shape_until_scroll();

// Inspect the output runs
for run in buffer.layout_runs() {
    for glyph in run.glyphs.iter() {
        println!("{:#?}", glyph);
    }
}

// Create a default text color
let text_color = Color::rgb(0xFF, 0xFF, 0xFF);

// Draw the buffer (for performance, instead use SwashCache directly)
buffer.draw(&mut swash_cache, text_color, |x, y, w, h, color| {
    // Fill in your code here for drawing rectangles
});

Dependencies

~11–22MB
~325K SLoC