Files
godot-docs-l10n/classes/ru/class_gdextension.rst

129 lines
6.8 KiB
ReStructuredText
Raw Permalink 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_GDExtension:
GDExtension
===========
**Наследует:** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
Собственная библиотека для GDExtension.
.. rst-class:: classref-introduction-group
Описание
----------------
Тип ресурса **GDExtension** представляет собой `общую библиотеку <https://en.wikipedia.org/wiki/Shared_library>`__, которая может расширить функциональность движка. Синглтон :ref:`GDExtensionManager<class_GDExtensionManager>` отвечает за загрузку, перезагрузку и выгрузку ресурсов **GDExtension**.
\ **Примечание:** Сам GDExtension не является языком сценариев и не имеет отношения к ресурсам :ref:`GDScript<class_GDScript>`.
.. rst-class:: classref-introduction-group
Обучающие материалы
--------------------------------------
- :doc:`Обзор расширения GDExtension <../tutorials/scripting/gdextension/what_is_gdextension>`
- :doc:`Пример GDExtension на C++ <../tutorials/scripting/cpp/gdextension_cpp_example>`
.. rst-class:: classref-reftable-group
Методы
------------
.. table::
:widths: auto
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
| :ref:`InitializationLevel<enum_GDExtension_InitializationLevel>` | :ref:`get_minimum_library_initialization_level<class_GDExtension_method_get_minimum_library_initialization_level>`\ (\ ) |const| |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_library_open<class_GDExtension_method_is_library_open>`\ (\ ) |const| |
+------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Перечисления
------------------------
.. _enum_GDExtension_InitializationLevel:
.. rst-class:: classref-enumeration
enum **InitializationLevel**: :ref:`🔗<enum_GDExtension_InitializationLevel>`
.. _class_GDExtension_constant_INITIALIZATION_LEVEL_CORE:
.. rst-class:: classref-enumeration-constant
:ref:`InitializationLevel<enum_GDExtension_InitializationLevel>` **INITIALIZATION_LEVEL_CORE** = ``0``
Библиотека инициализируется одновременно с основными функциями движка.
.. _class_GDExtension_constant_INITIALIZATION_LEVEL_SERVERS:
.. rst-class:: classref-enumeration-constant
:ref:`InitializationLevel<enum_GDExtension_InitializationLevel>` **INITIALIZATION_LEVEL_SERVERS** = ``1``
Библиотека инициализируется одновременно с серверами движка (например, :ref:`RenderingServer<class_RenderingServer>` или :ref:`PhysicsServer3D<class_PhysicsServer3D>`).
.. _class_GDExtension_constant_INITIALIZATION_LEVEL_SCENE:
.. rst-class:: classref-enumeration-constant
:ref:`InitializationLevel<enum_GDExtension_InitializationLevel>` **INITIALIZATION_LEVEL_SCENE** = ``2``
Библиотека инициализируется одновременно с классами движка, связанными со сценой.
.. _class_GDExtension_constant_INITIALIZATION_LEVEL_EDITOR:
.. rst-class:: classref-enumeration-constant
:ref:`InitializationLevel<enum_GDExtension_InitializationLevel>` **INITIALIZATION_LEVEL_EDITOR** = ``3``
Библиотека инициализируется одновременно с классами редактора движка. Происходит только при загрузке GDExtension в редакторе.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описания метода
------------------------------
.. _class_GDExtension_method_get_minimum_library_initialization_level:
.. rst-class:: classref-method
:ref:`InitializationLevel<enum_GDExtension_InitializationLevel>` **get_minimum_library_initialization_level**\ (\ ) |const| :ref:`🔗<class_GDExtension_method_get_minimum_library_initialization_level>`
Возвращает минимальный уровень, необходимый для правильной инициализации этого расширения (см. перечисление :ref:`InitializationLevel<enum_GDExtension_InitializationLevel>`).
.. rst-class:: classref-item-separator
----
.. _class_GDExtension_method_is_library_open:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_library_open**\ (\ ) |const| :ref:`🔗<class_GDExtension_method_is_library_open>`
Возвращает ``true``, если библиотека этого расширения была открыта.
.. |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 (Нет возвращаемого значения.)`