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

@ -3,6 +3,21 @@
> Abgearbeitete Change Requests aus CHANGEREQUESTS.md, mit Datum und
> Anmerkung, was geändert wurde.
## 2026-07-07 — Sprechblasen-Texte zusätzlich als Untertitel am unteren Rand
**Request:** „Alle Gespräche alles was über den Köpfen steht muss auch
unten am Bildschirm Rand stehen damit man es lesen kann. Alle bis auf die
die man selber führt mit Auswahl weil die sieht man ja sowieso in der Box."
**Umsetzung:** Die Sprechblasen-Komponente spiegelt jede Zeile zusätzlich
in eine gemeinsame Untertitel-Leiste am unteren Bildschirmrand — mit
vorangestelltem Sprechernamen (aus dem NameLabel des Trägers, z. B.
„Wren: ..."). Das gilt automatisch für Ambient-Gespräche zwischen NPCs,
die Erzähltexte beim Dreschen, den Epilog und die Stations-Meldungen.
Selbst geführte Dialoge werden NICHT gespiegelt (sie stehen bereits in
der Chatbox); die Leiste blendet nach der Anzeigedauer der Zeile aus und
überlebt Szenenwechsel. Headless verifiziert.
## 2026-07-06 — Gespräche bis zur nächsten Auswahl skippen
**Request:** „Eine Möglichkeit Gespräche zu skippen bis zur nächsten

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)