关于本仓库

本仓库如今仅可视为一种历史性的参考资料。

该代码的原始版本开发于2002年至2004年间，并随书籍《游戏人工智能》免费附赠。然而，经过多年的发展，这段代码已逐渐失去了作为参考的价值。目前，该教材的第三版篇幅大幅增加，而本仓库中的代码并未及时更新以反映书中的勘误或算法改进。在过去十多年里，我从未在自己的咨询工作中使用过本仓库中的代码。

第三版教材并未提及本仓库中的代码，而是以语言无关的格式，在正文中提供了更为详尽且经过修正的代码清单。我推荐读者参考该版本。

---

历史信息

游戏人工智能系统。

版权所有 © 伊恩·米灵顿 2003–2009。保留所有权利。

本软件根据许可协议分发。使用本软件即表示您同意随附软件许可协议中的所有条款和条件。

本代码还包含 AI Core 引擎的部分内容。

版权所有 © Icosagon Limited 2003–2007。保留所有权利。

请参阅随附的 LICENSE 文件。

安装

可以将代码解压到任意目录中。

平台兼容性

本软件在设计时尽可能地实现了平台无关性。对于您的平台，可能需要修改的唯一文件是 ./src/timing.cpp，该文件当前封装了 Windows 多媒体定时器。

构建

使用 SCons 构建

可以使用 SCONS 构建代码，SCons 可从 http://www.scons.org/ 下载。只需切换到 build 目录并运行 scons 即可。

cd build scons

构建完成后，若要清除中间文件（但保留库和示例程序）：

scons -c ../src

使用 Microsoft Visual Studio 8 Professional 构建

随附了适用于 Microsoft Visual Studio 8 Professional 的解决方案文件和项目文件。这些文件也可能适用于 Express 版本，但我尚未进行测试。

使用 CMake 在 Linux 上构建

可以在 Linux（以及可能其他平台）上使用 CMake 构建代码：

cd build cmake . make

文档

要构建文档（见下文），您必须先安装 Doxygen（可从 http://www.stack.nl/~dimitri/doxygen/ 获取）。只需切换到 ./doc/build/doxygen 目录，然后输入以下命令即可生成文档：

doxygen aicore.config

目录结构

构建过程会在 ./lib 目录下生成一个静态链接库，并可与 ./include 目录中的头文件一起使用。示例程序会被编译并放置在 ./bin 目录中。

源代码位于 ./src 目录，文档则位于 ./doc 目录中，其中参考文档存放在 ./doc/ref 目录内。

文档

源代码具有详尽的注释，其内容与《游戏人工智能》一书中的讨论相对应。

利用源代码文件中的标签，可以生成 Doxygen 文档；./doc/build/doxygen 目录中提供了用于构建文档的配置文件。所提供的 Doxygen 配置仅生成 HTML 格式输出，因为其他格式的输出取决于您机器的具体配置。

目前，此功能并未集成到 SCons 配置中，因为 SCons 对 Doxygen 的支持依赖于 Doxygen 在您机器上的安装位置。

示例程序

要运行示例程序，您的机器上需要安装 OpenGL 和 GLUT，并确保相关的 DLL 或共享对象位于系统的路径中。

aicore 快速上手指南

⚠️ 重要提示：本仓库代码主要作为历史参考（源自 2002-2004 年的《Artificial Intelligence for Games》一书配套代码）。作者已十余年未在咨询工作中使用此代码，且未跟进后续算法改进。如需用于现代生产环境，强烈建议参考该书第三版中提供的语言无关的最新代码列表。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：支持 Windows 或 Linux（代码设计为平台无关，但部分计时文件可能需要针对特定平台调整）。
• 构建工具（任选其一）：
  • SCons (推荐): 需安装 SCons (官网)。
  • CMake + Make: 适用于 Linux 环境。
  • Microsoft Visual Studio 8: 适用于 Windows (专业版或可能兼容 Express 版)。
• 运行依赖（仅运行演示程序时需要）：
  • OpenGL
  • GLUT (需确保相关 DLL 或共享库在系统路径中)
• 文档生成（可选）：
  • Doxygen (官网)

安装步骤

本工具无需复杂安装，只需将代码解压至任意目录即可。以下是基于不同构建系统的编译命令：

方案 A：使用 SCons (跨平台推荐)

cd build
scons

清理中间文件（保留库和演示程序）：

scons -c ../src

方案 B：使用 CMake (Linux 环境)

cd build
cmake .
make

方案 C：使用 Visual Studio

直接打开项目中包含的 Solution 和 Project 文件进行编译（适用于 Microsoft Visual Studio 8 Professional）。

生成文档 (可选)

若已安装 Doxygen，可生成 HTML 格式的开发文档：

cd ./doc/build/doxygen
doxygen aicore.config

基本使用

编译完成后，生成的文件结构如下：

• 静态链接库：位于 ./lib 目录。
• 头文件：位于 ./include 目录，供您的项目引用。
• 演示程序：编译后的可执行文件位于 ./bin 目录。

运行演示程序

进入 ./bin 目录，直接运行生成的演示程序可观察 AI 效果（需确保已安装 OpenGL 和 GLUT）：

cd ../bin
# 根据实际生成的文件名运行，例如：
./demo_name

集成到您的项目

在您的 C++ 项目中，包含头文件并链接静态库即可使用核心功能：

#include <aicore/header_name.h> // 替换为具体需要的头文件

int main() {
    // 调用 aicore 提供的 AI 算法
    return 0;
}

注：源代码位于 ./src，详细的技术参考文档位于 ./doc/ref。由于代码较旧，建议结合《Artificial Intelligence for Games》原著内容进行理解。