lights2d
game/lights2d 为 NSGo 画布提供 2D 光照能力:环境暗场层、点光源与聚光灯、基于遮挡体的精确 2D 可见性多边形阴影,以及 CPU 切线空间法线贴图精灵着色。
import "github.com/nsgo-dev/game/packages/game/lights2d"
环境暗场、点光源与聚光灯
创建带有 Ambient 环境色与 *Light 列表的 Scene,在 Canvas.Draw 中绘制完 2D 世界后叠加绘制:
torch := lights2d.NewLight(160, 120, 180, core.RGB(255, 196, 120))
torch.CastShadows = true
flashlight := lights2d.NewLight(240, 140, 260, core.RGB(220, 235, 255))
flashlight.ConeAngle = 0 // 弧度:0 为 +X,pi/2 为 +Y
flashlight.ConeSpread = math.Pi / 3
flashlight.CastShadows = true
lighting := &lights2d.Scene{
Ambient: core.RGBA(12, 16, 30, 0.85),
Lights: []*lights2d.Light{torch, flashlight},
}
// 在 Canvas.Draw 中绘制完瓦片和精灵之后:
lighting.Draw(d, worldBounds)
NewLight(x, y, radius, color)创建默认启用的全向点光源,Intensity: 1,二次衰减Falloff: 2。- 将
ConeSpread设为(0, 2*math.Pi)即可变为方向聚光灯,沿ConeAngle做 smoothstep 角度衰减。 - 可用
light.AttenuationAt(x, y)或scene.EvaluateAt(x, y)在 CPU 侧查询任意世界坐标的精确照度。
可见性多边形阴影遮挡体
通过 RectOccluder、PolygonOccluder 或 SegmentOccluder 将墙体、柱子或瓦片碰撞体加入 Scene.Occluders:
lighting.Occluders = []lights2d.Occluder{
lights2d.RectOccluder(core.Bounds{Origin: core.Point{X: 200, Y: 90}, Size: core.Size{Width: 48, Height: 64}}),
lights2d.SegmentOccluder(lights2d.Segment{
A: core.Point{X: 80, Y: 180},
B: core.Point{X: 160, Y: 180},
}),
}
当 light.CastShadows 为 true 时,Scene.Draw 会用 VisibilityPolygon(origin, radius, occluders) 裁剪该光源。你也可以直接调用几何辅助函数实现潜行视野、视线判断或战争迷雾:
| 函数 | 用途 |
|---|---|
VisibilityPolygon(origin, radius, occluders) |
计算从 origin 出发在 radius 范围内的有序 2D 可见多边形。 |
Visible(origin, target, occluders) |
判断 origin 到 target 的连线是否被遮挡体阻断。 |
PointInPolygon(p, poly) |
测试点 p 是否位于可见多边形内。 |
法线贴图精灵
为像素画或手绘 2D 精灵配上一张切线空间法线贴图(*image.NRGBA),即可获得随光源方向变化的立体高光与凹凸感:
knight := lights2d.NewNormalSprite(diffuseImg, normalMapImg)
knight.X = 160
knight.Y = 120
knight.LightZ = 48 // 光源相对精灵平面的虚拟 Z 高度
// 在 Canvas.Draw 中:
knight.Draw(d, lighting)
NormalSprite 会缓存 CPU 着色后的像素缓冲,仅当精灵坐标、LightZ、环境光或影响范围内的光源/遮挡体变化时才重新计算。若原地修改了 Diffuse 或 NormalMap 像素,请调用 knight.Invalidate();若需离线烘焙自定义缓冲,可直接调用 ShadeNormalMap、ShadeNormalMapWithOccluders 或 scene.ShadeNormalMap。