NinePatchRect

Inherits: Control < CanvasItem < Node < Object

Category: Core

Brief Description

Scalable texture-based frame that tiles the texture’s centers and sides, but keeps the corners’ original size. Perfect for panels and dialog boxes.

Properties

AxisStretchModeaxis_stretch_horizontal
AxisStretchModeaxis_stretch_vertical
booldraw_center
intpatch_margin_bottom
intpatch_margin_left
intpatch_margin_right
intpatch_margin_top
Rect2region_rect
Texturetexture

Signals

  • texture_changed ( )

Fired when the node’s texture changes.

Enumerations

enum AxisStretchMode:

  • AXIS_STRETCH_MODE_STRETCH = 0 — Doesn’t do anything at the time of writing. Default value for axis_stretch_horizontal and axis_stretch_vertical.
  • AXIS_STRETCH_MODE_TILE = 1 — Doesn’t do anything at the time of writing.
  • AXIS_STRETCH_MODE_TILE_FIT = 2 — Doesn’t do anything at the time of writing.

Description

Better known as 9-slice panels, NinePatchRect produces clean panels of any size, based on a small texture. To do so, it splits the texture in a 3 by 3 grid. When you scale the node, it tiles the texture’s sides horizontally or vertically, the center on both axes but it doesn’t scale or tile the corners.

Property Descriptions

Setterset_h_axis_stretch_mode(value)
Getterget_h_axis_stretch_mode()

Doesn’t do anything at the time of writing.


Setterset_v_axis_stretch_mode(value)
Getterget_v_axis_stretch_mode()

Doesn’t do anything at the time of writing.


Setterset_draw_center(value)
Getteris_draw_center_enabled()

If true, draw the panel’s center. Else, only draw the 9-slice’s borders. Default value: true


  • int patch_margin_bottom
Setterset_patch_margin(value)
Getterget_patch_margin()

The height of the 9-slice’s bottom row. A margin of 16 means the 9-slice’s bottom corners and side will have a height of 16 pixels. You can set all 4 margin values individually to create panels with non-uniform borders.


  • int patch_margin_left
Setterset_patch_margin(value)
Getterget_patch_margin()

The height of the 9-slice’s left column.


  • int patch_margin_right
Setterset_patch_margin(value)
Getterget_patch_margin()

The height of the 9-slice’s right column.


  • int patch_margin_top
Setterset_patch_margin(value)
Getterget_patch_margin()

The height of the 9-slice’s top row.


Setterset_region_rect(value)
Getterget_region_rect()

Rectangular region of the texture to sample from. If you’re working with an atlas, use this property to define the area the 9-slice should use. All other properties are relative to this one.


Setterset_texture(value)
Getterget_texture()

The node’s texture resource.