godot 4.0 tool_button

ToolbuttonPlugin pour Godot 4.0 - V1.4

Boutons de l'éditeur avec Une ligne de code: @tool zéro lignes de code.

Installez simplement et sélectionnez n'importe quel nœud:

• Les méthodes publiques seront répertoriées au bas du panneau Editor.
• Les signaux avec 0 arguments seront également affichés.

Pour des fonctionnalités plus avancées, lisez ci-dessous.

Commencer

• Activer le plugin.
• Ajoutez @tool au sommet de votre script.
• Ajoutez un _get_tool_buttons() -> Array .
• Les articles du tableau peuvent être:
  • Noms des méthodes "my_method"
  • Méthode elle-même my_method
  • Méthode liée method.bind(true, "ok" 1.0)
  • Méthodes anonymes func(): print("Hey!")
  • Méthodes anonymes avec nom func press_me(): print("You pressed me!")
  • Noms des signaux "my_signal"
  • Signal lui-même my_signal
  • Array avec signal et arguments ["my_signal", [true, "ok"]]
  • Dictionarys avec contrôle fin de réglage: {call=method.bind(true), text="My Method", tint=Color.RED}
  • Arrays avec l'un des éléments ci-dessus ["my_method", method2.bind(1.0), "a_signal", {text="X", call=reset}]

Exemple avancé

Pour spécifier des boutons qui affichent au-dessus de l'inspecteur, ajoutez un func _get_tool_buttons .

Avec Strings :

@tool
extends Node

func _get_tool_buttons() :
	return [ boost_score, remove_player ]

func boost_score() :
	Player.score += 100

func remove_player() :
	Player.queue_free()

et / ou Callable S

 # WARNING, some stuff won't work: If you get *"Cannot access member without instance"*: https://github.com/godotengine/godot/issues/56780
@tool
extends Node

func _get_tool_buttons() :
	return [
		func add_score() : score += 10 ,
		func reset_health() : health = 0
	]

et / ou Dictionarys

@tool
extends Node

signal reset()

func _get_tool_buttons() : return [
	" boost_score " ,
	{ call = " boost_score " , args = [ 100 ] , tint = Color.DEEP_SKY_BLUE } ,
	{ call = " emit_signal " , args = [ " reset " ] , text = " Reset " , tint = Color.TOMATO } ,
	{
		call = func() : print( " My Health: " , health),
		text = " Print Health " ,
		tint = func() : return Color(health * . 1 , 0.0 , 0.0 )
		lock = func() : return health == 100
	}
]

func boost_score(x = 10 ) :
	Player.score += x

call est obligatoire. Les autres sont facultatifs.

clé	dessiner	défaut
appel	Méthode à appeler.	-
args	Tableau d'arguments à passer. (Bouton de souris sur les args.)	-
texte	Étiquette de bouton.	-
teinte	Couleur du bouton.	Couleur blanc
icône	Icône de bouton.	-
plat	Le bouton est un style plat.	FAUX
indice	Astuce Texte pour la souris.	-
imprimer	Imprimer la sortie de l'appel de la méthode?	vrai
aligner	Alignement du bouton.	BoxContainer.Alignment_Center
verrouillage	Bouton de désactivation?	FAUX
update_filesystem	Dit à Godot Editor de sauver le système de fichiers.	FAUX

Exemple de ressource

Pour que _get_tool_buttons travaille sur une Resource il doit être statique.

@tool
extends Resource
class_name MyResource

# STATIC
static func _get_tool_buttons() :
	return [ " my_button " ]

# LOCAL
export(String) var my_name : String = " "

func my_button() :
	print(my_name)

Signaux

signal my_signal()
signal my_arg_signal(x, y)

func _get_tool_buttons() :
	return [
		my_signal,
		[ my_arg_signal, [ true , " okay " ]]
	] 

Prise en charge des bouton multiples

Vous pouvez avoir plusieurs boutons sur la même ligne.
Ils peuvent tous être appelés immédiatement (par défaut), ou séparés, sur la base d'une bascule.

 func _get_tool_buttons():
	return [
		[msg, msg.bind("yes"), msg.bind("no")],
	]

func msg(msg := "Default Message"):
	print("Got: ", msg)

func doit():
	pass

Changements

1.4

• Ajout de la prise en charge du signal.
• Ajout de la prise en charge de plusieurs boutons dans la même ligne.
• Ajout de boutons générés automatiquement pour tester les méthodes publiques.
• Ajout de boutons générés automatiquement pour tester les signaux sans argument.
• Boutons de méthode de teinte automatique bleu et boutons de signal jaune.
• Beaucoup de petites solutions.

1.3

• Ajout @SELECT_AND_EDIT::file_path , @EDIT_RESOURCE::file_path , @SELECT_FILE::file_path .

1.2

• Ajout du bouton «Imprimer Meta», qui imprimera toutes les méta-données dans un objet.

1.1

• Mis à jour pour Godot 4.0.alpha2
• Ajout lock tint text icon d' call Callable : { text="Callable", call=func(): print("From Callable with love") }
• Changé disabled pour lock
• Les boutons inférieurs sont triés par ordre alphabétique.