Package VASSAL.build.module

Class ChessClockControl

java.lang.Object

VASSAL.search.AbstractImageFinder

VASSAL.build.AbstractBuildable

VASSAL.build.AbstractConfigurable

VASSAL.build.module.ChessClockControl

All Implemented Interfaces:

AutoConfigurable, Buildable, Configurable, GameComponent, PropertyNameSource, CommandEncoder, ComponentDescription, ValidityChecker, Translatable, Auditable, ImageSearchTarget, SearchTarget, UniqueIdManager.Identifyable

public class ChessClockControl
extends AbstractConfigurable
implements CommandEncoder, GameComponent, UniqueIdManager.Identifyable, ComponentDescription

CHESS CLOCK CONTROLLER for VASSAL. This Module-level component manages a set of one or more ChessClock clocks. It creates a master "Chess Clocks" button on the Module's toolbar. Clicking the button shows/hides the clocks themselves, when no clocks are running, or stops all clocks if one is running. The Chess Clock Control component also contains the configurable elements that specify how the clocks are to be displayed.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ChessClockControl.IconConfig	Autoconfigurer for master chessclock button icon (allows user to choose an icon image)
static class	ChessClockControl.TimeStyleConfig	Autoconfigurer for the days/hours/minutes/seconds/tenths styles

Nested classes/interfaces inherited from interface VASSAL.build.AutoConfigurable

AutoConfigurable.Util

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ALLOW_RESET
protected boolean	allowReset
static final String	BUTTON_TEXT
static final String	BUTTON_TOOLTIP
protected LaunchButton	chessClockButton
protected List<ChessClock>	chessclocks
protected boolean	chessClocksVisible
static final String	CHESSMENU_HIDE
static final String	CHESSMENU_NEXT
static final String	CHESSMENU_PAUSE
static final String	CHESSMENU_SHOW
static final String	CHESSMENU_START_OPPONENT
static final String	COMMAND_PREFIX
static final char	DELIMITER
protected String	description
static final String	DESCRIPTION
static final String	ICON
protected String	id
protected static final UniqueIdManager	ID_MGR
protected boolean	instanceIsActive
static final String	NAME
static final String	NEXT_HOTKEY
protected NamedKeyStrokeListener	nextListener
protected boolean	onlineGame
static final String	PAUSE_HOTKEY
protected NamedKeyStrokeListener	pauseListener
static final String	SHOW_DAYS
static final String	SHOW_HOTKEY
static final String	SHOW_HOURS
static final String	SHOW_SECONDS
static final String	SHOW_TENTHSECONDS
protected String	showDays
protected String	showHours
protected NamedKeyStrokeListener	showListener
protected String	showSeconds
protected String	showTenthSeconds
static final String	START_OPPONENT_HOTKEY
protected NamedKeyStrokeListener	startOpponentListener
static final String	STYLE_ALWAYS
static final String	STYLE_AUTO
static final String	STYLE_NEVER

Fields inherited from class VASSAL.build.AbstractConfigurable

changeSupport, config, localizedName, myI18nData, name

Fields inherited from class VASSAL.build.AbstractBuildable

buildComponents, validator

Fields inherited from interface VASSAL.build.Configurable

NAME_PROPERTY

Constructor Summary

Constructors

Constructor	Description
ChessClockControl()

Method Summary

