ch.aplu.android

Class GGTextField

java.lang.Object

ch.aplu.android.GGTextField

public class GGTextField
extends java.lang.Object

Class to provide a dynamically created line of text shown in a game grid window. Gets its functionality from a TextActor instance (no subclassing of TextActor in order to shield the user from the many Actor class methods.) Whenever the text, fontSize, textColor, bgColor or typeface attribute is altered, the old text actor is removed from the game grid and a new actor is created and added to the game grid on the next show() invocation.

Constructor Summary

Constructors

Constructor and Description
GGTextField(Location location, boolean enableRefresh) Creates a GGTextField with standard attributes and no text.
GGTextField(java.lang.String text, Location location, boolean enableRefresh) Creates a GGTextField instance with standard attributes.

Method Summary

Methods

Modifier and Type	Method and Description
TextActor	getTextActor() Returns the current TextActor used for this text field.
int	getTextHeight() Returns the height of the text.
int	getTextWidth() Returns the total width of the text.
void	hide() Hides the text.
boolean	isVisible() Returns the visibility of the text.
void	setBgColor(int bgColor) Sets the background color attribute.
void	setFontSize(int fontSize) Sets the font size attribute.
void	setLocation(Location location) Sets the location attribute.
void	setLocationOffset(android.graphics.Point locationOffset) Sets a pixel offset in x- any y-direction relative to the current location.
void	setText(java.lang.String text) Sets the text attribute.
void	setTextColor(int textColor) Sets the text color attribute.
void	setTypeface(android.graphics.Typeface typeface) Sets the typeface attribute.
void	show() Displays the text.

Methods inherited from class java.lang.Object

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

Constructor Detail

GGTextField

public GGTextField(java.lang.String text,
           Location location,
           boolean enableRefresh)

Creates a GGTextField instance with standard attributes. Does not yet show the text. The internal text actor is created and added to the game grid at this point, but the text actor is still hidden. The order of visiblity in respect to other actors does not depend on the moment of creation, because the text actor is set on top of other actors when show() is invoked. The text color is white, the background color transparent, the font size 20 pixels and the typeface Typeface.DEFAULT. Automatic refresh can cause flickering, when the text actors are created rapidly. To avoid flickering, let the simulation thread perform the refreshing.

Parameters:

location - the location where the the text will be placed (horizontally left aligned, vertically center aligned)

text - the text string to show

enableRefresh - if true, the automatic refresh of the game grid is turned on; otherwise refresh must be called by user code or performed by the simulation thread

GGTextField

public GGTextField(Location location,
           boolean enableRefresh)

Creates a GGTextField with standard attributes and no text.

Parameters:

location - the location where the the text will be placed (horizontally left aligned, vertically center aligned)

enableRefresh - if true, the automatic refresh of the game grid is turned on; otherwise refresh must be called by user code or performed by the simulation thread

Method Detail

show

public void show()

Displays the text. If the text was never shown or attributes were modified, creates the internal TextActor instance. Sets the visibility of the TextActor class on top of all other Actor's classes. This may be changed by calling GameGrid.setPaintOrder(). Be aware that the paint order of all other TextActors is affected. Refreshs the game grid, if enableRefresh = true was set in the constructor.

See Also:

GameGrid.setPaintOrder(Class... classes)

hide

public void hide()

Hides the text. Refreshs the game grid, if enableRefresh = true was set in the constructor.

isVisible

public boolean isVisible()

Returns the visibility of the text.

Returns:

true, if the text is visible; otherwise false

setLocation

public void setLocation(Location location)

Sets the location attribute. Refreshs the game grid, if enableRefresh = true was set in the constructor.

Parameters:

location - the location where the the text will be placed (horizontally left aligned, vertically center aligned)

setLocationOffset

public void setLocationOffset(android.graphics.Point locationOffset)

Sets a pixel offset in x- any y-direction relative to the current location. Refreshs the game grid, if enableRefresh = true was set in the constructor. Used to fine tune the displayed text field position in a coarse game grid.

Parameters:

locationOffset - x,y displacement (x to the left, y downwards)

setText

public void setText(java.lang.String text)

Sets the text attribute. Refreshs the game grid, if enableRefresh = true was set in the constructor.

Parameters:

text - the text string to show

setTextColor

public void setTextColor(int textColor)

Sets the text color attribute. Refreshs the game grid, if enableRefresh = true was set in the constructor.

Parameters:

textColor - the color of the text

setBgColor

public void setBgColor(int bgColor)

Sets the background color attribute. Refreshs the game grid, if enableRefresh = true was set in the constructor.

Parameters:

bgColor - the color of the text background

setFontSize

public void setFontSize(int fontSize)

Sets the font size attribute. Refreshs the game grid, if enableRefresh = true was set in the constructor.

Parameters:

fontSize - the size of the font (in pixels)

setTypeface

public void setTypeface(android.graphics.Typeface typeface)

Sets the typeface attribute. Refreshs the game grid, if enableRefresh = true was set in the constructor.

Parameters:

typeface - the typeface (font) of the text

getTextActor

public TextActor getTextActor()

Returns the current TextActor used for this text field. The actor changes when the text, fontSize, textColor, bgColor or typeface attribute is altered and the modified text is shown.

Returns:

the text actor used for this field; null, if the actor has never been shown

getTextWidth

public int getTextWidth()

Returns the total width of the text. Maybe used to align the text.

Returns:

the text width in pixels

getTextHeight

public int getTextHeight()

Returns the height of the text. Maybe used to align the text.

Returns:

the text height in pixels