Class reference
TextureProgressBar
Inherits Range
Texture-based progress bar. Useful for loading screens and life or stamina bars.
Description
TextureProgressBar works like ProgressBar, but uses up to 3 textures instead of Redot's Theme resource. It can be used to create horizontal, vertical and radial progress bars.
Properties
int fill_mode = 0
int fill_mode = 0The fill direction. See FillMode for possible values.
int mouse_filter = 1
int mouse_filter = 1bool nine_patch_stretch = false
bool nine_patch_stretch = falseIf true, Redot treats the bar's textures like in NinePatchRect. Use the stretch_margin_* properties like stretch_margin_bottom to set up the nine patch's 3×3 grid. When using a radial fill_mode, this setting will only enable stretching for texture_progress, while texture_under and texture_over will be treated like in NinePatchRect.
Vector2 radial_center_offset = Vector2(0, 0)
Vector2 radial_center_offset = Vector2(0, 0)Offsets texture_progress if fill_mode is FILL_CLOCKWISE, FILL_COUNTER_CLOCKWISE, or FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE. Note: The effective radial center always stays within the texture_progress bounds. If you need to move it outside the texture's bounds, modify the texture_progress to contain additional empty space where needed.
float radial_fill_degrees = 360.0
float radial_fill_degrees = 360.0Upper limit for the fill of texture_progress if fill_mode is FILL_CLOCKWISE, FILL_COUNTER_CLOCKWISE, or FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE. When the node's value is equal to its max_value, the texture fills up to this angle. See Range.value, Range.max_value.
float radial_initial_angle = 0.0
float radial_initial_angle = 0.0Starting angle for the fill of texture_progress if fill_mode is FILL_CLOCKWISE, FILL_COUNTER_CLOCKWISE, or FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE. When the node's value is equal to its min_value, the texture doesn't show up at all. When the value increases, the texture fills and tends towards radial_fill_degrees. Note: radial_initial_angle is wrapped between 0 and 360 degrees (inclusive).
int size_flags_vertical = 1
int size_flags_vertical = 1float step = 1.0
float step = 1.0int stretch_margin_bottom = 0
int stretch_margin_bottom = 0The height of the 9-patch'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. Only effective if nine_patch_stretch is true.
int stretch_margin_left = 0
int stretch_margin_left = 0The width of the 9-patch's left column. Only effective if nine_patch_stretch is true.
int stretch_margin_right = 0
int stretch_margin_right = 0The width of the 9-patch's right column. Only effective if nine_patch_stretch is true.
int stretch_margin_top = 0
int stretch_margin_top = 0The height of the 9-patch's top row. Only effective if nine_patch_stretch is true.
Texture2D texture_over
Texture2D texture_overTexture2D that draws over the progress bar. Use it to add highlights or an upper-frame that hides part of texture_progress.
Texture2D texture_progress
Texture2D texture_progressTexture2D that clips based on the node's value and fill_mode. As value increased, the texture fills up. It shows entirely when value reaches max_value. It doesn't show at all if value is equal to min_value. The value property comes from Range. See Range.value, Range.min_value, Range.max_value.
Vector2 texture_progress_offset = Vector2(0, 0)
Vector2 texture_progress_offset = Vector2(0, 0)The offset of texture_progress. Useful for texture_over and texture_under with fancy borders, to avoid transparent margins in your progress texture.
Texture2D texture_under
Texture2D texture_underTexture2D that draws under the progress bar. The bar's background.
Color tint_over = Color(1, 1, 1, 1)
Color tint_over = Color(1, 1, 1, 1)Multiplies the color of the bar's texture_over texture. The effect is similar to CanvasItem.modulate, except it only affects this specific texture instead of the entire node.
Color tint_progress = Color(1, 1, 1, 1)
Color tint_progress = Color(1, 1, 1, 1)Multiplies the color of the bar's texture_progress texture.
Color tint_under = Color(1, 1, 1, 1)
Color tint_under = Color(1, 1, 1, 1)Multiplies the color of the bar's texture_under texture.
Methods
int get_stretch_margin(int margin) const
int get_stretch_margin(int margin) constReturns the stretch margin with the specified index. See stretch_margin_bottom and related properties.
void set_stretch_margin(int margin, int value)
int margin, int value)Sets the stretch margin with the specified index. See stretch_margin_bottom and related properties.
Constants
FILL_LEFT_TO_RIGHT = 0
The texture_progress fills from left to right.
FILL_RIGHT_TO_LEFT = 1
The texture_progress fills from right to left.
FILL_TOP_TO_BOTTOM = 2
The texture_progress fills from top to bottom.
FILL_BOTTOM_TO_TOP = 3
The texture_progress fills from bottom to top.
FILL_CLOCKWISE = 4
Turns the node into a radial bar. The texture_progress fills clockwise. See radial_center_offset, radial_initial_angle and radial_fill_degrees to control the way the bar fills up.
FILL_COUNTER_CLOCKWISE = 5
Turns the node into a radial bar. The texture_progress fills counterclockwise. See radial_center_offset, radial_initial_angle and radial_fill_degrees to control the way the bar fills up.
FILL_BILINEAR_LEFT_AND_RIGHT = 6
The texture_progress fills from the center, expanding both towards the left and the right.
FILL_BILINEAR_TOP_AND_BOTTOM = 7
The texture_progress fills from the center, expanding both towards the top and the bottom.
FILL_CLOCKWISE_AND_COUNTER_CLOCKWISE = 8
Turns the node into a radial bar. The texture_progress fills radially from the center, expanding both clockwise and counterclockwise. See radial_center_offset, radial_initial_angle and radial_fill_degrees to control the way the bar fills up.