Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

TextureRect

Hérite de : Control < CanvasItem < Node < Object

Un contrôle qui affiche une texture.

Description

Un contrôle qui affiche une texture, par exemple une icône dans un GUI. Le placement de la texture peut être contrôlé avec la propriété stretch_mode. Elle peut être redimensionnée, répétée, ou rester centrée dans son rectangle délimitant.

Tutoriels

Propriétés

ExpandMode

expand_mode

0

bool

flip_h

false

bool

flip_v

false

MouseFilter

mouse_filter

1 (overrides Control)

StretchMode

stretch_mode

0

Texture2D

texture

Énumérations

enum ExpandMode: 🔗

ExpandMode EXPAND_KEEP_SIZE = 0

La taille minimale sera égale à la taille de la texture, c'est-à-dire TextureRect ne peut être plus petit que la texture.

ExpandMode EXPAND_IGNORE_SIZE = 1

La taille de la texture ne sera pas considérée pour le calcul de la taille minimale, ainsi le TextureRect peut être rétréci en dessous de la taille de la texture.

ExpandMode EXPAND_FIT_WIDTH = 2

La hauteur de la texture sera ignorée. La largeur minimale sera égale à la hauteur actuelle. Utilisable pour les dispositions horizontales, par exemple à l'intérieur d'un HBoxContainer.

ExpandMode EXPAND_FIT_WIDTH_PROPORTIONAL = 3

Comme EXPAND_FIT_WIDTH, mais garde le rapport d'aspect de texture.

ExpandMode EXPAND_FIT_HEIGHT = 4

La largeur de la texture sera ignorée. La hauteur minimale sera égale à la largeur actuelle. Utile pour les dispositions verticales, par exemple à l'intérieur d'un VBoxContainer.

ExpandMode EXPAND_FIT_HEIGHT_PROPORTIONAL = 5

Comme EXPAND_FIT_HEIGHT, mais garde le rapport d'aspect de texture.

enum StretchMode: 🔗

StretchMode STRETCH_SCALE = 0

Change l'échelle pour adapter le rectangle total du nœud.

StretchMode STRETCH_TILE = 1

Tile inside the node's bounding rectangle.

Note: STRETCH_TILE mode is not supported for texture set to an AtlasTexture with non-zero AtlasTexture.margin.

StretchMode STRETCH_KEEP = 2

La texture conserve sa taille d’origine et reste dans le coin supérieur gauche du rectangle délimitant.

StretchMode STRETCH_KEEP_CENTERED = 3

La texture conserve sa taille d’origine et reste centrée dans le rectangle délimitant du nœud.

StretchMode STRETCH_KEEP_ASPECT = 4

Échelonne la texture pour s'adapter au rectangle délimitant du nœud, mais maintient le rapport d'aspect de la texture.

StretchMode STRETCH_KEEP_ASPECT_CENTERED = 5

Adapte la texture à la taille de l'élément en la centrant et en maintenant ses proportions.

StretchMode STRETCH_KEEP_ASPECT_COVERED = 6

Échelonne la texture pour que le côté le plus court rentre dans le rectangle délimitant du nœud. L'autre côté est coupé aux limites du nœud.

Descriptions des propriétés

ExpandMode expand_mode = 0 🔗

Expérimental : Using EXPAND_FIT_WIDTH, EXPAND_FIT_WIDTH_PROPORTIONAL, EXPAND_FIT_HEIGHT, or EXPAND_FIT_HEIGHT_PROPORTIONAL may result in unstable behavior in some Container controls. This behavior may be re-evaluated and changed in the future.

Définit comment la taille minimale est déterminée en fonction de la taille de la texture.

bool flip_h = false 🔗

  • void set_flip_h(value: bool)

  • bool is_flipped_h()

Si true, la texture est inversée horizontalement.

bool flip_v = false 🔗

  • void set_flip_v(value: bool)

  • bool is_flipped_v()

Si true, la texture est inversée verticalement.

StretchMode stretch_mode = 0 🔗

Contrôle le comportement de la texture en redimensionnant le rectangle délimitant du nœud.

Texture2D texture 🔗

La ressource Texture2D du nœud.