Segnali con argomenti

Un segnale può trasportare valori. Elencali nella dichiarazione, come i parametri di una funzione:

signal damaged(amount: int, hp_left: int)
signal died

Passa i valori a emit() nello stesso ordine:

func take_damage(amount: int) -> void:
	hp = maxi(hp - amount, 0)
	damaged.emit(amount, hp)
	if hp == 0:
		died.emit()

Una funzione connessa riceve i valori come parametri, quindi ha bisogno di un parametro per ogni valore:

hero.damaged.connect(_on_hero_damaged)

func _on_hero_damaged(amount: int, hp_left: int) -> void:
	print("-%d HP, %d left" % [amount, hp_left])

I tipi nella dichiarazione documentano i valori: GDScript non li controlla quando emetti. Una mancata corrispondenza si manifesta nella funzione ricevente. Una funzione con un numero errato di parametri, o un parametro tipizzato che non può contenere il valore, genera un errore alla riga emit(), e quella funzione non viene eseguita.

bind() aggiunge i tuoi valori dopo quelli emessi. Un metodo può quindi ascoltare diversi eroi e sapere comunque quale è stato colpito:

ada.damaged.connect(_on_damaged.bind("Ada"))
bo.damaged.connect(_on_damaged.bind("Bo"))

func _on_damaged(amount: int, hp_left: int, who: String) -> void:
	print(who, " lost ", amount, " HP")

Gli argomenti forniscono a un listener i dati di cui ha bisogno, così non deve leggerli dall'emettitore. Non collegare mai una lambda che usa l'oggetto emittente stesso, come hero.died.connect(func(): print(hero.hp)): la lambda mantiene in vita hero, hero mantiene la lambda, nessuno dei due viene mai liberato e Godot segnala istanze non liberate quando il programma termina.