godot 4.0 tool_button

Toolbuttonplugin для Godot 4.0 - v1.4

Кнопки редактора с одна строка кода: @tool нулевые строки кода.

Просто установите и выберите любой узел:

• Публичные методы будут перечислены в нижней части панели редактора.
• Также будут показаны сигналы с 0 аргументами.

Для более продвинутых функций прочитайте ниже.

Начиная

• Включить плагин.
• Добавьте @tool в верхнюю часть своего сценария.
• Добавьте _get_tool_buttons() -> Array .
• Предметы массива могут быть:
  • Названия методов "my_method"
  • Сам метод my_method
  • Метод связанного метода method.bind(true, "ok" 1.0)
  • Анонимные методы func(): print("Hey!")
  • Анонимные методы с именем func press_me(): print("You pressed me!")
  • Имена сигналов "my_signal"
  • Сам сигнал my_signal
  • Массив с сигналом и аргументами ["my_signal", [true, "ok"]]
  • Словары с тонким настроенным элементом управления: {call=method.bind(true), text="My Method", tint=Color.RED}
  • Массивы с любым из вышеперечисленных ["my_method", method2.bind(1.0), "a_signal", {text="X", call=reset}]

Расширенный пример

Чтобы указать кнопки, которые показывают над инспектором, добавьте фонд _get_tool_buttons .

С 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()

и/или 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
	]

и/или 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 обязательен. Другие не являются обязательными.

ключ	посягательство	по умолчанию
вызов	Метод для вызова.	-
Аргс	Множество аргументов для прохождения. (Кнопка мыши над, чтобы увидеть Args.)	-
текст	Кнопка метки.	-
оттенка	Кнопкий цвет.	Color.white
икона	Значок кнопки.	-
плоский	Кнопка - это плоский стиль.	ЛОЖЬ
намекать	Подсказка для мыши.	-
печать	Печать вывод метода вызова?	истинный
выровнять	Выравнивание кнопок.	BoxContainer.alenment_Center
замок	Отключить кнопку?	ЛОЖЬ
update_filesystem	Говорит Godot Editor, чтобы он изменил файловую систему.	ЛОЖЬ

Пример ресурса

Для _get_tool_buttons работать над Resource , он должен быть статичным.

@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)

Сигналы

signal my_signal()
signal my_arg_signal(x, y)

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

Многотоковая поддержка

Вы можете иметь несколько кнопок на одной линии.
Все они могут быть вызваны сразу (по умолчанию) или отдельно, на основе переключения.

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

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

func doit():
	pass

Изменения

1.4

• Добавлена поддержка сигнала.
• Добавлена поддержка нескольких кнопок в одном и том же ряду.
• Добавлены автоматически сгенерированные кнопки для тестирования публичных методов.
• Добавлены автоматически сгенерированные кнопки для тестирования сигналов без аргументов.
• Автоматические методы метода кнопки синие и сигнальные кнопки желтые.
• Лоты маленьких исправлений.

1.3

• Добавлено @SELECT_AND_EDIT::file_path , @EDIT_RESOURCE::file_path , @SELECT_FILE::file_path .

1.2

• Добавлена кнопка «Печать мета», которая будет распечатать все метаданные в объекте.

1.1

• Обновлено для Godot 4.0.alpha2
• Добавлено Callable Support call text icon tint lock { text="Callable", call=func(): print("From Callable with love") }
• Изменен disabled , чтобы lock
• Нижние кнопки алфавитно отсортированы.