mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
313 lines
17 KiB
ReStructuredText
313 lines
17 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_ProceduralSkyMaterial:
|
||
|
||
ProceduralSkyMaterial
|
||
=====================
|
||
|
||
**Hérite de :** :ref:`Material<class_Material>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Un matériau qui définit un ciel simple pour une ressource :ref:`Sky<class_Sky>`.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Description
|
||
-----------
|
||
|
||
**ProceduralSkyMaterial** fournit un moyen de créer un arrière-plan efficace rapidement en définissant des paramètres procéduraux pour le soleil, le ciel et le sol. Le ciel et le sol sont définis par une couleur principale, une couleur à l'horizon, et une courbe d'assouplissement pour interpoler entre eux. Les soleils sont décrits par une position dans le ciel, une couleur, et un angle maximal depuis le soleil où se termine la courbe d'assoupissement. L'angle maximal définit donc la taille du soleil dans le ciel.
|
||
|
||
\ **ProceduralSkyMaterial** prend en charge jusqu'à 4 soleils, en utilisant la couleur, et l'énergie, la direction et la distance angulaire des quatre premiers nœuds :ref:`DirectionalLight3D<class_DirectionalLight3D>` dans la scène. Cela signifie que les soleils sont définis individuellement par les propriétés de leurs :ref:`DirectionalLight3D<class_DirectionalLight3D>` et globalement par :ref:`sun_angle_max<class_ProceduralSkyMaterial_property_sun_angle_max>` et :ref:`sun_curve<class_ProceduralSkyMaterial_property_sun_curve>`.
|
||
|
||
\ **ProceduralSkyMaterial** utilise un shader léger pour dessiner le ciel et est donc adapté aux mises à jour en temps réel. Cela en fait une excellente option pour un ciel simple et peu cher en calculs, mais irréaliste. Si vous avez besoin d'une option procédurale plus réaliste, utilisez :ref:`PhysicalSkyMaterial<class_PhysicalSkyMaterial>`.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Propriétés
|
||
--------------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`energy_multiplier<class_ProceduralSkyMaterial_property_energy_multiplier>` | ``1.0`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`ground_bottom_color<class_ProceduralSkyMaterial_property_ground_bottom_color>` | ``Color(0.2, 0.169, 0.133, 1)`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`ground_curve<class_ProceduralSkyMaterial_property_ground_curve>` | ``0.02`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`ground_energy_multiplier<class_ProceduralSkyMaterial_property_ground_energy_multiplier>` | ``1.0`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`ground_horizon_color<class_ProceduralSkyMaterial_property_ground_horizon_color>` | ``Color(0.6463, 0.6558, 0.6708, 1)`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`Texture2D<class_Texture2D>` | :ref:`sky_cover<class_ProceduralSkyMaterial_property_sky_cover>` | |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`sky_cover_modulate<class_ProceduralSkyMaterial_property_sky_cover_modulate>` | ``Color(1, 1, 1, 1)`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`sky_curve<class_ProceduralSkyMaterial_property_sky_curve>` | ``0.15`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`sky_energy_multiplier<class_ProceduralSkyMaterial_property_sky_energy_multiplier>` | ``1.0`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`sky_horizon_color<class_ProceduralSkyMaterial_property_sky_horizon_color>` | ``Color(0.6463, 0.6558, 0.6708, 1)`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`sky_top_color<class_ProceduralSkyMaterial_property_sky_top_color>` | ``Color(0.385, 0.454, 0.55, 1)`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`sun_angle_max<class_ProceduralSkyMaterial_property_sun_angle_max>` | ``30.0`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`sun_curve<class_ProceduralSkyMaterial_property_sun_curve>` | ``0.15`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`use_debanding<class_ProceduralSkyMaterial_property_use_debanding>` | ``true`` |
|
||
+-----------------------------------+------------------------------------------------------------------------------------------------+--------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Descriptions des propriétés
|
||
------------------------------------------------------
|
||
|
||
.. _class_ProceduralSkyMaterial_property_energy_multiplier:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **energy_multiplier** = ``1.0`` :ref:`🔗<class_ProceduralSkyMaterial_property_energy_multiplier>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_energy_multiplier**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_energy_multiplier**\ (\ )
|
||
|
||
Le multiplicateur de luminosité générale du ciel. Des valeurs plus élevées résulteront en un ciel plus lumineux.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_ground_bottom_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **ground_bottom_color** = ``Color(0.2, 0.169, 0.133, 1)`` :ref:`🔗<class_ProceduralSkyMaterial_property_ground_bottom_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_ground_bottom_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_ground_bottom_color**\ (\ )
|
||
|
||
Couleur du sol en bas. Est mélangé avec :ref:`ground_horizon_color<class_ProceduralSkyMaterial_property_ground_horizon_color>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_ground_curve:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **ground_curve** = ``0.02`` :ref:`🔗<class_ProceduralSkyMaterial_property_ground_curve>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_ground_curve**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_ground_curve**\ (\ )
|
||
|
||
La rapidité avec laquelle la couleur :ref:`ground_horizon_color<class_ProceduralSkyMaterial_property_ground_horizon_color>` change en :ref:`ground_bottom_color<class_ProceduralSkyMaterial_property_ground_bottom_color>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_ground_energy_multiplier:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **ground_energy_multiplier** = ``1.0`` :ref:`🔗<class_ProceduralSkyMaterial_property_ground_energy_multiplier>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_ground_energy_multiplier**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_ground_energy_multiplier**\ (\ )
|
||
|
||
Multiplicateur pour la couleur du sol. Une valeur plus élevée rendra le sol plus lumineux.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_ground_horizon_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **ground_horizon_color** = ``Color(0.6463, 0.6558, 0.6708, 1)`` :ref:`🔗<class_ProceduralSkyMaterial_property_ground_horizon_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_ground_horizon_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_ground_horizon_color**\ (\ )
|
||
|
||
Couleur du sol à l'horizon. Mélangé avec :ref:`ground_bottom_color<class_ProceduralSkyMaterial_property_ground_bottom_color>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sky_cover:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Texture2D<class_Texture2D>` **sky_cover** :ref:`🔗<class_ProceduralSkyMaterial_property_sky_cover>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sky_cover**\ (\ value\: :ref:`Texture2D<class_Texture2D>`\ )
|
||
- :ref:`Texture2D<class_Texture2D>` **get_sky_cover**\ (\ )
|
||
|
||
La texture de couverture du ciel à utiliser. Cette texture doit utiliser une projection équi-rectangulaire (similaire à :ref:`PanoramaSkyMaterial<class_PanoramaSkyMaterial>`). Les couleurs de la texture seront *ajoutées* à la couleur du ciel existante, et seront multipliées par :ref:`sky_energy_multiplier<class_ProceduralSkyMaterial_property_sky_energy_multiplier>` et :ref:`sky_cover_modulate<class_ProceduralSkyMaterial_property_sky_cover_modulate>`. Ceci est principalement adapté à l'affichage d'étoiles de nuit, mais il peut également être utilisé pour afficher des nuages de jour ou de nuit (avec un aspect non physiquement valide).
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sky_cover_modulate:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **sky_cover_modulate** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_ProceduralSkyMaterial_property_sky_cover_modulate>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sky_cover_modulate**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_sky_cover_modulate**\ (\ )
|
||
|
||
La teinte à appliquer à la texture :ref:`sky_cover<class_ProceduralSkyMaterial_property_sky_cover>`. Cela peut être utilisé pour changer les couleurs ou l'opacité de la couverture du ciel indépendamment de l'énergie du ciel, ce qui est utile pour les transitions jour/nuit ou météo. Seulement effectif si une texture est définie dans :ref:`sky_cover<class_ProceduralSkyMaterial_property_sky_cover>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sky_curve:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **sky_curve** = ``0.15`` :ref:`🔗<class_ProceduralSkyMaterial_property_sky_curve>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sky_curve**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_sky_curve**\ (\ )
|
||
|
||
La rapidité avec laquelle la couleur :ref:`sky_horizon_color<class_ProceduralSkyMaterial_property_sky_horizon_color>` change en :ref:`sky_top_color<class_ProceduralSkyMaterial_property_sky_top_color>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sky_energy_multiplier:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **sky_energy_multiplier** = ``1.0`` :ref:`🔗<class_ProceduralSkyMaterial_property_sky_energy_multiplier>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sky_energy_multiplier**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_sky_energy_multiplier**\ (\ )
|
||
|
||
Multiplicateur pour la couleur du ciel. Une valeur plus élevée rendra le ciel plus clair.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sky_horizon_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **sky_horizon_color** = ``Color(0.6463, 0.6558, 0.6708, 1)`` :ref:`🔗<class_ProceduralSkyMaterial_property_sky_horizon_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sky_horizon_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_sky_horizon_color**\ (\ )
|
||
|
||
Couleur du ciel à l'horizon. Se mélange avec :ref:`sky_top_color<class_ProceduralSkyMaterial_property_sky_top_color>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sky_top_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **sky_top_color** = ``Color(0.385, 0.454, 0.55, 1)`` :ref:`🔗<class_ProceduralSkyMaterial_property_sky_top_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sky_top_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_sky_top_color**\ (\ )
|
||
|
||
Couleur du ciel en haut. Se mélange avec :ref:`sky_horizon_color<class_ProceduralSkyMaterial_property_sky_horizon_color>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sun_angle_max:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **sun_angle_max** = ``30.0`` :ref:`🔗<class_ProceduralSkyMaterial_property_sun_angle_max>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sun_angle_max**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_sun_angle_max**\ (\ )
|
||
|
||
Distance depuis le centre du soleil où il s'éteint complètement.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_sun_curve:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **sun_curve** = ``0.15`` :ref:`🔗<class_ProceduralSkyMaterial_property_sun_curve>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_sun_curve**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_sun_curve**\ (\ )
|
||
|
||
À point le soleil s'éteint rapidement entre le bord du disque du soleil et :ref:`sun_angle_max<class_ProceduralSkyMaterial_property_sun_angle_max>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_ProceduralSkyMaterial_property_use_debanding:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`bool<class_bool>` **use_debanding** = ``true`` :ref:`🔗<class_ProceduralSkyMaterial_property_use_debanding>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_use_debanding**\ (\ value\: :ref:`bool<class_bool>`\ )
|
||
- :ref:`bool<class_bool>` **get_use_debanding**\ (\ )
|
||
|
||
Si ``true``, active le debanding. Le debanding ajoute une petite quantité de bruit qui aide à réduire les bandes qui apparaissent suite aux changements lisses de couleur dans le ciel.
|
||
|
||
.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)`
|
||
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
|
||
.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)`
|
||
.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)`
|
||
.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)`
|
||
.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)`
|
||
.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)`
|
||
.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)`
|
||
.. |void| replace:: :abbr:`void (Aucune valeur de retour.)`
|