问题背景与重构目标
原文第一版烟花代码能跑出画面,但暴露了三类硬伤:位置更新写成x += vx,速度单位是像素每帧,帧时间波动时粒子会顿一下;阻力写成vx *= 0.97,帧率不同导致衰减效果不一致;爆炸只靠随机角度和随机速度,形态单一;每帧screen.fill清屏,粒子消失得干干净净,没有残影和余韵。原作者把烟花重新建模为带生命周期的粒子系统,所有运动物体都是Particle实例,Firework只负责何时起爆、按哪种形态生成子粒子,以及把初始参数塞进粒子列表。这样形态与运动解耦,新增爆炸样式只需写新的速度生成函数,物理更新不用改。
粒子字段与生命周期
Particle用life和max_life双字段:life是剩余秒数,每帧减dt;max_life用于计算life / max_life进度比例,颜色插值、透明度和粒子大小都依赖它。字段包括x、y、vx、vy、life、max_life、color、size、trail、gravity、drag、twinkle。__slots__用于减少上千粒子时的__dict__开销。trail保存历史坐标,长度控制在5到8,超过长度用pop(0),粒子多时可用collections.deque(maxlen=8)。gravity和drag放在粒子上,支持垂柳等不同形态共存。twinkle是0到1随机数,给闪烁加相位差,避免所有粒子同步像呼吸灯。
帧率无关的运动学
核心是把物理量只和秒挂钩。阻力定义成“一秒后的保留比例”,用drag ** dt做指数衰减;重力作为加速度乘dt;位置更新采用先更新速度再更新位置的半隐式欧拉。dt要钳制上限,原文用min(clock.tick(60) / 1000.0, 1 / 30),卡顿时宁可慢一点,也不要让粒子瞬移。- def update(self, dt):
- self.trail.append((self.x, self.y))
- self.vy += self.gravity * dt
- damp = self.drag ** dt
- self.vx *= damp
- self.vy *= damp
- self.x += self.vx * dt
- self.y += self.vy * dt
- self.life -= dt
复制代码 原文实测参数:球形重力260px/s²、阻力0.55、初速度320到420px/s、寿命1.4到1.8s;环形重力180、阻力0.72、初速度约380、寿命1.8到2.2s;垂柳重力420、阻力0.45、初速度180到260、寿命2.6到3.2s。经验上让speed × life落在窗口高度0.8到1.2倍之间,1280宽窗口用400速度、1.6秒寿命,理论射程640像素,边缘不易溢出。
爆炸形态参数化
所有形态先产生角度和速度,再转直角坐标。球形爆角度0到360均匀随机,速度取0.75到1.0倍基准速度,避免速度接近零的粒子堆在爆心。环形爆角度均分并加很小抖动,速度乘0.96到1.04,不能随机太大,否则退化成球形。心形不能随机取角度,要沿参数方程采样点当速度向量,屏幕y轴向下,算出的y要取负,采样顺序要random.shuffle,否则前几帧像描边。心形x约±16、y约±17,scale取20时横跨约640像素。- def sphere_vectors(count, speed):
- vecs = []
- for _ in range(count):
- angle = random.uniform(0, 2 * math.pi)
- s = speed * random.uniform(0.75, 1.0)
- vecs.append((math.cos(angle) * s, math.sin(angle) * s))
- return vecs
- def heart_vectors(count, scale):
- vecs = []
- ts = [(2 * math.pi * i / count) for i in range(count)]
- random.shuffle(ts)
- for t in ts:
- x = 16 * math.sin(t) ** 3
- y = 13 * math.cos(t) - 5 * math.cos(2 * t) - 2 * math.cos(3 * t) - math.cos(4 * t)
- vecs.append((x * scale, -y * scale))
- return vecs
复制代码 垂柳角度限制在上半圆,速度小、重力大、寿命长,用暖白偏黄并在后半段降亮度。二次爆炸在Firework里给粒子存child_at,life / max_life低于40%时在当前位置再burst一次,触发后把child_at设为None,防止每帧重复触发;原文提到忘清空会一秒钟生成上万个粒子导致卡死。
残影、渐隐与伪辉光
不再每帧清屏,而是每帧盖一层带透明度的黑色Surface。fade.set_alpha(28)表示每帧盖28/255黑,旧位置按指数衰减形成拖尾。alpha 10到18残影很长像雾,25到35是常规烟花档位,50到70很短,255等于清屏。副作用是亮色累积,密集区域会越来越白,可用降低粒子自身alpha或提高fade alpha解决。颜色随寿命插值用HSV比RGB干净,val下限设25避免纯黑突然消失,hue向红偏12度模拟火星冷却。伪辉光预渲染一张光斑图,用SRCALPHA保留透明度,粒子用BLEND_RGB_ADD叠加;光斑峰值亮度约200,只有寿命前30%用加色混合,其余切普通混合,避免中心糊成纯白。- def make_glow(radius=8):
- size = radius * 2
- surf = pygame.Surface((size, size), pygame.SRCALPHA)
- for r in range(radius, 0, -1):
- alpha = int(255 * (1 - r / radius) ** 2)
- pygame.draw.circle(surf, (255, 255, 255, alpha), (radius, radius), r)
- return surf
复制代码
性能优化与排错
先量化再优化。原文在主循环统计update和draw耗时,发现draw占85%,物理不到10%。优化顺序:预渲染光斑、字体、背景星空;复用Surface,不要每帧新建;粒子800以下用draw.circle,超过1500再考虑pygame.surfarray加numpy。粒子成批生灭,可用ParticlePool预分配固定容量,原文容量4000,池满返回None直接丢弃而不扩容,避免连点鼠标时无限制生成导致卡死。高分屏用pygame.display.set_mode((1280, 720), pygame.SCALED)统一逻辑分辨率,避免2倍缩放下发虚和渲染开销翻四倍。- class ParticlePool:
- def __init__(self, capacity=4000):
- self.items = [Particle() for _ in range(capacity)]
- self.cursor = 0
- def spawn(self):
- for _ in range(len(self.items)):
- p = self.items[self.cursor]
- self.cursor = (self.cursor + 1) % len(self.items)
- if not p.alive:
- p.alive = True
- return p
- return None
复制代码 原文列出的六类运行问题包括:窗口白屏或无响应,画面越叠越白或越烧越黑,中文字体与资源路径,打包成可执行文件后资源丢失,边遍历边删除,高分屏下画面发虚和坐标偏移。排查时应优先检查事件循环和初始化顺序、残影与加色混合的累积、资源路径与打包方式,以及遍历粒子列表时是否安全删除;高分屏优先用SCALED处理DPI。 |