- 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>
114 lines
4.2 KiB
GDScript
114 lines
4.2 KiB
GDScript
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)
|