engine.h

   1 #ifndef ZZGO_ENGINE_H
   2 #define ZZGO_ENGINE_H
   3
   4 #include "board.h"
   5 #include "move.h"
   6
   7 /* Used to signal the main loop that the engine structures need to be reset
   8  * (for fresh board). */
   9 extern bool engine_reset;
  10
  11 struct engine;
  12 struct move_queue;
  13 struct time_info;
  14
  15 typedef char *(*engine_notify_play)(struct engine *e, struct board *b, struct move *m);
  16 typedef char *(*engine_chat)(struct engine *e, struct board *b, char *cmd);
  17 /* Generate a move. If pass_all_alive is true, <pass> shall be generated only
  18  * if all stones on the board can be considered alive, without regard to "dead"
  19  * considered stones. */
  20 typedef coord_t *(*engine_genmove)(struct engine *e, struct board *b, struct time_info *ti, enum stone color, bool pass_all_alive);
  21 /* One dead group per queued move (coord_t is (ab)used as group_t). */
  22 typedef void (*engine_dead_group_list)(struct engine *e, struct board *b, struct move_queue *mq);
  23 /* e->data and e will be free()d by caller afterwards. */
  24 typedef void (*engine_done)(struct engine *e);
  25
  26 /* This is engine data structure. A new engine instance is spawned
  27  * for each new game during the program lifetime. */
  28 struct engine {
  29         char *name;
  30         char *comment;
  31
  32         /* If set, do not reset the engine state on clear_board. */
  33         bool keep_on_clear;
  34
  35         board_cprint printhook;
  36         engine_notify_play notify_play;
  37         engine_chat chat;
  38         engine_genmove genmove;
  39         engine_dead_group_list dead_group_list;
  40         engine_done done;
  41         void *data;
  42 };
  43
  44 #endif