完善客户端功能并同步差距文档

project/name_show.gd

@@ -0,0 +1,77 @@
+# name_show —— §8.4 / §8.6 头顶名字「是否显示」1:1：CPythonSystem::IsAlwaysShowName /
+#   SetAlwaysShowNameFlag + game.py::__IsShowName + CPythonTextTail::ShowAllTextTail 的
+#   3500 距离裁剪 + ShowCharacterTextTail 的资格判定 + UpdateAllTextTail 的 bNameFlag 强显。
+#   （与 name_color.gd / text_tail.gd / chat_tail.gd 同一套纯静态镜像套路。）
+#
+# REF（40250 ClientVS22 source/ 为唯一基线）：
+#   UserInterface/PythonSystem.cpp:5    #define DEFAULT_VALUE_ALWAYS_SHOW_NAME true
+#   UserInterface/PythonSystem.cpp:307  m_Config.bAlwaysShowName = DEFAULT_VALUE_ALWAYS_SHOW_NAME
+#   UserInterface/PythonSystem.cpp:327  IsAlwaysShowName() -> m_Config.bAlwaysShowName
+#   UserInterface/PythonSystem.cpp:334  SetAlwaysShowNameFlag(iFlag) -> bAlwaysShowName = (iFlag == 1)
+#   UserInterface/PythonSystem.cpp:449  config "ALWAYS_VIEW_NAME" -> atoi(value) == 1
+#   UserInterface/PythonSystem.cpp:535  save "ALWAYS_VIEW_NAME %d"（仅当 != 默认值时落盘）
+#   UserInterface/PythonSystemModule.cpp:181/214  systemSetAlwaysShowNameFlag / systemIsAlwaysShowName
+#   root/uigameoption.py:220  __OnClickAlwaysShowNameOnButton -> systemSetting.SetAlwaysShowNameFlag(True) + RefreshAlwaysShowName()
+#   root/game.py:323  onPressKeyDict[app.DIK_LALT] -> ShowName()
+#   root/game.py:406  onClickKeyDict[app.DIK_LALT] -> HideName()
+#   root/game.py:1143 ShowName() -> self.ShowNameFlag = True
+#   root/game.py:1149 __IsShowName() -> if IsAlwaysShowName(): return True; if ShowNameFlag: return True; return False
+#   root/game.py:1533 OnRender：chr.Pick() 命中 -> textTail.ShowCharacterTextTail(idx)
+#   root/game.py:1535 OnRender：targetBoard.GetTargetVID() != 0 -> textTail.ShowCharacterTextTail(vid)
+#   root/game.py:1550 OnRender：if __IsShowName(): textTail.ShowAllTextTail()
+#   UserInterface/PythonTextTail.cpp:416 UpdateDistance：fDistanceFromPlayer = |(ownerX-centerX, -ownerY-centerY)|
+#   UserInterface/PythonTextTail.cpp:422 ShowAllTextTail：m_CharacterTextTailMap 里 fDistanceFromPlayer < 3500.0f 才 ShowCharacterTextTail
+#   UserInterface/PythonTextTail.cpp:440 ShowCharacterTextTail：不在图 / 已入列 / !pOwner->isShow() / 无实例 / IsGuildWall() -> return；CanPickInstance() 才入列
+#   UserInterface/PythonTextTail.cpp:74  UpdateAllTextTail：chat 尾标 bNameFlag -> ShowCharacterTextTail（不受 3500 限制）
+#
+# seam ⑩：参考端「名字显示」是每帧重建 m_CharacterTextTailList（Pick / target / ShowAll）
+#   再 Render / Arrange（防重叠）/ Hide 的屏幕空间流程；本移植是 net_world 里每个实体一块
+#   billboard Label3D，靠本模块谓词逐帧 set .visible。鼠标悬停 chr.Pick() 未接（net_world
+#   无悬停拾取）、屏幕空间 ArrangeTextTail 防重叠未做 —— 记为 seam ⑩。
+#   另：参考 UpdateDistance 因 owner 在渲染帧（Y 取反）、center 在像素帧才写成
+#   (ownerX-centerX, -ownerY-centerY)；本移植所有坐标统一在 pos_cm 帧，等价于同帧平面距。
+extends RefCounted
+
+const ALWAYS_SHOW_NAME_DEFAULT := true      # DEFAULT_VALUE_ALWAYS_SHOW_NAME
+const SHOW_ALL_DISTANCE := 3500.0           # ShowAllTextTail 的 fDistanceFromPlayer < 3500（px==cm）
+const CFG_KEY := "ALWAYS_VIEW_NAME"         # PythonSystem 配置行 / 存盘键
+
+# SetAlwaysShowNameFlag(int iFlag): m_Config.bAlwaysShowName = iFlag == 1
+static func always_show_from_flag(flag: int) -> bool:
+	return flag == 1
+
+# config "ALWAYS_VIEW_NAME" 行：atoi(value) == 1
+static func always_show_from_cfg(value: Variant) -> bool:
+	return int(value) == 1
+
+# __IsShowName() = IsAlwaysShowName() or ShowNameFlag（LALT 按住）
+static func is_show_name(always_show_name: bool, alt_held: bool) -> bool:
+	return always_show_name or alt_held
+
+# ShowAllTextTail：只有平面距离 < 3500 的角色尾标才 ShowCharacterTextTail
+static func within_show_all(dist_cm: float) -> bool:
+	return dist_cm < SHOW_ALL_DISTANCE
+
+# UpdateDistance 的平面距。net_world 的 pos_cm 已是统一帧，直接同帧平面距
+#   （参考端的 -ownerY 是渲染帧 / 像素帧混用的产物，见文件头 seam ⑩ 注）。
+static func planar_distance_cm(a_cm: Vector2, b_cm: Vector2) -> float:
+	return a_cm.distance_to(b_cm)
+
+# ShowCharacterTextTail 的资格判定（把早退条件取反）：
+#   pOwner->isShow()（可见 / 未死透）、!IsGuildWall()、CanPickInstance()
+static func eligible_character(is_shown: bool, is_guild_wall: bool, can_pick: bool) -> bool:
+	return is_shown and not is_guild_wall and can_pick
+
+# 综合：某实体这一帧的头顶名字是否显示。
+#   forced —— chr.Pick() 命中 / targetBoard VID / chat 尾标 bNameFlag：都走 ShowCharacterTextTail，
+#             但绕过 ShowAllTextTail 的 3500 裁剪（资格判定仍要过）。
+#   非 forced —— 需 __IsShowName() 为真 且 距离 < 3500 且 资格通过。
+static func name_visible_for(forced: bool, show_name: bool, dist_cm: float,
+		is_shown: bool, is_guild_wall: bool, can_pick: bool) -> bool:
+	if not eligible_character(is_shown, is_guild_wall, can_pick):
+		return false
+	if forced:
+		return true
+	if not show_name:
+		return false
+	return within_show_all(dist_cm)