mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-05 14:10:19 +03:00
161 lines
9.9 KiB
ReStructuredText
161 lines
9.9 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_FogMaterial:
|
||
|
||
FogMaterial
|
||
===========
|
||
|
||
**Наследует:** :ref:`Material<class_Material>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Материал, который управляет визуализацией объемного тумана, назначается :ref:`FogVolume<class_FogVolume>`.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
Ресурс :ref:`Material<class_Material>`, который может использоваться :ref:`FogVolume<class_FogVolume>` для рисования объемных эффектов.
|
||
|
||
Если вам нужны более продвинутые эффекты, используйте пользовательский :doc:`шейдер тумана <../tutorials/shaders/shader_reference/fog_shader>`.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-----------------------------------+--------------------------------------------------------------------+-----------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`albedo<class_FogMaterial_property_albedo>` | ``Color(1, 1, 1, 1)`` |
|
||
+-----------------------------------+--------------------------------------------------------------------+-----------------------+
|
||
| :ref:`float<class_float>` | :ref:`density<class_FogMaterial_property_density>` | ``1.0`` |
|
||
+-----------------------------------+--------------------------------------------------------------------+-----------------------+
|
||
| :ref:`Texture3D<class_Texture3D>` | :ref:`density_texture<class_FogMaterial_property_density_texture>` | |
|
||
+-----------------------------------+--------------------------------------------------------------------+-----------------------+
|
||
| :ref:`float<class_float>` | :ref:`edge_fade<class_FogMaterial_property_edge_fade>` | ``0.1`` |
|
||
+-----------------------------------+--------------------------------------------------------------------+-----------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`emission<class_FogMaterial_property_emission>` | ``Color(0, 0, 0, 1)`` |
|
||
+-----------------------------------+--------------------------------------------------------------------+-----------------------+
|
||
| :ref:`float<class_float>` | :ref:`height_falloff<class_FogMaterial_property_height_falloff>` | ``0.0`` |
|
||
+-----------------------------------+--------------------------------------------------------------------+-----------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания свойств
|
||
--------------------------------
|
||
|
||
.. _class_FogMaterial_property_albedo:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **albedo** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_FogMaterial_property_albedo>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_albedo**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_albedo**\ (\ )
|
||
|
||
:ref:`Color<class_Color>` однократного рассеяния :ref:`FogVolume<class_FogVolume>`. Внутренне :ref:`albedo<class_FogMaterial_property_albedo>` преобразуется в однократное рассеяние, которое аддитивно смешивается с другими :ref:`FogVolume<class_FogVolume>` и :ref:`Environment.volumetric_fog_albedo<class_Environment_property_volumetric_fog_albedo>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FogMaterial_property_density:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **density** = ``1.0`` :ref:`🔗<class_FogMaterial_property_density>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_density**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_density**\ (\ )
|
||
|
||
Плотность :ref:`FogVolume<class_FogVolume>`. Более плотные объекты более непрозрачны, но могут страдать от артефактов недостаточной выборки, которые выглядят как полосы. Отрицательные значения можно использовать для вычитания тумана из других :ref:`FogVolume<class_FogVolume>` или глобального объемного тумана.
|
||
|
||
\ **Примечание:** Из-за ограниченной точности значения :ref:`density<class_FogMaterial_property_density>` между ``-0.001`` и ``0.001`` (исключая) действуют как ``0.0``. Это не относится к :ref:`Environment.volumetric_fog_density<class_Environment_property_volumetric_fog_density>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FogMaterial_property_density_texture:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Texture3D<class_Texture3D>` **density_texture** :ref:`🔗<class_FogMaterial_property_density_texture>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_density_texture**\ (\ value\: :ref:`Texture3D<class_Texture3D>`\ )
|
||
- :ref:`Texture3D<class_Texture3D>` **get_density_texture**\ (\ )
|
||
|
||
3D-текстура, которая используется для масштабирования :ref:`density<class_FogMaterial_property_density>` :ref:`FogVolume<class_FogVolume>`. Это может использоваться для изменения плотности тумана в :ref:`FogVolume<class_FogVolume>` с любым видом статического узора. Для анимированных эффектов рассмотрите возможность использования пользовательского :doc:`шейдера тумана <../tutorials/shaders/shader_reference/fog_shader>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FogMaterial_property_edge_fade:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **edge_fade** = ``0.1`` :ref:`🔗<class_FogMaterial_property_edge_fade>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_edge_fade**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_edge_fade**\ (\ )
|
||
|
||
Жесткость краев :ref:`FogVolume<class_FogVolume>`. Более высокое значение приведет к более мягким краям, а более низкое значение приведет к более жестким краям.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FogMaterial_property_emission:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **emission** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_FogMaterial_property_emission>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_emission**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_emission**\ (\ )
|
||
|
||
:ref:`Color<class_Color>` света, излучаемого :ref:`FogVolume<class_FogVolume>`. Излучаемый свет не будет отбрасывать свет или тени на другие объекты, но может быть полезен для модуляции :ref:`Color<class_Color>` :ref:`FogVolume<class_FogVolume>` независимо от источников света.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_FogMaterial_property_height_falloff:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **height_falloff** = ``0.0`` :ref:`🔗<class_FogMaterial_property_height_falloff>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_height_falloff**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_height_falloff**\ (\ )
|
||
|
||
Скорость, с которой плотность тумана, зависящего от высоты, уменьшается по мере увеличения высоты в мировом пространстве. Высокий спад приведет к резкому переходу, а низкий спад приведет к более плавному переходу. Значение ``0.0`` приводит к туману однородной плотности. Порог высоты определяется высотой соответствующего :ref:`FogVolume<class_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 (Нет возвращаемого значения.)`
|