Enum TextJustify

Namespace

Egami.Fonts.Layout

Assembly

Egami.Fonts.dll

How justified lines stretch (CSS text-justify).

public enum TextJustify

Fields

Auto = 0

Word separators in scripts that use spaces; between characters in Chinese, Japanese and scripts without spaces.

InterCharacter = 2

Between every two grapheme clusters, except inside cursive scripts.

InterWord = 1

Word separators only.

Kashida = 4

Tatweels (kashida) lengthen words in Arabic and the other scripts that join with U+0640, as Word's kashida justification does, up to Kashida; word separators take the rest, and the only stretch in other scripts.

None = 3

No stretching; justified lines align at the start.

Examples

// Font families come from a collection; later families cover what the first lacks.
FontCollection fonts = new();
fonts.AddFile(System.IO.Path.Combine(folder, "NotoSans-Regular.ttf"));
fonts.AddFile(System.IO.Path.Combine(folder, "NotoSansArabic-Regular.ttf"));
fonts.TryGetFamily("Noto Sans", out FontFamily latin);
fonts.TryGetFamily("Noto Sans Arabic", out FontFamily arabic);

// Styles nest: the inner span keeps the outer one's size and adds a color and an underline.
RichText text = new RichTextBuilder()
    .Append("Peace is ")
    .Push(new TextStyle { Size = 20 })
    .Append("\u0633\u0644\u0627\u0645 ")
    .Push(new TextStyle { Color = new Rgba8(200, 30, 30, 255), Decoration = new TextDecoration() })
    .Append("in Arabic")
    .Pop()
    .Pop()
    .AddPlaceholder(new Placeholder(16, 16, PlaceholderAlignment.Middle))
    .ToRichText();

ParagraphStyle style = new()
{
    DefaultStyle = new TextStyle { FontFamilies = [latin, arabic], Size = 16, LineHeight = LineHeight.Multiple(1.4f) },
    Align = TextAlign.Justify,
    LineBreaking = new LineBreakOptions(WordBreak: WordBreak.Normal),
};

// Shaped once: lay it out at any width later.
Paragraph paragraph = Paragraph.Create(text, style);