Class GlyphLayout

gdx/src/com/badlogic/gdx/graphics/g2d/GlyphLayout.java:48–630

Stores GlyphRun runs of glyphs for a piece of text. The text may contain newlines and color markup tags. Where wrapping occurs is determined by BitmapFontData#getWrapIndex(Array, int). Additionally, when BitmapFontData#markupEnabled is true wrapping can occur at color sta

 * @author Alexander Dorokhov
 * @author Thomas Creutzenberg */
public class GlyphLayout implements Poolable {
	static private final Pool<GlyphRun> glyphRunPool = new DefaultPool<>(GlyphRun::new);
	static private final IntArray colorStack = new IntArray(4);
	static private final float epsilon = 0.0001f;

	/** Each run has the glyphs for a line of text.
	 * <p>
	 * Runs are pooled, so references should not be kept past the next call to
	 * {@link #setText(BitmapFont, CharSequence, int, int, Color, float, int, boolean, String)} or {@link #reset()}. */
	public final Array<GlyphRun> runs = new Array(1);

	/** Determines the colors of the glpyhs in the {@link #runs}. Entries are pairs where the first is the glyph index (across all
	 * runs) where the color starts and the second is the color encoded as ABGR8888.
	 * <p>
	 * For example: <code>[0, WHITE, 4, GREEN, 5, WHITE]</code><br>
	 * Glpyhs 0 to 3 are WHITE, 4 is GREEN and 5 to the end are WHITE.
	 * <p>
	 * The array is empty if there are no runs, otherwise it has at least two entries: <code>[0, startColor]</code> */
	public final IntArray colors = new IntArray(2);

	/** Number of glyphs across all {@link #runs}. */
	public int glyphCount;

	public float width, height;

	/** Creates an empty GlyphLayout. */
	public GlyphLayout () {
	}

	/** @see #setText(BitmapFont, CharSequence) */
	public GlyphLayout (BitmapFont font, CharSequence str) {
		setText(font, str);
	}

	/** @see #setText(BitmapFont, CharSequence) */
	public GlyphLayout (BitmapFont font, CharSequence str, Color color, float targetWidth, int halign, boolean wrap) {
		setText(font, str, color, targetWidth, halign, wrap);
	}

	/** @see #setText(BitmapFont, CharSequence) */
	public GlyphLayout (BitmapFont font, CharSequence str, int start, int end, Color color, float targetWidth, int halign,
		boolean wrap, String truncate) {
		setText(font, str, start, end, color, targetWidth, halign, wrap, truncate);
	}

	/** Calls {@link #setText(BitmapFont, CharSequence, int, int, Color, float, int, boolean, String) setText} with the whole
	 * string, the font's current color, and no alignment or wrapping. */
	public void setText (BitmapFont font, CharSequence str) {
		setText(font, str, 0, str.length(), font.getColor(), 0, Align.left, false, null);
	}

	/** Calls {@link #setText(BitmapFont, CharSequence, int, int, Color, float, int, boolean, String) setText} with the whole
	 * string and no truncation. */
	public void setText (BitmapFont font, CharSequence str, Color color, float targetWidth, int halign, boolean wrap) {
		setText(font, str, 0, str.length(), color, targetWidth, halign, wrap, null);
	}

	/** @param color The default color to use for the text (the BitmapFont {@link BitmapFont#getColor() color} is not used). If