General crate for text layout / text shaping
```rust,ignore,norun use azultextlayout::{ textlayout::{splittextintowords, wordstoscaledwords}, textshaping::getfontmetricsfreetype, };
let text = "hello"; let fontsize = 14.0; // px let font = includebytes!("Helvetica.ttf"); let fontindex = 0; // only for fonts with font collections let fontmetrics = getfontmetricsfreetype(&font, fontindex); let words = splittextintowords(text); let scaledwords = wordstoscaledwords(&words, &font, fontindex as u32, fontmetrics, fontsize);
let totalwidth = scaledwords.items.iter().map(|i| i.word_width).sum(); ```
```rust,ignore,norun use azultextlayout::{textlayout, textshaping::getfontmetricsfreetype}; use azulcss::{LayoutSize, StyleTextAlignmentHorz}; use azulcore::ui_solver::ResolvedTextLayoutOptions;
// set all options of the text let text = "hello"; let fontsize = 14.0; // px let fontbytes = includebytes!("Helvetica.ttf"); let fontindex = 0; // only for fonts with font collections let textlayoutoptions = ResolvedTextLayoutOptions { fontsizepx: fontsize, lineheight: None, letterspacing: None, wordspacing: None, tabwidth: None, // for line breaking, maximum width that a line can have maxhorizontal_width: Some(400.0), // px leading: None, holes: Vec::new(), };
// Cache the font metrics of the given font (baseline, height, etc.) let fontmetrics = getfontmetricsfreetype(fontbytes, fontindex as i32); // "Hello World" => ["Hello", "World"] let words = textlayout::splittextintowords(text); // "Hello" @ 14px => Size { width: 50px, height: 14px } let scaledwords = textlayout::wordstoscaledwords(&words, fontbytes, fontindex, fontmetrics, textlayoutoptions.fontsizepx); // Calculate the origin of the word relative to the line let wordpositions = textlayout::positionwords(&words, &scaledwords, &textlayoutoptions); // Calculate the origin of the line relative to (0, 0) let mut inlinetextlayout = textlayout::wordpositionstoinlinetextlayout(&wordpositions, &scaledwords); // Align the line horizontally inlinetextlayout.alignchildrenhorizontal(StyleTextAlignmentHorz::Center); // Calculate the glyph positons (lineoffset + wordoffset + glyphoffset) let layoutedglyphs = textlayout::getlayoutedglyphs(&wordpositions, &scaledwords, &inlinetext_layout);
println!("{:#?}", inlinetextlayout); // get infos about word offset, line breaking, etc. println!("{:#?}", layouted_glyphs); // get the final glyph positions relative to the origin ```
License: MIT