Files
Basalt2/docs/references/elements/Program.md
Robert Jelic 3504d8a3aa Docs fix
2025-09-13 12:50:01 +02:00

3.2 KiB

Program

This is the program class. It provides a program that runs in a window.

Extends: VisualElement

Properties

Property Type Default Description
program table nil The program instance
path string "" The path to the program
running boolean false Whether the program is running
errorCallback function nil The error callback function
doneCallback function nil The done callback function

Functions

Method Returns Description
Program.new -
Program:BasaltProgram -
Program:BasaltProgram -
Program:BasaltProgram -
Program:BasaltProgram -
Program.new Program Creates a new Program instance
Program:Program Program Initializes the Program instance
Program:Program Program Executes a program
Program:Program Program Stops the program
Program:Program Program Sends an event to the program
Program:Program Program Registers a callback for the program's error event
Program:Program Program Registers a callback for the program's done event
Program:Program any Handles all incomming events
Program:Program - Gets called when the element gets focused
Program:Program - Renders the program

Program.new()

Program:BasaltProgram()

Program:BasaltProgram()

Program:BasaltProgram()

Program:BasaltProgram()

Program.new()

Returns

  • Program object The newly created Program instance

Program:Program(props, basalt)

Parameters

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

Returns

  • Program self The initialized instance

Program:Program(path, env?, addEnvironment?)

Executes a program

Parameters

  • path string The path to the program
  • env (optional) table The environment to run the program in
  • addEnvironment (optional) boolean Whether to add the environment to the program's environment (false = overwrite instead of adding)

Returns

  • Program self The Program instance

Program:Program()

Stops the program

Returns

  • Program self The Program instance

Program:Program(event, any)

Sends an event to the program

Parameters

  • event string The event to send
  • any The event arguments

Returns

  • Program self The Program instance

Program:Program(fn)

Registers a callback for the program's error event, if the function returns false, the program won't stop

Parameters

  • fn function The callback function to register

Returns

  • Program self The Program instance

Program:Program(fn)

Registers a callback for the program's done event

Parameters

  • fn function The callback function to register

Returns

  • Program self The Program instance

Program:Program(event, any)

Parameters

  • event string The event to handle
  • any The event arguments

Returns

  • any result The event result

Program:Program()

Program:Program()