俄罗斯方块项目详细设计说明书.doc

C语言版俄罗斯方块项目

详细设计说明书

杰普物联网研发中心
Briup IOT R&D Center

文件状态：
[√] 草 稿
[ ] 正式发布
[ ] 正在修改
文件标识：
briup-IOT-S-01
当前版本：
V1.0
作 者：
Paul Wang
完成日期：
2014-3-14
文档类型： ¨需求文档 ¨计划文档 þ设计文档 ¨测试文档
¨用户文档 ¨工程文档 ¨维护文档
密 级： þ公开资料 ¨内部资料 ¨保密资料 ¨机密资料

详细设计说明书

版权声明
上海杰普软件有限公司版权所有，保留一切权利。
未经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档的部分或全部，并以任何形式传播。

产品支持服务
我们将不断改进我们的产品和用户手册，使其更完善、更便于使用，您的意见和建议对我们的工作非常重要，您可以用您喜欢的任何方式与我们联系。
我们的联系地址和电话是：
公司地址：
邮 编：215300
电 话：
传 真：
网 址：
E-Mail:

详细设计说明书
文档修改/审批记录
版本号
修改人/审批人
修改/审批日期
修改内容
备注
V1.0
Paul
2014-3-14
创建

目录
1 简介 6
1.1 目的 6
1.2 范围 6
1.3 参考资料 6
1.4 术语定义及说明 6
2 系统详细设计 7
2.1 主流程 7
2.2 功能模块框图 7
2.3 非功能模块介绍 7
3 模块详细设计 8
3.1 游戏模块 8
3.1.1 功能概述 8
3.1.2 界面概述 8
3.1.3 类（结构）设计 9
3.1.4 关键逻辑与算法说明 9
3.1.5 访问的表或其他数据实体 9
3.1.6 调用外部接口说明 9
3.1.7 提供调用接口说明 10
3.1.8 模块内部使用的公共函数、包的说明 10
3.1.9 流程逻辑 10
3.1.10 尚未解决的问题 11
3.2 预览模块 11
3.2.1 功能概述 11
3.2.2 界面概述 11
3.2.3 类（结构）设计 11
3.2.4 关键逻辑与算法说明 12
3.2.5 访问的表或其他数据库实体 12
3.2.6 调用外部接口说明 12
3.2.7 提供调用接口说明 12
3.2.8 模块内部使用的公用函数/包等的说明 12
3.2.9 流程逻辑 13
3.2.10 尚未解决的问题 13
3.3 等级积分表模块 13
3.3.1 功能概述 13
3.3.2 界面概述 13
3.3.3 类设计 14
3.3.4 关键逻辑与算法说明 14
3.3.5 访问的表或其他数据实体 14
3.3.6 调用外部接口说明 14
3.3.7 提供调用接口说明 14
3.3.8 模块内部使用的公共函数、包的说明 14
3.3.9 流程逻辑 14
3.3.10 尚未解决的问题 14
4 限制条件 14
5 测试计划 14
6 附录： 14

1 简介

1.1 目的
阐述C语言实现俄罗斯方块游戏的界面的功能和界面设计。
1.2 范围
本文根据《俄罗斯方块需求分析说明书（V1.0版）》、《劳拉方块游戏策略》等资料制定，在分析了俄罗斯方块界面需求的基础上制定本规范，适用于普通PC机实现的功能和界面开发。可应用于广大PC机基础编程爱好者学习使用。
1.3 参考资料
《c语言程序设计》
《劳拉方块设计理念》
《软件工程》
1.4 术语定义及说明
表格 1：说明书术语说明
英文缩写
英文全称
说 明
SG
Start Game
启动游戏
ES
Exit And Save
退出游戏并保存数据
MD
Move Down
下移，迅速下滑
ML
Move Left
左移一格位置
MR
Mov Right
右移一格位置
RS
Restart Game
重新启动一局新的游戏

2 系统详细设计
2.1 主流程

图 1：项目流程图
2.2 功能模块框图
2.3 非功能模块介绍

