世界空间 UI

使用世界空间 UI 在玩家头顶上方绘制文本，以及任何其他应该感觉像是游戏世界本身一部分的文本。

世界空间 UI 绘制在 2D 世界中，而不是屏幕上。可将其用于名字牌、生命条、标识，以及任何应该感觉锚定在游戏对象上的文本。

世界空间 UI 使用 米 进行尺寸设置。如果你使用屏幕式像素尺寸，UI 会大得惊人。

核心规则

• 始终调用 UI.push_world_draw_context() 和 defer UI.pop_draw_context().

• 矩形尺寸和偏移请使用米。

• 为正确的深度排序推入 Z 值（通常使用 pos.y).

• 使用 子矩形 仅用于百分比填充（如生命条）。

示例

显示玩家等级

draw_player_level :: proc(player: Player) {
    UI.push_world_draw_context();
    defer UI.pop_draw_context();

    pos := player.world_position;
    UI.push_z(pos.y);
    defer UI.pop_z();

    ts := UI.default_text_settings();
    ts.size = 0.30; // 世界空间文本大小
    ts.halign = .CENTER;
    ts.valign = .CENTER;

    text_pos := pos + v2{0, 1.7};
    rect := Rect{text_pos, text_pos}->grow(0.05, 0.4, 0.05, 0.4);
    UI.text(rect, ts, "Lvl %", {player.level});
}

玩家基地标识

draw_base_sign :: proc(sign: Entity, label: string) {
    UI.push_world_draw_context();
    defer UI.pop_draw_context();

    pos := sign.world_position;
    UI.push_z(pos.y);
    defer UI.pop_z();

    ts := UI.default_text_settings();
    ts.size = 0.30;
    ts.halign = .CENTER;
    ts.valign = .CENTER;

    text_pos := pos + v2{0, 2.2};
    rect := Rect{text_pos, text_pos}->grow(0.06, 0.8, 0.06, 0.8);

    // 可选的深色底板，以提高可读性
    UI.quad(rect, core_globals.white_sprite, {0, 0, 0, 0.6});
    UI.text(rect, ts, label);
}

生命条

// 注意：health/max_health 是你自己类中的用户自定义字段，不是内置的 Entity 字段。
draw_world_ui :: proc(entity: My_Entity) {
    UI.push_world_draw_context();
    defer UI.pop_draw_context();

    pos := entity.world_position;
    UI.push_z(pos.y);
    defer UI.pop_z();

    bar_pos := pos + v2{0, 1.5};
    bar_rect := Rect{bar_pos, bar_pos}->grow(0.1, 0.5, 0.1, 0.5);

    UI.quad(bar_rect, core_globals.white_sprite, {0, 0, 0, 0.8});

    health_pct := entity.health / entity.max_health;
    fill_rect := bar_rect->inset(0.02)->subrect(0, 0, health_pct, 1);
    fill_color := lerp(v4{1, 0, 0, 1}, {0, 1, 0, 1}, health_pct);
    UI.quad(fill_rect, core_globals.white_sprite, fill_color);
}

坐标转换

// 将世界位置转换为屏幕位置
screen_pos := world_to_screen(entity.world_position);

// 将屏幕位置转换为世界位置
world_pos := screen_to_world(get_mouse_screen_position());

提示

• 保持世界空间 UI 简洁，并在远距离下保持可读。如果你有可缩放的摄像机，缩小时请确保调整文本大小。

• 使用 fit_aspect(texture->get_aspect()) 如果你在世界空间中绘制图标。

• 如果文本闪烁或重叠，请检查你的 Z 值和间距。