godot-docs-l10n/classes/fr/class_fogvolume.rst

:github_url: hide

.. _class_FogVolume:

FogVolume
=========

**Hérite de :** :ref:`VisualInstance3D<class_VisualInstance3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`

Une région qui contribue au brouillard volumétrique par défaut de l'environnement du monde.

.. rst-class:: classref-introduction-group

Description
-----------

Les **FogVolume**\ s sont utilisés pour ajouter du brouillard localisé dans l'effet de brouillard volumétrique global. Les **FogVolume**\ s peuvent également enlever du brouillard volumétrique de certaines zones si vous utilisez un :ref:`FogMaterial<class_FogMaterial>` avec une densité :ref:`FogMaterial.density<class_FogMaterial_property_density>` négative.

La performance de **FogVolume** est directement liée à leur taille relative sur l'écran et à la complexité de leur :ref:`FogMaterial<class_FogMaterial>` attaché. Il est préférable de garder les **FogVolume**\ s relativement petits et simples si possible.

\ **Note :** Les **FogVolume**\ s ont un effet visible seulement si :ref:`Environment.volumetric_fog_enabled<class_Environment_property_volumetric_fog_enabled>` vaut ``true``. Si vous ne voulez pas que le brouillard soit visible à l'échelle globale (mais seulement dans des nœuds **FogVolume**), définissez :ref:`Environment.volumetric_fog_density<class_Environment_property_volumetric_fog_density>` à ``0.0``.

.. rst-class:: classref-introduction-group

Tutoriels
------------------

- :doc:`Brouillard volumétrique et volumes de brouillard <../tutorials/3d/volumetric_fog>`

.. rst-class:: classref-reftable-group

Propriétés
--------------------

.. table::
   :widths: auto

   +------------------------------------------------------------+----------------------------------------------------+----------------------+
   | :ref:`Material<class_Material>`                            | :ref:`material<class_FogVolume_property_material>` |                      |
   +------------------------------------------------------------+----------------------------------------------------+----------------------+
   | :ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>` | :ref:`shape<class_FogVolume_property_shape>`       | ``3``                |
   +------------------------------------------------------------+----------------------------------------------------+----------------------+
   | :ref:`Vector3<class_Vector3>`                              | :ref:`size<class_FogVolume_property_size>`         | ``Vector3(2, 2, 2)`` |
   +------------------------------------------------------------+----------------------------------------------------+----------------------+

.. rst-class:: classref-section-separator

----

.. rst-class:: classref-descriptions-group

Descriptions des propriétés
------------------------------------------------------

.. _class_FogVolume_property_material:

.. rst-class:: classref-property

:ref:`Material<class_Material>` **material** :ref:`🔗<class_FogVolume_property_material>`

.. rst-class:: classref-property-setget

- |void| **set_material**\ (\ value\: :ref:`Material<class_Material>`\ )
- :ref:`Material<class_Material>` **get_material**\ (\ )

Le :ref:`Material<class_Material>` utilisé par le **FogVolume**. Peut être soit un :ref:`FogMaterial<class_FogMaterial>` intégré soit un :ref:`ShaderMaterial<class_ShaderMaterial>` personnalisé.

.. rst-class:: classref-item-separator

----

.. _class_FogVolume_property_shape:

.. rst-class:: classref-property

:ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>` **shape** = ``3`` :ref:`🔗<class_FogVolume_property_shape>`

.. rst-class:: classref-property-setget

- |void| **set_shape**\ (\ value\: :ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>`\ )
- :ref:`FogVolumeShape<enum_RenderingServer_FogVolumeShape>` **get_shape**\ (\ )

La forme du **FogVolume**. Ceci peut être définit à :ref:`RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID<class_RenderingServer_constant_FOG_VOLUME_SHAPE_ELLIPSOID>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CONE<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CONE>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CYLINDER<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CYLINDER>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_BOX<class_RenderingServer_constant_FOG_VOLUME_SHAPE_BOX>` ou :ref:`RenderingServer.FOG_VOLUME_SHAPE_WORLD<class_RenderingServer_constant_FOG_VOLUME_SHAPE_WORLD>`.

.. rst-class:: classref-item-separator

----

.. _class_FogVolume_property_size:

.. rst-class:: classref-property

:ref:`Vector3<class_Vector3>` **size** = ``Vector3(2, 2, 2)`` :ref:`🔗<class_FogVolume_property_size>`

.. rst-class:: classref-property-setget

- |void| **set_size**\ (\ value\: :ref:`Vector3<class_Vector3>`\ )
- :ref:`Vector3<class_Vector3>` **get_size**\ (\ )

La taille du **FogVolume** lorsque :ref:`shape<class_FogVolume_property_shape>` vaut :ref:`RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID<class_RenderingServer_constant_FOG_VOLUME_SHAPE_ELLIPSOID>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CONE<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CONE>`, :ref:`RenderingServer.FOG_VOLUME_SHAPE_CYLINDER<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CYLINDER>` ou :ref:`RenderingServer.FOG_VOLUME_SHAPE_BOX<class_RenderingServer_constant_FOG_VOLUME_SHAPE_BOX>`.

\ **Note :** Des volumes de brouillard minces peuvent sembler clignoter lorsque la caméra se déplace ou tourne. Cela peut être atténué en augmentant :ref:`ProjectSettings.rendering/environment/volumetric_fog/volume_depth<class_ProjectSettings_property_rendering/environment/volumetric_fog/volume_depth>` (avec un coût sur les performances) ou en diminuant :ref:`Environment.volumetric_fog_length<class_Environment_property_volumetric_fog_length>` (sans coût sur les performances, mais au coût d'une portée du brouillard inférieure). Sinon, le **FogVolume** peut rendu plus épais et utiliser une densité inférieure dans le matériau :ref:`material<class_FogVolume_property_material>`.

\ **Note :** Si :ref:`shape<class_FogVolume_property_shape>` vaut :ref:`RenderingServer.FOG_VOLUME_SHAPE_CONE<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CONE>` ou :ref:`RenderingServer.FOG_VOLUME_SHAPE_CYLINDER<class_RenderingServer_constant_FOG_VOLUME_SHAPE_CYLINDER>`, le cône/cylindre sera ajusté pour correspondre à la taille. Une échelle non uniforme des formes de cônes/cylindres via la propriété :ref:`size<class_FogVolume_property_size>` n'est pas supportée, mais vous pouvez à la place re-dimensionner le nœud **FogVolume**.

.. |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.)`