fastframe-emoji

Colour emoji in the platform’s own style, inline in egui text: Apple’s on macOS, Segoe UI Emoji on Windows, the desktop’s emoji font on Linux, and a font the app bundles for anything they lack.

• Whole sequences: flags, skin tones, keycaps and families joined with U+200D become one picture, as the platform joins them. A sequence newer than the fonts shows its first emoji.
• Inline: each emoji is laid out as one transparent placeholder glyph, as wide as the picture painted over it and no taller than the text row, so selection, wrapping and right-to-left reordering work on it like any character.
• Never in the frame: fonts are memory-mapped once (Apple’s is 190 MB), and each new picture is drawn on a worker thread; the frame that first shows an emoji leaves its placeholder and the worker asks for a repaint.
• Outside egui too: Emoji::render hands back a premultiplied RGBA picture for an app’s own renderer.

Usage

// At startup: the platform's emoji, with the app's own font behind them.
fastframe_emoji::EmojiSetup::default()
    .bundled(include_bytes!("../assets/fonts/NotoColorEmoji.ttf"))
    .install();
std::thread::spawn(fastframe_emoji::warm_up);

// Laying out a message:
let mut job = egui::text::LayoutJob::default();
let mut placements = Vec::new();
fastframe_emoji::append(ui, &mut job, &mut placements, text, &format);
let galley = ui.fonts_mut(|fonts| fonts.layout_job(job));
// ...paint the galley, then the pictures over it:
fastframe_emoji::paint(ui, &galley, origin, &placements);

A text editor keeps its characters: editor_job draws the emoji transparent and returns where they are for paint_cluster. A copied selection holds PLACEHOLDER for each emoji; placements lists the clusters in the same order, to put them back.

Apps choose:

EmojiSetup::default()
    .system(true)        // the platform's emoji font (the default)
    .bundled(noto)       // a CBDT or sbix font for what it lacks
    .synchronous(demo)   // draw inside the frame, for screenshot tests
    .install();
fastframe_emoji::prewarm(ctx, picker_page);   // queue pictures early
let picture = fastframe_emoji::get().render("👍🏽", 48); // outside egui

Where pictures come from

The bundled font is shaped and drawn like the Linux one. Each cluster is tried whole, then without U+FE0F, then with trailing parts dropped, and every font is asked for each form before a part is dropped. Segoe UI Emoji has no country or subdivision flags, so on Windows those come from the bundled font.

Pictures are framed in the emoji font’s own cell (one advance wide, ascent plus descent tall), so each platform’s emoji sit on the text as that platform draws them. See DESIGN.md for the reasoning.

What stays in the app

The bundled font and its licence, the size emoji are drawn at, and how the app turns placeholders back into text when copying (ZapFast’s transcript).

Credits

The layout with placeholders and the bitmap reading come from ZapFast. The Windows renderer is Andrés Rodríguez’s (@pulgueta, ZapFast #229), and joining Apple’s sequences with harfrust over a mapped font is GM’s (@thisisgm, ZapFast #279).

Licences

The code is MIT. The test fixture is a subset of Noto Color Emoji, under the SIL Open Font License 1.1.