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标志被忽略。
属性¶
|
||
flags |
|
|
|
||
|
属性说明¶
Texture atlas
Setter |
set_atlas(value) |
Getter |
get_atlas() |
包含图集的纹理。可以是任何Texture子类型。
bool filter_clip
Default |
|
Setter |
set_filter_clip(value) |
Getter |
has_filter_clip() |
如果true
,剪辑区域外的区域,以避免周围纹理像素的出血。
Rect2 margin
Default |
|
Setter |
set_margin(value) |
Getter |
get_margin() |
区域周围的边距。Rect2 的 Rect2.size 参数(编辑器中的“w”和“h”)调整纹理的大小,使其适合于边距。
Rect2 region
Default |
|
Setter |
set_region(value) |
Getter |
get_region() |
地图集的使用区域。