|
|
# 烟花特效程序使用说明文档
## 一、程序介绍
本程序基于 **Python + Pygame** 开发，实现了**鼠标点击发射烟花**、**键盘切换多种爆炸造型**、**真实闪烁星空背景**、**长条流光粒子**、**流星升空拖尾**及**爆炸音效**的完整视觉效果。界面宽大、色彩鲜艳、操作简单，适合演示与娱乐使用。
---
## 二、运行环境要求
1. 安装 Python 3.x
2. 安装依赖库：
```bash
pip install pygame
```
---
## 三、功能说明
1. **星空背景**
- 800 颗随机大小、亮度的星星
- 缓慢呼吸式闪烁，更接近真实夜空
2. **烟花发射**
- 鼠标左键点击屏幕任意位置 → 发射烟花
- 烟花从底部升空，带有流星拖尾效果
3. **爆炸音效**
- 烟花到达最高点时自动播放爆炸声
- 音量已调至适中，可在代码中修改
4. **多造型爆炸（核心功能）**
通过键盘数字键 **1~6** 切换造型，鼠标点击即使用当前造型爆炸：
- 1：圆形扩散
- 2：圆环
- 3：十字星光
- 4：爱心
- 5：五角星
- 6：螺旋
5. **粒子效果**
- 长条流光粒子，沿运动方向延伸
- 带重力、透明度衰减、长度衰减
- 爆炸范围为规整圆形
---
## 四、操作指南
| 操作 | 功能 |
|------|------|
| 鼠标左键点击 | 在点击位置发射烟花 |
| 键盘 1 | 切换为【圆形】爆炸 |
| 键盘 2 | 切换为【圆环】爆炸 |
| 键盘 3 | 切换为【十字】爆炸 |
| 键盘 4 | 切换为【爱心】爆炸 |
| 键盘 5 | 切换为【五角星】爆炸 |
| 键盘 6 | 切换为【螺旋】爆炸 |
| 关闭窗口 | 退出程序 |
---
## 五、界面说明
- 左上角显示操作提示文字（按键说明 + 鼠标操作）
- 深邃深蓝色星空背景
- 烟花升空有明亮拖尾，爆炸为长条彩色粒子
- 粒子会自然下落、逐渐消失
---
## 六、可自定义修改项（可选）
你可以在代码中轻松调整以下内容：
1. **窗口大小**
修改 `WIDTH, HEIGHT = 1600, 900`
2. **星星数量**
修改 `for _ in range(800)` 中的数字
3. **爆炸音量**
修改 `explosion_sound.set_volume(0.8)`（0~1）
4. **粒子数量/速度/长度**
在 `Particle` 类和 `explode` 函数中调整数值
5. **烟花颜色**
在 `color_list` 中增删 RGB 颜色
---
## 七、常见问题
1. **运行报错**
- 未安装 pygame：执行 `pip install pygame`
- 字体报错：不影响运行，或更换系统字体名称
2. **音效无声**
- 电脑音量未打开
- 部分系统不支持内置音频，可替换外部音效文件
3. **画面卡顿**
- 降低星星数量（800 → 400）
- 降低粒子数量（200 → 100）
---
## 八、文件结构
只需一个主程序文件，无需外部图片/音频资源：
- `fireworks.py`（主程序）
包含：星空、粒子、烟花逻辑、造型切换、事件控制、渲染循环
---
如果你需要，我可以再帮你生成一份 **Word 格式排版好的文档文本** 或 **简洁PPT版说明**。 |
|
发表于 2026-2-10 16:33:32
