mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
242 lines
14 KiB
ReStructuredText
242 lines
14 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_LightmapGIData:
|
||
|
||
LightmapGIData
|
||
==============
|
||
|
||
**Hérite de :** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Contient une lightmap pré-calculée et des données de sonde d'objet dynamique pour :ref:`LightmapGI<class_LightmapGI>`.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Description
|
||
-----------
|
||
|
||
**LightmapGIData** contient une lightmap pré-calculée et des données de sonde d'objet dynamique pour :ref:`LightmapGI<class_LightmapGI>`. Elle est remplacée chaque fois que les lightmaps sont pré-calculées dans :ref:`LightmapGI<class_LightmapGI>`.
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Propriétés
|
||
--------------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+--------------------------------------------------------------------------+-------------------------------------------------------------------------------+--------+
|
||
| :ref:`TextureLayered<class_TextureLayered>` | :ref:`light_texture<class_LightmapGIData_property_light_texture>` | |
|
||
+--------------------------------------------------------------------------+-------------------------------------------------------------------------------+--------+
|
||
| :ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\] | :ref:`lightmap_textures<class_LightmapGIData_property_lightmap_textures>` | ``[]`` |
|
||
+--------------------------------------------------------------------------+-------------------------------------------------------------------------------+--------+
|
||
| :ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\] | :ref:`shadowmask_textures<class_LightmapGIData_property_shadowmask_textures>` | ``[]`` |
|
||
+--------------------------------------------------------------------------+-------------------------------------------------------------------------------+--------+
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Méthodes
|
||
----------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| |void| | :ref:`add_user<class_LightmapGIData_method_add_user>`\ (\ path\: :ref:`NodePath<class_NodePath>`, uv_scale\: :ref:`Rect2<class_Rect2>`, slice_index\: :ref:`int<class_int>`, sub_instance\: :ref:`int<class_int>`\ ) |
|
||
+---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| |void| | :ref:`clear_users<class_LightmapGIData_method_clear_users>`\ (\ ) |
|
||
+---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`int<class_int>` | :ref:`get_user_count<class_LightmapGIData_method_get_user_count>`\ (\ ) |const| |
|
||
+---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`NodePath<class_NodePath>` | :ref:`get_user_path<class_LightmapGIData_method_get_user_path>`\ (\ user_idx\: :ref:`int<class_int>`\ ) |const| |
|
||
+---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| :ref:`bool<class_bool>` | :ref:`is_using_spherical_harmonics<class_LightmapGIData_method_is_using_spherical_harmonics>`\ (\ ) |const| |
|
||
+---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
| |void| | :ref:`set_uses_spherical_harmonics<class_LightmapGIData_method_set_uses_spherical_harmonics>`\ (\ uses_spherical_harmonics\: :ref:`bool<class_bool>`\ ) |
|
||
+---------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Énumérations
|
||
------------------------
|
||
|
||
.. _enum_LightmapGIData_ShadowmaskMode:
|
||
|
||
.. rst-class:: classref-enumeration
|
||
|
||
enum **ShadowmaskMode**: :ref:`🔗<enum_LightmapGIData_ShadowmaskMode>`
|
||
|
||
.. _class_LightmapGIData_constant_SHADOWMASK_MODE_NONE:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`ShadowmaskMode<enum_LightmapGIData_ShadowmaskMode>` **SHADOWMASK_MODE_NONE** = ``0``
|
||
|
||
Le shadowmasking est désactivé. Aucune texture de shadowmask ne sera créée lors du pré-calcul des lightmaps. Les textures de shadowmask existantes seront retirées pendant le pré-calcul.
|
||
|
||
.. _class_LightmapGIData_constant_SHADOWMASK_MODE_REPLACE:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`ShadowmaskMode<enum_LightmapGIData_ShadowmaskMode>` **SHADOWMASK_MODE_REPLACE** = ``1``
|
||
|
||
Le shadowmasking est activé. Les ombres directionnelles qui sont à l'extérieur de la :ref:`DirectionalLight3D.directional_shadow_max_distance<class_DirectionalLight3D_property_directional_shadow_max_distance>` seront rendues en utilisant la texture de Shadowmask. Les ombres qui sont à l'intérieur de l'intervalle seront rendues en utilisant des ombres en temps réel exclusivement. Ce mode permet d'obtenir des ombres en temps réel plus précises à proximité, sans l'effet potentiel de « barbouillage » qui peut se produire lors de l'utilisation de lightmaps avec une taille élevée de texel. Le désavantage est que lorsque la caméra se déplace rapidement, la transition entre la lumière en temps réel et le shadowmask peut être évidente. De plus, les objets qui n'ont que des ombres pré-calculées dans le shadowmask (et pas d'ombres en temps réel) n'afficheront pas d'ombres lorsqu'ils sont proches.
|
||
|
||
.. _class_LightmapGIData_constant_SHADOWMASK_MODE_OVERLAY:
|
||
|
||
.. rst-class:: classref-enumeration-constant
|
||
|
||
:ref:`ShadowmaskMode<enum_LightmapGIData_ShadowmaskMode>` **SHADOWMASK_MODE_OVERLAY** = ``2``
|
||
|
||
Le shadowmasking est activé. Les ombres directionnelles sont rendues avec des ombres en temps réel superposées sur la texture de shadowmask. Ce mode permet des transitions d'ombre plus lisses lorsque la caméra se déplace rapidement, au coût d'un effet de barbouillage potentiel pour les ombres directionnelles qui sont proches (en raison de l'ombre en temps réel qui est mélangée avec un shadowmask à basse résolution). Les objets qui n'ont que des ombres pré-calculées dans le shadowmask (et pas d'ombres en temps réel) garderont leurs ombres lorsqu'ils sont proches.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Descriptions des propriétés
|
||
------------------------------------------------------
|
||
|
||
.. _class_LightmapGIData_property_light_texture:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`TextureLayered<class_TextureLayered>` **light_texture** :ref:`🔗<class_LightmapGIData_property_light_texture>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_light_texture**\ (\ value\: :ref:`TextureLayered<class_TextureLayered>`\ )
|
||
- :ref:`TextureLayered<class_TextureLayered>` **get_light_texture**\ (\ )
|
||
|
||
**Obsolète :** The lightmap atlas can now contain multiple textures. See :ref:`lightmap_textures<class_LightmapGIData_property_lightmap_textures>`.
|
||
|
||
La texture de l'atlas des lightmaps générée par le lightmapper.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_LightmapGIData_property_lightmap_textures:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\] **lightmap_textures** = ``[]`` :ref:`🔗<class_LightmapGIData_property_lightmap_textures>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_lightmap_textures**\ (\ value\: :ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\]\ )
|
||
- :ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\] **get_lightmap_textures**\ (\ )
|
||
|
||
Les textures de l'atlas des lightmaps générées par le lightmapper.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_LightmapGIData_property_shadowmask_textures:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\] **shadowmask_textures** = ``[]`` :ref:`🔗<class_LightmapGIData_property_shadowmask_textures>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_shadowmask_textures**\ (\ value\: :ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\]\ )
|
||
- :ref:`Array<class_Array>`\[:ref:`TextureLayered<class_TextureLayered>`\] **get_shadowmask_textures**\ (\ )
|
||
|
||
Les textures de l'atlas du shadowmask générées par le lightmapper.
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Descriptions des méthodes
|
||
--------------------------------------------------
|
||
|
||
.. _class_LightmapGIData_method_add_user:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **add_user**\ (\ path\: :ref:`NodePath<class_NodePath>`, uv_scale\: :ref:`Rect2<class_Rect2>`, slice_index\: :ref:`int<class_int>`, sub_instance\: :ref:`int<class_int>`\ ) :ref:`🔗<class_LightmapGIData_method_add_user>`
|
||
|
||
Ajoute un objet qui est considéré comme pré-calculé dans cette **LightmapGIData**.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_LightmapGIData_method_clear_users:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **clear_users**\ (\ ) :ref:`🔗<class_LightmapGIData_method_clear_users>`
|
||
|
||
Retire tous les objets qui sont considérés comme pré-calculés dans cette **LightmapGIData**.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_LightmapGIData_method_get_user_count:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`int<class_int>` **get_user_count**\ (\ ) |const| :ref:`🔗<class_LightmapGIData_method_get_user_count>`
|
||
|
||
Renvoie le nombre d'objets considérés comme pré-calculés dans cette **LightmapGIData**.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_LightmapGIData_method_get_user_path:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`NodePath<class_NodePath>` **get_user_path**\ (\ user_idx\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_LightmapGIData_method_get_user_path>`
|
||
|
||
Renvoie le :ref:`NodePath<class_NodePath>` de l'objet pré-calculé à l'index ``user_idx``.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_LightmapGIData_method_is_using_spherical_harmonics:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
:ref:`bool<class_bool>` **is_using_spherical_harmonics**\ (\ ) |const| :ref:`🔗<class_LightmapGIData_method_is_using_spherical_harmonics>`
|
||
|
||
Si ``true``, les lightmaps ont été pré-calculées avec des informations directionnelles. Voir aussi :ref:`LightmapGI.directional<class_LightmapGI_property_directional>`.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_LightmapGIData_method_set_uses_spherical_harmonics:
|
||
|
||
.. rst-class:: classref-method
|
||
|
||
|void| **set_uses_spherical_harmonics**\ (\ uses_spherical_harmonics\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_LightmapGIData_method_set_uses_spherical_harmonics>`
|
||
|
||
Si ``uses_spherical_harmonics`` vaut ``true``, indique au moteur de traiter les données de la lightmap comme si elle était pré-calculée avec des informations directionnelles.
|
||
|
||
\ **Note :** Modifier cette valeur sur les lightmaps déjà pré-calculées ne déclenchera pas un re-calcul. Cela signifie que l'apparence du matériau sera incorrecte jusqu'à ce que les lightmaps soient re-calculées, auquel cas la valeur définie ici est supprimée puisque la ressource **LightmapGIData** entière est remplacée par le lightmapper.
|
||
|
||
.. |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.)`
|