feat(client): 客户端网络层、zh_cn 中文语言文件、NSIS 中文安装脚本、UI 渲染器与 HUD（gl 标签）
This commit is contained in:
NianGao Dev
107
internal/ui/hud.go
Normal file
107
internal/ui/hud.go
Normal file
@@ -0,0 +1,107 @@
|
||||
//go:build gl
|
||||
|
||||
// HUD 抬头显示：准星、热键栏、生命/饥饿、破坏进度（UI还原.md §2、§3.4 规格）。
|
||||
package ui
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
|
||||
"mc/internal/game"
|
||||
"mc/internal/item"
|
||||
)
|
||||
|
||||
// HUD 游戏内 HUD。
|
||||
type HUD struct {
|
||||
sess *game.Session
|
||||
items *item.Registry
|
||||
|
||||
// 物品图标：items 图集纹理与 UV
|
||||
itemTex uint32
|
||||
itemUV map[string][4]float32
|
||||
|
||||
// 逻辑分辨率与缩放（UI还原.md §3.1：427×240 基准 × 整数缩放）
|
||||
baseW, baseH float32
|
||||
scale float32
|
||||
}
|
||||
|
||||
// NewHUD 创建 HUD。
|
||||
func NewHUD(sess *game.Session, items *item.Registry, baseW, baseH, scale float32) *HUD {
|
||||
return &HUD{sess: sess, items: items, itemUV: map[string][4]float32{}, baseW: baseW, baseH: baseH, scale: scale}
|
||||
}
|
||||
|
||||
// SetItemAtlas 设置物品图标纹理与 UV 表（items 图集）。
|
||||
func (h *HUD) SetItemAtlas(tex uint32, uv map[string][4]float32) {
|
||||
h.itemTex = tex
|
||||
h.itemUV = uv
|
||||
}
|
||||
|
||||
// Draw 每帧绘制 HUD（调用方已 Begin）。
|
||||
func (h *HUD) Draw(r *Renderer) {
|
||||
w, hgt := float32(r.w), float32(r.h)
|
||||
s := h.scale
|
||||
white := [4]float32{1, 1, 1, 1}
|
||||
|
||||
// 准星（UI还原.md §3.4：屏幕正中 15×15 十字）
|
||||
cx, cy := w/2, hgt/2
|
||||
r.DrawRect(cx-1*s, cy-8*s, 2*s, 16*s, white)
|
||||
r.DrawRect(cx-8*s, cy-1*s, 16*s, 2*s, white)
|
||||
|
||||
// 热键栏（UI还原.md §3.4：182×22，底部居中）
|
||||
barW, barH := 182*s, 22*s
|
||||
bx, by := cx-barW/2, hgt-barH
|
||||
r.DrawRect(bx, by, barW, barH, [4]float32{0, 0, 0, 0.5})
|
||||
for i := 0; i < 9; i++ {
|
||||
sx := bx + float32(i)*20*s + 1*s
|
||||
sy := by + 3*s
|
||||
if i == h.sess.Inv.Selected {
|
||||
r.DrawRect(sx-2*s, sy-2*s, 20*s, 20*s, [4]float32{1, 1, 1, 0.9}) // 选中高亮框
|
||||
}
|
||||
h.drawItemIcon(r, h.sess.Inv.Slots[i], sx, sy)
|
||||
}
|
||||
|
||||
// 生命：10 心（每心 9×9，屏幕左下，UI还原.md §3.4）
|
||||
hearts := int(20 / 2)
|
||||
hp := h.sess.PlayerHealth()
|
||||
hx, hy := w/2-91*s, hgt-30*s
|
||||
for i := 0; i < hearts; i++ {
|
||||
color := [4]float32{0.2, 0.2, 0.2, 0.6} // 空
|
||||
if i < hp/2 {
|
||||
color = [4]float32{1, 0.1, 0.1, 1} // 满
|
||||
}
|
||||
r.DrawRect(hx+float32(i%10)*8*s, hy+float32(i/10)*9*s, 7*s, 7*s, color)
|
||||
}
|
||||
|
||||
// 饥饿：10 鸡腿（右侧偏移）
|
||||
for i := 0; i < 10; i++ {
|
||||
r.DrawRect(w/2-91*s+100*s+float32(i%10)*8*s, hy+float32(i/10)*9*s, 7*s, 7*s, [4]float32{0.6, 0.4, 0.15, 1})
|
||||
}
|
||||
|
||||
// 破坏进度（方块交互与动画.md §4：HUD 中央进度）
|
||||
if prog := h.sess.BreakProgress(); prog > 0 {
|
||||
r.DrawRect(cx-40*s, cy+20*s, 80*s, 4*s, [4]float32{0, 0, 0, 0.7})
|
||||
r.DrawRect(cx-40*s, cy+20*s, 80*s*float32(prog), 4*s, [4]float32{1, 1, 1, 0.9})
|
||||
}
|
||||
|
||||
// 坐标调试（后置移除）
|
||||
r.DrawText(w/2, hgt-40*s, fmt.Sprintf("XYZ %.1f / %.1f / %.1f", h.sess.Player.Pos[0], h.sess.Player.Pos[1], h.sess.Player.Pos[2]), 1*s, white)
|
||||
}
|
||||
|
||||
// drawItemIcon 在槽位绘制物品图标 + 数量。
|
||||
func (h *HUD) drawItemIcon(r *Renderer, stack item.Stack, x, y float32) {
|
||||
s := h.scale
|
||||
if stack.Empty() {
|
||||
return
|
||||
}
|
||||
def, ok := h.items.Get(stack.Name)
|
||||
if !ok {
|
||||
return
|
||||
}
|
||||
if uv, found := h.itemUV[def.Texture]; found && h.itemTex != 0 {
|
||||
r.pushQuad(quad{x: x + 2*s, y: y + 2*s, w: 16 * s, h: 16 * s,
|
||||
u0: uv[0], v0: uv[1], u1: uv[2], v1: uv[3],
|
||||
r: 1, g: 1, b: 1, a: 1, tex: h.itemTex})
|
||||
}
|
||||
if stack.Count > 1 {
|
||||
r.DrawText(x+10*s, y+8*s, fmt.Sprintf("%d", stack.Count), 1*s, [4]float32{1, 1, 1, 1})
|
||||
}
|
||||
}
|
||||
322
internal/ui/ui.go
Normal file
322
internal/ui/ui.go
Normal file
@@ -0,0 +1,322 @@
|
||||
//go:build gl
|
||||
|
||||
// Package ui 2D UI 渲染器：正交投影、四边形批处理、位图字体文本、九宫格（UI还原.md §3）。
|
||||
//
|
||||
// 与 3D 渲染共用 GL 上下文但状态隔离（UI与输入.md §2）：每帧 3D 之后调用，
|
||||
// 内部保存/恢复必要状态。
|
||||
package ui
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"image"
|
||||
"strings"
|
||||
|
||||
"mc/internal/font"
|
||||
"mc/internal/textr"
|
||||
|
||||
"github.com/go-gl/gl/v3.3-core/gl"
|
||||
)
|
||||
|
||||
// quad 一个四边形（屏幕像素坐标，y 轴向下）。
|
||||
type quad struct {
|
||||
x, y, w, h float32
|
||||
u0, v0, u1, v1 float32
|
||||
r, g, b, a float32
|
||||
tex uint32
|
||||
}
|
||||
|
||||
// Renderer UI 渲染器。
|
||||
type Renderer struct {
|
||||
prog uint32
|
||||
vao, vbo uint32
|
||||
texWhite uint32
|
||||
fontTex uint32
|
||||
fontAtlas *font.Atlas
|
||||
texCache map[string]uint32 // 长文本光栅化纹理缓存
|
||||
quads []quad
|
||||
w, h int32
|
||||
scale float32 // 像素缩放（guiScale）
|
||||
}
|
||||
|
||||
// New 创建 UI 渲染器（窗口逻辑分辨率 × 缩放）。
|
||||
func New(winW, winH int, scale float32) (*Renderer, error) {
|
||||
r := &Renderer{w: int32(winW), h: int32(winH), scale: scale, texCache: make(map[string]uint32)}
|
||||
vs, err := compileShader(gl.VERTEX_SHADER, uiVertSrc)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("ui.New 顶点着色器: %w", err)
|
||||
}
|
||||
fs, err := compileShader(gl.FRAGMENT_SHADER, uiFragSrc)
|
||||
if err != nil {
|
||||
return nil, fmt.Errorf("ui.New 片元着色器: %w", err)
|
||||
}
|
||||
prog := gl.CreateProgram()
|
||||
gl.AttachShader(prog, vs)
|
||||
gl.AttachShader(prog, fs)
|
||||
gl.LinkProgram(prog)
|
||||
var ok int32
|
||||
gl.GetProgramiv(prog, gl.LINK_STATUS, &ok)
|
||||
if ok == 0 {
|
||||
return nil, fmt.Errorf("ui.New: 着色器链接失败")
|
||||
}
|
||||
gl.DeleteShader(vs)
|
||||
gl.DeleteShader(fs)
|
||||
r.prog = prog
|
||||
|
||||
gl.GenVertexArrays(1, &r.vao)
|
||||
gl.GenBuffers(1, &r.vbo)
|
||||
// 白色占位纹理
|
||||
gl.GenTextures(1, &r.texWhite)
|
||||
gl.BindTexture(gl.TEXTURE_2D, r.texWhite)
|
||||
gl.TexImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, 1, 1, 0, gl.RGBA, gl.UNSIGNED_BYTE, gl.Ptr([]uint8{255, 255, 255, 255}))
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST)
|
||||
return r, nil
|
||||
}
|
||||
|
||||
// SetFont 设置位图字体（UI还原.md §4：上传字形图集纹理）。
|
||||
func (r *Renderer) SetFont(at *font.Atlas) {
|
||||
r.fontAtlas = at
|
||||
if at.Image == nil {
|
||||
return
|
||||
}
|
||||
if r.fontTex == 0 {
|
||||
gl.GenTextures(1, &r.fontTex)
|
||||
}
|
||||
gl.BindTexture(gl.TEXTURE_2D, r.fontTex)
|
||||
b := at.Image.Bounds()
|
||||
gl.TexImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, int32(b.Dx()), int32(b.Dy()), 0, gl.RGBA, gl.UNSIGNED_BYTE, imageBytesUI(at.Image))
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE)
|
||||
}
|
||||
|
||||
// DrawRect 绘制纯色矩形。
|
||||
func (r *Renderer) DrawRect(x, y, w, h float32, rgba [4]float32) {
|
||||
r.pushQuad(quad{x: x, y: y, w: w, h: h, u0: 0, v0: 0, u1: 1, v1: 1,
|
||||
r: rgba[0], g: rgba[1], b: rgba[2], a: rgba[3], tex: r.texWhite})
|
||||
}
|
||||
|
||||
// DrawText 绘制文本（ASCII 位图字形，含 1px 阴影，UI还原.md §4）。
|
||||
func (r *Renderer) DrawText(x, y float32, s string, scale float32, rgba [4]float32) {
|
||||
if r.fontAtlas == nil {
|
||||
return
|
||||
}
|
||||
s = strings.ReplaceAll(s, "§", "") // MVP：忽略颜色码（后置支持）
|
||||
cx := x
|
||||
for _, ch := range s {
|
||||
g, ok := r.fontAtlas.Glyphs[ch]
|
||||
if !ok {
|
||||
g = r.fontAtlas.Missing()
|
||||
}
|
||||
px := float32(g.X) / float32(r.fontAtlas.Image.Bounds().Dx())
|
||||
py := float32(g.Y) / float32(r.fontAtlas.Image.Bounds().Dy())
|
||||
pw := float32(g.W) / float32(r.fontAtlas.Image.Bounds().Dx())
|
||||
ph := float32(g.H) / float32(r.fontAtlas.Image.Bounds().Dy())
|
||||
gw := float32(g.W) * scale
|
||||
gh := float32(g.H) * scale
|
||||
// 阴影（黑色，偏移 1px）
|
||||
r.pushQuad(quad{x: cx + 1*scale, y: y + 1*scale, w: gw, h: gh, u0: px, v0: py, u1: px + pw, v1: py + ph,
|
||||
r: 0.1, g: 0.1, b: 0.1, a: rgba[3] * 0.8, tex: r.fontTex})
|
||||
r.pushQuad(quad{x: cx, y: y, w: gw, h: gh, u0: px, v0: py, u1: px + pw, v1: py + ph,
|
||||
r: rgba[0], g: rgba[1], b: rgba[2], a: rgba[3], tex: r.fontTex})
|
||||
cx += float32(g.Width) * scale
|
||||
}
|
||||
}
|
||||
|
||||
// TextWidth 文本像素宽度（布局用）。
|
||||
func (r *Renderer) TextWidth(s string, scale float32) float32 {
|
||||
if r.fontAtlas == nil {
|
||||
return float32(len(s)) * 8 * scale
|
||||
}
|
||||
return float32(textrWidth(r.fontAtlas, s)) * scale
|
||||
}
|
||||
|
||||
// textrWidth 计算文本宽度（复用 textr 逻辑的轻量版）。
|
||||
func textrWidth(at *font.Atlas, s string) int {
|
||||
w := 0
|
||||
for _, ch := range s {
|
||||
if g, ok := at.Glyphs[ch]; ok {
|
||||
w += g.Width
|
||||
} else {
|
||||
w += 8
|
||||
}
|
||||
}
|
||||
return w
|
||||
}
|
||||
|
||||
// DrawTexImage 上传一张图像为纹理并绘制（长文本/图标用），返回纹理 ID 供缓存。
|
||||
func (r *Renderer) DrawTexImage(x, y float32, img image.Image, scale float32) {
|
||||
var tex uint32
|
||||
gl.GenTextures(1, &tex)
|
||||
gl.BindTexture(gl.TEXTURE_2D, tex)
|
||||
b := img.Bounds()
|
||||
gl.TexImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, int32(b.Dx()), int32(b.Dy()), 0, gl.RGBA, gl.UNSIGNED_BYTE, imageBytesUI(img))
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST)
|
||||
r.pushQuad(quad{x: x, y: y, w: float32(b.Dx()) * scale, h: float32(b.Dy()) * scale,
|
||||
u0: 0, v0: 0, u1: 1, v1: 1, r: 1, g: 1, b: 1, a: 1, tex: tex})
|
||||
}
|
||||
|
||||
// UploadImage 上传图像为纹理并返回 ID（物品图标/长文本用）。
|
||||
func (r *Renderer) UploadImage(img image.Image) uint32 {
|
||||
var tex uint32
|
||||
gl.GenTextures(1, &tex)
|
||||
gl.BindTexture(gl.TEXTURE_2D, tex)
|
||||
b := img.Bounds()
|
||||
gl.TexImage2D(gl.TEXTURE_2D, 0, gl.RGBA8, int32(b.Dx()), int32(b.Dy()), 0, gl.RGBA, gl.UNSIGNED_BYTE, imageBytesUI(img))
|
||||
gl.GenerateMipmap(gl.TEXTURE_2D)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST_MIPMAP_LINEAR)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE)
|
||||
gl.TexParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE)
|
||||
return tex
|
||||
}
|
||||
|
||||
// Begin 开始一帧 UI 绘制（清空批次）。
|
||||
func (r *Renderer) Begin() { r.quads = r.quads[:0] }
|
||||
|
||||
// Flush 提交批次（切换投影 → 绘制 → 恢复状态）。
|
||||
func (r *Renderer) Flush() {
|
||||
if len(r.quads) == 0 {
|
||||
return
|
||||
}
|
||||
// 保存 3D 状态
|
||||
gl.Disable(gl.DEPTH_TEST)
|
||||
gl.UseProgram(r.prog)
|
||||
|
||||
// 正交投影（像素坐标，y 向下）
|
||||
var proj [16]float32
|
||||
ortho2D(&proj, 0, float32(r.w), float32(r.h), 0)
|
||||
projLoc := gl.GetUniformLocation(r.prog, gl.Str("uProj\x00"))
|
||||
gl.UniformMatrix4fv(projLoc, 1, false, &proj[0])
|
||||
sampLoc := gl.GetUniformLocation(r.prog, gl.Str("uTex\x00"))
|
||||
gl.Uniform1i(sampLoc, 0)
|
||||
|
||||
// 批处理：合并为顶点数组（每 quad 6 顶点，含纹理 ID 通过多次绘制分组）
|
||||
gl.BindVertexArray(r.vao)
|
||||
gl.BindBuffer(gl.ARRAY_BUFFER, r.vbo)
|
||||
gl.EnableVertexAttribArray(0) // pos
|
||||
gl.EnableVertexAttribArray(1) // uv
|
||||
gl.EnableVertexAttribArray(2) // color
|
||||
stride := int32(9 * 4)
|
||||
|
||||
currentTex := uint32(0xFFFFFFFF)
|
||||
flushBatch := func(tex uint32, verts []float32) {
|
||||
if len(verts) == 0 {
|
||||
return
|
||||
}
|
||||
gl.ActiveTexture(gl.TEXTURE0)
|
||||
gl.BindTexture(gl.TEXTURE_2D, tex)
|
||||
gl.BufferData(gl.ARRAY_BUFFER, len(verts)*4, gl.Ptr(verts), gl.STREAM_DRAW)
|
||||
gl.VertexAttribPointer(0, 2, gl.FLOAT, false, stride, gl.PtrOffset(0))
|
||||
gl.VertexAttribPointer(1, 2, gl.FLOAT, false, stride, gl.PtrOffset(2*4))
|
||||
gl.VertexAttribPointer(2, 4, gl.FLOAT, false, stride, gl.PtrOffset(4*4))
|
||||
gl.DrawArrays(gl.TRIANGLES, 0, int32(len(verts)/9))
|
||||
}
|
||||
var batch []float32
|
||||
for _, q := range r.quads {
|
||||
if q.tex != currentTex {
|
||||
flushBatch(currentTex, batch)
|
||||
batch = batch[:0]
|
||||
currentTex = q.tex
|
||||
}
|
||||
batch = append(batch, quadVertices(q)...)
|
||||
}
|
||||
flushBatch(currentTex, batch)
|
||||
|
||||
gl.BindVertexArray(0)
|
||||
gl.Enable(gl.DEPTH_TEST)
|
||||
r.quads = r.quads[:0]
|
||||
}
|
||||
|
||||
// pushQuad 入批。
|
||||
func (r *Renderer) pushQuad(q quad) { r.quads = append(r.quads, q) }
|
||||
|
||||
// quadVertices 四边形 → 6 顶点（2 三角形）。
|
||||
func quadVertices(q quad) []float32 {
|
||||
x0, y0 := q.x, q.y
|
||||
x1, y1 := q.x+q.w, q.y+q.h
|
||||
return []float32{
|
||||
x0, y0, q.u0, q.v0, q.r, q.g, q.b, q.a, 0,
|
||||
x1, y0, q.u1, q.v0, q.r, q.g, q.b, q.a, 0,
|
||||
x1, y1, q.u1, q.v1, q.r, q.g, q.b, q.a, 0,
|
||||
x0, y0, q.u0, q.v0, q.r, q.g, q.b, q.a, 0,
|
||||
x1, y1, q.u1, q.v1, q.r, q.g, q.b, q.a, 0,
|
||||
x0, y1, q.u0, q.v1, q.r, q.g, q.b, q.a, 0,
|
||||
}
|
||||
}
|
||||
|
||||
// ortho2D 正交投影矩阵（列主序，近 -1 远 1）。
|
||||
func ortho2D(m *[16]float32, l, r, b, t float32) {
|
||||
*m = [16]float32{}
|
||||
m[0] = 2 / (r - l)
|
||||
m[5] = 2 / (t - b)
|
||||
m[10] = -1
|
||||
m[12] = -(r + l) / (r - l)
|
||||
m[13] = -(t + b) / (t - b)
|
||||
m[15] = 1
|
||||
}
|
||||
|
||||
// imageBytesUI image.Image → RGBA 字节流。
|
||||
func imageBytesUI(img image.Image) []byte {
|
||||
b := img.Bounds()
|
||||
out := make([]byte, 0, b.Dx()*b.Dy()*4)
|
||||
for y := b.Min.Y; y < b.Max.Y; y++ {
|
||||
for x := b.Min.X; x < b.Max.X; x++ {
|
||||
cr, cg, cb, ca := img.At(x, y).RGBA()
|
||||
out = append(out, byte(cr>>8), byte(cg>>8), byte(cb>>8), byte(ca>>8))
|
||||
}
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
// uiVertSrc UI 顶点着色器。
|
||||
const uiVertSrc = `
|
||||
#version 330 core
|
||||
layout(location = 0) in vec2 aPos;
|
||||
layout(location = 1) in vec2 aUV;
|
||||
layout(location = 2) in vec4 aColor;
|
||||
uniform mat4 uProj;
|
||||
out vec2 vUV;
|
||||
out vec4 vColor;
|
||||
void main() {
|
||||
gl_Position = uProj * vec4(aPos, 0.0, 1.0);
|
||||
vUV = aUV;
|
||||
vColor = aColor;
|
||||
}
|
||||
`
|
||||
|
||||
// uiFragSrc UI 片元着色器（纹理 × 颜色，alpha 混合）。
|
||||
const uiFragSrc = `
|
||||
#version 330 core
|
||||
in vec2 vUV;
|
||||
in vec4 vColor;
|
||||
uniform sampler2D uTex;
|
||||
out vec4 fragColor;
|
||||
void main() {
|
||||
vec4 t = texture(uTex, vUV);
|
||||
fragColor = vec4(vColor.rgb, vColor.a) * vec4(1.0, 1.0, 1.0, t.a);
|
||||
}
|
||||
`
|
||||
|
||||
// 编译着色器（与 render 包一致的简化版）。
|
||||
func compileShader(kind uint32, src string) (uint32, error) {
|
||||
s := gl.CreateShader(kind)
|
||||
cs, free := gl.Strs(src + "\x00")
|
||||
gl.ShaderSource(s, 1, cs, nil)
|
||||
free()
|
||||
gl.CompileShader(s)
|
||||
var ok int32
|
||||
gl.GetShaderiv(s, gl.COMPILE_STATUS, &ok)
|
||||
if ok == 0 {
|
||||
var logLen int32
|
||||
gl.GetShaderiv(s, gl.INFO_LOG_LENGTH, &logLen)
|
||||
log := strings.Repeat(" ", int(logLen))
|
||||
gl.GetShaderInfoLog(s, logLen, nil, gl.Str(log))
|
||||
return 0, fmt.Errorf("着色器编译失败: %s", log)
|
||||
}
|
||||
return s, nil
|
||||
}
|
||||
|
||||
var _ = textr.New // 保持引用（长文本光栅化路径后置启用）
|
||||
Reference in New Issue
Block a user