com.antelmann.game.fourwins
Class FourWinsPlayer

java.lang.Object
  com.antelmann.game.TemplatePlayer
      com.antelmann.game.fourwins.FourWinsPlayer

All Implemented Interfaces:

Player, Serializable

public class FourWinsPlayer
extends TemplatePlayer

adds AI to the FourWinsGame

Author:

Holger Antelmann

See Also:

FourWinsGame, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.antelmann.game.TemplatePlayer

TemplatePlayer.MoveEvaluater, TemplatePlayer.Synchronizer

Field Summary

Fields inherited from class com.antelmann.game.TemplatePlayer

levelOverride, monitors, orderMoves, playerName, SEARCH_ALPHABETA, SEARCH_MINMAX, searchOption

Constructor Summary

FourWinsPlayer()

FourWinsPlayer(String name)

FourWinsPlayer(String name, int searchOption, boolean trackingEnabled)

FourWinsPlayer(String name, int searchOption, boolean trackingEnabled, long randomSeed)

Method Summary

boolean	canPlayGame(GamePlay game) canPlayGame() returns true only if the Player provides an applicable heuristic for the type of game given.
void	disableRandom()
double	heuristic(GamePlay game, GameMove move, int[] role) This function - often used as a callback function - evaluates the given move in the context of the given game; it is expected to return quickly.
protected double	ratePosition(FourWinsGame game, int column, int row, int player)
GameMove	selectMove(GamePlay game, int[] role, int level, long milliseconds) This implementation selects the best move according to the given configuration.
void	setRandomSeed(long seed) if seed = 0, randomization is disabled
String	toString() overridden to return some information about the player

Methods inherited from class com.antelmann.game.TemplatePlayer

disableTracking, enableTracking, evaluate, evaluate, getlevelOverride, getMonitors, getOrderMoves, getPlayerName, getSearchOption, numberOfPositionsSearched, numberOfRequests, performanceRatio, pruneMove, setlevelOverride, setOrderMoves, setPlayerName, setSearchOption, setTracking, statsAsString, totalTimeTaken, trackingEnabled

Methods inherited from class java.lang.Object

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

Constructor Detail

FourWinsPlayer

public FourWinsPlayer()

FourWinsPlayer

public FourWinsPlayer(String name)

FourWinsPlayer

public FourWinsPlayer(String name,
                      int searchOption,
                      boolean trackingEnabled)

FourWinsPlayer

public FourWinsPlayer(String name,
                      int searchOption,
                      boolean trackingEnabled,
                      long randomSeed)

Method Detail

setRandomSeed

public void setRandomSeed(long seed)

if seed = 0, randomization is disabled

disableRandom

public void disableRandom()

canPlayGame

public boolean canPlayGame(GamePlay game)

Description copied from interface: Player

canPlayGame() returns true only if the Player provides an applicable heuristic for the type of game given. This way, a player can control whether it can a game.

 //Example:
 if (game instanceof MyGameClass) return true; else return false;
 // or:
 if (game.getClass() == myFavoriteGame.getClass()) return true; else return false;
 

selectMove

public GameMove selectMove(GamePlay game,
                           int[] role,
                           int level,
                           long milliseconds)

Description copied from class: TemplatePlayer

This implementation selects the best move according to the given configuration. If the time is constrained by milliseconds > 0, a thread is spanned for each move; each thread will evaluate that move within the given time constrain. If no time constrain is given, all evaluations will happen in the same thread limited by the given level. If tracking is enabled, a monitor will be added containing the number of nodes examined, the time taken and the best move stored in Monitor.setObject().

Specified by:

selectMove in interface Player

Overrides:

selectMove in class TemplatePlayer

See Also:

TemplatePlayer.Synchronizer, TemplatePlayer.MoveEvaluater

heuristic

public double heuristic(GamePlay game,
                        GameMove move,
                        int[] role)

Description copied from interface: Player

This function - often used as a callback function - evaluates the given move in the context of the given game; it is expected to return quickly. This function is really the only function that contains proprietory knowlege about the game (as all other functions could be implemented generically without domain knowlege; this is why the class TemplatePlayer provides already most methods except this function for easy implementations of this interface); heuristic() asks for a heuristic of the move given the game status - treating the status as a leaf in a potential search tree (whereas evaluate() may perform a game tree search before returning a value).

See Also:

TemplatePlayer

ratePosition

protected double ratePosition(FourWinsGame game,
                              int column,
                              int row,
                              int player)

toString

public String toString()

Description copied from class: TemplatePlayer

overridden to return some information about the player

Overrides:

toString in class TemplatePlayer