#include "bit.h"
#include "const.h"
#include "game.h"
#include "move.h"
#include "opening.h"
#include "options.h"
#include "play.h"
#include "settings.h"
#include <assert.h>

Functions
void	play_init (Play play, Book book)
	Initialization. More...

void	play_free (Play *play)
	Free resources. More...

void	play_new (Play *play)
	Start a new game. More...

bool	play_load (Play play, const char file)
	Load a saved game. More...

void	play_save (Play play, const char file)
	Save a played game. More...

void	play_update (Play play, Move move)
	Update the game. More...

bool	play_is_game_over (Play *play)
	Check if game is over. More...

bool	play_must_pass (Play *play)
	Check if player must pass. More...

void	play_go (Play *play, const bool update)
	Start thinking. More...

void	play_hint (Play *play, int n)
	Start thinking. More...

void	play_hint_for_lib (Play play, int n, HintList hintlist)
	hint for libEdax More...

void	play_get_bookmove (Play play, MoveList book_moves)
	get book move for libEdax More...

int	play_get_bookmove_with_position (Play play, MoveList book_moves, Position *position)
	get book move for libEdax More...

void	play_hint_prepare (Play play, MoveList exclude_list)
	prepare hint for libEdax More...

void	play_hint_next (Play play, Hint hint, bool multiPvDepthMax)
	get next hint More...

void *	play_ponder_run (void *v)
	do ponderation. More...

void	play_ponder (Play *play)
	Ponder. More...

void	play_stop_pondering (Play *play)
	Stop pondering. More...

void	play_stop (Play *play)
	Stop thinking. More...

void	play_undo (Play *play)
	Undo a move. More...

void	play_redo (Play *play)
	Redo a move. More...

void	play_set_board (Play play, const char board)
	Set a new board. More...

void	play_set_board_from_FEN (Play play, const char board)
	Set a new board. More...

void	play_set_board_from_obj (Play play, const Board board, const int turn)
	Set a new board. More...

void	play_game (Play play, const char string)
	Play a move sequence. More...

bool	play_move (Play *play, int x)
	Play a move. More...

bool	play_user_move (Play play, const char string)
	Play a user move. More...

Move *	play_get_last_move (Play *play)
	Get the last played move. More...

static int	play_alternative (Play play, Move played, Move alternative, int depth, int *percent)
	Seek for the best alternative move. More...

static void	play_write_analysis (Play play, const Move m, const Move a, const int n_moves, const int depth, const int percent, FILE f)
	Write a line if an analysis. More...

void	play_analyze (Play *play, int n)
	Analyze a played game. More...

static int	play_book_alternative (Play play, Move played, Move *alternative)
	Seek for the best alternative move from the opening book. More...

void	play_book_analyze (Play *play, int n)
	Analyze a played game. More...

void	play_store (Play *play)
	store the game into the opening book More...

void	play_adjust_time (Play *play, const int left, const int extra)
	adjust time. More...

void	play_print (Play play, FILE f)
	Print the game state. More...

void	play_force_init (Play play, const char string)
	Initialize a forced line. More...

void	play_force_update (Play *play)
	Update a forced line. More...

void	play_force_restore (Play *play)
	Restore a forced line. More...

bool	play_force_go (Play play, Move move)
	Play a forced move. More...

void	play_symetry (Play *play, const int sym)
	Get the symetry of the actual position. More...

const char *	play_show_opening_name (Play play, const char (opening_get_name)(const Board ))
	Print the opening name. More...

Detailed Description

Edax play control.

Date: 1998 - 2017

Author: Richard Delorme

Version: 4.4

Function Documentation

◆ play_adjust_time()

void play_adjust_time	(	Play *	play,
		const int	left,
		const int	extra
	)

adjust time.

Set remaining time to play from a server (GGS) or a GUI (Quarry, ...).

Parameters

play	Play.
left	Time left.
extra	Extra time.

◆ play_alternative()

static int play_alternative	(	Play *	play,
		Move *	played,
		Move *	alternative,
		int *	depth,
		int *	percent
	)

static

Seek for the best alternative move.

Parameters

play	Play.
played	Last played move.
alternative	Second best move.
depth	Depth searched.
percent	Probcut selectivity searched.

Returns: The number of alternatives.

◆ play_analyze()

void play_analyze	(	Play *	play,
		int	n
	)

