mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2026-01-04 10:09:56 +03:00
189 lines
11 KiB
ReStructuredText
189 lines
11 KiB
ReStructuredText
:github_url: hide
|
||
|
||
.. _class_CanvasTexture:
|
||
|
||
CanvasTexture
|
||
=============
|
||
|
||
**Hérite de :** :ref:`Texture2D<class_Texture2D>` **<** :ref:`Texture<class_Texture>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||
|
||
Texture avec des normal maps et specular maps optionnelles à utiliser pour le rendu 2D.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Description
|
||
-----------
|
||
|
||
**CanvasTexture** est une alternative à :ref:`ImageTexture<class_ImageTexture>` pour le rendu 2D. Elle permet d'utiliser des normal maps et des maps spéculaires dans n'importe quel nœud héritant de :ref:`CanvasItem<class_CanvasItem>`. **CanvasTexture** permet aussi de redéfinir le filtrage de texture et le mode de répétition indépendamment des propriétés du nœud (ou des paramètres du projet).
|
||
|
||
\ **Remarque :** **CanvasTexture** ne peut pas être utilisée en 3D. Elle ne s'affichera pas correctement quand appliquée à un :ref:`VisualInstance3D<class_VisualInstance3D>`, tel que :ref:`Sprite3D<class_Sprite3D>` ou :ref:`Decal<class_Decal>`. Pour des matériaux basés sur la physique en 3D, utilisez plutôt :ref:`BaseMaterial3D<class_BaseMaterial3D>`.
|
||
|
||
.. rst-class:: classref-introduction-group
|
||
|
||
Tutoriels
|
||
------------------
|
||
|
||
- :doc:`Lumières et ombres 2D <../tutorials/2d/2d_lights_and_shadows>`
|
||
|
||
.. rst-class:: classref-reftable-group
|
||
|
||
Propriétés
|
||
--------------------
|
||
|
||
.. table::
|
||
:widths: auto
|
||
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`Texture2D<class_Texture2D>` | :ref:`diffuse_texture<class_CanvasTexture_property_diffuse_texture>` | |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`Texture2D<class_Texture2D>` | :ref:`normal_texture<class_CanvasTexture_property_normal_texture>` | |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`bool<class_bool>` | resource_local_to_scene | ``false`` (overrides :ref:`Resource<class_Resource_property_resource_local_to_scene>`) |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`Color<class_Color>` | :ref:`specular_color<class_CanvasTexture_property_specular_color>` | ``Color(1, 1, 1, 1)`` |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`float<class_float>` | :ref:`specular_shininess<class_CanvasTexture_property_specular_shininess>` | ``1.0`` |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`Texture2D<class_Texture2D>` | :ref:`specular_texture<class_CanvasTexture_property_specular_texture>` | |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`TextureFilter<enum_CanvasItem_TextureFilter>` | :ref:`texture_filter<class_CanvasTexture_property_texture_filter>` | ``0`` |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
| :ref:`TextureRepeat<enum_CanvasItem_TextureRepeat>` | :ref:`texture_repeat<class_CanvasTexture_property_texture_repeat>` | ``0`` |
|
||
+-----------------------------------------------------+----------------------------------------------------------------------------+----------------------------------------------------------------------------------------+
|
||
|
||
.. rst-class:: classref-section-separator
|
||
|
||
----
|
||
|
||
.. rst-class:: classref-descriptions-group
|
||
|
||
Descriptions des propriétés
|
||
------------------------------------------------------
|
||
|
||
.. _class_CanvasTexture_property_diffuse_texture:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Texture2D<class_Texture2D>` **diffuse_texture** :ref:`🔗<class_CanvasTexture_property_diffuse_texture>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_diffuse_texture**\ (\ value\: :ref:`Texture2D<class_Texture2D>`\ )
|
||
- :ref:`Texture2D<class_Texture2D>` **get_diffuse_texture**\ (\ )
|
||
|
||
La texture de diffusion (couleur) à utiliser. C'est la texture principale que vous voulez définir dans la plupart des cas.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CanvasTexture_property_normal_texture:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Texture2D<class_Texture2D>` **normal_texture** :ref:`🔗<class_CanvasTexture_property_normal_texture>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_normal_texture**\ (\ value\: :ref:`Texture2D<class_Texture2D>`\ )
|
||
- :ref:`Texture2D<class_Texture2D>` **get_normal_texture**\ (\ )
|
||
|
||
La normal map à utiliser. A seulement un effet visible si des :ref:`Light2D<class_Light2D>`\ s affectent cette **CanvasTexture**.
|
||
|
||
\ **Note :** Godot s'attend à ce que la normal map utilise des coordonnées X+, Y+ et Z+. Voir `cette page <http://wiki.polycount.com/wiki/Normal_Map_Technical_Details#Common_Swizzle_Coordinates>`__ pour une comparaison des coordonnées de normal map attendues par les moteurs populaires.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CanvasTexture_property_specular_color:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Color<class_Color>` **specular_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_CanvasTexture_property_specular_color>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_specular_color**\ (\ value\: :ref:`Color<class_Color>`\ )
|
||
- :ref:`Color<class_Color>` **get_specular_color**\ (\ )
|
||
|
||
Le multiplicateur pour les couleurs de réflexion spéculaire. La couleur de la :ref:`Light2D<class_Light2D>` est également prise en compte lors de la détermination de la couleur de réflexion. A seulement un effet visible si des :ref:`Light2D<class_Light2D>`\ s affectent cette **CanvasTexture**.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CanvasTexture_property_specular_shininess:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`float<class_float>` **specular_shininess** = ``1.0`` :ref:`🔗<class_CanvasTexture_property_specular_shininess>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_specular_shininess**\ (\ value\: :ref:`float<class_float>`\ )
|
||
- :ref:`float<class_float>` **get_specular_shininess**\ (\ )
|
||
|
||
L'exposant spéculaire pour des réflexions spéculaires de :ref:`Light2D<class_Light2D>`\ s. Des valeurs plus grandes donnent un aspect plus brillant/"mouillé", avec des réflexions devenant plus locales et moins visible au global. La valeur par défaut de ``1.0`` désactive complètement les reflets spéculaires. A un effet visible seulement si des :ref:`Light2D<class_Light2D>`\ s affectent cette **CanvasTexture**.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CanvasTexture_property_specular_texture:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`Texture2D<class_Texture2D>` **specular_texture** :ref:`🔗<class_CanvasTexture_property_specular_texture>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_specular_texture**\ (\ value\: :ref:`Texture2D<class_Texture2D>`\ )
|
||
- :ref:`Texture2D<class_Texture2D>` **get_specular_texture**\ (\ )
|
||
|
||
La specular map à utiliser pour des reflets spéculaires de :ref:`Light2D<class_Light2D>`. Cela devrait être une texture en noir et blanc ou en couleur, où les zones plus claires correspondent à une valeur plus grande de :ref:`specular_shininess<class_CanvasTexture_property_specular_shininess>`. Utiliser une :ref:`specular_texture<class_CanvasTexture_property_specular_texture>` en couleur permet de contrôler la brillance spéculaire canal par canal. N'a d'effet visible que si des :ref:`Light2D<class_Light2D>`\ s affectent cette **CanvasTexture**.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CanvasTexture_property_texture_filter:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`TextureFilter<enum_CanvasItem_TextureFilter>` **texture_filter** = ``0`` :ref:`🔗<class_CanvasTexture_property_texture_filter>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_texture_filter**\ (\ value\: :ref:`TextureFilter<enum_CanvasItem_TextureFilter>`\ )
|
||
- :ref:`TextureFilter<enum_CanvasItem_TextureFilter>` **get_texture_filter**\ (\ )
|
||
|
||
Le mode de filtrage de texture à utiliser lors du dessin de cette **CanvasTexture**.
|
||
|
||
.. rst-class:: classref-item-separator
|
||
|
||
----
|
||
|
||
.. _class_CanvasTexture_property_texture_repeat:
|
||
|
||
.. rst-class:: classref-property
|
||
|
||
:ref:`TextureRepeat<enum_CanvasItem_TextureRepeat>` **texture_repeat** = ``0`` :ref:`🔗<class_CanvasTexture_property_texture_repeat>`
|
||
|
||
.. rst-class:: classref-property-setget
|
||
|
||
- |void| **set_texture_repeat**\ (\ value\: :ref:`TextureRepeat<enum_CanvasItem_TextureRepeat>`\ )
|
||
- :ref:`TextureRepeat<enum_CanvasItem_TextureRepeat>` **get_texture_repeat**\ (\ )
|
||
|
||
Le mode de répétition de texture à utiliser lors du dessin de cette **CanvasTexture**.
|
||
|
||
.. |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.)`
|