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.

AtlasTexture

Hérite de : Texture2D < Texture < Resource < RefCounted < Object

Une texture qui recadre une partie d'une autre Texture2D.

Description

Ressource Texture2D qui ne dessine qu'une partie de sa texture atlas, tel que défini par la region. Une marge supplémentaire margin peut également être définie, ce qui est utile pour les petits ajustements.

Plusieurs ressources AtlasTexture peuvent être découpées à partir du même atlas. Tasser plusieurs textures plus petites dans une grande texture unique aide à optimiser les coûts en mémoire vidéo et les render calls.

Note : AtlasTexture ne peut pas être utilisée dans une AnimatedTexture, et ne se répétera pas correctement dans des nœuds tels que TextureRect ou Sprite2D. Pour répéter une AtlasTexture, modifiez sa region à la place.

Propriétés

Texture2D

atlas

bool

filter_clip

false

Rect2

margin

Rect2(0, 0, 0, 0)

Rect2

region

Rect2(0, 0, 0, 0)

bool

resource_local_to_scene

false (overrides Resource)


Descriptions des propriétés

Texture2D atlas 🔗

La texture qui contient l'atlas. Peut être de n'importe type héritant de Texture2D, y compris une autre AtlasTexture.


bool filter_clip = false 🔗

  • void set_filter_clip(value: bool)

  • bool has_filter_clip()

Si true, la zone située à l'extérieur de la region est coupée pour éviter les saignements des pixels de texture environnants.


Rect2 margin = Rect2(0, 0, 0, 0) 🔗

  • void set_margin(value: Rect2)

  • Rect2 get_margin()

La marge autour de la region. Utile pour les petits ajustements. Si le paramètre Rect2.size de cette propriété ("w" et "h" dans l'éditeur) est défini, la texture dessiné est redimensionnée de sorte qu'elle corresponde à cette marge.


Rect2 region = Rect2(0, 0, 0, 0) 🔗

  • void set_region(value: Rect2)

  • Rect2 get_region()

La région utilisée pour dessiner l'atlas. Si l'une ou l'autre des dimensions de la région vaut 0, la valeur de la taille de l'atlas sera utilisée pour cet axe à la place.

Note: La taille de l'image est toujours un entier, donc la taille réelle de la région est arrondie.