更新tetris.cpp

Author: chudonghao

tetris.cpp

@@ -6,22 +6,33 @@
 ///=============================================================================
 /// C++基础知识：
 /// 1. 预处理（注释、头文件引入、定义宏）
-/// 2. 基本数据类型
+/// 2. 数据类型
+///    1. 基本数据类型与数组
+///    2. 指针（特殊的基本数据类型）
+///    3. 引用（特殊的语法糖与语法含义）
 /// 3. 定义类型
 ///    1. 成员变量
 /// 4. 定义变量
 ///    1. 定义基本数据类型变量
 ///    2. 定义结构体类型变量
 ///    2. 定义数组变量
 /// 5. 定义函数
-/// 6. 访问变量
-/// 7. 调用函数
-/// 8. （自定义）类型的内存结构
-/// 9. 函数的调用过程
+/// 6. 表达式
+///    1. 访问变量
+///    2. 调用函数
+/// 7. 逻辑语句
+///    1. 条件语句 if switch(case default break)
+///    2. 循环语句 for while do..while -- continue break
+///    3. 跳转语句 goto
+/// 8. 入口函数
+/// 9. （自定义）类型的内存结构
+/// 10. 函数的调用过程
 ///=============================================================================
 /// 理解或思想：
 /// 👉 预处理：💡简单的文本替换，提高代码复用
-/// 👉 数据类型的作用：💡赋予内存格子含义，或者说💡标注内存的处理方式
+/// 👉 数据类型的作用：💡赋予格子（内存）含义，或者说💡标注内存的处理方式
+///    👉 指针：💡整数，💡代表格子的地址（编号）
+///    👉 引用：💡从底层角度看：引用是指针的语法糖，💡从语义角度看：引用是变量别名
 /// 👉 定义（自定义）类型：
 ///    💡确定该类型变量占用的格子数（通过成员变量自动计算大小）
 ///    💡以及每个格子的含义（通过成员变量自动确定每个格子的含义）
@@ -30,19 +41,22 @@
 /// 👉 定义函数：💡描述一个过程：输入->处理->输出，即参数->函数体->返回值
 /// 👉 访问变量：💡找到对应格子，按类型含义访问和处理格子内的数据
 /// 👉 调用函数：💡很好理解
+/// 👉 逻辑语句：💡比较+跳转
 /// 👉 （自定义）类型的内存结构：
 ///    💡从避免CPU多次存取内存的角度出发，自动空出格子以提高内存访问效率
 /// 👉 函数的调用过程：
 ///    💡递归！
 ///    💡栈！
-///    💡输入（参数）输出（返回值）通过函数调用栈传递
+///    💡输入（参数）输出（返回值）通过在函数调用栈上创建变量传递
+///    💡参数和返回值必须通过复制值的方式传递，指针和引用的特殊之处在于复制（传递）的是地址
 ///=============================================================================
 /// 思想！：
 /// 👉 程序的基本作用：💡内存读写与指令执行
 /// 👉 面向对象-理解方式1：💡数据+算法（过程）
 /// 👉 面向对象-理解方式2：💡变量+函数
 ///=============================================================================
 
+// 🏷 头文件引入
 // 引入标准库.算法.函数std::clamp
 #include <algorithm>
 // 引入标准库.函数setlocale
@@ -59,40 +73,52 @@
 // * ...
 #include <ncurses.h>
 
+// 🏷 定义（全局）变量
 WINDOW *game_window;
 WINDOW *info_window;
 
+// 🏷 定义函数
 void CreateWindow() {
   game_window = newwin(20, 10, 0, 0);
   info_window = newwin(20, 70, 0, 10);
 }
 
+// 🏷 定义函数
 void DestroyWindow() { endwin(); }
 
+// 🏷 定义（自定义）类型
 // 定义格子类型
 struct Cell {
   bool has_tetro{};
 };
 
+// 🏷 定义（自定义）类型
 // 定义棋盘类型
 struct Board {
   Cell cell[20][10]{};
 };
 
-// I O T J L S Z
+// 🏷 定义（自定义）类型
+// 定义四连骨牌类型
+// 四连骨牌有7种形式：I O T J L S Z
 struct Mino {
   // Mi mi[4];
   Cell cell[4][4]{};
 };
 
+// 🏷 定义（全局）变量
 // 定义棋盘变量
 Board board;
 
+// 🏷 定义（全局）变量
 // 定义四连骨牌
 Mino mino;
+// 🏷 定义（全局）变量
+// 定义四连骨牌的位置
 int x;
 int y;
 
