CR: Sprechblasen-Texte zusaetzlich als Untertitel am unteren Rand

- speech_bubble.gd spiegelt jede Zeile ausserhalb spielergefuehrter
  Dialoge in eine gemeinsame Untertitel-Leiste (Sprechername aus dem
  NameLabel des Traegers vorangestellt); gilt automatisch fuer
  Ambient-Gespraeche, Dreschen-/Epilog-Erzaehltexte und
  Stations-Meldungen
- Spieler-Dialoge werden nicht gespiegelt (stehen in der Chatbox);
  Leiste blendet nach der Zeilendauer aus und ueberlebt Szenenwechsel
- Headless verifiziert (Ambient gespiegelt mit Namen, Dialog nicht)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-07 06:23:05 +02:00
parent d7f510eaf9
commit 8d9ad3156b
2 changed files with 86 additions and 3 deletions

View file

@ -1,11 +1,19 @@
class_name SpeechBubble
extends Node3D
## Wiederverwendbare Sprechblase über dem Kopf eines Sprechers (Phase 2a).
## Wiederverwendbare Sprechblase über dem Kopf eines Sprechers (Phase 2a,
## Untertitel-Spiegelung per Change Request).
##
## Billboard-Label3D, das an jedem Node mit Kopf-Ankerpunkt hängen kann —
## NPCs wie Spieler nutzen dieselbe Szene (scenes/ui/speech_bubble.tscn,
## als Kind "SpeechBubble" des Sprechers). Die Anzeigedauer richtet sich
## nach der Textlänge; im Sticky-Modus bleibt die Zeile stehen, bis
## hide_bubble() aufgerufen wird (für Knoten mit offener Antwortauswahl).
## hide_bubble() aufgerufen wird. Jede Zeile außerhalb eines
## spielergeführten Dialogs wird zusätzlich in einer gemeinsamen
## Untertitel-Leiste am unteren Bildschirmrand gespiegelt (mit
## Sprechername aus dem NameLabel des Trägers, sofern vorhanden) —
## spielergeführte Dialoge stehen bereits in der Dialog-Box und werden
## nicht doppelt angezeigt. Die Leiste lebt einmalig unter root und
## überlebt Szenenwechsel.
signal line_finished
@ -14,12 +22,23 @@ const SECONDS_PER_CHAR := 0.055
const MIN_DURATION := 2.0
const MAX_DURATION := 7.0
static var _caption_layer: CanvasLayer
static var _caption_label: Label
static var _caption_timer: Timer
static var _caption_source: Node
var _remaining := 0.0
var _is_sticky := false
@onready var _label: Label3D = $Label3D
## Blendet die Untertitel-Leiste nach Ablauf ihrer Anzeigedauer aus.
static func _on_caption_timeout() -> void:
if _caption_layer != null and is_instance_valid(_caption_layer):
_caption_layer.visible = false
## Blendet die Zeile ein. Bei is_sticky bleibt sie bis hide_bubble()
## stehen, sonst blendet sie nach textlängenabhängiger Dauer aus und
## meldet line_finished.
@ -28,12 +47,17 @@ func show_line(text: String, is_sticky := false) -> void:
_is_sticky = is_sticky
_remaining = clampf(BASE_DURATION + text.length() * SECONDS_PER_CHAR, MIN_DURATION, MAX_DURATION)
visible = true
if not is_sticky and not DialogueSystem.is_dialogue_active:
_show_caption(text, _remaining)
## Blendet die Sprechblase sofort aus, ohne line_finished zu melden.
## Blendet die Sprechblase sofort aus, ohne line_finished zu melden;
## eine von dieser Blase stammende Untertitel-Zeile verschwindet mit.
func hide_bubble() -> void:
visible = false
_label.text = ""
if _caption_source == self and _caption_layer != null and is_instance_valid(_caption_layer):
_caption_layer.visible = false
## Zählt die Anzeigedauer herunter und meldet das Zeilenende.
@ -44,3 +68,47 @@ func _process(delta: float) -> void:
if _remaining <= 0.0:
hide_bubble()
line_finished.emit()
## Spiegelt die Zeile in die gemeinsame Untertitel-Leiste, mit
## Sprechername aus dem NameLabel des Trägers, sofern vorhanden.
func _show_caption(text: String, duration: float) -> void:
_ensure_caption()
var prefix := ""
var name_label := get_parent().get_node_or_null("NameLabel") as Label3D
if name_label != null and not name_label.text.is_empty():
prefix = "%s: " % name_label.text
_caption_label.text = prefix + text
_caption_layer.visible = true
_caption_source = self
_caption_timer.stop()
_caption_timer.wait_time = maxf(duration, 0.5)
_caption_timer.start()
## Baut die Untertitel-Leiste beim ersten Bedarf einmalig unter root.
func _ensure_caption() -> void:
if _caption_layer != null and is_instance_valid(_caption_layer):
return
_caption_layer = CanvasLayer.new()
_caption_layer.layer = 5
_caption_label = Label.new()
_caption_label.set_anchors_preset(Control.PRESET_BOTTOM_WIDE)
_caption_label.offset_top = -96.0
_caption_label.offset_bottom = -44.0
_caption_label.offset_left = 80.0
_caption_label.offset_right = -80.0
_caption_label.horizontal_alignment = HORIZONTAL_ALIGNMENT_CENTER
_caption_label.vertical_alignment = VERTICAL_ALIGNMENT_CENTER
_caption_label.autowrap_mode = TextServer.AUTOWRAP_WORD_SMART
_caption_label.add_theme_font_size_override("font_size", 20)
_caption_label.add_theme_color_override("font_color", Color(1, 0.98, 0.9))
_caption_label.add_theme_color_override("font_outline_color", Color.BLACK)
_caption_label.add_theme_constant_override("outline_size", 8)
_caption_layer.add_child(_caption_label)
_caption_timer = Timer.new()
_caption_timer.one_shot = true
_caption_timer.timeout.connect(SpeechBubble._on_caption_timeout)
_caption_layer.add_child(_caption_timer)
_caption_layer.visible = false
get_tree().root.add_child(_caption_layer)