Files
godot-docs-l10n/classes/uk/class_editorresourceconversionplugin.rst

109 lines
6.5 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_EditorResourceConversionPlugin:
EditorResourceConversionPlugin
==============================
**Успадковує:** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
Плагін для додавання користувацьких перетворювачів з одного ресурсного формату в інший в контекстному меню редактора; наприклад, перетворення :ref:`StandardMaterial3D<class_StandardMaterial3D>` в :ref:`ShaderMaterial<class_ShaderMaterial>`.
.. rst-class:: classref-introduction-group
Опис
--------
**EditorResourceConversionPlugin** викликається, коли для ресурсу відкривається контекстне меню в інспекторі редактора. Відповідні плагіни перетворення відображатимуться як параметри меню для перетворення даного ресурсу на цільовий тип.
Нижче показано приклад базового плагіна, який перетворює :ref:`ImageTexture<class_ImageTexture>` на :ref:`PortableCompressedTexture2D<class_PortableCompressedTexture2D>`.
.. tabs::
.. code-tab:: gdscript
розширює EditorResourceConversionPlugin
func _handles(ресурс: ресурс):
return resourceImageTexture
func _converts_to():
return "PortableCompressedTexture2D"
func _convert(itex: ресурс):
var ptex = PortableCompressedTexture2D.new()
ptex.create_from_image(itex.get_image(), PortableCompressedTexture2D.COMPRESSION_MODE_LOSSLESS)
return ptex
Щоб використовувати **EditorResourceConversionPlugin**, спочатку зареєструйте його за допомогою методу :ref:`EditorPlugin.add_resource_conversion_plugin()<class_EditorPlugin_method_add_resource_conversion_plugin>`.
.. rst-class:: classref-reftable-group
Методи
------------
.. table::
:widths: auto
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Resource<class_Resource>` | :ref:`_convert<class_EditorResourceConversionPlugin_private_method__convert>`\ (\ resource\: :ref:`Resource<class_Resource>`\ ) |virtual| |const| |
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`_converts_to<class_EditorResourceConversionPlugin_private_method__converts_to>`\ (\ ) |virtual| |const| |
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`_handles<class_EditorResourceConversionPlugin_private_method__handles>`\ (\ resource\: :ref:`Resource<class_Resource>`\ ) |virtual| |const| |
+---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описи методів
--------------------------
.. _class_EditorResourceConversionPlugin_private_method__convert:
.. rst-class:: classref-method
:ref:`Resource<class_Resource>` **_convert**\ (\ resource\: :ref:`Resource<class_Resource>`\ ) |virtual| |const| :ref:`🔗<class_EditorResourceConversionPlugin_private_method__convert>`
Приймає вхідний :ref:`Resource<class_Resource>` та перетворює його на тип, заданий у :ref:`_converts_to()<class_EditorResourceConversionPlugin_private_method__converts_to>`. Повернений :ref:`Resource<class_Resource>` є результатом перетворення, а вхідний :ref:`Resource<class_Resource>` залишається незмінним..
.. rst-class:: classref-item-separator
----
.. _class_EditorResourceConversionPlugin_private_method__converts_to:
.. rst-class:: classref-method
:ref:`String<class_String>` **_converts_to**\ (\ ) |virtual| |const| :ref:`🔗<class_EditorResourceConversionPlugin_private_method__converts_to>`
Повертає назву класу цільового типу :ref:`Resource<class_Resource>`, що цей плагін перетворює вихідні ресурси.
.. rst-class:: classref-item-separator
----
.. _class_EditorResourceConversionPlugin_private_method__handles:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **_handles**\ (\ resource\: :ref:`Resource<class_Resource>`\ ) |virtual| |const| :ref:`🔗<class_EditorResourceConversionPlugin_private_method__handles>`
Визначте, чи може бути перетворений на цільовий тип ресурсу.
.. |virtual| replace:: :abbr:`virtual (Зазвичай, цей метод перевизначається користувачем, щоб він мав вплив.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Цей метод не має побічних ефектів. Не змінює ніяку змінну екземпляра об'єкта.)`
.. |vararg| replace:: :abbr:`vararg (Цей метод приймає будь-яке число аргументів після описаних тут.)`
.. |constructor| replace:: :abbr:`constructor (Цей метод використовується для побудови типів.)`
.. |static| replace:: :abbr:`static (Цей метод не потребує екземпляра для виклику, його можна викликати безпосередньо за допомогою назви класу.)`
.. |operator| replace:: :abbr:`operator (Цей метод описує дійсний оператор для взаємодії з цим типом як з лівим операндом.)`
.. |bitfield| replace:: :abbr:`BitField (Це значення є цілим числом, складеним у вигляді бітової маски з наступних прапорів.)`
.. |void| replace:: :abbr:`void (Значення не повертається.)`