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.

StyleBoxTexture

Eredita: StyleBox < Resource < RefCounted < Object

Uno StyleBox divisa in nove sezioni basata su una texture.

Descrizione

Uno StyleBox a nove sezioni basato su texture, in un modo simile a NinePatchRect. Questo stylebox esegue un ridimensionamento 3×3 di una texture, dove solo la cella centrale è completamente stirata. Ciò rende possibile progettare stili con bordi a prescindere dalle dimensioni dello stylebox.

Proprietà

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

Color

modulate_color

Color(1, 1, 1, 1)

Rect2

region_rect

Rect2(0, 0, 0, 0)

Texture2D

texture

float

texture_margin_bottom

0.0

float

texture_margin_left

0.0

float

texture_margin_right

0.0

float

texture_margin_top

0.0

Metodi

float

get_expand_margin(margin: Side) const

float

get_texture_margin(margin: Side) const

void

set_expand_margin(margin: Side, size: float)

void

set_expand_margin_all(size: float)

void

set_texture_margin(margin: Side, size: float)

void

set_texture_margin_all(size: float)


Enumerazioni

enum AxisStretchMode: 🔗

AxisStretchMode AXIS_STRETCH_MODE_STRETCH = 0

Allunga la texture dello stylebox. Ciò provoca una distorsione visiva a meno che la dimensione della texture non corrisponda perfettamente a quella dello stylebox.

AxisStretchMode AXIS_STRETCH_MODE_TILE = 1

Ripete la texture dello stylebox per adattarla alle dimensioni dello stylebox secondo il sistema a nove sezioni.

AxisStretchMode AXIS_STRETCH_MODE_TILE_FIT = 2

Ripete la texture dello stylebox per adattarla alle dimensioni dello stylebox secondo il sistema a nove sezioni. A differenza di AXIS_STRETCH_MODE_TILE, la texture può essere leggermente allungata per ripetere la texture a nove sezioni, senza cuciture.


Descrizioni delle proprietà

AxisStretchMode axis_stretch_horizontal = 0 🔗

Controlla come la texture dello stylebox sarà allungata o ripetuta orizzontalmente.


AxisStretchMode axis_stretch_vertical = 0 🔗

Controlla come la texture dello stylebox sarà allungata o ripetuta verticalmente.


bool draw_center = true 🔗

  • void set_draw_center(value: bool)

  • bool is_draw_center_enabled()

Se true, sarà disegnata la sezione centrale della texture a nove sezioni.


float expand_margin_bottom = 0.0 🔗

  • void set_expand_margin(margin: Side, size: float)

  • float get_expand_margin(margin: Side) const

Espande il margine inferiore di questo style box quando viene disegnato, in modo che sia più grande di quanto richiesto.


float expand_margin_left = 0.0 🔗

  • void set_expand_margin(margin: Side, size: float)

  • float get_expand_margin(margin: Side) const

Espande il margine sinistro di questo style box quando viene disegnato, in modo che sia più grande di quanto richiesto.


float expand_margin_right = 0.0 🔗

  • void set_expand_margin(margin: Side, size: float)

  • float get_expand_margin(margin: Side) const

Espande il margine destro di questo style box quando viene disegnato, in modo che sia più grande di quanto richiesto.


float expand_margin_top = 0.0 🔗

  • void set_expand_margin(margin: Side, size: float)

  • float get_expand_margin(margin: Side) const

Espande il margine superiore di questo style box quando viene disegnato, in modo che sia più grande di quanto richiesto.


Color modulate_color = Color(1, 1, 1, 1) 🔗

  • void set_modulate(value: Color)

  • Color get_modulate()

Modula il colore della texture quando viene disegnato questo style box.


Rect2 region_rect = Rect2(0, 0, 0, 0) 🔗

  • void set_region_rect(value: Rect2)

  • Rect2 get_region_rect()

La regione da usare dalla texture.

Ciò equivale a racchiudere prima la texture in un AtlasTexture con la stessa regione.

Se vuoto (Rect2(0, 0, 0, 0)), sarà usata l'intera texture.


Texture2D texture 🔗

La texture da utilizzare quando si disegna questo style box.


float texture_margin_bottom = 0.0 🔗

  • void set_texture_margin(margin: Side, size: float)

  • float get_texture_margin(margin: Side) const

Aumenta il margine inferiore del riquadro 3×3 della texture .

Un valore più alto significa che una parte maggiore della texture sorgente è considerata parte del bordo inferiore del riquadro 3×3.

Questo è anche il valore utilizzato come riserva per StyleBox.content_margin_bottom se è negativo.


float texture_margin_left = 0.0 🔗

  • void set_texture_margin(margin: Side, size: float)

  • float get_texture_margin(margin: Side) const

Aumenta il margine sinistro del riquadro 3×3 della texture .

Un valore più alto significa che una parte maggiore della texture sorgente è considerata parte del bordo sinistro del riquadro 3×3.

Questo è anche il valore utilizzato come riserva per StyleBox.content_margin_left se è negativo.


float texture_margin_right = 0.0 🔗

  • void set_texture_margin(margin: Side, size: float)

  • float get_texture_margin(margin: Side) const

Aumenta il margine destro del riquadro 3×3 della texture .

Un valore più alto significa che una parte maggiore della texture sorgente è considerata parte del bordo destro del riquadro 3×3.

Questo è anche il valore utilizzato come riserva per StyleBox.content_margin_right se è negativo.


float texture_margin_top = 0.0 🔗

  • void set_texture_margin(margin: Side, size: float)

  • float get_texture_margin(margin: Side) const

Aumenta il margine superiore del riquadro 3×3 della texture .

Un valore più alto significa che una parte maggiore della texture sorgente è considerata parte del bordo superiore del riquadro 3×3.

Questo è anche il valore utilizzato come riserva per StyleBox.content_margin_top se è negativo.


Descrizioni dei metodi

float get_expand_margin(margin: Side) const 🔗

Restituisce la dimensione del margine di espansione del lato specificato come Side.


float get_texture_margin(margin: Side) const 🔗

Restituisce la dimensione del margine del lato specificato come Side.


void set_expand_margin(margin: Side, size: float) 🔗

Imposta il margine di espansione a size pixel per il lato specificato con Side.


void set_expand_margin_all(size: float) 🔗

Imposta il margine di espansione a size pixel per tutti i lati.


void set_texture_margin(margin: Side, size: float) 🔗

Imposta il margine a size pixel per il lato specificato come Side.


void set_texture_margin_all(size: float) 🔗

Imposta il margine su size pixel per tutti i lati.