Basalt/docs/objects/Basalt.md

Before you can access Basalt, you need to add the following code on top of your file:

local basalt = require("Basalt")

Now you are able to access the following methods:

basalt.createFrame

Create a base-frame (main frame)

Parameters:

1. string name

Returns:

1. frame object

Usage:

• Create and show a frame with id "myFirstFrame"

local mainFrame = basalt.createFrame("myFirstFrame"):show()

basalt.removeFrame

Removes a base frame

Parameters:

1. string name

Usage:

• Removes the previously created frame with id "myFirstFrame"

local mainFrame = basalt.createFrame("myFirstFrame"):show()
basalt.removeFrame("myFirstFrame")

basalt.getFrame

Returns a base frame with the given name

Parameters:

1. string name

Returns:

1. frame object

Usage:

• Creates, fetches and shows the "myFirstFrame" object

basalt.createFrame("myFirstFrame")
basalt.getFrame("myFirstFrame"):show()

basalt.getActiveFrame

Returns the currently active base frame

Returns:

1. frame The current frame

Usage:

• Displays the active frame name in the debug console

basalt.createFrame("myFirstFrame"):show()
basalt.debug(basalt.getActiveFrame():getName()) -- returns myFirstFrame

basalt.autoUpdate

Starts the draw and event handler until basalt.stopUpdate() is called

Usage:

• Enable the basalt updates, otherwise the screen will not continue to update

local mainFrame = basalt.createFrame("myFirstFrame"):show()
basalt.autoUpdate()

basalt.update

Calls the draw and event handler once - this gives more flexibility about which events basalt should process. For example you could filter the terminate event.

Parameters:

1. string The event to be received
2. ... Additional event variables to capture

Usage:

• Creates and starts a custom update cycle

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myButton"):setPosition(2,2):show()

while true do
        basalt.update(os.pullEventRaw())
end

basalt.stopUpdate

Stops the automatic draw and event handler which got started by basalt.autoUpdate()

Usage:

• When the quit button is clicked, the button stops basalt auto updates

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myButton"):setPosition(2,2):setText("Stop Basalt!"):show()

aButton:onClick(function()
basalt.stopUpdate()
end)

basalt.autoUpdate()

basalt.isKeyDown

Checks if the user is currently holding a key

Parameters:

1. number key code (use the keys table for that)

Returns:

1. boolean true or false

Usage:

• Shows a debug message with true or false if the left ctrl key is down, as soon as you click on the button.

local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aButton = mainFrame:addButton("myButton"):setPosition(2,2):setText("Check Ctrl"):show()

aButton:onClick(function()
basalt.debug(basalt.isKeyDown(keys.leftCtrl))
end)

basalt.autoUpdate()

basalt.debug

creates a label with some information on the main frame on the bottom left, if you click on that label it will open a log view for you. See it as the new print for debugging

You can also edit the default debug Label (change position, change color or whatever you want) by accessing the variable basalt.debugLabel which returns the debug Label.

Also basalt.debugFrame and basalt.debugList are available.

Parameters:

1. ... (multiple parameters are possible, like print does)
   

Usage:

• Prints "Hello! ^-^" to the debug console

basalt.debug("Hello! ", "^-^")