AtlasTexture

Inherits: Texture < Resource < Reference < Object

将纹理的一部分裁剪出来，例如来自纹理图集的纹理。

描述

Texture资源，由region定义，裁剪出atlas纹理的一个部分。主要的用例是从纹理图集中裁剪出纹理，一个大的纹理文件，包含了多个较小的纹理。由 atlas的Texture、定义使用 atlas区域的region和定义边界宽度的margin组成。

AtlasTexture不能在AnimatedTexture中使用，不能在TextureRect等节点中平铺，如果在其他AtlasTexture资源内部使用，将不能正常工作。多个AtlasTexture资源可以用来裁剪图集中的多个纹理。与使用多个小文件相比，使用一个纹理图集有助于优化视频内存消耗和渲染调用。

注意： AtlasTextures不支持重复。当使用AtlasTexture时，Texture.FLAG_REPEAT和Texture.FLAG_MIRRORED_REPEAT标志被忽略。

属性

Texture

atlas

bool

filter_clip

false

int

flags

0 (overrides Texture)

Rect2

margin

Rect2( 0, 0, 0, 0 )

Rect2

region

Rect2( 0, 0, 0, 0 )

属性说明

Setter

set_atlas(value)

Getter

get_atlas()

包含图集的纹理。可以是任何Texture子类型。

Default

false

Setter

set_filter_clip(value)

Getter

has_filter_clip()

如果true，剪辑区域外的区域，以避免周围纹理像素的出血。

Default

Rect2( 0, 0, 0, 0 )

Setter

set_margin(value)

Getter

get_margin()

区域周围的边距。Rect2 的 Rect2.size 参数（编辑器中的“w”和“h”）调整纹理的大小，使其适合于边距。

Default

Rect2( 0, 0, 0, 0 )

Setter

set_region(value)

Getter

get_region()

地图集的使用区域。