+// 🏷 定义函数
 // 绘制棋盘
 void RenderBoard() {
   // 遍历每个格子
@@ -106,6 +132,9 @@ void RenderBoard() {
     }
   }
 }
+
+// 🏷 定义函数
+// 清除磁盘
 void ClearBoard() {
   // 遍历每个格子
   for (int row = 0; row < 20; ++row) {
@@ -114,6 +143,8 @@ void ClearBoard() {
     }
   }
 }
+
+// 🏷 定义函数
 // 绘制四连骨牌
 void RenderMino() {
   // 遍历MINO的每个格子
@@ -126,6 +157,8 @@ void RenderMino() {
   }
 }
 
+// 🏷 定义函数
+// 碰撞检测
 bool CollisionDetect(Mino &mino, int x, int y) {
   // 每个mino的骨牌是否产生碰撞
   for (int row = 0; row < 4; ++row) {
@@ -150,6 +183,8 @@ bool CollisionDetect(Mino &mino, int x, int y) {
   return false;
 }
 
+// 🏷 定义函数
+// 创建四连骨牌
 bool CreateMino() {
   // 随机创建其中一种类型：I O T J L S Z
   std::random_device rd;
@@ -233,6 +268,8 @@ bool CreateMino() {
   return true;
 }
 
+// 🏷 定义函数
+// 下落四连骨牌
 // 落地之后需要其它逻辑，返回值代表是否下落成功
 bool Fall() {
   // 判断能不能下落
@@ -244,6 +281,9 @@ bool Fall() {
   y = y + 1;
   return true;
 }
+
+// 🏷 定义函数
+// 使四连骨牌落地，即将四连骨牌分解为单个骨牌放置在棋盘上
 void Land() {
   // 把当前的四连骨牌放在棋盘上
   // 绘制在棋盘上
@@ -256,6 +296,8 @@ void Land() {
   }
 }
 
+// 🏷 定义函数
+// 旋转四连骨牌
 void Rotate() {
   // ↻
   // - - - -
@@ -287,12 +329,16 @@ void Rotate() {
   }
 }
 
+// 🏷 定义函数
+// 清除棋盘上的一行
 void ClearLine(int y) {
   for (int col = 0; col < 10; ++col) {
     board.cell[y][col].has_tetro = false;
   }
 }
 
+// 🏷 定义函数
+// 将棋盘上的某一行的上方所有行向下移动一行
 void MoveDownAllAboveLine(int y) {
   for (int row = y; 0 <= row; --row) {
     if (row == 0) {
@@ -305,6 +351,8 @@ void MoveDownAllAboveLine(int y) {
   }
 }
 
+// 🏷 定义函数
+// 判断棋盘上的某一行是否放满骨牌
 bool IsLineFull(int y) {
   // return std::all_of(&board.cell[y][0], &board.cell[y][10], [](auto
   // &cell){return cell.has_tetro;});
@@ -316,6 +364,8 @@ bool IsLineFull(int y) {
   return true;
 }
 
+// 🏷 定义函数
+// 检查棋盘上的某一行是否放满骨牌、清理放满的行、将清理的行的上方所有骨牌向下移动
 void CheckAndDeleteLine() {
   for (int row = 0; row < 20; ++row) {
     if (IsLineFull(row)) {
@@ -325,10 +375,13 @@ void CheckAndDeleteLine() {
   }
 }
 
+// 🏷 定义宏
 #define GAME_OVER 0
 #define EXIT 1
 #define RESTART 2
 
+// 🏷 定义函数
+// 显示欢迎信息
 bool Welcome() {
   wclear(info_window);
   mvwprintw(info_window, 3, 0, "Welcome Tetris!");
@@ -348,6 +401,8 @@ bool Welcome() {
   }
 }
 
+// 🏷 定义函数
+// 显示游戏结束信息
 int GameOver() {
   wclear(info_window);
   mvwprintw(info_window, 5, 0, "Game Over!");
@@ -367,6 +422,8 @@ int GameOver() {
   }
 }
 
+// 🏷 定义函数
+// 显示游戏帮助信息
 void HelpInfo() {
   wclear(info_window);
   mvwprintw(info_window, 3, 0, "Keys:");
@@ -377,6 +434,8 @@ void HelpInfo() {
   mvwprintw(info_window, 9, 0, "e exit");
 }
 
+// 🏷 定义函数
+// 单次游戏循环
 int GameLoop() {
   HelpInfo();
   ClearBoard();
@@ -439,6 +498,8 @@ int GameLoop() {
   }
 }
 
+// 🏷 定义函数
+// 入口函数
 int main() {
   setlocale(LC_ALL, "");
   // 初始化界面系统ncurses