Analyze a played game.

Parameters

play	Play.
n	number of moves to analyze.

◆ play_book_alternative()

static int play_book_alternative	(	Play *	play,
		Move *	played,
		Move *	alternative
	)

static

Seek for the best alternative move from the opening book.

Parameters

play	Play.
played	Last played move.
alternative	Second best move.

Returns: The number of alternatives.

◆ play_book_analyze()

void play_book_analyze	(	Play *	play,
		int	n
	)

Analyze a played game.

Parameters

play	Play.
n	number of moves to analyze.

◆ play_force_go()

bool play_force_go	(	Play *	play,
		Move *	move
	)

Play a forced move.

Check if the actual board is in the forced line, and play the next forced move.

Parameters

play	Play.
move	Output move.

Returns: 'true' if a forced move have been found.

◆ play_force_init()

void play_force_init	(	Play *	play,
		const char *	string
	)

Initialize a forced line.

Parameters

play	Play.
string	A string with a sequence of moves.

◆ play_force_restore()

void play_force_restore ( Play * play )

Restore a forced line.

Check if the actual board is in the forced line, and restore the forced line accordingly.

Parameters

play Play.

◆ play_force_update()

void play_force_update ( Play * play )

Update a forced line.

Check if the actual board is in the forced line, and update the forced line accordingly.

Parameters

play Play.

◆ play_free()

void play_free ( Play * play )

Free resources.

Parameters

play Play.

◆ play_game()

void play_game	(	Play *	play,
		const char *	string
	)

Play a move sequence.

Parameters

play	Play.
string	move sequence.

◆ play_get_bookmove()

void play_get_bookmove	(	Play *	play,
		MoveList *	book_moves
	)

get book move for libEdax

Parameters

play	Play
book_moves	result(out parameter)

◆ play_get_bookmove_with_position()

int play_get_bookmove_with_position	(	Play *	play,
		MoveList *	book_moves,
		Position *	position
	)

get book move for libEdax

Parameters

play	Play
book_moves	result(out parameter)
position	position(out parameter)

◆ play_get_last_move()

Move * play_get_last_move ( Play * play )

Get the last played move.

Parameters

play Play.

Returns: last played move.

◆ play_go()

void play_go	(	Play *	play,
		const bool	update
	)

Start thinking.

Parameters

play	Play.
update	Flag to tell if edax should update or no its game.

◆ play_hint()

void play_hint	(	Play *	play,
		int	n
	)

Start thinking.

Evaluate first best moves of the position.

Parameters

play	Play.
n	Number of (best) moves to evaluate.

◆ play_hint_for_lib()

void play_hint_for_lib	(	Play *	play,
		int	n,
		HintList *	hintlist
	)

hint for libEdax

Evaluate first best moves of the position.

Parameters

play	Play.
n	Number of (best) moves to evaluate.
hintlist	result (out parameter)

◆ play_hint_next()

void play_hint_next	(	Play *	play,
		Hint *	hint,
		bool	multiPvDepthMax
	)

get next hint

Evaluate first best moves of the position among rest moves.

Parameters

play	Play.
hint	result (out parameter)

◆ play_hint_prepare()

void play_hint_prepare	(	Play *	play,
		MoveList *	exclude_list
	)

prepare hint for libEdax

Parameters

play Play.

◆ play_init()

void play_init	(	Play *	play,
		Book *	book
	)

Initialization.

Parameters

play	Play.
book	Opening book.

◆ play_is_game_over()

bool play_is_game_over ( Play * play )

Check if game is over.

Parameters

play Play.

Returns: true if game is over.

◆ play_load()

bool play_load	(	Play *	play,
		const char *	file
	)

Load a saved game.

Parameters

play	Play.
file	File name of the game.

Returns: true if game is successfuly loaded.

◆ play_move()

bool play_move	(	Play *	play,
		int	x
	)

Play a move.

Parameters

play	Play.
x	Coordinate played.

Returns: true if the move has been legally played.

◆ play_must_pass()

bool play_must_pass ( Play * play )

Check if player must pass.

Parameters

play Play.

Returns: true if player must pass.

◆ play_new()

void play_new ( Play * play )

Start a new game.

Parameters

play Play.

◆ play_ponder()

void play_ponder ( Play * play )

Ponder.

Think during opponent time. Activate the thread suspended in play_ponder_loop.