Modifier and Type	Method	Description
void	addChessClock(ChessClock clock)	Allows individual chess clocks to add themselves to our control scheme
void	addTo(Buildable parent)	Registers us with the game module, tool bar, command encoder, etc.
void	build(Element e)	Builds the clock control's component hierarchy from a given XML element, or a null one is given initializes a brand new default "new clock control" hierarchy.
Command	decode(String command)	Deserializes our command from a string version, if the command belongs to us.
String	encode(Command c)	Serializes our command into a string, if it belongs to us
Class<?>[]	getAllowableConfigureComponents()
String[]	getAttributeDescriptions()	Return an array of Strings describing the attributes of this object.
String[]	getAttributeNames()	Lists all the buildFile (XML) attribute names for this component.
Class<?>[]	getAttributeTypes()	Return the Class for the attributes of this object.
String	getAttributeValueString(String key)	Gets the value of one of this component's XML attributes
List<ChessClock>	getChessClocks()
boolean	getChessClocksVisible()
int	getClocksTicking()
static String	getConfigureTypeName()
String	getDescription()
HelpFile	getHelpFile()
String	getId()
static ChessClockControl	getInstance()	When we need to find a ChessClockControl in a static context
Command	getRestoreCommand()	When saving a game, each GameComponent should return a Command that, when executed, restores the GameComponent to its state when the game was saved If this component has no persistent state, return null
String	getShowDays()
String	getShowHours()
String	getShowSeconds()
String	getShowTenths()
void	hideClocks()	Hide all the clocks on the toolbar
boolean	isAllowReset()
boolean	isInstanceIsActive()
boolean	isOnline()
boolean	isUnique()	There can be only one!
void	pressControlButton()	Figures out "the right thing to do" when player clicks the main Chess Clock Control button.
void	removeChessClock(ChessClock clock)	Removes a chess clock
void	removeFrom(Buildable parent)	Unregisters us from everything when shutting down.
void	setAttribute(String key, Object value)	Sets the value of one of this component's XML attributes
void	setId(String id)	Manages our unique ID
void	setOnline(boolean online)	Tells Chess Clock Control that this is a real online game, meaning we move to stricter verification standards for clocks (completely non-online clocks are really just "sandbox toys")
void	setup(boolean gameStarting)	Handles starting and ending a game from the point of view of Chess Clocks.
void	showClocks()	Show all the clocks on the toolbar
Command	startClock(ChessClock targetClock)
Command	startNextClock()
Command	startOpponentClock()
Command	stopAllClocks()
Command	stopClock(ChessClock targetClock)
void	updateAllClocks()	Update all clocks (when our time-display format changes)

Methods inherited from class VASSAL.build.AbstractConfigurable

add, addPropertyChangeListener, getAttributeVisibility, getConfigureComponents, getConfigureName, getConfigurer, getExpressionList, getFormattedStringList, getI18nData, getI18nPrefix, getLocalizedConfigureName, getMenuTextList, getNamedKeyStrokeList, getPropertyList, getTypeName, remove, removePropertyChangeListener, setAllAttributesUntranslatable, setAttributeTranslatable, setConfigureName

Methods inherited from class VASSAL.build.AbstractBuildable

addImageNamesRecursively, buildString, getAllDescendantComponentsOf, getAncestor, getBuildables, getBuildComponents, getBuildElement, getComponents, getComponentsOf, getNonFolderAncestor, getPropertyNames, setAncestor, validate

Methods inherited from class VASSAL.search.AbstractImageFinder

addLocalImageNames, getAllImageNames, getLocalImageNames

Methods inherited from class java.lang.Object

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

Methods inherited from interface VASSAL.script.expression.Auditable

getComponentName, getComponentTypeName

Methods inherited from interface VASSAL.build.Buildable

getBuildElement, isMandatory, isMovable

Methods inherited from interface VASSAL.tools.UniqueIdManager.Identifyable

getConfigureName

Field Details

ID_MGR

protected static final UniqueIdManager ID_MGR

chessclocks

protected List<ChessClock> chessclocks

showTenthSeconds

protected String showTenthSeconds

showSeconds

protected String showSeconds

showHours

protected String showHours

showDays

protected String showDays

allowReset

protected boolean allowReset

chessClockButton

protected LaunchButton chessClockButton

chessClocksVisible

protected boolean chessClocksVisible

onlineGame

protected boolean onlineGame

nextListener

protected NamedKeyStrokeListener nextListener

startOpponentListener

protected NamedKeyStrokeListener startOpponentListener

showListener

protected NamedKeyStrokeListener showListener

pauseListener

protected NamedKeyStrokeListener pauseListener

instanceIsActive

protected boolean instanceIsActive

id

protected String id

description

protected String description

DELIMITER

public static final char DELIMITER

See Also:

• Constant Field Values

NAME

public static final String NAME

See Also:

• Constant Field Values

ICON

public static final String ICON

See Also:

• Constant Field Values

BUTTON_TEXT

public static final String BUTTON_TEXT

See Also:

• Constant Field Values

BUTTON_TOOLTIP

public static final String BUTTON_TOOLTIP

See Also:

• Constant Field Values

DESCRIPTION

public static final String DESCRIPTION

See Also:

• Constant Field Values

PAUSE_HOTKEY

public static final String PAUSE_HOTKEY

See Also:

• Constant Field Values

NEXT_HOTKEY

public static final String NEXT_HOTKEY

See Also:

• Constant Field Values

START_OPPONENT_HOTKEY

public static final String START_OPPONENT_HOTKEY

See Also:

• Constant Field Values

SHOW_HOTKEY

public static final String SHOW_HOTKEY

See Also:

• Constant Field Values

SHOW_TENTHSECONDS

public static final String SHOW_TENTHSECONDS

See Also:

• Constant Field Values

SHOW_SECONDS

public static final String SHOW_SECONDS

See Also:

• Constant Field Values

