StyleBoxTexture

StyleBoxTexture

Inherits: StyleBox < Resource < Reference < Object

基于纹理的九宫格StyleBox。

描述

基于纹理的九宫格 StyleBox，类似于 NinePatchRect。这个样式盒会对纹理执行 3×3 缩放，其中只有中心单元会被完全拉伸。这使得无论样式盒的大小如何，都可以设计有边框的样式。

属性

AxisStretchMode	axis_stretch_horizontal	`0`
AxisStretchMode	axis_stretch_vertical	`0`
bool	draw_center	`true`
float	expand_margin_bottom	`0.0`
float	expand_margin_left	`0.0`
float	expand_margin_right	`0.0`
float	expand_margin_top	`0.0`
float	margin_bottom	`0.0`
float	margin_left	`0.0`
float	margin_right	`0.0`
float	margin_top	`0.0`
Color	modulate_color	`Color( 1, 1, 1, 1 )`
Texture	normal_map
Rect2	region_rect	`Rect2( 0, 0, 0, 0 )`
Texture	texture

方法

float	get_expand_margin_size ( Margin margin ) const
float	get_margin_size ( Margin margin ) const
void	set_expand_margin_all ( float size )
void	set_expand_margin_individual ( float size_left, float size_top, float size_right, float size_bottom )
void	set_expand_margin_size ( Margin margin, float size )
void	set_margin_size ( Margin margin, float size )

信号

texture_changed ( )

当样式盒的纹理被改变时发出。

枚举

enum AxisStretchMode:

AXIS_STRETCH_MODE_STRETCH = 0 —- 拉伸样式盒的纹理。这会导致可见的失真，除非纹理大小与样式盒的大小完美匹配。
AXIS_STRETCH_MODE_TILE = 1 —- 根据九宫格系统，重复样式盒的纹理，以匹配样式盒的大小。
AXIS_STRETCH_MODE_TILE_FIT = 2 —- 根据九宫格系统，重复样式盒的纹理，以匹配样式盒的大小。与 AXIS_STRETCH_MODE_TILE 不同，可能会稍微拉伸纹理以使九宫格纹理平铺无缝。

属性说明

AxisStretchMode axis_stretch_horizontal

Default	`0`
Setter	set_h_axis_stretch_mode(value)
Getter	get_h_axis_stretch_mode()

控制如何水平拉伸或平铺样式盒的纹理。有关可能的值，请参阅 AxisStretchMode。

AxisStretchMode axis_stretch_vertical

Default	`0`
Setter	set_v_axis_stretch_mode(value)
Getter	get_v_axis_stretch_mode()

控制如何垂直拉伸或平铺StyleBox的纹理。有关可能的值，请参阅 AxisStretchMode。

bool draw_center

Default	`true`
Setter	set_draw_center(value)
Getter	is_draw_center_enabled()

如果true，将绘制九宫格纹理的中心瓦片。

float expand_margin_bottom

Default	`0.0`
Setter	set_expand_margin_size(value)
Getter	get_expand_margin_size()

绘制时扩展此样式盒的底部边距，使其绘制得比请求的大。

float expand_margin_left

Default	`0.0`
Setter	set_expand_margin_size(value)
Getter	get_expand_margin_size()

绘制时扩展此样式盒的左边距，使其绘制得比请求的大。

float expand_margin_right

Default	`0.0`
Setter	set_expand_margin_size(value)
Getter	get_expand_margin_size()

绘制时扩展此样式盒的右边距，使其绘制得比请求的大。

float expand_margin_top

Default	`0.0`
Setter	set_expand_margin_size(value)
Getter	get_expand_margin_size()

绘制时扩展此样式盒的上边距，使其绘制得比请求的大。

float margin_bottom

Default	`0.0`
Setter	set_margin_size(value)
Getter	get_margin_size()

增加3×3 StyleBox的底边距。

更高的值意味着更多的源纹理被认为是3×3 box的底边的一部分。

如果StyleBox.content_margin_bottom为负值，这个值也是作为后备值使用。

float margin_left

Default	`0.0`
Setter	set_margin_size(value)
Getter	get_margin_size()

增加 3×3 StyleBox的左边距。

较高的值意味着更多的源纹理被认为是 3×3 box左边框的一部分。

如果StyleBox.content_margin_left为负值，这个值也是作为后备值使用。

float margin_right

Default	`0.0`
Setter	set_margin_size(value)
Getter	get_margin_size()

增加 3×3 StyleBox的右边距。

较高的值意味着更多的源纹理被认为是 3×3 box右边框的一部分。

如果StyleBox.content_margin_right为负值，这个值也是作为后备值使用。

float margin_top

Default	`0.0`
Setter	set_margin_size(value)
Getter	get_margin_size()

增加 3×3 StyleBox的上边距。

较高的值意味着更多的源纹理被认为是 3×3 box上边框的一部分。

如果StyleBox.content_margin_top为负值，这个值也是作为后备值使用。

Color modulate_color

Default	`Color( 1, 1, 1, 1 )`
Setter	set_modulate(value)
Getter	get_modulate()

绘制此样式盒时用于调制纹理的颜色。

Texture normal_map

Setter	set_normal_map(value)
Getter	get_normal_map()

绘制此样式盒时使用的法线贴图。

注意： Godot 期望法线贴图使用 X+、Y- 和 Z+ 坐标系。参阅这个页面比较流行引擎所期望的法线贴图坐标系。

Rect2 region_rect

Default	`Rect2( 0, 0, 0, 0 )`
Setter	set_region_rect(value)
Getter	get_region_rect()

指定要使用的纹理的子区域。

这相当于首先将纹理包裹在具有相同区域的 AtlasTexture 中。

Texture texture

Setter	set_texture(value)
Getter	get_texture()

绘制此样式盒时所使用的纹理。

方法说明

float get_expand_margin_size ( Margin margin ) const

返回给定的margin的扩展边距的大小。可能的值见Margin。

float get_margin_size ( Margin margin ) const

返回给定 margin 的大小。有关可能的值，请参阅 Margin。

void set_expand_margin_all ( float size )

将所有边距的扩展边距设置为 size 像素。

void set_expand_margin_individual ( float size_left, float size_top, float size_right, float size_bottom )

将每个边距的扩展边距设置为 size_left、size_top、size_right 和 size_bottom 像素。

void set_expand_margin_size ( Margin margin, float size )

将给定的 margin 的扩展边距设置为 size 像素。有关可能的值，请参阅 Margin。

void set_margin_size ( Margin margin, float size )

将给定的 margin 的边距设置为 size 像素。有关可能的值，请参阅 Margin。