class_name SpeechBubble extends Node3D ## 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. 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 const BASE_DURATION := 1.2 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. func show_line(text: String, is_sticky := false) -> void: _label.text = text _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; ## 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. func _process(delta: float) -> void: if not visible or _is_sticky: return _remaining -= delta 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)