项目架构重构,代码整理

This commit is contained in:
2026-04-28 22:44:31 +08:00
parent 2f435f5ca6
commit 0840a807b5
18 changed files with 2332 additions and 1893 deletions
+19 -2
View File
@@ -98,6 +98,15 @@ Tereis/
├─ src/
│ ├─ include/ 头文件
│ ├─ source/ 源文件
│ │ ├─ Tetris.cpp 程序入口、窗口和消息框架
│ │ ├─ TetrisLogic.cpp 基础俄罗斯方块逻辑框架
│ │ ├─ TetrisRender.cpp 基础绘制框架
│ │ ├─ common/ 资源路径、文件检查等通用工具
│ │ ├─ app/ 媒体播放、布局命中、输入和定时器处理
│ │ ├─ extensions/ 框架外通用扩展、界面状态和视觉效果
│ │ ├─ logic/ 特殊方块落地效果等逻辑扩展
│ │ ├─ render/ 图片加载等渲染内部支持
│ │ └─ rogue/ Rogue 模式、强化和技能系统
│ └─ resources/ Windows 资源脚本
├─ assets/
│ ├─ audio/ 背景音乐
@@ -130,6 +139,8 @@ Tereis/
C:\mingw64\bin\
```
构建脚本会递归收集 `src/source` 下的 `.cpp` 文件。新增功能代码可以放入功能目录,不需要手动维护固定源码列表。
## 构建与运行
在项目根目录执行:
@@ -194,10 +205,16 @@ powershell -NoProfile -ExecutionPolicy Bypass -File .\build-mingw.ps1 -Run
本项目以过程式 C++ 写法为主,核心逻辑分布如下:
- `src/source/Tetris.cpp`窗口、消息循环、输入和鼠标交互
- `src/source/Tetris.cpp`Win32 程序入口、窗口创建和消息分发主干
- `src/source/TetrisLogic.cpp`:基础方块逻辑、消行和状态重置
- `src/source/TetrisRogue.cpp`:Rogue 模式、强化、技能和成长系统
- `src/source/TetrisRender.cpp`:界面绘制、面板、动画和特效
- `src/source/common/TetrisAssets.cpp`:资源路径拼接和文件存在判断
- `src/source/app/`:背景音乐、复活视频、窗口布局命中、鼠标键盘和定时器处理
- `src/source/logic/TetrisPieceEffects.cpp`:彩虹、爆破、激光、十字和稳定结构等落地效果
- `src/source/extensions/TetrisGameExtensions.cpp`:框架外通用状态切换、复活、说明页、视觉效果等扩展支持
- `src/source/render/TetrisRenderAssets.cpp`:背景图、致谢页图片等 GDI+ 图片资源加载
- `src/source/rogue/TetrisRogue.cpp`:Rogue 模式、强化、技能和成长系统
- `src/include/Tetris.h`:主要结构体、全局状态和函数声明
- `src/include/TetrisAppInternal.h``src/include/TetrisRenderInternal.h``src/include/TetrisAssets.h`:窗口层、渲染层和资源工具的内部声明
项目适合作为程序设计课程大作业展示,也便于在答辩时讲解窗口程序、游戏循环、碰撞检测、状态管理和功能扩展。