Parameters

play Play.

◆ play_ponder_run()

void * play_ponder_run ( void * v )

do ponderation.

Ponderation (thinking during opponent time) is done within a thread. The thread is launched at startup and immediately suspended, thanks to condition_wait. When edax is required to ponder, the thread is activated by a condition_signal, and the search start. To stop the ponderation, just stop the search and wait for the lock to be release.

Parameters

v the play.

Returns: NULL (unused).

◆ play_print()

void play_print	(	Play *	play,
		FILE *	f
	)

Print the game state.

Print the game state: board, time, played move, etc.

Parameters

play	Play.
f	Output stream.

◆ play_redo()

void play_redo ( Play * play )

Redo a move.

Parameters

play Play.

◆ play_save()

void play_save	(	Play *	play,
		const char *	file
	)

Save a played game.

Parameters

play	Play.
file	File name of the game.

◆ play_set_board()

void play_set_board	(	Play *	play,
		const char *	board
	)

Set a new board.

Parameters

play	Play.
board	A new board.

◆ play_set_board_from_FEN()

void play_set_board_from_FEN	(	Play *	play,
		const char *	board
	)

Set a new board.

Parameters

play	Play.
board	A new board.

◆ play_set_board_from_obj()

void play_set_board_from_obj	(	Play *	play,
		const Board *	board,
		const int	turn
	)

Set a new board.

Parameters

play	Play.
board	A new board.
turn	player to play

Author: lavox

Date: 2018

◆ play_show_opening_name()

const char * play_show_opening_name	(	Play *	play,
		const char ()(const Board *)	opening_get_name
	)

Print the opening name.

◆ play_stop()

void play_stop ( Play * play )

Stop thinking.

Parameters

play Play.

◆ play_stop_pondering()

void play_stop_pondering ( Play * play )

Stop pondering.

If edax is pondering, stop the search, and wait that the pondering thread is suspended.

Parameters

play Play.

◆ play_store()

void play_store ( Play * play )

store the game into the opening book

Parameters

play Play.

◆ play_symetry()

void play_symetry	(	Play *	play,
		const int	sym
	)

Get the symetry of the actual position.

Parameters

play	Play.
sym	Symetry.

◆ play_undo()

void play_undo ( Play * play )

Undo a move.

Parameters

play Play.

◆ play_update()

void play_update	(	Play *	play,
		Move *	move
	)

Update the game.

Parameters

play	Play.
move	Move.

◆ play_user_move()

bool play_user_move	(	Play *	play,
		const char *	string
	)

Play a user move.

Parameters

play	Play.
string	Move as a string.

Returns: true if the move has been legally played.

◆ play_write_analysis()

static void play_write_analysis	(	Play *	play,
		const Move *	m,
		const Move *	a,
		const int	n_moves,
		const int	depth,
		const int	percent,
		FILE *	f
	)

static

Write a line if an analysis.

Write a line of a post-mortem game analysis.

Parameters

play	Play.
m	Move actually played.
a	Best alternative move.
n_moves	Number of alternatives.
depth	Analysis depth.
percent	Analysis probcut selectivity (as a percent).
f	Output stream.

Functions

Detailed Description

Function Documentation

◆ play_adjust_time()

◆ play_alternative()

◆ play_analyze()

◆ play_book_alternative()

◆ play_book_analyze()

◆ play_force_go()

◆ play_force_init()

◆ play_force_restore()

◆ play_force_update()

◆ play_free()

◆ play_game()

◆ play_get_bookmove()

◆ play_get_bookmove_with_position()

◆ play_get_last_move()

◆ play_go()

◆ play_hint()

◆ play_hint_for_lib()

◆ play_hint_next()

◆ play_hint_prepare()

◆ play_init()

◆ play_is_game_over()

◆ play_load()

◆ play_move()

◆ play_must_pass()

◆ play_new()

◆ play_ponder()

◆ play_ponder_run()

◆ play_print()

◆ play_redo()

◆ play_save()

◆ play_set_board()

◆ play_set_board_from_FEN()

◆ play_set_board_from_obj()

◆ play_show_opening_name()

◆ play_stop()

◆ play_stop_pondering()

◆ play_store()

◆ play_symetry()

◆ play_undo()

◆ play_update()

◆ play_user_move()

◆ play_write_analysis()