mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
254 lines
14 KiB
ReStructuredText
254 lines
14 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_PhysicalSkyMaterial:
|
||
|
||
PhysicalSkyMaterial
|
||
===================
|
||
|
||
**Наследует:** :ref:`Material<class_Material>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Материал, определяющий небо для ресурса :ref:`Sky<class_Sky>` с помощью набора физических свойств.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Описание
|
||
----------------
|
||
|
||
**PhysicalSkyMaterial** использует аналитическую модель дневного света Preetham для рисования неба на основе физических свойств. Это приводит к существенно более реалистичному небу, чем :ref:`ProceduralSkyMaterial<class_ProceduralSkyMaterial>`, но он немного медленнее и менее гибкий.
|
||
|
||
\ **PhysicalSkyMaterial** поддерживает только одно солнце. Цвет, энергия и направление солнца берутся из первого :ref:`DirectionalLight3D<class_DirectionalLight3D>` в дереве сцены.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Свойства
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`energy_multiplier<class_PhysicalSkyMaterial_property_energy_multiplier>` | ``1.0`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`ground_color<class_PhysicalSkyMaterial_property_ground_color>` | ``Color(0.1, 0.07, 0.034, 1)`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`mie_coefficient<class_PhysicalSkyMaterial_property_mie_coefficient>` | ``0.005`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`mie_color<class_PhysicalSkyMaterial_property_mie_color>` | ``Color(0.69, 0.729, 0.812, 1)`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`mie_eccentricity<class_PhysicalSkyMaterial_property_mie_eccentricity>` | ``0.8`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`Texture2D<class_Texture2D>` | :ref:`night_sky<class_PhysicalSkyMaterial_property_night_sky>` | |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`rayleigh_coefficient<class_PhysicalSkyMaterial_property_rayleigh_coefficient>` | ``2.0`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`rayleigh_color<class_PhysicalSkyMaterial_property_rayleigh_color>` | ``Color(0.3, 0.405, 0.6, 1)`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`sun_disk_scale<class_PhysicalSkyMaterial_property_sun_disk_scale>` | ``1.0`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`turbidity<class_PhysicalSkyMaterial_property_turbidity>` | ``10.0`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`use_debanding<class_PhysicalSkyMaterial_property_use_debanding>` | ``true`` |
|
||
+-----------------------------------+--------------------------------------------------------------------------------------+----------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Описания свойств
|
||
--------------------------------
|
||
|
||
.. _class_PhysicalSkyMaterial_property_energy_multiplier:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **energy_multiplier** = ``1.0`` :ref:`🔗<class_PhysicalSkyMaterial_property_energy_multiplier>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_energy_multiplier**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_energy_multiplier**\ (\ )
|
||
|
||
Множитель общей яркости неба. Более высокие значения дают более яркое небо.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_ground_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **ground_color** = ``Color(0.1, 0.07, 0.034, 1)`` :ref:`🔗<class_PhysicalSkyMaterial_property_ground_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_ground_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_ground_color**\ (\ )
|
||
|
||
Изменяет :ref:`Color<class_Color>` в нижней половине неба, чтобы отобразить землю.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_mie_coefficient:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **mie_coefficient** = ``0.005`` :ref:`🔗<class_PhysicalSkyMaterial_property_mie_coefficient>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_mie_coefficient**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_mie_coefficient**\ (\ )
|
||
|
||
Управляет силой `Mie scattering <https://en.wikipedia.org/wiki/Mie_scattering>`__ для неба. Рассеивание Ми (Mie scattering) происходит при столкновении света с более крупными частицами (например, водой). На Земле рассеивание Ми приводит к появлению белесого цвета вокруг солнца и горизонта.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_mie_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **mie_color** = ``Color(0.69, 0.729, 0.812, 1)`` :ref:`🔗<class_PhysicalSkyMaterial_property_mie_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_mie_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_mie_color**\ (\ )
|
||
|
||
Управляет :ref:`Color<class_Color>` эффекта `рассеивания Ми <https://en.wikipedia.org/wiki/Mie_scattering>`__. Хотя это и не является физически точным, это позволяет создавать планеты, похожие на инопланетян.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_mie_eccentricity:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **mie_eccentricity** = ``0.8`` :ref:`🔗<class_PhysicalSkyMaterial_property_mie_eccentricity>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_mie_eccentricity**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_mie_eccentricity**\ (\ )
|
||
|
||
Управляет направлением `Mie scattering <https://en.wikipedia.org/wiki/Mie_scattering>`__. Значение ``1`` означает, что когда свет попадает на частицу, он проходит прямо вперед. Значение ``-1`` означает, что весь свет рассеивается назад.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_night_sky:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Texture2D<class_Texture2D>` **night_sky** :ref:`🔗<class_PhysicalSkyMaterial_property_night_sky>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_night_sky**\ (\ value\: :ref:`Texture2D<class_Texture2D>`\ )
|
||
- :ref:`Texture2D<class_Texture2D>` **get_night_sky**\ (\ )
|
||
|
||
:ref:`Texture2D<class_Texture2D>` для ночного неба. Это добавляется к небу, так что если оно достаточно яркое, то может быть видно днем.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_rayleigh_coefficient:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **rayleigh_coefficient** = ``2.0`` :ref:`🔗<class_PhysicalSkyMaterial_property_rayleigh_coefficient>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_rayleigh_coefficient**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_rayleigh_coefficient**\ (\ )
|
||
|
||
Управляет силой `Рэлеевского рассеяния <https://en.wikipedia.org/wiki/Rayleigh_scattering>`__. Рэлеевское рассеяние возникает при столкновении света с мелкими частицами. Оно отвечает за голубой цвет неба.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_rayleigh_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **rayleigh_color** = ``Color(0.3, 0.405, 0.6, 1)`` :ref:`🔗<class_PhysicalSkyMaterial_property_rayleigh_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_rayleigh_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_rayleigh_color**\ (\ )
|
||
|
||
Управляет :ref:`Color<class_Color>` `рэлеевского рассеяния <https://en.wikipedia.org/wiki/Rayleigh_scattering>`__. Хотя это и не является физически точным, это позволяет создавать планеты, похожие на инопланетян. Например, если установить для этого параметра красный :ref:`Color<class_Color>`, то получится атмосфера, похожая на Марс, с соответствующим синим закатом.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_sun_disk_scale:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **sun_disk_scale** = ``1.0`` :ref:`🔗<class_PhysicalSkyMaterial_property_sun_disk_scale>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sun_disk_scale**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_sun_disk_scale**\ (\ )
|
||
|
||
Устанавливает размер солнечного диска. Значение по умолчанию основано на воспринимаемом размере Солнца с Земли.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_turbidity:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **turbidity** = ``10.0`` :ref:`🔗<class_PhysicalSkyMaterial_property_turbidity>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_turbidity**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_turbidity**\ (\ )
|
||
|
||
Устанавливает толщину атмосферы. Высокая мутность создает туманную атмосферу, а низкая мутность приводит к более чистой атмосфере.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_PhysicalSkyMaterial_property_use_debanding:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **use_debanding** = ``true`` :ref:`🔗<class_PhysicalSkyMaterial_property_use_debanding>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_use_debanding**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_use_debanding**\ (\ )
|
||
|
||
Если ``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 (Нет возвращаемого значения.)`
|