:github_url: hide

.. meta::
	:keywords: background, sky

.. _class_WorldEnvironment:

WorldEnvironment
================

**Наследует:** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`

Свойства среды по умолчанию для всей сцены (эффекты постобработки, настройки освещения и фона).

.. rst-class:: classref-introduction-group

Описание
----------------

Узел **WorldEnvironment** используется для настройки :ref:`Environment<class_Environment>` по умолчанию для сцены.

Параметры, определенные в **WorldEnvironment**, могут быть переопределены узлом :ref:`Environment<class_Environment>`, установленным на текущем :ref:`Camera3D<class_Camera3D>`. Кроме того, в данной сцене одновременно может быть создан только один **WorldEnvironment**.

\ **WorldEnvironment** позволяет пользователю указывать параметры освещения по умолчанию (например, окружающее освещение), различные эффекты постобработки (например, SSAO, DOF, Tonemapping) и способ рисования фона (например, сплошной цвет, skybox). Обычно они добавляются для улучшения реализма/цветового баланса сцены.

.. rst-class:: classref-introduction-group

Обучающие материалы
--------------------------------------

- :doc:`Окружающая среда и постобработка <../tutorials/3d/environment_and_post_processing>`

- `Демонстрация 3D-испытателей материалов <https://godotengine.org/asset-library/asset/2742>`__

- `Демонстрация шутера от третьего лица (TPS) <https://godotengine.org/asset-library/asset/2710>`__

.. rst-class:: classref-reftable-group

Свойства
----------------

.. table::
   :widths: auto

   +-------------------------------------------------+-----------------------------------------------------------------------------+
   | :ref:`CameraAttributes<class_CameraAttributes>` | :ref:`camera_attributes<class_WorldEnvironment_property_camera_attributes>` |
   +-------------------------------------------------+-----------------------------------------------------------------------------+
   | :ref:`Compositor<class_Compositor>`             | :ref:`compositor<class_WorldEnvironment_property_compositor>`               |
   +-------------------------------------------------+-----------------------------------------------------------------------------+
   | :ref:`Environment<class_Environment>`           | :ref:`environment<class_WorldEnvironment_property_environment>`             |
   +-------------------------------------------------+-----------------------------------------------------------------------------+

.. rst-class:: classref-section-separator

----

.. rst-class:: classref-descriptions-group

Описания свойств
--------------------------------

.. _class_WorldEnvironment_property_camera_attributes:

.. rst-class:: classref-property

:ref:`CameraAttributes<class_CameraAttributes>` **camera_attributes** :ref:`🔗<class_WorldEnvironment_property_camera_attributes>`

.. rst-class:: classref-property-setget

- |void| **set_camera_attributes**\ (\ value\: :ref:`CameraAttributes<class_CameraAttributes>`\ )
- :ref:`CameraAttributes<class_CameraAttributes>` **get_camera_attributes**\ (\ )

Ресурс :ref:`CameraAttributes<class_CameraAttributes>` по умолчанию, который следует использовать, если для :ref:`Camera3D<class_Camera3D>` ничего не установлено.

.. rst-class:: classref-item-separator

----

.. _class_WorldEnvironment_property_compositor:

.. rst-class:: classref-property

:ref:`Compositor<class_Compositor>` **compositor** :ref:`🔗<class_WorldEnvironment_property_compositor>`

.. rst-class:: classref-property-setget

- |void| **set_compositor**\ (\ value\: :ref:`Compositor<class_Compositor>`\ )
- :ref:`Compositor<class_Compositor>` **get_compositor**\ (\ )

Ресурс :ref:`Compositor<class_Compositor>` по умолчанию, который следует использовать, если в :ref:`Camera3D<class_Camera3D>` ничего не установлено.

.. rst-class:: classref-item-separator

----

.. _class_WorldEnvironment_property_environment:

.. rst-class:: classref-property

:ref:`Environment<class_Environment>` **environment** :ref:`🔗<class_WorldEnvironment_property_environment>`

.. rst-class:: classref-property-setget

- |void| **set_environment**\ (\ value\: :ref:`Environment<class_Environment>`\ )
- :ref:`Environment<class_Environment>` **get_environment**\ (\ )

Ресурс :ref:`Environment<class_Environment>`, используемый этим **WorldEnvironment**, определяющий свойства по умолчанию.

.. |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 (Нет возвращаемого значения.)`