visualize.md

AI比赛工具(solo)

选择AI代码进行决斗
支持比赛参数设定与比赛记录输出、重放

运行需求

1. Python3 （包含tkinter库及其余数个标准库）

2. match_core.py放置于可import位置，建议放置于同级目录

用法

1. 进行比赛

   选择双方玩家规范编写的AI代码（含有play函数）进行
   在设置比赛参数后，点击 SOLO! 按钮开始一场比赛
   比赛进行中窗口将没有响应，比赛完成后会显示开局状态
   此时点击 播放 按钮可以回放比赛

2. 比赛记录与回放

   点击 保存记录 按钮将弹出窗口选择路径，保存上一局的比赛结果 格式为zlog

   点击 读取记录 按钮将弹出选定zlog记录文件的窗口 可读取由标准比赛记录字典生成的zlog记录文件 读取后点击 播放 按钮将回放比赛

界面介绍

1. 玩家代码选择区（玩家1、玩家2）

   可输入（绝对或相对）py文件路径
   右侧 浏览 按钮可打开文件选择窗口，并生成绝对路径

2. 输出目录选择区

   可输入（绝对或相对）比赛记录输出目录路径 右侧 浏览 按钮可打开目录选择窗口，并生成绝对路径

3. 比赛参数设置

   • 场地半宽
   • 场地高
   • 双方最大回合数（总回合数为两倍）
   • 双方最大思考时间（单位为秒）

4. 执行按钮

   • SOLO! 按钮：
     读取玩家代码与比赛信息，运行一次比赛，并生成比赛回放

   • 读取记录 按钮：
     弹出比赛记录文件（pkl）选择界面，选择后读取并生成回放

5. 回放控制按钮

   在读入回放后，点击将播放回放记录
   在播放时，点击可切换播放/暂停
   在记录播放完毕后，点击将重置、回到比赛开局状态

   若比赛结束时双方未进行操作，该按钮不可用

6. 进度条

   读入回放后，可拖动浏览比赛记录 拖动时播放进度将暂停

   若比赛结束时双方未进行操作，该进度条不可用

其它说明

1. Windows平台下，将文件后缀名改为.pyw，可直接双击运行窗口

2. 比赛双方主题色由AI名称（代码文件名或比赛记录中双方名称）生成：

   使用colorsys.hsv_to_rgb函数转换颜色

    色相由hash(name)取余换算得到  
    饱和度由hash(name[::-1])取余换算得到  
    明度依不同图像部分而不同
   

   当双方色相相近（差值小于0.1）时，后手玩家的主题色色相将增加180°

3. 文件开头import后有数个简单参数，可根据电脑分辨率自行设置