Skip to main content
Version: 14.x (API 14) [Legacy]

Struct FluentGlyphRangeBuilder

A fluent ImGui glyph range builder.

Assembly: Dalamud.dll
Declaration
public struct FluentGlyphRangeBuilder

Methods

Clear()

Clears the builder.

Declaration
public FluentGlyphRangeBuilder Clear()
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Remarks

A builder is in cleared state on first use.

With(char)

Adds a single codepoint to the builder.

Declaration
public FluentGlyphRangeBuilder With(char codepoint)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.CharcodepointThe codepoint to add.
Remarks

Unsupported codepoints will be ignored.

With(uint)

Adds a single codepoint to the builder.

Declaration
public FluentGlyphRangeBuilder With(uint codepoint)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.UInt32codepointThe codepoint to add.
Remarks

Unsupported codepoints will be ignored.

With(int)

Adds a single codepoint to the builder.

Declaration
public FluentGlyphRangeBuilder With(int codepoint)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Int32codepointThe codepoint to add.
Remarks

Unsupported codepoints will be ignored.

With(UnicodeRange)

Adds a unicode range to the builder.

Declaration
public FluentGlyphRangeBuilder With(UnicodeRange range)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Text.Unicode.UnicodeRangerangeThe unicode range to add.
Remarks

Unsupported codepoints will be ignored.

With(UnicodeRange, UnicodeRange)

Adds unicode ranges to the builder.

Declaration
public FluentGlyphRangeBuilder With(UnicodeRange range1, UnicodeRange range2)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Text.Unicode.UnicodeRangerange1The 1st unicode range to add.
System.Text.Unicode.UnicodeRangerange2The 2st unicode range to add.
Remarks

Unsupported codepoints will be ignored.

With(UnicodeRange, UnicodeRange, UnicodeRange)

Adds unicode ranges to the builder.

Declaration
public FluentGlyphRangeBuilder With(UnicodeRange range1, UnicodeRange range2, UnicodeRange range3)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Text.Unicode.UnicodeRangerange1The 1st unicode range to add.
System.Text.Unicode.UnicodeRangerange2The 2st unicode range to add.
System.Text.Unicode.UnicodeRangerange3The 3rd unicode range to add.
Remarks

Unsupported codepoints will be ignored.

With(UnicodeRange, UnicodeRange, UnicodeRange, UnicodeRange, params UnicodeRange[])

Adds unicode ranges to the builder.

Declaration
public FluentGlyphRangeBuilder With(UnicodeRange range1, UnicodeRange range2, UnicodeRange range3, UnicodeRange range4, params UnicodeRange[] evenMoreRanges)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Text.Unicode.UnicodeRangerange1The 1st unicode range to add.
System.Text.Unicode.UnicodeRangerange2The 2st unicode range to add.
System.Text.Unicode.UnicodeRangerange3The 3rd unicode range to add.
System.Text.Unicode.UnicodeRangerange4The 4th unicode range to add.
System.Text.Unicode.UnicodeRange[]evenMoreRangesEven more unicode ranges to add.
Remarks

Unsupported codepoints will be ignored.

With(IEnumerable<UnicodeRange>)

Adds unicode ranges to the builder.

Declaration
public FluentGlyphRangeBuilder With(IEnumerable<UnicodeRange> ranges)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Collections.Generic.IEnumerable<System.Text.Unicode.UnicodeRange>rangesUnicode ranges to add.
Remarks

Unsupported codepoints will be ignored.

With(char, char)

Adds a range of characters to the builder.

Declaration
public FluentGlyphRangeBuilder With(char from, char to)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.CharfromThe first codepoint, inclusive.
System.ChartoThe last codepoint, inclusive.
Remarks

<p>Unsupported codepoints will be ignored.</p> <p>If <code class="paramref">from</code> is more than <code class="paramref">to</code>, then they will be swapped.</p>

With(uint, uint)

Adds a range of characters to the builder.

Declaration
public FluentGlyphRangeBuilder With(uint from, uint to)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.UInt32fromThe first codepoint, inclusive.
System.UInt32toThe last codepoint, inclusive.
Remarks

<p>Unsupported codepoints will be ignored.</p> <p>If <code class="paramref">from</code> is more than <code class="paramref">to</code>, then they will be swapped.</p>

With(int, int)

Adds a range of characters to the builder.

Declaration
public FluentGlyphRangeBuilder With(int from, int to)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Int32fromThe first codepoint, inclusive.
System.Int32toThe last codepoint, inclusive.
Remarks

<p>Unsupported codepoints will be ignored.</p> <p>If <code class="paramref">from</code> is more than <code class="paramref">to</code>, then they will be swapped.</p>

With(ReadOnlySpan<byte>)

Adds characters from a UTF-8 character sequence.

Declaration
public FluentGlyphRangeBuilder With(ReadOnlySpan<byte> utf8Sequence)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.ReadOnlySpan<System.Byte>utf8SequenceThe sequence.
Remarks

Unsupported codepoints will be ignored.

With(IEnumerable<byte>)

Adds characters from a UTF-8 character sequence.

Declaration
public FluentGlyphRangeBuilder With(IEnumerable<byte> utf8Sequence)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Collections.Generic.IEnumerable<System.Byte>utf8SequenceThe sequence.
Remarks

Unsupported codepoints will be ignored.

With(ReadOnlySpan<char>)

Adds characters from a UTF-16 character sequence.

Declaration
public FluentGlyphRangeBuilder With(ReadOnlySpan<char> utf16Sequence)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.ReadOnlySpan<System.Char>utf16SequenceThe sequence.
Remarks

Unsupported codepoints will be ignored.

With(IEnumerable<char>)

Adds characters from a UTF-16 character sequence.

Declaration
public FluentGlyphRangeBuilder With(IEnumerable<char> utf16Sequence)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Collections.Generic.IEnumerable<System.Char>utf16SequenceThe sequence.
Remarks

Unsupported codepoints will be ignored.

With(string)

Adds characters from a string.

Declaration
public FluentGlyphRangeBuilder With(string @string)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.StringstringThe string.
Remarks

Unsupported codepoints will be ignored.

WithLanguage(CultureInfo)

Adds glyphs that are likely to be used in the given culture to the builder.

Declaration
public FluentGlyphRangeBuilder WithLanguage(CultureInfo cultureInfo)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.Globalization.CultureInfocultureInfoA culture info.
Remarks

Unsupported codepoints will be ignored. Unsupported culture will do nothing. Do make a PR if you need more.

WithLanguage(string)

Adds glyphs that are likely to be used in the given culture to the builder.

Declaration
public FluentGlyphRangeBuilder WithLanguage(string languageTag)
Returns

Dalamud.Interface.ManagedFontAtlas.FluentGlyphRangeBuilder: this for method chaining.

Parameters
TypeNameDescription
System.StringlanguageTagA language tag that will be used to locate the culture info.
Remarks

See System.Globalization.CultureInfo.GetCultureInfo(System.String) documentation for supported language tags.

Build(bool, bool)

Builds the accumulated data into an ImGui glyph range.

Declaration
public ushort[] Build(bool addFallbackCodepoints = true, bool addEllipsisCodepoints = true)
Returns

System.UInt16[]: The built ImGui glyph ranges.

Parameters
TypeNameDescription
System.BooleanaddFallbackCodepointsWhether to add the default fallback codepoints to the range.
System.BooleanaddEllipsisCodepointsWhether to add the default ellipsis codepoints to the range.

BuildExact()

Builds the accumulated data into an ImGui glyph range, exactly as specified.

Declaration
public ushort[] BuildExact()
Returns

System.UInt16[]: The built ImGui glyph ranges.