maze_python/CONFIG_README.md

配置文件说明

概述

config.py 包含了整个迷宫游戏的所有配置参数，使得项目更易于维护和自定义。

配置参数说明

UI 界面配置

• UI_HEIGHT = 1000: 游戏窗口高度
• UI_WIDTH = 1500: 游戏窗口宽度

迷宫配置

• MAZE_SIZE = 800: 迷宫显示区域大小
• WALL_SIZE = 50: 每个墙体/格子的像素大小

性能配置

• FPS = 120: 游戏帧率
• AUTO_PLAY_INTERVAL = 30: 自动播放时每多少帧前进一步

按钮尺寸配置

• BUTTON_START_SIZE = (200, 100): 开始按钮尺寸
• BUTTON_SAVE_SIZE = (80, 80): 保存按钮尺寸
• BUTTON_CONTROL_SIZE = (100, 50): 路径控制按钮尺寸

字体配置

• FONT_FILE = "syht.otf": 字体文件路径
• FONT_SIZE = 18: 字体大小

资源路径配置

所有图片资源的路径都定义在这里，便于统一管理：

• WALL_IMAGE: 墙体纹理
• COIN_IMAGE: 金币纹理
• TRAP_IMAGE: 陷阱纹理
• START_BUTTON_IMAGE: 开始按钮图片
• SAVE_BUTTON_IMAGE: 保存按钮图片

颜色配置

预定义了常用的颜色值：

• COLOR_WHITE: 白色背景
• COLOR_BLACK: 黑色文字
• COLOR_GRAY: 灰色按钮
• COLOR_GREEN: 绿色高亮
• COLOR_GOLD: 金色路径

布局配置

get_button_positions() 函数返回所有UI元素的位置，包括：

• 各种按钮的位置
• 文字显示的位置
• 根据窗口大小自动计算相对位置

使用方法

导入配置

from config import *

获取按钮位置

button_positions = get_button_positions()
start_x, start_y = button_positions['start_button']

修改配置

要修改游戏参数，只需编辑 config.py 文件即可，无需修改主程序代码。

优势

1. 集中管理: 所有配置参数集中在一个文件中
2. 易于维护: 修改参数不需要在多个文件中查找
3. 可扩展性: 新增配置项只需在配置文件中添加
4. 代码整洁: 主程序代码更加简洁明了
5. 复用性: 配置可以被多个模块共享使用