StyleBoxTexture

Inherits: StyleBox < Resource < Reference < Object

基于纹理的九宫格StyleBox

描述

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

方法

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 不同,可能会稍微拉伸纹理以使九宫格纹理平铺无缝。

属性说明

Default

0

Setter

set_h_axis_stretch_mode(value)

Getter

get_h_axis_stretch_mode()

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


Default

0

Setter

set_v_axis_stretch_mode(value)

Getter

get_v_axis_stretch_mode()

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


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()

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


Default

0.0

Setter

set_margin_size(value)

Getter

get_margin_size()

增加3×3 StyleBox的底边距。

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

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


Default

0.0

Setter

set_margin_size(value)

Getter

get_margin_size()

增加 3×3 StyleBox的左边距。

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

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


Default

0.0

Setter

set_margin_size(value)

Getter

get_margin_size()

增加 3×3 StyleBox的右边距。

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

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


Default

0.0

Setter

set_margin_size(value)

Getter

get_margin_size()

增加 3×3 StyleBox的上边距。

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

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


Default

Color( 1, 1, 1, 1 )

Setter

set_modulate(value)

Getter

get_modulate()

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


Setter

set_normal_map(value)

Getter

get_normal_map()

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

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


Default

Rect2( 0, 0, 0, 0 )

Setter

set_region_rect(value)

Getter

get_region_rect()

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

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


Setter

set_texture(value)

Getter

get_texture()

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

方法说明

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


返回给定 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_leftsize_topsize_rightsize_bottom 像素。


  • void set_expand_margin_size ( Margin margin, float size )

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


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