SHOW_HOURS

public static final String SHOW_HOURS

See Also:

• Constant Field Values

SHOW_DAYS

public static final String SHOW_DAYS

See Also:

• Constant Field Values

ALLOW_RESET

public static final String ALLOW_RESET

See Also:

• Constant Field Values

STYLE_ALWAYS

public static final String STYLE_ALWAYS

See Also:

• Constant Field Values

STYLE_AUTO

public static final String STYLE_AUTO

See Also:

• Constant Field Values

STYLE_NEVER

public static final String STYLE_NEVER

See Also:

• Constant Field Values

CHESSMENU_PAUSE

public static final String CHESSMENU_PAUSE

CHESSMENU_SHOW

public static final String CHESSMENU_SHOW

CHESSMENU_HIDE

public static final String CHESSMENU_HIDE

CHESSMENU_NEXT

public static final String CHESSMENU_NEXT

CHESSMENU_START_OPPONENT

public static final String CHESSMENU_START_OPPONENT

COMMAND_PREFIX

public static final String COMMAND_PREFIX

See Also:

• Constant Field Values

Constructor Details

ChessClockControl

public ChessClockControl()

Method Details

isInstanceIsActive

public boolean isInstanceIsActive()

getChessClocks

public List<ChessClock> getChessClocks()

Returns:

Our list of chessclocks

getDescription

public String getDescription()

Specified by:

getDescription in interface ComponentDescription

Returns:

Description to be displayed next to component type/name in the main Editor window. Or null or "" to not display anything.

build

public void build(Element e)

Builds the clock control's component hierarchy from a given XML element, or a null one is given initializes a brand new default "new clock control" hierarchy.

Specified by:

build in interface Buildable

Overrides:

build in class AbstractBuildable

Parameters:

e - XML element to build from, or null to build the default hierarchy

addTo

public void addTo(Buildable parent)

Registers us with the game module, tool bar, command encoder, etc.

Specified by:

addTo in interface Buildable

Parameters:

parent - - Should be the main GameModule, but in any event that's what we add it to

removeFrom

public void removeFrom(Buildable parent)

Unregisters us from everything when shutting down.

Specified by:

removeFrom in interface Configurable

Parameters:

parent - - Presumably the main GameModule, but in any event that's what we remove ourselves from.

setId

public void setId(String id)

Manages our unique ID

Specified by:

setId in interface UniqueIdManager.Identifyable

Parameters:

id - - sets our unique id

getId

public String getId()

Specified by:

getId in interface UniqueIdManager.Identifyable

Returns:

our unique id

isAllowReset

public boolean isAllowReset()

Returns:

Whether clocks can be reset manually

getChessClocksVisible

public boolean getChessClocksVisible()

Returns:

true if the group of chess clocks we manage is currently visible

getConfigureTypeName

public static String getConfigureTypeName()

Returns:

Component type name, which appears in [..] in Editor window

getAllowableConfigureComponents

public Class<?>[] getAllowableConfigureComponents()

Specified by:

getAllowableConfigureComponents in interface Configurable

Returns:

List of valid subcomponent class types for this component (in our case, individual Chess Clocks!) which can be added in the Editor.

getAttributeNames

public String[] getAttributeNames()

Description copied from class: AbstractBuildable

Lists all the buildFile (XML) attribute names for this component. If this component is ALSO an AbstractConfigurable, then this list of attributes determines the appropriate attribute order for AbstractConfigurable.getAttributeDescriptions() and AbstractConfigurable.getAttributeTypes().

Specified by:

getAttributeNames in interface AutoConfigurable

Specified by:

getAttributeNames in class AbstractBuildable

Returns:

Key names for our attributes from the buildFile (XML) definition.

getAttributeDescriptions

public String[] getAttributeDescriptions()

Description copied from interface: AutoConfigurable

Return an array of Strings describing the attributes of this object. These strings are used as prompts in the Properties window for this object.

Specified by:

getAttributeDescriptions in interface AutoConfigurable

Specified by:

getAttributeDescriptions in class AbstractConfigurable

Returns:

Descriptions for our buildFile (XML) attributes. These appear when our component is configured in the Editor window.

getAttributeTypes

public Class<?>[] getAttributeTypes()

Description copied from interface: AutoConfigurable

Return the Class for the attributes of this object. Valid classes are: String, Integer, Double, Boolean, Image, File, Color, and KeyStroke

Specified by:

getAttributeTypes in interface AutoConfigurable

Specified by:

getAttributeTypes in class AbstractConfigurable

Returns:

Class types for configuring each of our buildFile (XML) attributes. Specifies which flavor of configurer to uses.

