godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2026-01-04 10:09:56 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
c3f2364c10f397e3718d45ebd79eda715f38f8e0
godot-docs-l10n/classes/fr/class_environment.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch 
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

2408 lines
142 KiB
ReStructuredText
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_Environment:
Environment
===========
**Hérite de :** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
Ressource pour les nœuds d’environnement (comme :ref:`WorldEnvironment<class_WorldEnvironment>`) qui définissent plusieurs options de rendu.
.. rst-class:: classref-introduction-group
Description
-----------
Resource for environment nodes (like :ref:`WorldEnvironment<class_WorldEnvironment>`) that define multiple environment operations (such as background :ref:`Sky<class_Sky>` or :ref:`Color<class_Color>`, ambient light, fog, depth-of-field...). These parameters affect the final render of the scene. The order of these operations is:
- Depth of Field Blur
- Auto Exposure
- Glow
- Tonemap
- Adjustments
.. rst-class:: classref-introduction-group
Tutoriels
------------------
- :doc:`Les environnements et les effets post-rendu <../tutorials/3d/environment_and_post_processing>`
- :doc:`Éclairage HDR <../tutorials/3d/high_dynamic_range>`
- `Démo de test des matériaux 3D <https://godotengine.org/asset-library/asset/2742>`__
- `Démo de tir à la troisième personne (TPS) <https://godotengine.org/asset-library/asset/2710>`__
.. rst-class:: classref-reftable-group
Propriétés
--------------------
.. table::
:widths: auto
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`adjustment_brightness<class_Environment_property_adjustment_brightness>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture<class_Texture>` | :ref:`adjustment_color_correction<class_Environment_property_adjustment_color_correction>` | |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`adjustment_contrast<class_Environment_property_adjustment_contrast>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`adjustment_enabled<class_Environment_property_adjustment_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`adjustment_saturation<class_Environment_property_adjustment_saturation>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`ambient_light_color<class_Environment_property_ambient_light_color>` | ``Color(0, 0, 0, 1)`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ambient_light_energy<class_Environment_property_ambient_light_energy>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ambient_light_sky_contribution<class_Environment_property_ambient_light_sky_contribution>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`AmbientSource<enum_Environment_AmbientSource>` | :ref:`ambient_light_source<class_Environment_property_ambient_light_source>` | ``0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`background_camera_feed_id<class_Environment_property_background_camera_feed_id>` | ``1`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`background_canvas_max_layer<class_Environment_property_background_canvas_max_layer>` | ``0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`background_color<class_Environment_property_background_color>` | ``Color(0, 0, 0, 1)`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`background_energy_multiplier<class_Environment_property_background_energy_multiplier>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`background_intensity<class_Environment_property_background_intensity>` | ``30000.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`BGMode<enum_Environment_BGMode>` | :ref:`background_mode<class_Environment_property_background_mode>` | ``0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_aerial_perspective<class_Environment_property_fog_aerial_perspective>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_density<class_Environment_property_fog_density>` | ``0.01`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_depth_begin<class_Environment_property_fog_depth_begin>` | ``10.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_depth_curve<class_Environment_property_fog_depth_curve>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_depth_end<class_Environment_property_fog_depth_end>` | ``100.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`fog_enabled<class_Environment_property_fog_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_height<class_Environment_property_fog_height>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_height_density<class_Environment_property_fog_height_density>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`fog_light_color<class_Environment_property_fog_light_color>` | ``Color(0.518, 0.553, 0.608, 1)`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_light_energy<class_Environment_property_fog_light_energy>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`FogMode<enum_Environment_FogMode>` | :ref:`fog_mode<class_Environment_property_fog_mode>` | ``0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_sky_affect<class_Environment_property_fog_sky_affect>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`fog_sun_scatter<class_Environment_property_fog_sun_scatter>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` | :ref:`glow_blend_mode<class_Environment_property_glow_blend_mode>` | ``1`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_bloom<class_Environment_property_glow_bloom>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`glow_enabled<class_Environment_property_glow_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_hdr_luminance_cap<class_Environment_property_glow_hdr_luminance_cap>` | ``12.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_hdr_scale<class_Environment_property_glow_hdr_scale>` | ``2.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_hdr_threshold<class_Environment_property_glow_hdr_threshold>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_intensity<class_Environment_property_glow_intensity>` | ``0.3`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_levels/1<class_Environment_property_glow_levels/1>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_levels/2<class_Environment_property_glow_levels/2>` | ``0.8`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_levels/3<class_Environment_property_glow_levels/3>` | ``0.4`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_levels/4<class_Environment_property_glow_levels/4>` | ``0.1`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_levels/5<class_Environment_property_glow_levels/5>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_levels/6<class_Environment_property_glow_levels/6>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_levels/7<class_Environment_property_glow_levels/7>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture<class_Texture>` | :ref:`glow_map<class_Environment_property_glow_map>` | |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_map_strength<class_Environment_property_glow_map_strength>` | ``0.8`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_mix<class_Environment_property_glow_mix>` | ``0.05`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`glow_normalized<class_Environment_property_glow_normalized>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`glow_strength<class_Environment_property_glow_strength>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`ReflectionSource<enum_Environment_ReflectionSource>` | :ref:`reflected_light_source<class_Environment_property_reflected_light_source>` | ``0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sdfgi_bounce_feedback<class_Environment_property_sdfgi_bounce_feedback>` | ``0.5`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sdfgi_cascade0_distance<class_Environment_property_sdfgi_cascade0_distance>` | ``12.8`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`sdfgi_cascades<class_Environment_property_sdfgi_cascades>` | ``4`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`sdfgi_enabled<class_Environment_property_sdfgi_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sdfgi_energy<class_Environment_property_sdfgi_energy>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sdfgi_max_distance<class_Environment_property_sdfgi_max_distance>` | ``204.8`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sdfgi_min_cell_size<class_Environment_property_sdfgi_min_cell_size>` | ``0.2`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sdfgi_normal_bias<class_Environment_property_sdfgi_normal_bias>` | ``1.1`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sdfgi_probe_bias<class_Environment_property_sdfgi_probe_bias>` | ``1.1`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`sdfgi_read_sky_light<class_Environment_property_sdfgi_read_sky_light>` | ``true`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`sdfgi_use_occlusion<class_Environment_property_sdfgi_use_occlusion>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`SDFGIYScale<enum_Environment_SDFGIYScale>` | :ref:`sdfgi_y_scale<class_Environment_property_sdfgi_y_scale>` | ``1`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Sky<class_Sky>` | :ref:`sky<class_Environment_property_sky>` | |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`sky_custom_fov<class_Environment_property_sky_custom_fov>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Vector3<class_Vector3>` | :ref:`sky_rotation<class_Environment_property_sky_rotation>` | ``Vector3(0, 0, 0)`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_ao_channel_affect<class_Environment_property_ssao_ao_channel_affect>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_detail<class_Environment_property_ssao_detail>` | ``0.5`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`ssao_enabled<class_Environment_property_ssao_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_horizon<class_Environment_property_ssao_horizon>` | ``0.06`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_intensity<class_Environment_property_ssao_intensity>` | ``2.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_light_affect<class_Environment_property_ssao_light_affect>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_power<class_Environment_property_ssao_power>` | ``1.5`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_radius<class_Environment_property_ssao_radius>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssao_sharpness<class_Environment_property_ssao_sharpness>` | ``0.98`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`ssil_enabled<class_Environment_property_ssil_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssil_intensity<class_Environment_property_ssil_intensity>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssil_normal_rejection<class_Environment_property_ssil_normal_rejection>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssil_radius<class_Environment_property_ssil_radius>` | ``5.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssil_sharpness<class_Environment_property_ssil_sharpness>` | ``0.98`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssr_depth_tolerance<class_Environment_property_ssr_depth_tolerance>` | ``0.5`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`ssr_enabled<class_Environment_property_ssr_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssr_fade_in<class_Environment_property_ssr_fade_in>` | ``0.15`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`ssr_fade_out<class_Environment_property_ssr_fade_out>` | ``2.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`ssr_max_steps<class_Environment_property_ssr_max_steps>` | ``64`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`tonemap_agx_contrast<class_Environment_property_tonemap_agx_contrast>` | ``1.25`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`tonemap_agx_white<class_Environment_property_tonemap_agx_white>` | ``16.29`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`tonemap_exposure<class_Environment_property_tonemap_exposure>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`ToneMapper<enum_Environment_ToneMapper>` | :ref:`tonemap_mode<class_Environment_property_tonemap_mode>` | ``0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`tonemap_white<class_Environment_property_tonemap_white>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`volumetric_fog_albedo<class_Environment_property_volumetric_fog_albedo>` | ``Color(1, 1, 1, 1)`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_ambient_inject<class_Environment_property_volumetric_fog_ambient_inject>` | ``0.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_anisotropy<class_Environment_property_volumetric_fog_anisotropy>` | ``0.2`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_density<class_Environment_property_volumetric_fog_density>` | ``0.05`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_detail_spread<class_Environment_property_volumetric_fog_detail_spread>` | ``2.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`volumetric_fog_emission<class_Environment_property_volumetric_fog_emission>` | ``Color(0, 0, 0, 1)`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_emission_energy<class_Environment_property_volumetric_fog_emission_energy>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`volumetric_fog_enabled<class_Environment_property_volumetric_fog_enabled>` | ``false`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_gi_inject<class_Environment_property_volumetric_fog_gi_inject>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_length<class_Environment_property_volumetric_fog_length>` | ``64.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_sky_affect<class_Environment_property_volumetric_fog_sky_affect>` | ``1.0`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`float<class_float>` | :ref:`volumetric_fog_temporal_reprojection_amount<class_Environment_property_volumetric_fog_temporal_reprojection_amount>` | ``0.9`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`bool<class_bool>` | :ref:`volumetric_fog_temporal_reprojection_enabled<class_Environment_property_volumetric_fog_temporal_reprojection_enabled>` | ``true`` |
+------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+-----------------------------------+
.. rst-class:: classref-reftable-group
Méthodes
----------------
.. table::
:widths: auto
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_glow_level<class_Environment_method_get_glow_level>`\ (\ idx\: :ref:`int<class_int>`\ ) |const| |
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_glow_level<class_Environment_method_set_glow_level>`\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ ) |
+---------------------------+------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Énumérations
------------------------
.. _enum_Environment_BGMode:
.. rst-class:: classref-enumeration
enum **BGMode**: :ref:`🔗<enum_Environment_BGMode>`
.. _class_Environment_constant_BG_CLEAR_COLOR:
.. rst-class:: classref-enumeration-constant
:ref:`BGMode<enum_Environment_BGMode>` **BG_CLEAR_COLOR** = ``0``
Efface l'arrière-plan en utilisant la couleur d'effacement définie dans :ref:`ProjectSettings.rendering/environment/defaults/default_clear_color<class_ProjectSettings_property_rendering/environment/defaults/default_clear_color>`.
.. _class_Environment_constant_BG_COLOR:
.. rst-class:: classref-enumeration-constant
:ref:`BGMode<enum_Environment_BGMode>` **BG_COLOR** = ``1``
Efface l'arrière-plan en utilisant la couleur d'effacement personnalisée.
.. _class_Environment_constant_BG_SKY:
.. rst-class:: classref-enumeration-constant
:ref:`BGMode<enum_Environment_BGMode>` **BG_SKY** = ``2``
Affiche un ciel personnalisé en arrière-plan.
.. _class_Environment_constant_BG_CANVAS:
.. rst-class:: classref-enumeration-constant
:ref:`BGMode<enum_Environment_BGMode>` **BG_CANVAS** = ``3``
Affiche un :ref:`CanvasLayer<class_CanvasLayer>` en arrière-plan.
.. _class_Environment_constant_BG_KEEP:
.. rst-class:: classref-enumeration-constant
:ref:`BGMode<enum_Environment_BGMode>` **BG_KEEP** = ``4``
Garde à l'écran chaque pixel dessiné à l'arrière-plan. Il s'agit du mode d'arrière-plan le plus rapide, mais il ne peut être utilisé en toute sécurité que dans des scènes entièrement intérieures (pas de ciel visible ou de reflets du ciel). S'il est activé dans une scène où l'arrière-plan est visible, des artéfacts de "ghost trail" (traînées fantômes) seront visibles lors du déplacement de la caméra.
.. _class_Environment_constant_BG_CAMERA_FEED:
.. rst-class:: classref-enumeration-constant
:ref:`BGMode<enum_Environment_BGMode>` **BG_CAMERA_FEED** = ``5``
Afficher le flux de la caméra en arrière-plan.
.. _class_Environment_constant_BG_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`BGMode<enum_Environment_BGMode>` **BG_MAX** = ``6``
Représente la taille de l'énumération :ref:`BGMode<enum_Environment_BGMode>`.
.. rst-class:: classref-item-separator
----
.. _enum_Environment_AmbientSource:
.. rst-class:: classref-enumeration
enum **AmbientSource**: :ref:`🔗<enum_Environment_AmbientSource>`
.. _class_Environment_constant_AMBIENT_SOURCE_BG:
.. rst-class:: classref-enumeration-constant
:ref:`AmbientSource<enum_Environment_AmbientSource>` **AMBIENT_SOURCE_BG** = ``0``
Recueillir la lumière ambiante depuis la source spécifiée comme arrière-plan.
.. _class_Environment_constant_AMBIENT_SOURCE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`AmbientSource<enum_Environment_AmbientSource>` **AMBIENT_SOURCE_DISABLED** = ``1``
Désactiver la lumière ambiante. Ceci fournit un léger boost de performance par rapport à :ref:`AMBIENT_SOURCE_SKY<class_Environment_constant_AMBIENT_SOURCE_SKY>`.
.. _class_Environment_constant_AMBIENT_SOURCE_COLOR:
.. rst-class:: classref-enumeration-constant
:ref:`AmbientSource<enum_Environment_AmbientSource>` **AMBIENT_SOURCE_COLOR** = ``2``
Spécifier une :ref:`Color<class_Color>` spécifique pour la lumière ambiante. Ceci fournit un léger boost de performance par rapport à :ref:`AMBIENT_SOURCE_SKY<class_Environment_constant_AMBIENT_SOURCE_SKY>`.
.. _class_Environment_constant_AMBIENT_SOURCE_SKY:
.. rst-class:: classref-enumeration-constant
:ref:`AmbientSource<enum_Environment_AmbientSource>` **AMBIENT_SOURCE_SKY** = ``3``
Recueillir la lumière ambiante depuis le :ref:`Sky<class_Sky>` peu importe de ce qu'est l'arrière-plan.
.. rst-class:: classref-item-separator
----
.. _enum_Environment_ReflectionSource:
.. rst-class:: classref-enumeration
enum **ReflectionSource**: :ref:`🔗<enum_Environment_ReflectionSource>`
.. _class_Environment_constant_REFLECTION_SOURCE_BG:
.. rst-class:: classref-enumeration-constant
:ref:`ReflectionSource<enum_Environment_ReflectionSource>` **REFLECTION_SOURCE_BG** = ``0``
Utiliser l'arrière-plan pour les réflexions.
.. _class_Environment_constant_REFLECTION_SOURCE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`ReflectionSource<enum_Environment_ReflectionSource>` **REFLECTION_SOURCE_DISABLED** = ``1``
Désactiver les réflexions. Cela donne un léger boost de performance par rapport aux autres options.
.. _class_Environment_constant_REFLECTION_SOURCE_SKY:
.. rst-class:: classref-enumeration-constant
:ref:`ReflectionSource<enum_Environment_ReflectionSource>` **REFLECTION_SOURCE_SKY** = ``2``
Utiliser le :ref:`Sky<class_Sky>` pour les réflexions quel que soit l'arrière-plan.
.. rst-class:: classref-item-separator
----
.. _enum_Environment_ToneMapper:
.. rst-class:: classref-enumeration
enum **ToneMapper**: :ref:`🔗<enum_Environment_ToneMapper>`
.. _class_Environment_constant_TONE_MAPPER_LINEAR:
.. rst-class:: classref-enumeration-constant
:ref:`ToneMapper<enum_Environment_ToneMapper>` **TONE_MAPPER_LINEAR** = ``0``
Does not modify color data, resulting in a linear tonemapping curve which unnaturally clips bright values, causing bright lighting to look blown out. The simplest and fastest tonemapper.
.. _class_Environment_constant_TONE_MAPPER_REINHARDT:
.. rst-class:: classref-enumeration-constant
:ref:`ToneMapper<enum_Environment_ToneMapper>` **TONE_MAPPER_REINHARDT** = ``1``
A simple tonemapping curve that rolls off bright values to prevent clipping. This results in an image that can appear dull and low contrast. Slower than :ref:`TONE_MAPPER_LINEAR<class_Environment_constant_TONE_MAPPER_LINEAR>`.
\ **Note:** When :ref:`tonemap_white<class_Environment_property_tonemap_white>` is left at the default value of ``1.0``, :ref:`TONE_MAPPER_REINHARDT<class_Environment_constant_TONE_MAPPER_REINHARDT>` produces an identical image to :ref:`TONE_MAPPER_LINEAR<class_Environment_constant_TONE_MAPPER_LINEAR>`.
.. _class_Environment_constant_TONE_MAPPER_FILMIC:
.. rst-class:: classref-enumeration-constant
:ref:`ToneMapper<enum_Environment_ToneMapper>` **TONE_MAPPER_FILMIC** = ``2``
Uses a film-like tonemapping curve to prevent clipping of bright values and provide better contrast than :ref:`TONE_MAPPER_REINHARDT<class_Environment_constant_TONE_MAPPER_REINHARDT>`. Slightly slower than :ref:`TONE_MAPPER_REINHARDT<class_Environment_constant_TONE_MAPPER_REINHARDT>`.
.. _class_Environment_constant_TONE_MAPPER_ACES:
.. rst-class:: classref-enumeration-constant
:ref:`ToneMapper<enum_Environment_ToneMapper>` **TONE_MAPPER_ACES** = ``3``
Uses a high-contrast film-like tonemapping curve and desaturates bright values for a more realistic appearance. Slightly slower than :ref:`TONE_MAPPER_FILMIC<class_Environment_constant_TONE_MAPPER_FILMIC>`.
\ **Note:** This tonemapping operator is called "ACES Fitted" in Godot 3.x.
.. _class_Environment_constant_TONE_MAPPER_AGX:
.. rst-class:: classref-enumeration-constant
:ref:`ToneMapper<enum_Environment_ToneMapper>` **TONE_MAPPER_AGX** = ``4``
Uses an adjustable film-like tonemapping curve and desaturates bright values for a more realistic appearance. Better than other tonemappers at maintaining the hue of colors as they become brighter. The slowest tonemapping option.
.. rst-class:: classref-item-separator
----
.. _enum_Environment_GlowBlendMode:
.. rst-class:: classref-enumeration
enum **GlowBlendMode**: :ref:`🔗<enum_Environment_GlowBlendMode>`
.. _class_Environment_constant_GLOW_BLEND_MODE_ADDITIVE:
.. rst-class:: classref-enumeration-constant
:ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **GLOW_BLEND_MODE_ADDITIVE** = ``0``
Adds the glow effect to the scene.
.. _class_Environment_constant_GLOW_BLEND_MODE_SCREEN:
.. rst-class:: classref-enumeration-constant
:ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **GLOW_BLEND_MODE_SCREEN** = ``1``
Adds the glow effect to the scene after modifying the glow influence based on the scene value; dark values will be highly influenced by glow and bright values will not be influenced by glow. This approach avoids bright values becoming overly bright from the glow effect. :ref:`tonemap_white<class_Environment_property_tonemap_white>` is used to determine the maximum scene value where the glow should have no influence. When :ref:`tonemap_mode<class_Environment_property_tonemap_mode>` is set to :ref:`TONE_MAPPER_LINEAR<class_Environment_constant_TONE_MAPPER_LINEAR>`, a value of ``1.0`` will be used as the maximum scene value.
.. _class_Environment_constant_GLOW_BLEND_MODE_SOFTLIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **GLOW_BLEND_MODE_SOFTLIGHT** = ``2``
Adds the glow effect to the tonemapped image after modifying the glow influence based on the image value; dark values and bright values will not be influenced by glow and mid-range values will be highly influenced by glow. This approach avoids bright values becoming overly bright from the glow effect. The glow will have the largest influence on image values of ``0.25`` and will have no influence when applied to image values greater than ``1.0``.
.. _class_Environment_constant_GLOW_BLEND_MODE_REPLACE:
.. rst-class:: classref-enumeration-constant
:ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **GLOW_BLEND_MODE_REPLACE** = ``3``
Replaces all pixels' color by the glow effect. This can be used to simulate a full-screen blur effect by tweaking the glow parameters to match the original image's brightness or to preview glow configuration in the editor.
.. _class_Environment_constant_GLOW_BLEND_MODE_MIX:
.. rst-class:: classref-enumeration-constant
:ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **GLOW_BLEND_MODE_MIX** = ``4``
Mixes the glow image with the scene image. Best used with :ref:`glow_bloom<class_Environment_property_glow_bloom>` to avoid darkening the scene.
.. rst-class:: classref-item-separator
----
.. _enum_Environment_FogMode:
.. rst-class:: classref-enumeration
enum **FogMode**: :ref:`🔗<enum_Environment_FogMode>`
.. _class_Environment_constant_FOG_MODE_EXPONENTIAL:
.. rst-class:: classref-enumeration-constant
:ref:`FogMode<enum_Environment_FogMode>` **FOG_MODE_EXPONENTIAL** = ``0``
Utiliser un modèle de brouillard physique défini principalement par la densité du brouillard.
.. _class_Environment_constant_FOG_MODE_DEPTH:
.. rst-class:: classref-enumeration-constant
:ref:`FogMode<enum_Environment_FogMode>` **FOG_MODE_DEPTH** = ``1``
Utiliser un modèle de brouillard simple défini par les positions de démarrage et de fin et une courbe personnalisée. Bien qu'il ne soit pas physiquement exact, ce modèle peut être utile lorsque vous avez besoin d'un contrôle plus artistique.
.. rst-class:: classref-item-separator
----
.. _enum_Environment_SDFGIYScale:
.. rst-class:: classref-enumeration
enum **SDFGIYScale**: :ref:`🔗<enum_Environment_SDFGIYScale>`
.. _class_Environment_constant_SDFGI_Y_SCALE_50_PERCENT:
.. rst-class:: classref-enumeration-constant
:ref:`SDFGIYScale<enum_Environment_SDFGIYScale>` **SDFGI_Y_SCALE_50_PERCENT** = ``0``
Utiliser une échelle de 50% pour la SDFGI sur l'axe Y (vertical). Les cellules de la SDFGI seront deux fois plus courtes que larges. Cela permet d'augmenter les détails de la GI et de réduire les fuites de lumière avec des sols et des plafonds minces. Il s'agit généralement du meilleur choix pour les scènes qui ne présentent pas beaucoup de verticalité.
.. _class_Environment_constant_SDFGI_Y_SCALE_75_PERCENT:
.. rst-class:: classref-enumeration-constant
:ref:`SDFGIYScale<enum_Environment_SDFGIYScale>` **SDFGI_Y_SCALE_75_PERCENT** = ``1``
Utiliser une échelle de 75% pour la SDFGI sur l'axe Y (vertical). Il s'agit d'un équilibre entre les échelles en Y 50% et 100% de la SDFGI.
.. _class_Environment_constant_SDFGI_Y_SCALE_100_PERCENT:
.. rst-class:: classref-enumeration-constant
:ref:`SDFGIYScale<enum_Environment_SDFGIYScale>` **SDFGI_Y_SCALE_100_PERCENT** = ``2``
Utiliser une échelle de 100% pour la SDFGI sur l'axe Y (vertical). Les cellules de la SDFGI seront deux fois plus grandes que larges. Il s'agit généralement du meilleur choix pour les scènes très verticales. Le désavantage est que les fuites de lumières peuvent être plus visibles avec des sols et des plafonds minces.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descriptions des propriétés
------------------------------------------------------
.. _class_Environment_property_adjustment_brightness:
.. rst-class:: classref-property
:ref:`float<class_float>` **adjustment_brightness** = ``1.0`` :ref:`🔗<class_Environment_property_adjustment_brightness>`
.. rst-class:: classref-property-setget
- |void| **set_adjustment_brightness**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_adjustment_brightness**\ (\ )
Applies a simple brightness adjustment to the rendered image after tonemaping. To adjust scene brightness use :ref:`tonemap_exposure<class_Environment_property_tonemap_exposure>` instead, which is applied before tonemapping and thus less prone to issues with bright colors. Effective only if :ref:`adjustment_enabled<class_Environment_property_adjustment_enabled>` is ``true``.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_adjustment_color_correction:
.. rst-class:: classref-property
:ref:`Texture<class_Texture>` **adjustment_color_correction** :ref:`🔗<class_Environment_property_adjustment_color_correction>`
.. rst-class:: classref-property-setget
- |void| **set_adjustment_color_correction**\ (\ value\: :ref:`Texture<class_Texture>`\ )
- :ref:`Texture<class_Texture>` **get_adjustment_color_correction**\ (\ )
La table de recherche de :ref:`Texture2D<class_Texture2D>` ou :ref:`Texture3D<class_Texture3D>` ("LookUp Table") à utiliser pour l'étalonnage des couleurs du post-traitement intégré. Peut utiliser une :ref:`GradientTexture1D<class_GradientTexture1D>` pour un LUT 1-dimensionnel, ou une :ref:`Texture3D<class_Texture3D>` pour un LUT plus complexe. Effectif seulement si :ref:`adjustment_enabled<class_Environment_property_adjustment_enabled>` vaut ``true``.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_adjustment_contrast:
.. rst-class:: classref-property
:ref:`float<class_float>` **adjustment_contrast** = ``1.0`` :ref:`🔗<class_Environment_property_adjustment_contrast>`
.. rst-class:: classref-property-setget
- |void| **set_adjustment_contrast**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_adjustment_contrast**\ (\ )
Increasing :ref:`adjustment_contrast<class_Environment_property_adjustment_contrast>` will make dark values darker and bright values brighter. This simple adjustment is applied to the rendered image after tonemaping. When set to a value greater than ``1.0``, :ref:`adjustment_contrast<class_Environment_property_adjustment_contrast>` is prone to clipping colors that become too bright or too dark. Effective only if :ref:`adjustment_enabled<class_Environment_property_adjustment_enabled>` is ``true``.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_adjustment_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **adjustment_enabled** = ``false`` :ref:`🔗<class_Environment_property_adjustment_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_adjustment_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_adjustment_enabled**\ (\ )
Si ``true``, active les propriétés ``adjustment_*`` fournies par cette ressource. Si ``false``, les modifications aux propriétés ``adjustment_*`` n'auront aucun effet sur la scène rendue.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_adjustment_saturation:
.. rst-class:: classref-property
:ref:`float<class_float>` **adjustment_saturation** = ``1.0`` :ref:`🔗<class_Environment_property_adjustment_saturation>`
.. rst-class:: classref-property-setget
- |void| **set_adjustment_saturation**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_adjustment_saturation**\ (\ )
Applies a simple saturation adjustment to the rendered image after tonemaping. When :ref:`adjustment_saturation<class_Environment_property_adjustment_saturation>` is set to ``0.0``, the rendered image will be fully converted to a grayscale image. Effective only if :ref:`adjustment_enabled<class_Environment_property_adjustment_enabled>` is ``true``.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ambient_light_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **ambient_light_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_Environment_property_ambient_light_color>`
.. rst-class:: classref-property-setget
- |void| **set_ambient_light_color**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_ambient_light_color**\ (\ )
La :ref:`Color<class_Color>` de la lumière ambiante. Seulement effectif si :ref:`ambient_light_sky_contribution<class_Environment_property_ambient_light_sky_contribution>` est inférieur à ``1.0`` (exclusif).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ambient_light_energy:
.. rst-class:: classref-property
:ref:`float<class_float>` **ambient_light_energy** = ``1.0`` :ref:`🔗<class_Environment_property_ambient_light_energy>`
.. rst-class:: classref-property-setget
- |void| **set_ambient_light_energy**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ambient_light_energy**\ (\ )
L'énergie de la lumière ambiante. Plus la valeur est élevée, plus la lumière est forte. Seulement efficace si :ref:`ambient_light_sky_contribution<class_Environment_property_ambient_light_sky_contribution>` est inférieur à ``1.0`` (exclusif).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ambient_light_sky_contribution:
.. rst-class:: classref-property
:ref:`float<class_float>` **ambient_light_sky_contribution** = ``1.0`` :ref:`🔗<class_Environment_property_ambient_light_sky_contribution>`
.. rst-class:: classref-property-setget
- |void| **set_ambient_light_sky_contribution**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ambient_light_sky_contribution**\ (\ )
Définit la quantité de lumière que le ciel apporte à la scène. Une valeur de ``0.0`` signifie que l'émission de lumière du ciel n'a aucun effet sur l'éclairage de la scène, de sorte que tout l'éclairage ambiant est fourni par la lumière ambiante. Au contraire, une valeur de ``1.0`` signifie que *toute* la lumière qui affecte la scène est fournie par le ciel, donc le paramètre de lumière ambiante n'a aucun effet sur la scène.
\ **Note :** :ref:`ambient_light_sky_contribution<class_Environment_property_ambient_light_sky_contribution>` est borné en interne entre ``0.0`` et ``1.0`` (inclusifs).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ambient_light_source:
.. rst-class:: classref-property
:ref:`AmbientSource<enum_Environment_AmbientSource>` **ambient_light_source** = ``0`` :ref:`🔗<class_Environment_property_ambient_light_source>`
.. rst-class:: classref-property-setget
- |void| **set_ambient_source**\ (\ value\: :ref:`AmbientSource<enum_Environment_AmbientSource>`\ )
- :ref:`AmbientSource<enum_Environment_AmbientSource>` **get_ambient_source**\ (\ )
La source de lumière ambiante à utiliser pour le rendu des matériaux et l'illumination globale.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_background_camera_feed_id:
.. rst-class:: classref-property
:ref:`int<class_int>` **background_camera_feed_id** = ``1`` :ref:`🔗<class_Environment_property_background_camera_feed_id>`
.. rst-class:: classref-property-setget
- |void| **set_camera_feed_id**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_camera_feed_id**\ (\ )
L'identifiant du flux de la caméra à afficher en arrière-plan.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_background_canvas_max_layer:
.. rst-class:: classref-property
:ref:`int<class_int>` **background_canvas_max_layer** = ``0`` :ref:`🔗<class_Environment_property_background_canvas_max_layer>`
.. rst-class:: classref-property-setget
- |void| **set_canvas_max_layer**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_canvas_max_layer**\ (\ )
L'ID de couche maximale à afficher. Seulement effectif lors de l'utilisation du mode d'arrière-plan :ref:`BG_CANVAS<class_Environment_constant_BG_CANVAS>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_background_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **background_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_Environment_property_background_color>`
.. rst-class:: classref-property-setget
- |void| **set_bg_color**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_bg_color**\ (\ )
La :ref:`Color<class_Color>` affichée pour les zones vides de la scène. Seulement effectif lors de l'utilisation du mode d'arrière-plan :ref:`BG_COLOR<class_Environment_constant_BG_COLOR>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_background_energy_multiplier:
.. rst-class:: classref-property
:ref:`float<class_float>` **background_energy_multiplier** = ``1.0`` :ref:`🔗<class_Environment_property_background_energy_multiplier>`
.. rst-class:: classref-property-setget
- |void| **set_bg_energy_multiplier**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_bg_energy_multiplier**\ (\ )
Multiplicateur pour l'énergie de l'arrière-plan. Augmentez pour rendre le fond plus clair, diminuer pour rendre le fond plus sombre.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_background_intensity:
.. rst-class:: classref-property
:ref:`float<class_float>` **background_intensity** = ``30000.0`` :ref:`🔗<class_Environment_property_background_intensity>`
.. rst-class:: classref-property-setget
- |void| **set_bg_intensity**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_bg_intensity**\ (\ )
Luminance de l'arrière-plan mesurée en nits (candela par mètre carré). Seulement utilisé lorsque :ref:`ProjectSettings.rendering/lights_and_shadows/use_physical_light_units<class_ProjectSettings_property_rendering/lights_and_shadows/use_physical_light_units>` est activé. La valeur par défaut est à peu près équivalente au ciel à midi.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_background_mode:
.. rst-class:: classref-property
:ref:`BGMode<enum_Environment_BGMode>` **background_mode** = ``0`` :ref:`🔗<class_Environment_property_background_mode>`
.. rst-class:: classref-property-setget
- |void| **set_background**\ (\ value\: :ref:`BGMode<enum_Environment_BGMode>`\ )
- :ref:`BGMode<enum_Environment_BGMode>` **get_background**\ (\ )
Le mode d'arrière-plan.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_aerial_perspective:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_aerial_perspective** = ``0.0`` :ref:`🔗<class_Environment_property_fog_aerial_perspective>`
.. rst-class:: classref-property-setget
- |void| **set_fog_aerial_perspective**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_aerial_perspective**\ (\ )
Si défini au dessus de ``0.0`` (exclusif), mélange la couleur du brouillard et la couleur du :ref:`Sky<class_Sky>` d'arrière-plan, comme lu de cubemap de radiance. Cela a un petit coût de performance lorsque défini au dessus de ``0.0``. Doit avoir :ref:`background_mode<class_Environment_property_background_mode>` défini à :ref:`BG_SKY<class_Environment_constant_BG_SKY>`.
Ceci est utile pour simuler la `perspective aérienne <https://fr.wikipedia.org/wiki/Perspective_a%C3%A9rienne>`__ dans de grandes scènes avec un brouillard à faible densité. Cependant, il n'est pas très utile pour le brouillard de haute densité, car le ciel brillera à travers. Lorsque défini à ``1.0``, la couleur du brouillard provient entièrement du :ref:`Sky<class_Sky>`. Si défini à ``0.0``, la perspective aérienne est désactivée.
Notez que cela n'échantillonne pas le :ref:`Sky<class_Sky>` directement, mais plutôt la cubemap de radiance. La cubemap est échantillonnée à un niveau de mipmap dépendant de la profondeur du pixel rendu, plus il est loin, plus la résolution de la mipmap échantillonnée est élevée. Cela résulte en la couleur réelle étant une version floue de celle du ciel, avec plus de flou lorsque plus proche de la caméra. La plus haute résolution de mipmap est utilisée à une profondeur de :ref:`Camera3D.far<class_Camera3D_property_far>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_density:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_density** = ``0.01`` :ref:`🔗<class_Environment_property_fog_density>`
.. rst-class:: classref-property-setget
- |void| **set_fog_density**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_density**\ (\ )
La densité de brouillard à utiliser. Ceci est démontré de différentes manières selon le mode :ref:`fog_mode<class_Environment_property_fog_mode>` choisi :
\ **Mode de brouillard exponentiel :** Des valeurs plus élevées résultent en un brouillard plus dense. Le rendu du brouillard est exponentiel comme dans la vie réelle.
\ **Mode de brouillard de profondeur :** L'intensité maximale du brouillard profond, l'effet apparaîtra à une certaine distance (relative à la caméra). À ``1.0``, le brouillard occultera entièrement la scène, à ``0.0``, le brouillard ne sera pas visible.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_depth_begin:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_depth_begin** = ``10.0`` :ref:`🔗<class_Environment_property_fog_depth_begin>`
.. rst-class:: classref-property-setget
- |void| **set_fog_depth_begin**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_depth_begin**\ (\ )
La distance de départ à partir de la caméra de la profondeur du brouillard. Seulement disponible lorsque :ref:`fog_mode<class_Environment_property_fog_mode>` est défini à :ref:`FOG_MODE_DEPTH<class_Environment_constant_FOG_MODE_DEPTH>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_depth_curve:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_depth_curve** = ``1.0`` :ref:`🔗<class_Environment_property_fog_depth_curve>`
.. rst-class:: classref-property-setget
- |void| **set_fog_depth_curve**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_depth_curve**\ (\ )
La courbe d'intensité de la profondeur brouillard. Un certain nombre de pré-réglages sont disponibles dans l'Inspecteur en faisant un clic droit sur la courbe. Seulement disponible lorsque :ref:`fog_mode<class_Environment_property_fog_mode>` est défini à :ref:`FOG_MODE_DEPTH<class_Environment_constant_FOG_MODE_DEPTH>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_depth_end:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_depth_end** = ``100.0`` :ref:`🔗<class_Environment_property_fog_depth_end>`
.. rst-class:: classref-property-setget
- |void| **set_fog_depth_end**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_depth_end**\ (\ )
La distance de fin à partir de la caméra de la profondeur du brouillard. Si cette valeur est défini à ``0``, elle sera égale à la valeur de :ref:`Camera3D.far<class_Camera3D_property_far>` de la caméra actuelle. Seulement disponible lorsque :ref:`fog_mode<class_Environment_property_fog_mode>` est défini à :ref:`FOG_MODE_DEPTH<class_Environment_constant_FOG_MODE_DEPTH>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **fog_enabled** = ``false`` :ref:`🔗<class_Environment_property_fog_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_fog_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_fog_enabled**\ (\ )
Si ``true``, les effets de brouillard sont activés.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_height:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_height** = ``0.0`` :ref:`🔗<class_Environment_property_fog_height>`
.. rst-class:: classref-property-setget
- |void| **set_fog_height**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_height**\ (\ )
La hauteur à laquelle commence l'effet de brouillard de hauteur.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_height_density:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_height_density** = ``0.0`` :ref:`🔗<class_Environment_property_fog_height_density>`
.. rst-class:: classref-property-setget
- |void| **set_fog_height_density**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_height_density**\ (\ )
La densité utilisée pour augmenter le brouillard à mesure que la hauteur diminue. Pour augmenter le brouillard à mesure que la hauteur augmente, utilisez une valeur négative.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_light_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **fog_light_color** = ``Color(0.518, 0.553, 0.608, 1)`` :ref:`🔗<class_Environment_property_fog_light_color>`
.. rst-class:: classref-property-setget
- |void| **set_fog_light_color**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_fog_light_color**\ (\ )
La couleur du brouillard.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_light_energy:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_light_energy** = ``1.0`` :ref:`🔗<class_Environment_property_fog_light_energy>`
.. rst-class:: classref-property-setget
- |void| **set_fog_light_energy**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_light_energy**\ (\ )
La luminosité du brouillard. Des valeurs plus élevées entraînent un brouillard plus lumineux.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_mode:
.. rst-class:: classref-property
:ref:`FogMode<enum_Environment_FogMode>` **fog_mode** = ``0`` :ref:`🔗<class_Environment_property_fog_mode>`
.. rst-class:: classref-property-setget
- |void| **set_fog_mode**\ (\ value\: :ref:`FogMode<enum_Environment_FogMode>`\ )
- :ref:`FogMode<enum_Environment_FogMode>` **get_fog_mode**\ (\ )
Le mode du brouillard.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_sky_affect:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_sky_affect** = ``1.0`` :ref:`🔗<class_Environment_property_fog_sky_affect>`
.. rst-class:: classref-property-setget
- |void| **set_fog_sky_affect**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_sky_affect**\ (\ )
Le facteur à utiliser lorsque le ciel est affecté avec un brouillard non volumétrique. ``1.0`` signifie que le brouillard peut masquer pleinement le ciel. Les valeurs inférieures réduisent l'impact du brouillard sur le rendu du ciel, avec ``0.0`` qui n'affecte pas le rendu du ciel.
\ **Note :** :ref:`fog_sky_affect<class_Environment_property_fog_sky_affect>` n'a aucun effet visuel si :ref:`fog_aerial_perspective<class_Environment_property_fog_aerial_perspective>` vaut ``1.0``.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_fog_sun_scatter:
.. rst-class:: classref-property
:ref:`float<class_float>` **fog_sun_scatter** = ``0.0`` :ref:`🔗<class_Environment_property_fog_sun_scatter>`
.. rst-class:: classref-property-setget
- |void| **set_fog_sun_scatter**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_fog_sun_scatter**\ (\ )
Si définie au-dessus de ``0.0``, rend la/les lumière(s) directionnelle(s) de la scène avec la couleur du brouillard selon l'angle de vue. Cela peut être utilisé pour donner l'impression que le soleil est "perce" à travers le brouillard.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_blend_mode:
.. rst-class:: classref-property
:ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **glow_blend_mode** = ``1`` :ref:`🔗<class_Environment_property_glow_blend_mode>`
.. rst-class:: classref-property-setget
- |void| **set_glow_blend_mode**\ (\ value\: :ref:`GlowBlendMode<enum_Environment_GlowBlendMode>`\ )
- :ref:`GlowBlendMode<enum_Environment_GlowBlendMode>` **get_glow_blend_mode**\ (\ )
The glow blending mode.
\ **Note:** The Compatibility renderer always uses :ref:`GLOW_BLEND_MODE_SCREEN<class_Environment_constant_GLOW_BLEND_MODE_SCREEN>` and :ref:`glow_blend_mode<class_Environment_property_glow_blend_mode>` will have no effect.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_bloom:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_bloom** = ``0.0`` :ref:`🔗<class_Environment_property_glow_bloom>`
.. rst-class:: classref-property-setget
- |void| **set_glow_bloom**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_bloom**\ (\ )
L'intensité du flou lumineux. Si la valeur est supérieure à ``0``, cela rend le glow visible dans les zones plus foncées que le seuil :ref:`glow_hdr_threshold<class_Environment_property_glow_hdr_threshold>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **glow_enabled** = ``false`` :ref:`🔗<class_Environment_property_glow_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_glow_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_glow_enabled**\ (\ )
If ``true``, the glow effect is enabled. This simulates real world atmosphere and eye/camera behavior by causing bright pixels to bleed onto surrounding pixels.
\ **Note:** When using the Mobile rendering method, glow looks different due to the lower dynamic range available in the Mobile rendering method.
\ **Note:** When using the Compatibility rendering method, glow uses a different implementation with some properties being unavailable and hidden from the inspector: ``glow_levels/*``, :ref:`glow_normalized<class_Environment_property_glow_normalized>`, :ref:`glow_strength<class_Environment_property_glow_strength>`, :ref:`glow_blend_mode<class_Environment_property_glow_blend_mode>`, :ref:`glow_mix<class_Environment_property_glow_mix>`, :ref:`glow_map<class_Environment_property_glow_map>`, and :ref:`glow_map_strength<class_Environment_property_glow_map_strength>`. This implementation is optimized to run on low-end devices and is less flexible as a result.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_hdr_luminance_cap:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_hdr_luminance_cap** = ``12.0`` :ref:`🔗<class_Environment_property_glow_hdr_luminance_cap>`
.. rst-class:: classref-property-setget
- |void| **set_glow_hdr_luminance_cap**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_hdr_luminance_cap**\ (\ )
Le seuil supérieur du glow HDR. Les zones plus lumineuses que ce seuil seront bornées pour l’effet de glow.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_hdr_scale:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_hdr_scale** = ``2.0`` :ref:`🔗<class_Environment_property_glow_hdr_scale>`
.. rst-class:: classref-property-setget
- |void| **set_glow_hdr_bleed_scale**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_hdr_bleed_scale**\ (\ )
Smooths the transition between values that are below and above :ref:`glow_hdr_threshold<class_Environment_property_glow_hdr_threshold>` by reducing the amount of glow generated by values that are close to :ref:`glow_hdr_threshold<class_Environment_property_glow_hdr_threshold>`. Values above ``glow_hdr_threshold + glow_hdr_scale`` will not have glow reduced in this way.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_hdr_threshold:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_hdr_threshold** = ``1.0`` :ref:`🔗<class_Environment_property_glow_hdr_threshold>`
.. rst-class:: classref-property-setget
- |void| **set_glow_hdr_bleed_threshold**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_hdr_bleed_threshold**\ (\ )
Le seuil inférieur du glow HDR. Lors de l'utilisation de la méthode de rendu Mobile (qui ne supporte qu'une plage dynamique inférieure, jusqu'à ``2.0``), cela peut devoir être inférieur à ``1.0`` pour que le glow soit visible. Une valeur de ``0.9`` fonctionne bien dans ce cas. Cette valeur doit également être diminuée en dessous de ``1.0`` lorsque l'on utilise du glow en 2D, car le rendu 2D est effectué en SDR (plage dynamique standard).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_intensity:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_intensity** = ``0.3`` :ref:`🔗<class_Environment_property_glow_intensity>`
.. rst-class:: classref-property-setget
- |void| **set_glow_intensity**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_intensity**\ (\ )
The overall brightness multiplier that is applied to the glow effect just before it is blended with the scene. When using the Mobile rendering method (which only supports a lower dynamic range up to ``2.0``), this should be increased to ``1.5`` to compensate.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_levels/1:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_levels/1** = ``0.0`` :ref:`🔗<class_Environment_property_glow_levels/1>`
.. rst-class:: classref-property-setget
- |void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const|
L'intensité du 1er niveau du glow. C'est le niveau le plus "local" (le moins flou).
\ **Note :** :ref:`glow_levels/1<class_Environment_property_glow_levels/1>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_levels/2:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_levels/2** = ``0.8`` :ref:`🔗<class_Environment_property_glow_levels/2>`
.. rst-class:: classref-property-setget
- |void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const|
L'intensité du 2ème niveau du glow.
\ **Note :** :ref:`glow_levels/2<class_Environment_property_glow_levels/2>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_levels/3:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_levels/3** = ``0.4`` :ref:`🔗<class_Environment_property_glow_levels/3>`
.. rst-class:: classref-property-setget
- |void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const|
L'intensité du 3ème niveau du glow.
\ **Note :** :ref:`glow_levels/3<class_Environment_property_glow_levels/3>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_levels/4:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_levels/4** = ``0.1`` :ref:`🔗<class_Environment_property_glow_levels/4>`
.. rst-class:: classref-property-setget
- |void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const|
L'intensité du 4ème niveau du glow.
\ **Note :** :ref:`glow_levels/4<class_Environment_property_glow_levels/4>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_levels/5:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_levels/5** = ``0.0`` :ref:`🔗<class_Environment_property_glow_levels/5>`
.. rst-class:: classref-property-setget
- |void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const|
L'intensité du 5ème niveau du glow.
\ **Note :** :ref:`glow_levels/5<class_Environment_property_glow_levels/5>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_levels/6:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_levels/6** = ``0.0`` :ref:`🔗<class_Environment_property_glow_levels/6>`
.. rst-class:: classref-property-setget
- |void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const|
L'intensité du 6ème niveau du glow.
\ **Note :** :ref:`glow_levels/6<class_Environment_property_glow_levels/6>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_levels/7:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_levels/7** = ``0.0`` :ref:`🔗<class_Environment_property_glow_levels/7>`
.. rst-class:: classref-property-setget
- |void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const|
L'intensité du 7ème niveau du glow. Il s'agit du niveau le plus "global" (le plus flou).
\ **Note :** :ref:`glow_levels/7<class_Environment_property_glow_levels/7>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_map:
.. rst-class:: classref-property
:ref:`Texture<class_Texture>` **glow_map** :ref:`🔗<class_Environment_property_glow_map>`
.. rst-class:: classref-property-setget
- |void| **set_glow_map**\ (\ value\: :ref:`Texture<class_Texture>`\ )
- :ref:`Texture<class_Texture>` **get_glow_map**\ (\ )
La texture qui devrait être utilisée comme glow map pour *multiplier* la couleur de glow résultante selon :ref:`glow_map_strength<class_Environment_property_glow_map_strength>`. Cela peut être utilisé pour créer un effet de "lentille sale". Les canaux de couleur RGB de la texture sont utilisés pour la modulation, mais le canal alpha est ignoré.
\ **Note :** La texture sera étirée pour s'adapter à l'écran. Par conséquent, il est recommandé d'utiliser une texture avec un rapport d'aspect qui correspond au rapport d'aspect de base de votre projet (généralement 16:9).
\ **Note :** :ref:`glow_map<class_Environment_property_glow_map>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_map_strength:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_map_strength** = ``0.8`` :ref:`🔗<class_Environment_property_glow_map_strength>`
.. rst-class:: classref-property-setget
- |void| **set_glow_map_strength**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_map_strength**\ (\ )
La force d'influence que la :ref:`glow_map<class_Environment_property_glow_map>` devrait avoir sur l'effet de glow global. Une force de ``0.0`` signifie que la glow map n'a pas d'influence, alors qu'une force de ``1.0`` signifie que la glow map a une influence complète.
\ **Note :** Si la glow map a des zones noires, une valeur de ``1.0`` peut également éteindre l'effet de glow entièrement dans ces zones spécifiques de l'écran.
\ **Note :** :ref:`glow_map_strength<class_Environment_property_glow_map_strength>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_mix:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_mix** = ``0.05`` :ref:`🔗<class_Environment_property_glow_mix>`
.. rst-class:: classref-property-setget
- |void| **set_glow_mix**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_mix**\ (\ )
Lors de l'utilisation du mode de mélange :ref:`glow_blend_mode<class_Environment_property_glow_blend_mode>` :ref:`GLOW_BLEND_MODE_MIX<class_Environment_constant_GLOW_BLEND_MODE_MIX>`, cela contrôle de combien l'image source est mélangée avec la couche de glow. Une valeur de ``0.0`` rend le rendu du glow invisible, alors qu'une valeur de ``1.0`` est équivalente à :ref:`GLOW_BLEND_MODE_REPLACE<class_Environment_constant_GLOW_BLEND_MODE_REPLACE>`.
\ **Note :** :ref:`glow_mix<class_Environment_property_glow_mix>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_normalized:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **glow_normalized** = ``false`` :ref:`🔗<class_Environment_property_glow_normalized>`
.. rst-class:: classref-property-setget
- |void| **set_glow_normalized**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_glow_normalized**\ (\ )
Si ``true``, les niveaux de glow seront normalisés de sorte que la somme de leurs intensités soit égale à ``1.0``.
\ **Note :** :ref:`glow_normalized<class_Environment_property_glow_normalized>` n'a aucun effet lors de l'utilisation de la méthode de rendu Compatibilité, en raison de cette méthode de rendu utilisant une simple implémentation du glow optimisée pour les appareils bas de gamme.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_glow_strength:
.. rst-class:: classref-property
:ref:`float<class_float>` **glow_strength** = ``1.0`` :ref:`🔗<class_Environment_property_glow_strength>`
.. rst-class:: classref-property-setget
- |void| **set_glow_strength**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_glow_strength**\ (\ )
The strength that is used when blurring across the screen to generate the glow effect. This affects the distance and intensity of the blur. When using the Mobile rendering method, this should be increased to compensate for the lower dynamic range.
\ **Note:** :ref:`glow_strength<class_Environment_property_glow_strength>` has no effect when using the Compatibility rendering method, due to this rendering method using a simpler glow implementation optimized for low-end devices.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_reflected_light_source:
.. rst-class:: classref-property
:ref:`ReflectionSource<enum_Environment_ReflectionSource>` **reflected_light_source** = ``0`` :ref:`🔗<class_Environment_property_reflected_light_source>`
.. rst-class:: classref-property-setget
- |void| **set_reflection_source**\ (\ value\: :ref:`ReflectionSource<enum_Environment_ReflectionSource>`\ )
- :ref:`ReflectionSource<enum_Environment_ReflectionSource>` **get_reflection_source**\ (\ )
La source de lumineuse réfléchie (spéculaire).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_bounce_feedback:
.. rst-class:: classref-property
:ref:`float<class_float>` **sdfgi_bounce_feedback** = ``0.5`` :ref:`🔗<class_Environment_property_sdfgi_bounce_feedback>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_bounce_feedback**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sdfgi_bounce_feedback**\ (\ )
Le multiplicateur d'énergie appliqué à la lumière chaque fois qu'elle rebondit d'une surface lors de l'utilisation du SDFGI. Les valeurs supérieures à ``0.0`` simulent plusieurs rebonds, ce qui donne une apparence plus réaliste. Augmenter :ref:`sdfgi_bounce_feedback<class_Environment_property_sdfgi_bounce_feedback>` n'a généralement pas d'impact sur les performances. Voir aussi :ref:`sdfgi_energy<class_Environment_property_sdfgi_energy>`.
\ **Note :** Les valeurs supérieures à ``0.5`` peuvent provoquer des boucles de rétroaction infinies et devraient être évitées dans des scènes avec des matériaux clairs.
\ **Note :** Si :ref:`sdfgi_bounce_feedback<class_Environment_property_sdfgi_bounce_feedback>` vaut ``0.0``, l'éclairage indirect ne sera pas représenté dans les réflexions car la lumière ne rebondira qu'une fois.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_cascade0_distance:
.. rst-class:: classref-property
:ref:`float<class_float>` **sdfgi_cascade0_distance** = ``12.8`` :ref:`🔗<class_Environment_property_sdfgi_cascade0_distance>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_cascade0_distance**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sdfgi_cascade0_distance**\ (\ )
**Note :** Cette propriété est liée à :ref:`sdfgi_min_cell_size<class_Environment_property_sdfgi_min_cell_size>` et :ref:`sdfgi_max_distance<class_Environment_property_sdfgi_max_distance>`. Changer sa valeur va automatiquement aussi changer ces propriétés.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_cascades:
.. rst-class:: classref-property
:ref:`int<class_int>` **sdfgi_cascades** = ``4`` :ref:`🔗<class_Environment_property_sdfgi_cascades>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_cascades**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_sdfgi_cascades**\ (\ )
Le nombre de cascades à utiliser pour la SDFGI (entre 1 et 8). Un plus grand nombre de cascades permet d'afficher la SDFGI plus loin tout en préservant le détail à proximité, avec un coût sur la performance. Lors de l'utilisation de la SDFGI dans des niveaux à petite échelle, :ref:`sdfgi_cascades<class_Environment_property_sdfgi_cascades>` peut souvent être diminué entre ``1`` et ``4`` pour améliorer les performances.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **sdfgi_enabled** = ``false`` :ref:`🔗<class_Environment_property_sdfgi_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_sdfgi_enabled**\ (\ )
Si ``true``, active l'illumination globale par champ de distance signée (SDFGI) pour les maillages ayant leur :ref:`GeometryInstance3D.gi_mode<class_GeometryInstance3D_property_gi_mode>` défini à :ref:`GeometryInstance3D.GI_MODE_STATIC<class_GeometryInstance3D_constant_GI_MODE_STATIC>`. La SDFGI est une technique d'illumination globale en temps réel qui fonctionne bien avec les niveaux générés procéduralement ou construits par les utilisateurs, y compris dans les situations où la géométrie est créée durant le gameplay. Le champ de distance signée est généré automatiquement autour de la caméra pendant qu'elle se déplace. Les lumières dynamiques sont supportées, mais les occulteurs dynamiques et les surfaces émissives ne le sont pas.
\ **Note :** La SDFGI n'est supportée que dans la méthode de rendu Forward+, pas Mobile ou Compatibilité.
\ **Performance :** La SDFGI est relativement exigeante sur le GPU et n'est pas adaptée au matériel de bas de gamme tel que les graphismes intégrés (considérez plutôt :ref:`LightmapGI<class_LightmapGI>`). Pour améliorer la performance de la SDFGI, activez :ref:`ProjectSettings.rendering/global_illumination/gi/use_half_resolution<class_ProjectSettings_property_rendering/global_illumination/gi/use_half_resolution>` dans les paramètres du projet.
\ **Note :** Les maillages doivent avoir des parois suffisamment épaisses pour éviter les fuites de lumière (évitez les murs à un seul côté). Pour les niveaux en intérieur, enfermez votre géométrie du niveau dans une boîte suffisamment grande et collez les extrémités pour fermer le maillage.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_energy:
.. rst-class:: classref-property
:ref:`float<class_float>` **sdfgi_energy** = ``1.0`` :ref:`🔗<class_Environment_property_sdfgi_energy>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_energy**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sdfgi_energy**\ (\ )
Le multiplicateur d'énergie à utiliser pour la SDFGI. Des valeurs plus élevées résulteront un éclairage et des réflexions indirectes plus lumineux. Voir aussi :ref:`sdfgi_bounce_feedback<class_Environment_property_sdfgi_bounce_feedback>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_max_distance:
.. rst-class:: classref-property
:ref:`float<class_float>` **sdfgi_max_distance** = ``204.8`` :ref:`🔗<class_Environment_property_sdfgi_max_distance>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_max_distance**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sdfgi_max_distance**\ (\ )
La distance maximale à laquelle la SDFGI est visible. Au-delà de cette distance, l'éclairage de l'environnement ou d'autres sources d'illumination globale telles que les :ref:`ReflectionProbe<class_ReflectionProbe>`\ s seront utilisées en repli.
\ **Note :** Cette propriété est liée à :ref:`sdfgi_min_cell_size<class_Environment_property_sdfgi_min_cell_size>` et :ref:`sdfgi_cascade0_distance<class_Environment_property_sdfgi_cascade0_distance>`. Changer sa valeur va automatiquement aussi changer ces propriétés.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_min_cell_size:
.. rst-class:: classref-property
:ref:`float<class_float>` **sdfgi_min_cell_size** = ``0.2`` :ref:`🔗<class_Environment_property_sdfgi_min_cell_size>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_min_cell_size**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sdfgi_min_cell_size**\ (\ )
La taille de cellule à utiliser pour la cascade de SDFGI la plus proche (en unités 3D). Les valeurs inférieures permettent à la SDFGI d'être plus précise, au prix de rendre les mises à jour de la SDFGI plus exigeantes. Cela peut causer du stuttering lorsque la caméra se déplace rapidement. Des valeurs plus élevées permettent à la SDFGI de couvrir plus de terrain, tout en réduisant l'impact sur la performance des mises à jour de la SDFGI.
\ **Note :** Cette propriété est liée à :ref:`sdfgi_max_distance<class_Environment_property_sdfgi_max_distance>` et :ref:`sdfgi_cascade0_distance<class_Environment_property_sdfgi_cascade0_distance>`. Changer sa valeur va automatiquement aussi changer ces propriétés.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_normal_bias:
.. rst-class:: classref-property
:ref:`float<class_float>` **sdfgi_normal_bias** = ``1.1`` :ref:`🔗<class_Environment_property_sdfgi_normal_bias>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_normal_bias**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sdfgi_normal_bias**\ (\ )
Le biais des normales à utiliser pour les sondes de la SDFGI. L'augmentation de cette valeur peut réduire les artefacts de traînées visibles sur les surfaces en pente, au coût de fuites de lumière accrues.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_probe_bias:
.. rst-class:: classref-property
:ref:`float<class_float>` **sdfgi_probe_bias** = ``1.1`` :ref:`🔗<class_Environment_property_sdfgi_probe_bias>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_probe_bias**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sdfgi_probe_bias**\ (\ )
Le biais constant à utiliser pour les sondes de la SDFGI. L'augmentation de cette valeur peut réduire les artefacts de traînées visibles sur les surfaces en pente, au coût de fuites de lumière accrues.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_read_sky_light:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **sdfgi_read_sky_light** = ``true`` :ref:`🔗<class_Environment_property_sdfgi_read_sky_light>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_read_sky_light**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_sdfgi_reading_sky_light**\ (\ )
Si ``true``, la SDFGI prend en compte l'éclairage de l'environnement. Cela devrait être défini sur ``false`` pour les scènes en intérieur.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_use_occlusion:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **sdfgi_use_occlusion** = ``false`` :ref:`🔗<class_Environment_property_sdfgi_use_occlusion>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_use_occlusion**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_sdfgi_using_occlusion**\ (\ )
Si ``true``, la SDFGI utilise une approche de détection d'occlusion pour réduire les fuites de lumière. L'occlusion peut cependant introduire des taches sombres à certains endroits, qui peuvent être indésirables dans les scènes principalement en extérieur. :ref:`sdfgi_use_occlusion<class_Environment_property_sdfgi_use_occlusion>` a un impact sur les performances et ne devrait être activé que lorsque nécessaire.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sdfgi_y_scale:
.. rst-class:: classref-property
:ref:`SDFGIYScale<enum_Environment_SDFGIYScale>` **sdfgi_y_scale** = ``1`` :ref:`🔗<class_Environment_property_sdfgi_y_scale>`
.. rst-class:: classref-property-setget
- |void| **set_sdfgi_y_scale**\ (\ value\: :ref:`SDFGIYScale<enum_Environment_SDFGIYScale>`\ )
- :ref:`SDFGIYScale<enum_Environment_SDFGIYScale>` **get_sdfgi_y_scale**\ (\ )
L'échelle Y à utiliser pour les cellules de la SDFGI. Les valeurs inférieures résulteront en des cellules SDFGI regroupées plus étroitement sur l'axe Y. Ceci est utilisé pour équilibrer entre la qualité et couvrir beaucoup de terrain vertical. :ref:`sdfgi_y_scale<class_Environment_property_sdfgi_y_scale>` doit être défini en fonction de la verticalité de votre scène (et de la vitesse à laquelle votre caméra peut déplacer sur l'axe Y).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sky:
.. rst-class:: classref-property
:ref:`Sky<class_Sky>` **sky** :ref:`🔗<class_Environment_property_sky>`
.. rst-class:: classref-property-setget
- |void| **set_sky**\ (\ value\: :ref:`Sky<class_Sky>`\ )
- :ref:`Sky<class_Sky>` **get_sky**\ (\ )
La ressource :ref:`Sky<class_Sky>` utilisée pour cet **Environment**.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sky_custom_fov:
.. rst-class:: classref-property
:ref:`float<class_float>` **sky_custom_fov** = ``0.0`` :ref:`🔗<class_Environment_property_sky_custom_fov>`
.. rst-class:: classref-property-setget
- |void| **set_sky_custom_fov**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_sky_custom_fov**\ (\ )
Si défini à une valeur supérieur à ``0.0``, redéfinit le champ de vision à utiliser pour le rendu du ciel. Si défini à ``0.0``, le même FOV que la :ref:`Camera3D<class_Camera3D>` actuelle est utilisé pour le rendu du ciel.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_sky_rotation:
.. rst-class:: classref-property
:ref:`Vector3<class_Vector3>` **sky_rotation** = ``Vector3(0, 0, 0)`` :ref:`🔗<class_Environment_property_sky_rotation>`
.. rst-class:: classref-property-setget
- |void| **set_sky_rotation**\ (\ value\: :ref:`Vector3<class_Vector3>`\ )
- :ref:`Vector3<class_Vector3>` **get_sky_rotation**\ (\ )
La rotation à utiliser pour le rendu du ciel.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_ao_channel_affect:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_ao_channel_affect** = ``0.0`` :ref:`🔗<class_Environment_property_ssao_ao_channel_affect>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_ao_channel_affect**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_ao_channel_affect**\ (\ )
L'intensité de l'occlusion ambiante de l'espace-écran sur les matériaux qui ont une texture d'occlusion ambiante définie. Des valeurs supérieures à ``0`` rendront l'effet SSAO visible dans les zones obscurcies par les textures d'occlusion ambiante.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_detail:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_detail** = ``0.5`` :ref:`🔗<class_Environment_property_ssao_detail>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_detail**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_detail**\ (\ )
Définit la force du niveau de détail supplémentaire pour l'effet d'occlusion ambiante de l'espace-écran. Une valeur élevée rend la passe de détails plus importante, mais peut contribuer à du crénelage dans votre image finale.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **ssao_enabled** = ``false`` :ref:`🔗<class_Environment_property_ssao_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_ssao_enabled**\ (\ )
If ``true``, the screen-space ambient occlusion effect is enabled. This darkens objects' corners and cavities to simulate ambient light not reaching the entire object as in real life. This works well for small, dynamic objects, but baked lighting or ambient occlusion textures will do a better job at displaying ambient occlusion on large static objects. Godot uses a form of SSAO called Adaptive Screen Space Ambient Occlusion which is itself a form of Horizon Based Ambient Occlusion.
\ **Note:** SSAO is only supported in the Forward+ and Compatibility rendering methods, not Mobile.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_horizon:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_horizon** = ``0.06`` :ref:`🔗<class_Environment_property_ssao_horizon>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_horizon**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_horizon**\ (\ )
The threshold for considering whether a given point on a surface is occluded or not represented as an angle from the horizon mapped into the ``0.0-1.0`` range. A value of ``1.0`` results in no occlusion.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_intensity:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_intensity** = ``2.0`` :ref:`🔗<class_Environment_property_ssao_intensity>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_intensity**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_intensity**\ (\ )
L'intensité de l'occlusion ambiante de l'espace-écran primaire. Agit comme un multiplicateur pour l'effet d'occlusion ambiante de l'espace-écran. Une valeur plus élevée résulte en une occlusion plus sombre.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_light_affect:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_light_affect** = ``0.0`` :ref:`🔗<class_Environment_property_ssao_light_affect>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_direct_light_affect**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_direct_light_affect**\ (\ )
L'intensité de l'occlusion ambiante dans l'espace écran sous lumière directe. Dans la vraie vie, l'occlusion ambiante ne s'applique qu'à la lumière indirecte, ce qui signifie que ses effets ne peuvent pas être vus sous lumière directe. Les valeurs supérieures à ``0`` rendront l'effet SSAO visible sous lumière directe.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_power:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_power** = ``1.5`` :ref:`🔗<class_Environment_property_ssao_power>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_power**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_power**\ (\ )
La distribution de l'occlusion. Une valeur plus élevée résulte en une occlusion plus sombre, semblable à :ref:`ssao_intensity<class_Environment_property_ssao_intensity>`, mais avec une décroissance plus nette.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_radius:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_radius** = ``1.0`` :ref:`🔗<class_Environment_property_ssao_radius>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_radius**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_radius**\ (\ )
La distance à laquelle des objets peuvent s'obstruer l'un l'autre lors du calcul de l'occlusion ambiante de l'espace-écran. Des valeurs plus élevées résulteront en de l'occlusion sur une plus grande distance au coût de la performance et de la qualité.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssao_sharpness:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssao_sharpness** = ``0.98`` :ref:`🔗<class_Environment_property_ssao_sharpness>`
.. rst-class:: classref-property-setget
- |void| **set_ssao_sharpness**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssao_sharpness**\ (\ )
La quantité avec laquelle l'effet d'occlusion ambiante de l'espace-écran est autorisé à flouter les bords des objets. Définir ceci trop élevé va résulter en du crénelage autour des bords des objets. Définir ceci trop bas va rendre les bords de l'objet flous.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssil_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **ssil_enabled** = ``false`` :ref:`🔗<class_Environment_property_ssil_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_ssil_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_ssil_enabled**\ (\ )
Si ``true``, l'effet d'éclairage indirect dans l'espace-écran (Screen-Space Indirect Lightning) est activé. L'éclairage indirect dans l'espace-écran est une forme d'éclairage indirect qui permet à la lumière diffuse de rebondir entre des objets voisins. L'éclairage indirect dans l'espace-écran fonctionne de manière très similaire à l'occlusion ambiante dans l'espace-écran, car il affecte seulement une plage limitée. Il est destiné à être utilisé avec une forme d'éclairage global appropriée comme SDFGI ou :ref:`VoxelGI<class_VoxelGI>`. L'éclairage indirect dans l'espace-écran n'est pas affecté par les :ref:`Light3D.light_indirect_energy<class_Light3D_property_light_indirect_energy>` de lumières individuelles.
\ **Note :** Le SSIL n'est supporté que dans la méthode de rendu Forward+, et non Mobile ou Compatibilité.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssil_intensity:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssil_intensity** = ``1.0`` :ref:`🔗<class_Environment_property_ssil_intensity>`
.. rst-class:: classref-property-setget
- |void| **set_ssil_intensity**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssil_intensity**\ (\ )
Le multiplicateur de luminosité pour l'effet d'éclairage indirect dans l'espace-écran. Une valeur plus élevée résultera en une lumière plus brillante.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssil_normal_rejection:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssil_normal_rejection** = ``1.0`` :ref:`🔗<class_Environment_property_ssil_normal_rejection>`
.. rst-class:: classref-property-setget
- |void| **set_ssil_normal_rejection**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssil_normal_rejection**\ (\ )
Amount of normal rejection used when calculating screen-space indirect lighting. Normal rejection uses the normal of a given sample point to reject samples that are facing away from the current pixel. Normal rejection is necessary to avoid light leaking when only one side of an object is illuminated. However, normal rejection can be disabled if light leaking is desirable, such as when the scene mostly contains emissive objects that emit light from faces that cannot be seen from the camera.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssil_radius:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssil_radius** = ``5.0`` :ref:`🔗<class_Environment_property_ssil_radius>`
.. rst-class:: classref-property-setget
- |void| **set_ssil_radius**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssil_radius**\ (\ )
The distance that bounced lighting can travel when using the screen space indirect lighting effect. A larger value will result in light bouncing further in a scene, but may result in under-sampling artifacts which look like long spikes surrounding light sources.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssil_sharpness:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssil_sharpness** = ``0.98`` :ref:`🔗<class_Environment_property_ssil_sharpness>`
.. rst-class:: classref-property-setget
- |void| **set_ssil_sharpness**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssil_sharpness**\ (\ )
The amount that the screen-space indirect lighting effect is allowed to blur over the edges of objects. Setting too high will result in aliasing around the edges of objects. Setting too low will make object edges appear blurry.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssr_depth_tolerance:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssr_depth_tolerance** = ``0.5`` :ref:`🔗<class_Environment_property_ssr_depth_tolerance>`
.. rst-class:: classref-property-setget
- |void| **set_ssr_depth_tolerance**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssr_depth_tolerance**\ (\ )
La tolérance de profondeur pour les réflexions sur l'espace de l'écran.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssr_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **ssr_enabled** = ``false`` :ref:`🔗<class_Environment_property_ssr_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_ssr_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_ssr_enabled**\ (\ )
If ``true``, screen-space reflections are enabled. Screen-space reflections are more accurate than reflections from :ref:`VoxelGI<class_VoxelGI>`\ s or :ref:`ReflectionProbe<class_ReflectionProbe>`\ s, but are slower and can't reflect surfaces occluded by others.
\ **Note:** SSR is only supported in the Forward+ rendering method, not Mobile or Compatibility.
\ **Note:** SSR is not supported on viewports that have a transparent background (where :ref:`Viewport.transparent_bg<class_Viewport_property_transparent_bg>` is ``true``).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssr_fade_in:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssr_fade_in** = ``0.15`` :ref:`🔗<class_Environment_property_ssr_fade_in>`
.. rst-class:: classref-property-setget
- |void| **set_ssr_fade_in**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssr_fade_in**\ (\ )
The fade-in distance for screen-space reflections. Affects the area from the reflected material to the screen-space reflection. Only positive values are valid (negative values will be clamped to ``0.0``).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssr_fade_out:
.. rst-class:: classref-property
:ref:`float<class_float>` **ssr_fade_out** = ``2.0`` :ref:`🔗<class_Environment_property_ssr_fade_out>`
.. rst-class:: classref-property-setget
- |void| **set_ssr_fade_out**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_ssr_fade_out**\ (\ )
The fade-out distance for screen-space reflections. Affects the area from the screen-space reflection to the "global" reflection. Only positive values are valid (negative values will be clamped to ``0.0``).
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_ssr_max_steps:
.. rst-class:: classref-property
:ref:`int<class_int>` **ssr_max_steps** = ``64`` :ref:`🔗<class_Environment_property_ssr_max_steps>`
.. rst-class:: classref-property-setget
- |void| **set_ssr_max_steps**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_ssr_max_steps**\ (\ )
Le nombre maximum d'étapes pour les réflexions de l'espace-écran (SSR). Les valeurs plus élevées sont plus lentes.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_tonemap_agx_contrast:
.. rst-class:: classref-property
:ref:`float<class_float>` **tonemap_agx_contrast** = ``1.25`` :ref:`🔗<class_Environment_property_tonemap_agx_contrast>`
.. rst-class:: classref-property-setget
- |void| **set_tonemap_agx_contrast**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_tonemap_agx_contrast**\ (\ )
Increasing :ref:`tonemap_agx_contrast<class_Environment_property_tonemap_agx_contrast>` will make dark values darker and bright values brighter. Produces a higher quality result than :ref:`adjustment_contrast<class_Environment_property_adjustment_contrast>` without any additional performance cost, but is only available when using the :ref:`TONE_MAPPER_AGX<class_Environment_constant_TONE_MAPPER_AGX>` tonemapper.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_tonemap_agx_white:
.. rst-class:: classref-property
:ref:`float<class_float>` **tonemap_agx_white** = ``16.29`` :ref:`🔗<class_Environment_property_tonemap_agx_white>`
.. rst-class:: classref-property-setget
- |void| **set_tonemap_agx_white**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_tonemap_agx_white**\ (\ )
The white reference value for tonemapping, which indicates where bright white is located in the scale of values provided to the tonemapper. For photorealistic lighting, it is recommended to set :ref:`tonemap_agx_white<class_Environment_property_tonemap_agx_white>` to at least ``6.0``. Higher values result in less blown out highlights, but may make the scene appear lower contrast. :ref:`tonemap_agx_white<class_Environment_property_tonemap_agx_white>` is the same as :ref:`tonemap_white<class_Environment_property_tonemap_white>`, but is only effective with the :ref:`TONE_MAPPER_AGX<class_Environment_constant_TONE_MAPPER_AGX>` tonemapper. See also :ref:`tonemap_exposure<class_Environment_property_tonemap_exposure>`.
\ **Note:** When using the Mobile renderer with :ref:`Viewport.use_hdr_2d<class_Viewport_property_use_hdr_2d>` disabled, :ref:`tonemap_agx_white<class_Environment_property_tonemap_agx_white>` is ignored and a white value of ``2.0`` will always be used instead.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_tonemap_exposure:
.. rst-class:: classref-property
:ref:`float<class_float>` **tonemap_exposure** = ``1.0`` :ref:`🔗<class_Environment_property_tonemap_exposure>`
.. rst-class:: classref-property-setget
- |void| **set_tonemap_exposure**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_tonemap_exposure**\ (\ )
Adjusts the brightness of values before they are provided to the tonemapper. Higher :ref:`tonemap_exposure<class_Environment_property_tonemap_exposure>` values result in a brighter image. See also :ref:`tonemap_white<class_Environment_property_tonemap_white>`.
\ **Note:** Values provided to the tonemapper will also be multiplied by ``2.0`` and ``1.8`` for :ref:`TONE_MAPPER_FILMIC<class_Environment_constant_TONE_MAPPER_FILMIC>` and :ref:`TONE_MAPPER_ACES<class_Environment_constant_TONE_MAPPER_ACES>` respectively to produce a similar apparent brightness as :ref:`TONE_MAPPER_LINEAR<class_Environment_constant_TONE_MAPPER_LINEAR>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_tonemap_mode:
.. rst-class:: classref-property
:ref:`ToneMapper<enum_Environment_ToneMapper>` **tonemap_mode** = ``0`` :ref:`🔗<class_Environment_property_tonemap_mode>`
.. rst-class:: classref-property-setget
- |void| **set_tonemapper**\ (\ value\: :ref:`ToneMapper<enum_Environment_ToneMapper>`\ )
- :ref:`ToneMapper<enum_Environment_ToneMapper>` **get_tonemapper**\ (\ )
Le mode de tonemapping à utiliser. Le tonemapping est le processus qui "convertit" des valeurs HDR pour être adaptées à du rendu sur un écran LDR. (Godot ne supporte pas encore le rendu sur des écrans HDR.)
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_tonemap_white:
.. rst-class:: classref-property
:ref:`float<class_float>` **tonemap_white** = ``1.0`` :ref:`🔗<class_Environment_property_tonemap_white>`
.. rst-class:: classref-property-setget
- |void| **set_tonemap_white**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_tonemap_white**\ (\ )
The white reference value for tonemapping, which indicates where bright white is located in the scale of values provided to the tonemapper. For photorealistic lighting, it is recommended to set :ref:`tonemap_white<class_Environment_property_tonemap_white>` to at least ``6.0``. Higher values result in less blown out highlights, but may make the scene appear lower contrast. :ref:`tonemap_agx_white<class_Environment_property_tonemap_agx_white>` will be used instead when using the :ref:`TONE_MAPPER_AGX<class_Environment_constant_TONE_MAPPER_AGX>` tonemapper. See also :ref:`tonemap_exposure<class_Environment_property_tonemap_exposure>`.
\ **Note:** :ref:`tonemap_white<class_Environment_property_tonemap_white>` must be set to ``2.0`` or lower on the Mobile renderer to produce bright images.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_albedo:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **volumetric_fog_albedo** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_Environment_property_volumetric_fog_albedo>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_albedo**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_volumetric_fog_albedo**\ (\ )
La :ref:`Color<class_Color>` du brouillard volumétrique lors de l'interaction avec des lumières. La brume et le brouillard ont un albédo proche de ``Color(1, 1, 1, 1)`` tandis que la fumée a un albédo plus foncé.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_ambient_inject:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_ambient_inject** = ``0.0`` :ref:`🔗<class_Environment_property_volumetric_fog_ambient_inject>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_ambient_inject**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_ambient_inject**\ (\ )
Dimensionne la force de la lumière ambiante utilisée dans le brouillard volumétrique. Une valeur de ``0.0`` signifie que la lumière ambiante n'affectera pas le brouillard volumétrique. :ref:`volumetric_fog_ambient_inject<class_Environment_property_volumetric_fog_ambient_inject>` a un petit coût en performances lorsque défini au-dessus de ``0.0``.
\ **Note :** Cela n'a aucun effet visible si :ref:`volumetric_fog_density<class_Environment_property_volumetric_fog_density>` vaut ``0.0`` ou si :ref:`volumetric_fog_albedo<class_Environment_property_volumetric_fog_albedo>` est une couleur entièrement noire.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_anisotropy:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_anisotropy** = ``0.2`` :ref:`🔗<class_Environment_property_volumetric_fog_anisotropy>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_anisotropy**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_anisotropy**\ (\ )
The direction of scattered light as it goes through the volumetric fog. A value close to ``1.0`` means almost all light is scattered forward. A value close to ``0.0`` means light is scattered equally in all directions. A value close to ``-1.0`` means light is scattered mostly backward. Fog and mist scatter light slightly forward, while smoke scatters light equally in all directions.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_density:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_density** = ``0.05`` :ref:`🔗<class_Environment_property_volumetric_fog_density>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_density**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_density**\ (\ )
La densité *exponentielle* de base du brouillard volumétrique. Définissez ceci à la plus basse densité que vous voulez avoir globalement. Des :ref:`FogVolume<class_FogVolume>`\ s peuvent être utilisés pour ajouter ou soustraire à cette densité dans des zones spécifiques. Le rendu du brouillard est exponentiel comme dans la vie réelle.
Une valeur de ``0.0`` désactive le brouillard volumétrique global tout en permettant à des :ref:`FogVolume<class_FogVolume>`\ s d'afficher du brouillard volumétrique dans des zones spécifiques.
Pour que le brouillard volumétrique fonctionne comme une solution d'*éclairage* volumique, définissez :ref:`volumetric_fog_density<class_Environment_property_volumetric_fog_density>` à la valeur non nulle la plus basse (``0.0001``) puis augmentez la valeur des :ref:`Light3D.light_volumetric_fog_energy<class_Light3D_property_light_volumetric_fog_energy>` des lumières à des valeurs entre ``10000`` et ``100000`` pour compenser la très faible densité.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_detail_spread:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_detail_spread** = ``2.0`` :ref:`🔗<class_Environment_property_volumetric_fog_detail_spread>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_detail_spread**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_detail_spread**\ (\ )
The distribution of size down the length of the froxel buffer. A higher value compresses the froxels closer to the camera and places more detail closer to the camera.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_emission:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **volumetric_fog_emission** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_Environment_property_volumetric_fog_emission>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_emission**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_volumetric_fog_emission**\ (\ )
La lumière émise par le brouillard volumétrique. Même avec l'émission, le brouillard volumétrique ne projettera pas de lumière sur d'autres surfaces. Les émissions sont utiles pour établir une couleur ambiante. Comme l'effet de brouillard volumétrique n'utilise que de la diffusion unique, le brouillard a tendance à avoir besoin d'un peu d'émission pour adoucir les ombres trop nettes.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_emission_energy:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_emission_energy** = ``1.0`` :ref:`🔗<class_Environment_property_volumetric_fog_emission_energy>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_emission_energy**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_emission_energy**\ (\ )
La luminosité de la lumière émise dans le brouillard volumétrique.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **volumetric_fog_enabled** = ``false`` :ref:`🔗<class_Environment_property_volumetric_fog_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_volumetric_fog_enabled**\ (\ )
Active l'effet de brouillard volumétrique. Le brouillard volumétrique utilise un buffer de froxels alignés sur l'écran pour calculer la diffusion volumétrique exacte à courte et moyenne portée. Le brouillard volumique interagit avec les :ref:`FogVolume<class_FogVolume>`\ s et les lumières pour calculer le brouillard local et global. Le brouillard volumétrique utilise un modèle PBR à diffusion unique basé sur l'extinction, la diffusion et l'émission qu'il expose aux utilisateurs par la densité, l'albédo et l'émission.
\ **Note :** Le brouillard volumétrique n'est supporté que dans la méthode de rendu Forward+, et non Mobile ou Compatibilité.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_gi_inject:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_gi_inject** = ``1.0`` :ref:`🔗<class_Environment_property_volumetric_fog_gi_inject>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_gi_inject**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_gi_inject**\ (\ )
Redimensionne la force de l'illumination globale utilisée dans la couleur d'albédo du brouillard volumétrique. Une valeur de ``0.0`` signifie que l'illumination globale n'affectera pas le brouillard volumétrique. :ref:`volumetric_fog_gi_inject<class_Environment_property_volumetric_fog_gi_inject>` a un petit coût de performance lorsque il est défini au dessus de ``0.0``.
\ **Note :** Cela n'a aucun effet visible si :ref:`volumetric_fog_density<class_Environment_property_volumetric_fog_density>` vaut ``0.0`` ou si :ref:`volumetric_fog_albedo<class_Environment_property_volumetric_fog_albedo>` a une couleur entièrement noire.
\ **Note :** Seuls :ref:`VoxelGI<class_VoxelGI>` et SDFGI (:ref:`sdfgi_enabled<class_Environment_property_sdfgi_enabled>`) sont pris en compte lors de l'utilisation de :ref:`volumetric_fog_gi_inject<class_Environment_property_volumetric_fog_gi_inject>`. L'illumination globale de :ref:`LightmapGI<class_LightmapGI>`, :ref:`ReflectionProbe<class_ReflectionProbe>` et SSIL (voir :ref:`ssil_enabled<class_Environment_property_ssil_enabled>`) sera ignorée par le brouillard volumétrique.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_length:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_length** = ``64.0`` :ref:`🔗<class_Environment_property_volumetric_fog_length>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_length**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_length**\ (\ )
La distance sur laquelle le brouillard volumétrique est calculé. Augmentez la pour calculer le brouillard sur une plus grande portée, diminuez la pour ajouter plus de détails quand une longue portée n'est pas nécessaire. Pour un brouillard de meilleure qualité, gardez ceci aussi bas que possible. Voir aussi :ref:`ProjectSettings.rendering/environment/volumetric_fog/volume_depth<class_ProjectSettings_property_rendering/environment/volumetric_fog/volume_depth>`.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_sky_affect:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_sky_affect** = ``1.0`` :ref:`🔗<class_Environment_property_volumetric_fog_sky_affect>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_sky_affect**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_sky_affect**\ (\ )
Le facteur à utiliser le brouillard volumétrique affecte le ciel. ``1.0`` signifie que le brouillard volumétrique peut masquer pleinement le ciel. Les valeurs inférieures réduisent l'impact du brouillard volumétrique sur le rendu du ciel, avec ``0.0`` qui n'affecte pas du tout le rendu du ciel.
\ **Note :** :ref:`volumetric_fog_sky_affect<class_Environment_property_volumetric_fog_sky_affect>` affecte également les :ref:`FogVolume<class_FogVolume>`\ s, même si :ref:`volumetric_fog_density<class_Environment_property_volumetric_fog_density>` vaut ``0.0``. Si vous remarquez que des :ref:`FogVolume<class_FogVolume>`\ s disparaissent en regardant vers le ciel, définissez :ref:`volumetric_fog_sky_affect<class_Environment_property_volumetric_fog_sky_affect>` à ``1.0``.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_temporal_reprojection_amount:
.. rst-class:: classref-property
:ref:`float<class_float>` **volumetric_fog_temporal_reprojection_amount** = ``0.9`` :ref:`🔗<class_Environment_property_volumetric_fog_temporal_reprojection_amount>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_temporal_reprojection_amount**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_volumetric_fog_temporal_reprojection_amount**\ (\ )
The amount by which to blend the last frame with the current frame. A higher number results in smoother volumetric fog, but makes "ghosting" much worse. A lower value reduces ghosting but can result in the per-frame temporal jitter becoming visible.
.. rst-class:: classref-item-separator
----
.. _class_Environment_property_volumetric_fog_temporal_reprojection_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **volumetric_fog_temporal_reprojection_enabled** = ``true`` :ref:`🔗<class_Environment_property_volumetric_fog_temporal_reprojection_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_volumetric_fog_temporal_reprojection_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_volumetric_fog_temporal_reprojection_enabled**\ (\ )
Active la reprojection temporelle dans le brouillard volumétrique. La reprojection temporelle mélange le brouillard volumétrique de la trame actuelle avec le brouillard volumétrique de la dernière trame pour lisser les bords irréguliers. Le coût en performance est minime, cependant, cela conduit à du "ghosting" sur les :ref:`FogVolume<class_FogVolume>`\ s et :ref:`Light3D<class_Light3D>`\ s mouvants, qui laissant alors une traînée derrière eux. Lorsque la reprojection temporelle est activée, essayez d'éviter de déplacer des :ref:`FogVolume<class_FogVolume>`\ s ou des :ref:`Light3D<class_Light3D>`\ s trop vite. Les effets d'éclairage dynamique de courte durée devraient avoir :ref:`Light3D.light_volumetric_fog_energy<class_Light3D_property_light_volumetric_fog_energy>` définis sur ``0.0`` pour éviter le ghosting.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descriptions des méthodes
--------------------------------------------------
.. _class_Environment_method_get_glow_level:
.. rst-class:: classref-method
:ref:`float<class_float>` **get_glow_level**\ (\ idx\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_Environment_method_get_glow_level>`
Renvoie l'intensité du niveau de glow à l'index ``idx``.
.. rst-class:: classref-item-separator
----
.. _class_Environment_method_set_glow_level:
.. rst-class:: classref-method
|void| **set_glow_level**\ (\ idx\: :ref:`int<class_int>`, intensity\: :ref:`float<class_float>`\ ) :ref:`🔗<class_Environment_method_set_glow_level>`
Définit l'intensité du niveau de glow à l'index ``idx``. Une valeur supérieure à ``0.0`` active le niveau. Chaque niveau dépend du niveau précédent. Cela signifie qu'activer des niveaux de glow plus élevés ralentira le rendu de l'effet de glow, même si les niveaux précédents ne sont pas activés.
.. |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.)`
Reference in New Issue View Git Blame Copy Permalink