playn.core

Class TextBlock

java.lang.Object

playn.core.TextBlock

public class TextBlock
extends java.lang.Object

Encapsulates a block of multi-line text. This code handles all the fiddly "fonts sometimes extend outside their reported bounds" hackery that was once embedded into the various backend code. It also handles text alignment.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TextBlock.Align Used to align a block of text.

Field Summary

Fields

Modifier and Type	Field and Description
IRectangle	bounds The bounds of this block of text.
TextLayout[]	lines The individual lines of text in this block.

Constructor Summary

Constructors

Constructor and Description
TextBlock(TextLayout[] lines) Creates a text block with the supplied lines.

Method Summary

Modifier and Type	Method and Description
void	fill(Canvas canvas, TextBlock.Align align, float x, float y) Fills lines into canvas at the specified coordinates, using the specified alignment.
static Rectangle	getBounds(TextLayout[] lines, Rectangle into) Computes the bounds of a block of text.
void	stroke(Canvas canvas, TextBlock.Align align, float x, float y) Strokes lines into canvas at the specified coordinates, using the specified alignment.
float	textWidth() Returns the width of the rendered text.
Canvas	toCanvas(Graphics gfx, TextBlock.Align align, int fillColor) Creates a canvas image large enough to accommodate this text block and renders the lines into it.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

lines

public final TextLayout[] lines

The individual lines of text in this block. Obtained by a call to Graphics.layoutText(String,TextFormat,TextWrap).

bounds

public final IRectangle bounds

The bounds of this block of text. The x component of the bounds may be positive, indicating that the text should be rendered at that offset. This is to account for the fact that some text renders to the left of its reported origin due to font extravagance. The stroke(playn.core.Canvas, playn.core.TextBlock.Align, float, float) and fill(playn.core.Canvas, playn.core.TextBlock.Align, float, float) methods automatically take into account this x coordinate, the caller need only account for it if they choose to render lines manually.

Constructor Detail

TextBlock

public TextBlock(TextLayout[] lines)

Creates a text block with the supplied lines.

Method Detail

getBounds

public static Rectangle getBounds(TextLayout[] lines,
                                  Rectangle into)

Computes the bounds of a block of text. The x component of the bounds may be positive, indicating that the text should be rendered at that offset. This is to account for the fact that some text renders to the left of its reported origin due to font extravagance.

textWidth

public float textWidth()

Returns the width of the rendered text. This is the width that should be used when computing alignment for text in this block.

fill

public void fill(Canvas canvas,
                 TextBlock.Align align,
                 float x,
                 float y)

Fills lines into canvas at the specified coordinates, using the specified alignment.

stroke

public void stroke(Canvas canvas,
                   TextBlock.Align align,
                   float x,
                   float y)

Strokes lines into canvas at the specified coordinates, using the specified alignment.

toCanvas

public Canvas toCanvas(Graphics gfx,
                       TextBlock.Align align,
                       int fillColor)

Creates a canvas image large enough to accommodate this text block and renders the lines into it. The image will include padding around the edge to ensure that antialiasing has a bit of extra space to do its work.