Package org.bitbrawl.foodfight.controller

Interface Clock

public interface Clock

A timer that can be used to determine how much time a controller has left for all of its moves.

Time limits in the game work like a chess timer: each controller gets a certain amount of time total to make all of its moves (TIME_LIMIT_NANOS, equal to sixty seconds), but it can spend that time among its turns however it wishes. For example, a controller could spend half of its allotted time on its first move if it spends less on its remaining turns.

Author:

Finn

Field Summary

Fields

Modifier and Type	Field	Description
static long	TIME_LIMIT_NANOS	The time limit (in nanoseconds) for all of a controller's moves.

Method Summary

Modifier and Type	Method	Description
long	getTimeLeft(TimeUnit unit)	Returns the amount of time that a controller has left in the game.

Field Detail

TIME_LIMIT_NANOS

static final long TIME_LIMIT_NANOS

The time limit (in nanoseconds) for all of a controller's moves.

Method Detail

getTimeLeft

long getTimeLeft(TimeUnit unit)

Returns the amount of time that a controller has left in the game. This is the amount of time left for all of this player's moves, not just the current turn. To determine how many moves are left in the game, a controller could use Field.getTurnNumber() and Field.TOTAL_TURNS. Note that this method rounds down to the nearest time unit, so it will provide more accurate results if a smaller time unit is used.

Parameters:

unit - the unit of time to use for time-left calculations

Returns:

the amount of time remaining for the associated controller