setAttribute

public void setAttribute(String key,
 Object value)

Sets the value of one of this component's XML attributes

Specified by:

setAttribute in interface AutoConfigurable

Specified by:

setAttribute in interface Translatable

Specified by:

setAttribute in class AbstractBuildable

Parameters:

key - the name of the attribute. Will be one of those listed in getAttributeNames()

value - New value for the attribute. Can be either String version or the actual Object.

getAttributeValueString

public String getAttributeValueString(String key)

Gets the value of one of this component's XML attributes

Specified by:

getAttributeValueString in interface AutoConfigurable

Specified by:

getAttributeValueString in interface Translatable

Specified by:

getAttributeValueString in class AbstractBuildable

Parameters:

key - the name of the attribute. Will be one of those listed in getAttributeNames()

Returns:

String value of the attribute.

getHelpFile

public HelpFile getHelpFile()

Specified by:

getHelpFile in interface Configurable

Returns:

The help file for this component. Used when user clicks "Help" button while configuring the component in the Editor.

getInstance

public static ChessClockControl getInstance()

When we need to find a ChessClockControl in a static context

Returns:

First ChessClockControl in our module

getShowTenths

public String getShowTenths()

Returns:

Setting for showing tenths of seconds. (Always, Auto, Never)

getShowSeconds

public String getShowSeconds()

Returns:

Setting for showing seconds. (Always, Auto, Never)

getShowHours

public String getShowHours()

Returns:

Setting for showing hours. (Always, Auto, Never)

getShowDays

public String getShowDays()

Returns:

Setting for showing days. (Always, Auto, Never)

getClocksTicking

public int getClocksTicking()

Returns:

the number of chess clocks currently ticking/active

stopAllClocks

public Command stopAllClocks()

Returns:

A command to stop all the clocks

startNextClock

public Command startNextClock()

Returns:

a command to start the next clock after stopping the one currently running (if any)

startOpponentClock

public Command startOpponentClock()

Returns:

a command to start the opponents clock after stopping the one currently running (if any)

startClock

public Command startClock(ChessClock targetClock)

Returns:

a command to start the requested clock after stopping the one currently running (if any)

stopClock

public Command stopClock(ChessClock targetClock)

Returns:

a command to start the requested clock after stopping the one currently running (if any)

hideClocks

public void hideClocks()

Hide all the clocks on the toolbar

showClocks

public void showClocks()

Show all the clocks on the toolbar

updateAllClocks

public void updateAllClocks()

Update all clocks (when our time-display format changes)

pressControlButton

public void pressControlButton()

Figures out "the right thing to do" when player clicks the main Chess Clock Control button. Does one of the following, in order of priority: (1) If the clocks are hidden, show them (2) If any clock is running, stop them all (3) Hide all the clocks

setOnline

public void setOnline(boolean online)

Tells Chess Clock Control that this is a real online game, meaning we move to stricter verification standards for clocks (completely non-online clocks are really just "sandbox toys")

Parameters:

online - True if this is an online game

isOnline

public boolean isOnline()

Returns:

True if this has been marked as an online game

setup

public void setup(boolean gameStarting)

Handles starting and ending a game from the point of view of Chess Clocks.

Specified by:

setup in interface GameComponent

Parameters:

gameStarting - If true, a game is starting. If false, then a game is ending.

addChessClock

public void addChessClock(ChessClock clock)

Allows individual chess clocks to add themselves to our control scheme

Parameters:

clock - clock to be added

removeChessClock

public void removeChessClock(ChessClock clock)

Removes a chess clock

Parameters:

clock - clock to be removed

decode

public Command decode(String command)

Deserializes our command from a string version, if the command belongs to us.

Specified by:

decode in interface CommandEncoder

Parameters:

command - Serialized string command

Returns:

An ChessClockControl.UpdateClockControlCommand

encode

public String encode(Command c)

Serializes our command into a string, if it belongs to us

Specified by:

encode in interface CommandEncoder

Parameters:

c - Command to serialize. Only serialized if it's an UpdateClockControlCommand.

Returns:

Serialized command, or null if command passed wasn't an UpdateClockControlCommand.

getRestoreCommand

public Command getRestoreCommand()

Description copied from interface: GameComponent

When saving a game, each GameComponent should return a Command that, when executed, restores the GameComponent to its state when the game was saved If this component has no persistent state, return null

Specified by:

getRestoreCommand in interface GameComponent

Returns:

Our command for restoring from a saved game (or adding an online player)

isUnique

public boolean isUnique()

There can be only one!

Specified by:

isUnique in interface Buildable

Returns: