俄罗斯方块:win32api开发

本文简述一门课程,演示win32api开发俄罗斯方块的开发过程。如果学生学习过C语言,没学过或者学习C++不好,刚刚開始学习win32api程序设计,还不懂消息循环和注冊窗体类。

俄罗斯方块:win32api开发

 俄罗斯方块:win32api开发 俄罗斯方块:win32api开发

近期的照片在这里 [http://www.douban.com/photos/album/132796665/] 和 [http://www.douban.com/photos/album/133241544/]。

1. 背景和原则

我这学期讲一门课,本科三年级,学生满员17人。一般接近满员,最低一次5人,那天据林同学说,其它的同学都去看足球赛了。

课程名字叫做算法与程序设计实践3。第一堂课我照例要解释:到了"3"这个阶段,就不讲算法了,仅仅有实践。只是,后来看看算法也还是有一点应用,比方从一个线性表里删除符合条件的元素们,在线性表里查找符合条件的元素,这样的难度的。

课是在机房上的,大部分时间学生和教师都看着显示,所以一学期下来,好多同学和我见面可能都不太认识。只是我们对代码的形成过程更熟悉一些。

我试图贯彻下述原则:学生应该看到教师编程的过程,而不不过结果;学生应该看到在编辑器和编译器中的代码,而不是WORD或PPT里的;学生应该先学会临模教师的编程过程,而没有能力直接临模结果;学生甚至应该看到教师的错误及错误的解决过程、教师的无知及检索过程,学生不应该看到事先排练的完美的编程过程和全知全能的教师,那样的过程和专家,学生模仿时无从下手。

所以,我课前不准备,在课堂上无意犯各种错误--偶尔演示学生们easy犯的错误--及解决。在LOG文件里记录我们的计划和当前的进度,在绘图里画下原型。

所以,我假装对某些API和函数不熟悉,演示在MSDN和互联网中查找手冊和解决方式的步骤。单独做一些技术原型验证对API的调用结果的猜想,而不是在project的过程中在项目代码中測试技术。有时,我知道问题在哪里,可是要先列出各种可能,然后一一验证猜想(而不是直接解决,这似乎是计算机本科生很easy犯的错误,假设攻克了就认定那是问题的解决办法)。除了这两点,其余的时间我应该尽可能诚实。

有时候,学生会告诉我哪里错了,先于我发现问题的解决办法。这令我享受这种教学过程。

终于,我们--以我编码为主--实现了WIN32API开发的俄罗斯方块。

选择俄罗斯方块的原因,是由于小游戏的业务逻辑足够复杂,保证学生了解在相对复杂的业务逻辑时的面临的问题和编程行为与toy作品不同;所使用的到技术较少,避免过多的机制 (数据库、网络等)分散学生的注意力,保证学生把精力集中在对业务逻辑上。

选择win32api是课堂上投票的结果。选择C语言而没有使用C++有两个原因。一是学生的C++掌握通常并不熟练;二是我希望学生能在项目中发现面向对象的必要性和长处,而不是仅由于学习过哪些语言而在project中选用;三是希望演示用C也能够实现基于对象的程序设计 (不是面向对象,不包含继承,仅包含方法与数据的内聚)。

2. 技术原型

涉及到的技术原型,要在project開始前建立小项目,以验证对这些技术的掌握和对效果的猜想。

要实验的技术列表,来源于需求。我们先不写代码,口头描写叙述需求,然后分解需求到所需的技术。这样就形成了技术列表。这个过程中,同一时候也形成了定义,包含名词和动词表。

这些技术原型也限定了除C语言以外须要掌握的技术,在这次开发其中。

技术原型包含:

* 使用GDI绘图、擦除。用于画小块和移动小块。移动是依据视觉暂留在新的位置上绘图,并把旧位置上的小块以底色重画。

* 键盘消息响应。用于在不暂停小块下落的情况下接受玩家通过按键操纵小块左移、右移、旋转、高速下落。

* 特定范围的随机数生成。用于在创建新的小块时,决定是哪个类型。类型计有S型、L型、凸形、田形,及它们的旋转。

* 计时器 (timer),用于驱动小块定时下落,推断是否该清除一行,计分,刷新工作区 (重画) 等。

* 在工作区输出文字。用于调试和显示分数。

终于形成的原型部分代码量例如以下。代码在附件中的 prototype文件夹下

绘图 (及消息循环) ,draw,226行
擦除,eraser,263行
在工作区输出文字,textout,201行
按键消息响应,key,207行
随机数,random, 31行
计时器,timer,214行

3. 开发过程的里程碑

技术原型确定以后,再又一次回到需求,并把需求排期。争取每次课程限定完毕一个功能。

需求排期遵循的原则是:优先完毕对其它功能无信赖的部分;优先完毕核心功能。

下面是开发过程中的里程碑。

1) 生成块。
2) 计时器驱动,块自己主动下降
3) 键盘控制块 旋转、高速下降、左移、右移
4) 落究竟或粘在底部已存在块上 (if (conficted || touch_bottom) stick)
5) 删除一行:删除一行,把之上的行下降一行
6) 计分:消除一行和多行分值不同

下面功能在本学期没有实现。

7) 生成新块前,在预览区显示下一个块
8) 分数积累到一定程度 (?),加快块下落的速度

开发过程以git版本号控制方式记录了历史,每一个重要功能一次commit,以日期作为message。

4. 定义

我们在开发前用示意图约定了一些定义,作为词汇表。排版原因,我在这里有文字解释一下。

俄罗斯方块元素:工作区上画图的最小单位,是一个小方格。俄罗斯方块的名字 Terris 即四元素,由于每一个当前块由4个元素组成。

数组元素:即C语言中的数组元素,数组中的某一个。提出这个定义是为了差别于俄罗斯方块的元素。

当前块 (current block) :正在移动的由四个元素构成的块。有S型、L型、田字型等类型。

已存在的块 (exist block) :堆积在工作区底部的,已经粘成一团的元素。

像素坐标,世界坐标。像素坐标是由GDI画图定义的,世界坐标由我们定义,以元素为单位,左上是原点 (0,0) ,向右向下递增。

stick。当前块接触到已存在的块,或者当前块接触到工作区底部,此时应该把当前块增加到已存在的块中,然后生成新的当前块;假设导致已存在的块中某一行充满元素,须要按游戏规则删除此行,然后把已存在的块中此行以上的元素降落一行。

5. 数据结构及流程

下面介绍当前块、已存在块、键盘操作、删除已存在块中的一行的数据结构和流程。

5.1 当前块

当前块中,包含当前块的下面数据:当前坐标,上一次的坐标 (用以擦除) ,当前类型 (接下来会解释),上一次的类型 (用于旋转)。结构体例如以下,整个程序中仅仅有这个结构体的唯一实例。

struct struct_block{
int x;
int y; /* row 0, col 0 */
int old_x;
int old_y;
int* type;
int* old_type;
};

当前块的类型使用数组实现,例如以下,各自是一字型、田字型、凸字型。

int line_v_block[]={0, 0, 0, 1, 0, 2, 0, 3};
int line_h_block[]={0,0,1,0,2,0,3,0};
int tian_block[]={0, 0, 0, 1, 1, 0, 1, 1};
int tu_v_block[]={0,1,1,0,1,1,2,1};
int tu_h_block[]={0,1,1,0,1,1,1,2};

数组中的每两个数值 (数据中的元素)代表一个当前块中的元素的坐标,计8个数值代表4个元素。

生成块时,

current_block.type = line_v_block;

指定了当前块的元素。

画图时,遍历"类型数组",把每一个元素绘出。不管何种类型,都遵循这一流程,从而实现"以数据作为代码":类型数组即数据,遍历"类型数组"、在旋转时改变类型等即为引擎。

旋转的代码演示样例,改变类型 (的指针) :

if(current_block.type == line_v_block)
{
current_block.type = line_h_block;
}

平移的代码演示样例,改变横坐标:

current_block.x -= 1;

自己主动下降的代码演示样例,改变上一次的纵坐标和当前纵坐标。

if(! is_conflicted() && ! is_touch_bottom())
{
current_block.old_y = current_block.y;
current_block.y = current_block.y + 1;
}
else
{
stick();
generate_block();
}

高速下降:
纵坐标 添加 全部元素中到达底部 (或已存在块中同一横坐标的顶) 的最短距离。

貌似题外话,helper函数:is_conflicted(),推断当前块是否接触到已存在块;is_touch_bottom(),推断当前块是否触底;匹配横坐标,给出当前块的底坐标;求当前块距离底部的最短距离。等等。

开发helper函数的目的,是为了使程序总体流程清晰。保障总体清晰的方法之中的一个,是要求每一个函数内容不得超过一屏。假设超过了,就须要折解出 helper 函数。在主流程中调用 helper 函数,而把helper函数体移出主流程,这样主流程代码长度就下降了。这和小学写作文的时候,老师要求先拉大纲是一个道理。常常有同学说,在开发过程中会发现新的功能,在开发遇到新的技术,没有做原型的,因此难以把握大纲。这都说明把握大纲和做计划的能力还差,须要通过练习来训练。这和小学生写着写着作文发现须要查字典,或者写跑题了,是一个道理。我们的成长并不是认识的字多了,而是能预见到将会用到哪些字 (甚至表达手法、写作素材)。

此外,在面向对象中,有些的函数会成为game (或者 current block 或者 exist block )的成员函数。这在开发中会认识到,假设它们与数据能内聚在一个类中,该是多么方便,因此了解面向对象的在信息隐藏方面的优势。这些函数应归属于哪个类,是由哪个类承担这个责任决定的。

5.2 已存在块

已存在块中包含下面数据结构:块的长度 (其实,是块的长度*2,代码中以横坐标和纵坐标作为两个数组元素) ,已存在块数组。例如以下。

int exist_block_size=0;
int exist_block[(maxx+1)*(maxy+1)];

这样的数据结构,及当前块的数据结构,把横纵坐标无区别地,不以结构体地方式放在数组中,在兴许开发中带来了麻烦。只是因为课程时间有限,后来,我未对此做出改动。应该逐渐演化程序结构,形成以元素作为结构体的数组。再开发出一些helper甚至成员函数,遍历时以俄罗斯方块元素为单位,而不是当前代码中的以数组元素为单位。

对已存在块数据结构操作的函数之中的一个是 stick,用于在当前块触底 (或触及已存在块)时,把当前块中的元素移到已存在块中。

有不少helper函数,基本都是通过遍历 exist_block,按匹配条件读当中的坐标。包含:匹配横坐标,给出已存在块的顶坐标 int get_exist_block_top(int x)。

5.3 键盘操作 & 动作序列

玩家操作块这一操作,由键盘消息响应開始。我们不在键盘响应中处理这一事件,而是仅仅在这里记住这个动作,增加动作序列中。这是后来的版本号。最初的版本号,我们也不在键盘响应中处理事件,而是调用 block.cpp 中的函数。原则是:凡依赖win32api的,放在 tetris.cpp 中,如 timer, 键盘响应,画图;凡是与业务逻辑有关,平台无关的,放在 block.cpp 中。接收向上箭头,是键盘响应,平台相关,所以放在 tetris.cpp 中;此时调用的 rotate,用于改变当前块的类型或坐标,平台无关,所以放在 block.cpp 中。

动作序列的数据结构例如以下。在动作序列数组buffer_action_seq中,数组动作元素
(动作) 的类型是 枚举 action。

enum action{ action_left=1, action_right=2, action_speed_down=3, action_rotate=4, action_down_auto=5, action_na=0};
action buffer_action_seq[action_size]={action_na};
int buffer_action_cursor = 0;

由玩家触发键盘消息開始,流程例如以下。

1)键盘消息响应:

buffer_action_seq[buffer_action_cursor++] = action_rotate;在动作序列中增加一个动作。这相应于设计模式中的 commander 模式要解决的问题。

2)在timer中自己主动下降

timer中 buffer_action_seq[buffer_action_cursor++] = action_down_auto; 在动作序列中增加一个动作。

3)在timer中触发WM_PAINT

timer 中 InvalidateRect 触发 WM_PAINT

4)WM_PAINT中运行动作序列

erase_old_block_seq(hdc);

