先上个模块关系图：
main.py- 程序主入口view.py- 游戏菜单界面模块game.py- 游戏主程序+界面模块resource.py- 程序所需的基本方法和资源模块
-
view.py
BasicView- 界面基类，包含界面初始化和创建界面必须的方法MenuView- 菜单类，包含菜单界面绘制和相关操作方法DifficultyView- 困难度类，包含困难度调整界面绘制和相关的操作方法RankingView- 排名类，包含排名展示界面绘制和相关操作方法
-
resource.py
resource模块只有
Res一个大类，Res类包含：- 默认的配置文件内容
- 修改/获取配置文件的方法
- 获取艺术字的方法
- 修改/获取排名文件的方法
- 修正艺术字偏移的方法
- 转换
0-255RGB颜色为0-1000RGB的方法 - 按概率进行随机选择的方法
-
game.py
Game- 游戏主类，包含游戏界面绘制和必需的操作方法，以及很大一坨类属性Line- 线体相关绘制和操作方法Trigger- 触发点相关绘制和操作方法FxBase- 线体效果基类FxNormal- 普通触发点效果类FxBonus- 奖励点效果类FxAclrt- 加速点效果类FxDclrt- 减速点效果FxMyopia- 近视点效果FxBomb- 爆炸点效果FxIvcb- 无敌点效果FxStones- 流石点效果FxTlpt- 传送点效果
其中
Line实例化后的对象会被储存在Game中，后面Trigger实例化时能通过Game的类方法取出Line的实例对象。
因为这里的函数关系太复杂了，暂且只列出各模块的函数，部分关系在下面一节中再展示...
青色代表类方法，黄色代表实例方法，绿色代表实例属性，蓝色代表异步函数，粉色代表静态方法。
-
game.py
展开查看方法用途描述
Game类:
方法名 类型 用途 set_color 类方法 基于 curses设置颜色对color_pair 类方法 在 curses.color_pair上的一个Hook，考虑不支持颜色的情况cls_init 类方法 初始化Game类的类属性 cut_point 类方法 修剪传入的点集合，返回一个只存在于地图内的点集合 reset_score 类方法 重置游戏分数为0 add_task 类方法 往 asyncio事件循环中增加协程任务，多用于触发点特效的处理add_score 类方法 增加分数，可以接受一个参数 num来指定加多少分create_border 类方法 创建游戏边界的点坐标集合 create_area 类方法 创建 curses窗口，包括消息窗口和游戏窗口del_area 类方法 在游戏结束后删除窗口 get_ins 类方法 获得储存的实例，用于取得 Line的实例对象myopia 类方法 使用布尔值设置是否近视 get_sight_info 类方法 用于近视处理部分，获得头部坐标和视野宽高 update_myopia_sight 类方法 用于更新视野区域点集合，搭配 Line实例的move方法printer 类方法 用于游戏区域图案打印， curses.addstr方法的一个Hook，同样是考虑了不支持颜色的情况flash_fx 实例方法 用于 count_down方法里对艺术字的随机纵向推拉动画count_down 实例方法 用于游戏倒计时 draw_flow_stones 实例方法 用于根据流石点集绘制流石 draw_border 实例方法 根据 create_border创建的点集绘制游戏区域边框draw_score 实例方法 在消息区绘制分数信息 calc_score 实例方法 用于在游戏结束后计算出最终得分 over 实例方法 游戏结束时进入的游戏结束方法 cancel_tasks 实例方法 在游戏结束后取消所有 asyncio事件循环中的协程任务start 实例方法 促使游戏开始的方法 Line类:
方法名 类型 用途 draw_line 实例方法 在游戏区域中绘制角色 draw_msg 实例方法 在消息区域中绘制线体相关消息 tail_impact 实例方法 检查尾巴从哪里开始截断，用于爆炸点的判断 impact 实例方法 线体死亡判断 move 实例方法 线体移动处理方法 add_tail 实例方法 加长尾巴的处理方法 control 实例方法 接受键盘控制的方法 hit 实例方法 判断头部是否位于传入的坐标点，也就是判断碰撞 velo 实例属性 返回线体速度的大小(无关方向) Trigger类:
方法名 类型 用途 check 实例方法 检查触发点的情况，包括检查是否还有触发点和是否碰撞到触发点 ava_points 实例方法 获得可用的点集合，不可用的点包括被线体占用，被触发点占用，边界点等等 make 实例方法 在游戏区域中随机放置触发点 draw 实例方法 在消息区域输出 触发点消息队列的内容trg_async 实例方法 根据线体碰到的触发点类型进行效果相关的异步任务分发 FxBase及其继承出的Fx...类：
方法名 类型 用途 hang_fx **(父类方法)**实例方法 在 触发点消息队列中挂起一条消息apply **(子类方法)**实例方法 给线体应用当前的效果 -
view.py
展开查看方法用途描述
BasicView类:
方法名 类型 用途 create_win 实例方法 基于 curses创建标题和选项栏两个窗口MenuView类:
方法名 类型 用途 first_page 实例方法 用于展示运行程序时的第一个画面 start_game 实例方法 用于开始游戏，开启 asyncio事件循环asyncio_game 实例方法 创建并行任务列表，将开始游戏 game.start()方法加入任务列表option_maker 实例方法 根据选项生成菜单文本 menu 实例方法 游戏菜单主程序，接受用户输入并予以反馈和跳转 DifficultyView类:
方法名 类型 用途 bar_maker 实例方法 根据当前选择的困难度生成一个小进度条 show_panel 实例方法 困难度菜单主程序，接受用户输入以改变困难度 RankingView类:
方法名 类型 用途 list_maker 实例方法 根据排名分片生成要打印出来的文本 show_panel 实例方法 排名表主程序，反馈当前的排名情况，接受用户输入以翻页或者返回 -
resource.py
展开查看方法用途描述
Res类:
方法名 类型 用途 art_texts 实例方法 获取艺术字，并返回艺术字的高度，长度以及文本内容 get_config 实例方法 读取配置文件并json解析，返回配置文件字典 set_config 实例方法 根据键设置对应配置的值，再转换为json格式储存 get_ranking 实例方法 读取排名文件并json解析，返回排名字典 set_ranking 实例方法 将新的总分加入排名文件，再转换为json格式储存 x_offset 静态方法 修复 curses.addstr打印多行文本时的错位问题，手动添加偏移rgb 静态方法 将 0-255的颜色RGB值转换为curses.init_color能接受的0-1000ratio_rand 静态方法 根据传入的字典键值对，按概率随机返回一个字典键（值是键对应的概率）
