mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
115 lines
8.8 KiB
ReStructuredText
115 lines
8.8 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_FogVolume:
|
||
|
||
FogVolume
|
||
=========
|
||
|
||
**Наследует:** :ref:`VisualInstance3D<class_VisualInstance3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
|
||
|
||
Регион, который вносит свой вклад в объемный туман по умолчанию из мировой среды.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
**FogVolume** используются для добавления локализованного тумана в глобальный эффект объемного тумана. **FogVolume** также могут удалять объемный туман из определенных областей, если использовать :ref:`FogMaterial<class_FogMaterial>` с отрицательным :ref:`FogMaterial.density<class_FogMaterial_property_density>`.
|
||
|
||
Производительность **FogVolume** напрямую связана с их относительным размером на экране и сложностью прикрепленного к ним :ref:`FogMaterial<class_FogMaterial>`. Лучше всего сохранять **FogVolume** относительно небольшими и простыми, где это возможно.
|
||
|
||
\ **Примечание:** **FogVolume** имеют видимый эффект, только если :ref:`Environment.volumetric_fog_enabled<class_Environment_property_volumetric_fog_enabled>` равно ``true``. Если вы не хотите, чтобы туман был виден глобально (но только в пределах узлов **FogVolume**), установите :ref:`Environment.volumetric_fog_density<class_Environment_property_volumetric_fog_density>` на ``0.0``.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Обучающие материалы
|
||
--------------------------------------
|
||
|
||
- :doc:`Объемный туман и объемы тумана <../tutorials/3d/volumetric_fog>`
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+------------------------------------------------------------+----------------------------------------------------+----------------------+
|
||
| :ref:`Material<class_Material>` | :ref:`material<class_FogVolume_property_material>` | |
|
||
+------------------------------------------------------------+----------------------------------------------------+----------------------+
|
||
| :ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>` | :ref:`shape<class_FogVolume_property_shape>` | ``3`` |
|
||
+------------------------------------------------------------+----------------------------------------------------+----------------------+
|
||
| :ref:`Vector3<class_Vector3>` | :ref:`size<class_FogVolume_property_size>` | ``Vector3(2, 2, 2)`` |
|
||
+------------------------------------------------------------+----------------------------------------------------+----------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания свойств
|
||
--------------------------------
|
||
|
||
.. _class_FogVolume_property_material:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Material<class_Material>` **material** :ref:`🔗<class_FogVolume_property_material>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_material**\ (\ value\: :ref:`Material<class_Material>`\ )
|
||
- :ref:`Material<class_Material>` **get_material**\ (\ )
|
||
|
||
:ref:`Material<class_Material>`, используемый **FogVolume**. Может быть как встроенным :ref:`FogMaterial<class_FogMaterial>`, так и пользовательским :ref:`ShaderMaterial<class_ShaderMaterial>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FogVolume_property_shape:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>` **shape** = ``3`` :ref:`🔗<class_FogVolume_property_shape>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_shape**\ (\ value\: :ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>`\ )
|
||
- :ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>` **get_shape**\ (\ )
|
||
|
||
Форма **FogVolume**. Может быть установлена как :ref:`RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID<class_RenderingServer_constant_FOG_VOLUME_SHAPE_ELLIPSOID>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CONE<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CONE>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CYLINDER<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CYLINDER>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_BOX<class_RenderingServer_constant_FOG_VOLUME_SHAPE_BOX>` или :ref:`RenderingServer.FOG_VOLUME_SHAPE_WORLD<class_RenderingServer_constant_FOG_VOLUME_SHAPE_WORLD>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FogVolume_property_size:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Vector3<class_Vector3>` **size** = ``Vector3(2, 2, 2)`` :ref:`🔗<class_FogVolume_property_size>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_size**\ (\ value\: :ref:`Vector3<class_Vector3>`\ )
|
||
- :ref:`Vector3<class_Vector3>` **get_size**\ (\ )
|
||
|
||
Размер **FogVolume**, когда :ref:`shape<class_FogVolume_property_shape>` равен :ref:`RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID<class_RenderingServer_constant_FOG_VOLUME_SHAPE_ELLIPSOID>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CONE<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CONE>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CYLINDER<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CYLINDER>` или :ref:`RenderingServer.FOG_VOLUME_SHAPE_BOX<class_RenderingServer_constant_FOG_VOLUME_SHAPE_BOX>`.
|
||
|
||
\ **Примечание:** Тонкие объемы тумана могут мерцать при движении или вращении камеры. Это можно устранить, увеличив :ref:`ProjectSettings.rendering/environment/volumetric_fog/volume_depth<class_ProjectSettings_property_rendering/environment/volumetric_fog/volume_depth>` (за счет производительности) или уменьшив :ref:`Environment.volumetric_fog_length<class_Environment_property_volumetric_fog_length>` (без потери производительности, но за счет более низкого диапазона тумана). В качестве альтернативы **FogVolume** можно сделать толще и использовать меньшую плотность в :ref:`material<class_FogVolume_property_material>`.
|
||
|
||
\ **Примечание:** Если :ref:`shape<class_FogVolume_property_shape>` — :ref:`RenderingServer.FOG_VOLUME_SHAPE_CONE<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CONE>` или :ref:`RenderingServer.FOG_VOLUME_SHAPE_CYLINDER<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CYLINDER>`, конус/цилиндр будет скорректирован в соответствии с размером. Неравномерное масштабирование форм конуса/цилиндра через свойство :ref:`size<class_FogVolume_property_size>` не поддерживается, но вместо этого можно масштабировать узел **FogVolume**.
|
||
|
||
.. |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 (Нет возвращаемого значения.)`
|