erase_old_block_seq (hdc) 遍历动作序列,按每一个动作改变当前块坐标,然后擦除因为动作产生的旧块。遍历动作序列以后,就完毕了自上个 timer 周期以来全部的动作,擦除了这期间产生的全部旧块。

void erase_old_block_seq(HDC hdc) 片断例如以下:
for (i = 0; i < buffer_action_cursor; i++)
{
switch (buffer_action_seq[i])
{
case action_left:
move_left();
erase_old_block(hdc);
break;

在序列里的每一个动作中,move_left 改坐标, erase_old_block(hdc) 擦除旧块.

5)WM_PAINT画新的当前块和已存在块

draw_current_block(hdc);
draw_exist_block(hdc);

由于重绘比计算花费的时间要多,作为性能优化,假设当前块与旧块坐标全然同样,不重画。

另,还有一个版本号的动作序列,不使用枚举和swtich-case,通过把函数作为消息传递给责任者,实现disptach:

void (*next_action)() = move_still; 
next_action = move_left

当中 move_left是一个函数。next_action这种元素 (类型是函数) 组成一个数组,作为动作序列。运行动作序列时,用以下这种代码:

while ( next_action++ != action_termination )
      next_action;

因为 next_action 既是函数,也是数组元素的指针,因此上述代码不是伪代码,而是能够运行的。这类似于 jump table 技术,数组元素的类型函数,能够遍历数组,运行元素相应的函数。

5.4 删除一行 & 计分数

每一个 timer 中,都调用 void kill_all_full_lines()。它遍历 exist block,凡符合满行条件的,调用 kill_block_in_line 删除该行,调用move_exist_block_down_line 把该行以上的 exist_block 下降一行。

这三个 helper 函数都是通过遍历 exist block 中的每一个元素,匹配坐标条件,然后删除数组元素或者改变数组元素的值。如前所述,因为 exist block 封装中未使用 俄罗斯方块元素,所以这些遍历都写得很丑陋。

删除一行以后,累积删除的行数。全删以后,依据删除的行数进行 switch-case,向全局变量 score 累加分数。在下个timer中,把 score 用 textout 输出到工作区。

6. 回想和检讨

6.1 数据结构,封装,循环条件

因为最初的 (也是终于的)数据结构设计偷了懒,后来又没有足够的时间改动,此前已经提及两次,exist block的结构过于贴*台,而远离需求。exist block的颗粒度太低,是以 int 为类型的 数组元素,相应于需求中的 俄罗斯方块元素 中的横纵坐标之中的一个。某个数组元素究竟是横坐标还是纵坐标,究竟是第几个俄罗斯方块元素,这些都须要由代码实现。这样,按需求写helper函数的时候,遍历的元素选取、终止条件,都遇到了麻烦。我在课堂上写作时须要考虑,有时还会错。经验说明,当我须要细致考虑,或者讲述时间较长时,学生听懂可能已经有相当难度了。终止条件错误的bug,在代码中存在两三处,导致在 exist block够多时,即游戏进行一段时间,工作区中会出现莫名其妙的俄罗斯方块元素。这个bug在最后阶段才解决。

这个故事告诉我们,设计不好,对编码实现的难度要求就会提高。战略失误,战役和战斗就不easy打。领导决策肤浅,要求下属跑死,结果也是白扯。道理都是一样的。

6.2 不要对付过去

在开发中间的某堂课,我们发现当前块移动时后面留了尾迹,擦得不干净。这些那堂课快结束了。为了能让学生在课后反复我课堂上的工作,所以我"对付"了代码,由局部刷新改为刷新整个工作区,包含背景。这样尾迹表面上清除掉了。

之后,延续了这段"对付"的代码。直到期末将至,我才发现这段"对付"掩盖了还有一些bug,坐标移动的bug导致除非刷新整个工作区就有尾迹。这个bug在最后阶段才解决。

6.3 并行,timer

有文章指出,刚開始学习的人很不easy理解的程序概念包含:赋值、递归和迭代、并行。本程序中有几个埋得比較深的bug,是因为我对并行没有足够警惕造成的。

timer, 键盘响应,WM_PAINT会并行发生。当当中一个未处理完的时候,还有一个可能就開始运行;甚至timer未处理完的时候,还有一个timer也可能会開始。而这些并行的代码,都调用了 block.cpp。比方有时导致当中一个正改坐标尚未完毕,还有一个開始刷新工作区,这样工作区里就出现个元素,位置是乱七八糟的。

并行的处理,须要 原子操作、进程间通信、避免重入 等概念。上述提到的动作序列,目的之中的一个就是希望擦除旧的当前块这一动作仅仅在 timer 中发生。

在本课程中,应该不期待学生具备这些操作系统中的知识。只是我还没有想到该怎样设计才干规避这些知识。只是我猜应该类似于不用线程也能设计出贪吃蛇,应该有依赖更浅显知识的设计手段,比方单纯轮询,而不用事件响应、消息循环。有哪位知道,请赐教,谢谢。

6.4 猜想后,应该先验证,然后再改动

学生们通常把验证猜想和实施解决归约成了一步,我也常常如此。下文中的他们,包含我。

他们观察到问题,然后做出猜想。这是正常步骤。

可是他们不以实验验证猜想是正确的,急急按猜想改动代码。假设问题消失了,好,他们假设抓住了问题的解决办法;假设问题还在,就再做个猜想,然后又立即改动。甚至更糟糕,没有退回到上一步的起点,就在当前工作代码上"继续"改动,让各个猜想累加起来,终于问题解决的时候甚至不知道是什么原因。

应该先设计实验,按猜想的模型,假设如何就会如何。验证猜想以后,再去解决。比方假设因为 timer 和 keyboard事件响应 同步导致绘图混乱,那么,不应该着争写进程通信,而是 应该先选用简单粗暴的手段 去除同步,以更大的颗粒度作为原子操作,验证猜想。假设猜想正确,现象应该有所改变。尽管影响性能和效果,但这并非准备终于採用的代码,仅仅是用来验证猜想的。当猜想验证以后,再去想效果更好的方案真正解决,比方建立个变量作为信号灯。

6.5 不要轻易更换技术方案,试图绕过问题

这个方面,我最初是发现计算机本科的同学倾向强烈。常常有方案,明明再向前一步就能解决,他们却在此时换了方案。问为什么。答:由于这个技术解决不了这个问题。

确定"不"是极其困难的,甚至比确定"能"要难上非常多。你不能,并不是就能确定这个方法不能。

须要充分了解你所使用的技术,对它可以完毕的任务有足够和明白的自信。同一时候,对用来替换的方案能解决何种问题,也应该明白。做原型验证,依据理论推论,这些都是解决之道。见到工具,拿来就用,偏听偏信别人的评论,就太草率了;一旦发现并不是万能良药,转身就去寻找就的手段,这就更草率了。

6.6 版本号控制

为了让学生能看到开发的过程,我上课时用文件系统做了版本号控制,每次课一个文件夹,有时压缩成zip。课程结束以后,一个版本号一个版本号增加git,然后commit,操作了两个小时(?),其间又操心整错了,苦不堪言。

下次一定要从最開始就做版本号控制。还要在 commit 前把 debug, pch, sdf 等二进制垃圾手动删除。

7. 附件

附件是以git版本号控制的代码及日志,在这里[http://download.csdn.net/detail/younggift/7499881]。

protype下是技术原型。

tetris下的是俄罗斯方块项目本身。早先的版本号是VS2010的,最后一天的是VS2012的。你能够仅代码部分加入进win32project,以适应你的VS版本号,或者dev c++版本号。

log0.txt是课堂上的日志。log1.txt是最后一天前期的日志。log2.doc是最后一天后期的日志,由于须要截图,所以改成用word。

pic.bmp是图片,用来说明定义的。

branch是一个分支,我忘了它是否增加了 trunk,留在那里备用,以防遗漏。

--------------------


博客会手工同步到下面地址:


[http://giftdotyoung.blogspot.com]


[http://blog.csdn.net/younggift]

俄罗斯方块:win32api开发,布布扣,bubuko.com

俄罗斯方块:win32api开发

上一篇:windows Server 2008 IIS7 503错误解决方案


下一篇:怎么使用pipenv管理你的python项目