particles
game/particles 提供由固定种子驱动的确定性 2D 粒子发射器 Emitter,由 game.Loop 推进并通过可复用的 sprite.Batch 绘制。
import "github.com/nsgo-dev/game/packages/game/particles"
两个配置和 Seed 完全相同、且按相同 dt 步进的发射器,会生成逐比特完全一致的粒子状态与绘制指令。
配置 Emitter
为 Emitter 指定图集 Atlas、帧列表 Frames、发射形状、运动参数和生命周期曲线:
fire := &particles.Emitter{
Atlas: fxAtlas,
Frames: []sprite.Frame{fxAtlas.Frames["spark_0"], fxAtlas.Frames["spark_1"]},
X: 160,
Y: 120,
Shape: particles.Circle(6),
Rate: 45, // 每秒发射粒子数
MaxParticles: 128,
LifetimeMin: 300 * time.Millisecond,
LifetimeMax: 700 * time.Millisecond,
SpeedMin: 20,
SpeedMax: 65,
AngleMin: -math.Pi * 0.75,
AngleMax: -math.Pi * 0.25,
GravityY: -30, // 向上飘升
SizeCurve: particles.FloatCurve{
{T: 0, Value: 0.6},
{T: 0.3, Value: 1.2},
{T: 1, Value: 0},
},
AlphaCurve: particles.FloatCurve{
{T: 0, Value: 1},
{T: 1, Value: 0},
},
Seed: 42,
Z: 20,
}
在 game.Loop.Update 中更新,在 core.Canvas.Draw 中绘制:
// 在 Loop.Update 中:
fire.Update(dt)
// 在 Canvas.Draw 中:
fire.Draw(d)
MaxParticles <= 0时默认为256。LifetimeMin和LifetimeMax均为0时默认为 1 秒。AngleMin与AngleMax以+X为起点顺时针计量(弧度)。InitialRotationMin/Max与RotationSpeedMin/Max控制初始角度与角速度(弧度 / 弧度每秒)。
发射形状
Emitter.Shape 控制新粒子相对于 (X, Y) 的出生位置:
| 形状 | 分布方式 |
|---|---|
Point() |
精确出生在 (X, Y)(Shape 的零值)。 |
Circle(radius) |
在以 (X, Y) 为圆心、半径为 radius 的圆盘内均匀分布。 |
Ring(radius) |
在半径为 radius 的圆周上均匀分布。 |
Rect(width, height) |
在以 (X, Y) 为中心的 width × height 矩形内均匀分布。 |
生命周期曲线
曲线按粒子归一化年龄 t = Age / Lifetime([0, 1])在按 T 排列的控制点之间线性插值:
SizeCurve(FloatCurve):生命周期内的等比缩放(空曲线恒为1)。AlphaCurve(FloatCurve):生命周期内的不透明度(空曲线恒为1)。RotationCurve(FloatCurve):生命周期内叠加的旋转弧度(空曲线恒为0)。ColorCurve(ColorCurve):线性 RGBA 颜色插值并写入Particle.Color(空曲线恒为不透明白色)。说明:精灵着色依赖 nsgo-dev/game#29,目前Draw会将ColorCurve的 alpha 通道与AlphaCurve相乘。
glow := particles.ColorCurve{
{T: 0, Color: core.RGBA(0xff, 0xd1, 0x66, 0xff)},
{T: 1, Color: core.RGBA(0xef, 0x47, 0x6f, 0x00)},
}
爆发发射、读取与重置
对于爆炸、拾取金币或落地扬尘等一次性特效,保持 Rate: 0 并按需调用 Burst(count):
sparks.X, sparks.Y = hit.X, hit.Y
sparks.Burst(24) // 立即发射,最多到 MaxParticles 上限
*Emitter 的其他方法:
Count():返回当前存活的粒子数。Particles():按生成顺序返回存活粒子[]Particle(复用内部切片,需要保留快照请自行复制)。Clear():清除全部存活粒子并重置发射累加器,但保留当前 PRNG 状态。Reset():清除全部存活粒子并按Seed重新播种,以便完全复现后续发射。