3 模块详细设计
3.1 游戏模块
3.1.1 功能概述
游戏界面及相关操作（菜单栏）。
1、 主界面
2、 开始操作
3、 暂停操作
4、 重新启动一局新的游戏操作
5、 退出操作

3.1.2 界面概述
主界面最简形式征集效果如下：

图 2：游戏模块效果图
3.1.3 类（结构）设计
表格 2：游戏模块类（结构）设计
类（结构）名：
struct termios
类（结构）功能：
设置与终端相关的参数。
方法1：
名称：
init_for_global();
功能：
初始化界面
输入：
键盘输入
输出：
无
方法2：
名称：
print_mode_shape();
功能：
打印当前的方块图形
输入：
内部数据
输出：
桌面图形变化

3.1.4 关键逻辑与算法说明
关键的操作是将键盘输入的信号进行分析后，转化成程序内部预先定义好的相关参数；然后采用长跳转的方式将参数的值带进指定处理函数的中。重点需要分析的按键分别是上（↑，图形转换方向）、下（↓，图形加速下滑）、左（←，图形左移）、右（→，图形右移）、Q（退出游戏）、R（重新开始）、回车（图形直接落到界面底部）等按键。
3.1.5 访问的表或其他数据实体
3.1.6 调用外部接口说明
表格 3：游戏模块外部接口
接口1：
名称：
Change_shape()
描述：
让当前游戏区的图形顺时针旋转90度，以改变图形方向
输入：
无
输出：
无
接口2：
名称：
Move_down()
描述：
让当前游戏区中的运动图形加速下滑
输入：
无
输出：
无
接口3：
名称：
Move_left()
描述：
使游戏区的当前图形向左移动一个指定单位长度的距离
输入：
无
输出：
无
接口4：
名称：
Move_right()
描述：
使游戏区的当前图形向右移动一个指定单位长度的距离
输入：
无
输出：
无

3.1.7 提供调用接口说明
表格 4：游戏模块提供接口说明
接口1：
名称：
Key_control()
描述：
对按键信息进行解析
输入：
无
输出：
无

3.1.8 模块内部使用的公共函数、包的说明
3.1.9 流程逻辑

图 3：游戏模块流程图
3.1.10 尚未解决的问题
公用共享的菜单栏。

3.2 预览模块
3.2.1 功能概述
预览下一个在游戏区出现的方块图形。

3.2.2 界面概述

图 4：预览模块效果图

3.2.3 类（结构）设计
表格 5：游览模块类（结构）设计
类（结构）名：
XXXX
类（结构）功能：
XXXX
方法1：
名称：
print_next()
功能：
显示下一个在游戏区出现的方块图形
输入：
无
输出：
无

3.2.4 关键逻辑与算法说明
每次生成一个随机数，用随机数和指定的图形建立映射关系，在方法中通过产生的随机数来选择图形。
3.2.5 访问的表或其他数据库实体

3.2.6 调用外部接口说明
表格 6：预览模块外部接口说明
接口1：
名称：
erase_next()
描述：
清空预览区现有的方块
输入：
无
输出：
无
接口2：
名称：
printf()
描述：
打印出新设定的方块
输入：
无
输出：
无

3.2.7 提供调用接口说明
表格 7：预览模块提供的接口
方法1：
名称：
print_next()
功能：
显示下一个在游戏区出现的方块图形
输入：
无
输出：
无

3.2.8 模块内部使用的公用函数/包等的说明

3.2.9 流程逻辑

图 5：预览模块流程图
3.2.10 尚未解决的问题

3.3 等级积分表模块
3.3.1 功能概述
1、 显示当前游戏的等级
2、 显示游戏的当前分数

3.3.2 界面概述

图 6：积分板效果图
3.3.3 类设计

3.3.4 关键逻辑与算法说明

3.3.5 访问的表或其他数据实体

3.3.6 调用外部接口说明

3.3.7 提供调用接口说明

3.3.8 模块内部使用的公共函数、包的说明

3.3.9 流程逻辑

3.3.10 尚未解决的问题

4 限制条件

5 测试计划

6 附录：

14
物联网研发中心