俄罗斯方块技术开发文档.docVIP

“俄罗斯方块”技术开发文档 Ver 1.0 开发者：余波 指导老师：方琳琳 设计流程 函数功能 1、void InitGame( ) 功能：游戏初始化。进入图形模式、调用新的时钟中断处理过程（SetTimer(newHandler)）、进入欢迎界面（Welcome()）。 2、void SetTimer(void interrupt(*MyHandler)(void)) 接口：MyHandler为新的时钟中断处理过程的入口地址。 功能：设置新的时钟中断处理过程。 3、void interrupt newHandler(void) 功能：新的时钟中断处理过程。 4、void Welcome( ) 功能：欢迎界面。 5、void NewGame( ) 功能：新的一局游戏。 6、void DrawBox(int i, int j) 接口：i,j分别为横坐标和纵坐标。 功能：画一个小方格。 7、void MsgBoard(int x,int y, int width,char *szMsg) 接口：x,y分别为横坐标和纵坐标；width为宽度；szMsg为要显示字符串的首地址。 功能：画文字消息框。 8、void NumBoard(int x,int y,int width,long num) 接口：x,y分别为横坐标和纵坐标；width为宽度；num为要显示的数字。 功能：画数据消息框。 9、int GetNextShape() 接口：返回19种方块形状的索引（0-18）。 功能：取得下一个形状的索引。 10、void DrawShape(int index, int x, int y, int color) 接口：index为19种方块形状的索引（0-18）；x,y分别为横坐标和纵坐标；color为颜色。 功能：画形状(4个方格)。 11、int Moveable(int index, int x, int y, enum direct dir) 接口：index为19种方块形状的索引（0-18）；x,y分别为横坐标和纵坐标；dir为Left、Rright或Down；返回0（不能移动）或1（可以移动）。 功能：判断方块能不能移动。 12、int Confilict(int index, int x, int y) 接口：index为19种方块形状的索引（0-18）；x,y分别为横坐标和纵坐标；返回0（没有冲突）或1（有冲突）。 功能：冲突检测。 13、void Move(int index, enum direct dir) 接口：index为19种方块形状的索引（0-18）；dir为Left、Rright或Down。 功能：移动方块。 14、int Rollable(int index, int x, int y, int *offset) 接口：index为19种方块形状的索引（0-18）；x,y分别为横坐标和纵坐标；offset指向偏移量；返回0（不能旋转）或1（可以旋转）。 功能：判断方块能不能旋转。 15、void Roll(int offset) 接口：offset为旋转后的偏移量。 功能：旋转方块。 16、int DeleteRows(int y) 接口：y为y坐标；返回值为删除的行数。 功能：删除所有可删除的行。 17、int FullRow(int y) 接口：y为y坐标；返回值为0（未满）或1（满）。 功能：判断该行是否满。 18、void DeleteRow(int y) 接口：y为y坐标。 功能：删除该行。 19、int AddScore(int rows) 接口：rows为一次消除的行数；返回分数（消一行2分；消二行6分；消三行12分；消四行20分）。 功能：根据消行的多少来加分。 20、int CheckGameOver() 接口：返回值为0（游戏没有结束）或1（游戏结束）。 功能：判断游戏是否结束。 21、int GameOver() 接口：返回值为0（不退出游戏，重新开始）或1（退出游戏）。 22、void KillTimer() 功能：恢复原来的时钟中断处理。 23、void SaveHiScore() 功能：保存最高纪录 技术说明 游戏中的各种形状及整个游戏空间的数据表示 定义了一个结构来表示形状。 struct shape { int xy[8]; int color; int next; } 其中：xy[8] 用来记录组成图形的小方块的相对坐标； color 表示小方块的颜色； next 表示该种图形的下一种变形的序号； 七种形状及它们旋转后的变形体一共有19种形状，用一个全局数组表示