Basalt2/docs/references/elements/VisualElement.md

@alias color number

VisualElement : BaseElement

Properties

Property	Type	Default	Description
x	number	1	x position of the element
y	number	1	y position of the element
z	number	1	z position of the element
width	number	1	width of the element
height	number	1	height of the element
background	color	black	background color of the element
foreground	color	white	foreground color of the element
clicked	boolean	an	false element is currently clicked
backgroundEnabled	boolean	true	whether the background is enabled
focused	boolean	false	whether the element is focused
visible	boolean	true	whether the element is visible

Functions

Method	Returns	Description
VisualElement.new	VisualElement
VisualElement:blit	-
VisualElement:blur	-
VisualElement:focus	-
VisualElement:getAbsolutePosition	-
VisualElement:getRelativePosition	number,
VisualElement:init	-
VisualElement:isInBounds	boolean
VisualElement:mouse_click	boolean
VisualElement:mouse_release	boolean
VisualElement:mouse_up	boolean
VisualElement:multiBlit	-
VisualElement:render	-
VisualElement:setCursor	-
VisualElement:textBg	-
VisualElement:textFg	-

@combinedProperty position x y @combinedProperty size width height @combinedProperty color foreground background

VisualElement.new(props, basalt)

Creates a new VisualElement instance

Parameters

• props table The properties to initialize the element with
• basalt table The basalt instance

Returns

• VisualElement object The newly created VisualElement instance

Usage

local element = VisualElement.new("myId", basalt)

VisualElement:blit(x, y, text, fg, bg)

Draws a text character with a foreground and background at the specified position, used in the rendering system

Parameters

• x number The x position to draw
• y number The y position to draw
• text string The text char to draw
• fg string The foreground color
• bg string The background color

VisualElement:blur()

Handles a blur event

VisualElement:focus()

Handles a focus event

VisualElement:getAbsolutePosition(x?, y?)

Returns the absolute position of the element or the given coordinates.

Parameters

• x (optional) number x position
• y (optional) number y position

VisualElement:getRelativePosition(x?, y?)

Returns the relative position of the element or the given coordinates.

Parameters

• x (optional) number x position
• y (optional) number y position

Returns

• nil nil nil

VisualElement:init()

Initializes the VisualElement instance

VisualElement:isInBounds(x, y)

Checks if the specified coordinates are within the bounds of the element

Parameters

• x number The x position to check
• y number The y position to check

Returns

• boolean isInBounds Whether the coordinates are within the bounds of the element

VisualElement:mouse_click(button, x, y)

Handles a mouse click event

Parameters

• button number The button that was clicked
• x number The x position of the click
• y number The y position of the click

Returns

• boolean clicked Whether the element was clicked

VisualElement:mouse_release(button, x, y)

Handles a mouse release event

Parameters

• button number The button that was released
• x number The x position of the release
• y number The y position of the release

Returns

• boolean release Whether the element was released on the element

VisualElement:mouse_up(button, x, y)

Handles a mouse up event

Parameters

• button number The button that was released
• x number The x position of the release
• y number The y position of the release

Returns

• boolean release Whether the element was released on the element

VisualElement:multiBlit(x, y, width, height, text, fg, bg)

Draws a text character/fg/bg at the specified position with a certain size, used in the rendering system

Parameters

• x number The x position to draw
• y number The y position to draw
• width number The width of the element
• height number The height of the element
• text string The text char to draw
• fg color The foreground color
• bg color The background color

VisualElement:render()

Renders the element

Usage

element:render()

VisualElement:setCursor(x, y, blink)

Sets the cursor position

Parameters

• x number The x position of the cursor
• y number The y position of the cursor
• blink boolean Whether the cursor should blink

VisualElement:textBg(x, y, text, bg)

Draws a text character with a background at the specified position, used in the rendering system

Parameters

• x number The x position to draw
• y number The y position to draw
• text string The text char to draw
• bg color The background color

VisualElement:textFg(x, y, text, fg)

Draws a text character at the specified position, used in the rendering system

Parameters

• x number The x position to draw
• y number The y position to draw
• text string The text char to draw
• fg color The foreground color