五子棋游戏

一、项目概述

1.1 项目名称

基于 C 语言与 EasyX 图形库的五子棋游戏

1.2 开发环境

• 编程语言：C 语言
• 图形库：EasyX Graphics Library
• 开发工具：Visual Studio 系列
• 运行环境：Windows 系统

1.3 项目功能

实现双人对战五子棋游戏，包含棋盘绘制、棋子绘制、鼠标落子、胜负判断核心功能，遵循标准五子棋规则：黑白双方交替落子，先连成 5 子（横、竖、左斜、右斜）一方获胜。

二、需求分析

2.1 功能需求

1. 绘制 15×15 标准五子棋棋盘；
2. 黑白棋子交替落子，左键点击棋盘交叉点落子；
3. 禁止在已有棋子的位置重复落子；
4. 实时判断胜负，满足 5 子连线判定胜利；
5. 游戏胜利后输出提示文字，结束游戏。

2.2 非功能需求

• 界面简洁清晰，操作简单；
• 程序运行稳定，无数组越界、崩溃问题；
• 代码结构清晰，模块化设计，便于维护。

三、总体设计

3.1 系统架构

采用模块化编程，将功能拆分为独立函数，核心模块分为：

1. 棋盘绘制模块
2. 棋子绘制模块
3. 落子合法性判断模块
4. 胜负判断模块
5. 主游戏流程控制模块

3.2 数据结构设计

使用二维数组存储棋盘状态：

c

运行

int pieceArr[NUM][NUM] = { 0 };

• 0：该位置无棋子
• 1：该位置为黑棋
• 2：该位置为白棋
• 数组大小：15×15，对应棋盘 15×15 交叉点

3.3 宏定义

c

运行

#define NUM 15 // 棋盘行列数 #define WIN_NUM 5 // 胜利所需棋子数

四、详细设计

4.1 棋盘绘制函数Draw_line()

• 功能：绘制 15×15 红色棋盘线；
• 实现：通过for循环绘制竖线和横线，线条间距 40 像素，窗口大小 600×600；
• 核心 API：setlinecolor(RED)、line()。

4.2 棋盘定位点函数Draw_point()

• 功能：绘制棋盘 5 个标准定位黑点，提升界面真实性；
• 实现：使用fillcircle()在固定坐标绘制实心小圆。

4.3 棋子绘制函数Draw_piece()

• 参数：black（棋子颜色）、x,y（鼠标坐标）；
• 功能：将鼠标坐标转换为棋盘下标，绘制黑白棋子，并更新二维数组；
• 逻辑：
  1. 坐标转换：i = x/40，j = y/40；
  2. 黑棋赋值 1，白棋赋值 2；
  3. 调用fillcircle()绘制棋子。

4.4 落子合法性判断NicePos()

• 参数：鼠标坐标x,y；
• 功能：判断点击位置是否已有棋子，无棋子返回true，允许落子；
• 实现：读取二维数组对应下标值，判断是否为 0。

4.5 胜负判断函数GameOver()

• 核心功能：判断最新落子是否形成 5 子连线；
• 判断方向：水平、垂直、左斜 ()、右斜 (/)；
• 算法：
  1. 从当前棋子向两个方向遍历统计同色棋子数；
  2. 数量≥5 则返回对应棋子颜色（1 黑胜 / 2 白胜）；
  3. 未满足条件返回 0，游戏继续。

4.6 主函数main()

• 功能：游戏总流程控制；
• 流程：
  1. 初始化图形窗口；
  2. 绘制棋盘与定位点；
  3. 循环监听鼠标左键消息；
  4. 合法则落子→判断胜负→切换棋手；
  5. 胜利则打印提示文字，结束游戏。