Basic lua initialization for the ui. More...

#include "ui_lua.h"
#include "../../shared/cxx.h"
#include "../../shared/defines.h"
#include "../../shared/shared.h"
#include "../../common/cvar.h"
#include "../../common/hashtable.h"
#include "../../common/filesys.h"
#include "../../common/scripts_lua.h"
#include "../cl_lua.h"
#include "ui_main.h"
#include "ui_components.h"
#include "ui_behaviour.h"
#include "ui_node.h"
#include "ui_parse.h"
#include "ui_internal.h"
#include "../../common/swig_lua_runtime.h"

Include dependency graph for ui_lua.cpp:

Go to the source code of this file.

Functions
void	UI_InitLua (void)
	Performs UI specific initialization. Call this after CL_InitLua.
void	UI_ShutdownLua (void)
	Performs UI specific lua shutdown. Call this before CL_ShutdownLua.
bool	UI_ExecuteLuaEventScript (uiNode_t *node, LUA_EVENT event)
	Executes a lua event handler.
bool	UI_ExecuteLuaEventScript_ParamList (uiNode_t node, LUA_EVENT event, linkedList_t params)
	Executes a lua event handler with string parameter list.
bool	UI_ExecuteLuaEventScript_ReturnBool (uiNode_t *node, LUA_EVENT event, bool &result)
	Executes a lua event handler and returns the result as a boolean.
bool	UI_ExecuteLuaEventScript_XY (uiNode_t *node, LUA_EVENT event, int x, int y)
	Executes a lua event handler with (x,y) argument.
bool	UI_ExecuteLuaEventScript_DxDy (uiNode_t *node, LUA_EVENT event, int dx, int dy)
	Executes a lua event handler with (dx,dy) argument.
bool	UI_ExecuteLuaEventScript_Key (uiNode_t *node, LUA_EVENT event, unsigned int key, unsigned short unicode)
	Executes a lua event handler with (keycode,unicode) argument.
bool	UI_ExecuteLuaEventScript_DragDrop (uiNode_t *node, LUA_EVENT event, bool &result)
	Executes a lua event handler for dragdrop interaction.
bool	UI_ExecuteLuaEventScript_DragDrop_XY (uiNode_t *node, LUA_EVENT event, int x, int y, bool &result)
	Executes a lua event handler for dragdrop interaction.
bool	UI_ExecuteLuaEventScript_DragDrop_IsDropped (uiNode_t *node, LUA_EVENT event, bool isDropped, bool &result)
	Executes a lua event handler for dragdrop interaction.
bool	UI_ExecuteLuaMethod (uiNode_t node, LUA_FUNCTION fcn, linkedList_t params, int nparams)
	Executes a lua based method defined on the behaviour class of a node.
bool	UI_ExecuteLuaConFunc (uiNode_t *node, LUA_FUNCTION fcn)
	Executes a lua based confunc node.
bool	UI_ExecuteLuaMethod_ByName (uiNode_t node, const char name, linkedList_t *params, int nparams)
	Executes a lua based method defined on the behaviour class of a node.
void	UI_RegisterHandler_OnLoad (LUA_FUNCTION fcn)
	Register global lua callback function called after loading the module.
void	UI_CallHandler_OnLoad (lua_State L, const char key)
	Call the registered callback handler. This stub primarily exists should the signature of the call change in the future. CL_ExecuteCallback only supports a callback with no arguments.
bool	UI_ParseAndLoadLuaScript (const char name, const char *text)
	Parses and loads a .ufo file holding a lua script.
uiNode_t *	UI_CreateControl (uiNode_t parent, const char type, const char name, const char super)
	Create a new control inherited from a given node class or other node.
void	UI_PrintNodeTree (uiNode_t *node, int level)
const char *	UI_Node_TypeOf (uiNode_t *node)
uiNode_t *	UI_CreateComponent (const char type, const char name, const char *super)
	Create a new component inherited from a given node class or other node.
uiNode_t *	UI_CreateWindow (const char type, const char name, const char *super)
	Create a window node with specified type and inheritance.

Variables
char	ui_scriptname [256] = ""

Detailed Description

Basic lua initialization for the ui.

Definition in file ui_lua.cpp.

Function Documentation

◆ UI_CallHandler_OnLoad()

void UI_CallHandler_OnLoad	(	lua_State *	L,
		const char *	key )

Call the registered callback handler. This stub primarily exists should the signature of the call change in the future. CL_ExecuteCallback only supports a callback with no arguments.

Definition at line 372 of file ui_lua.cpp.

References CL_ExecuteCallback(), and key.

Referenced by UI_ParseAndLoadLuaScript().

◆ UI_CreateComponent()

uiNode_t * UI_CreateComponent	(	const char *	type,
		const char *	name,
		const char *	super )

Create a new component inherited from a given node class or other node.

Parameters

[in]	type	The behaviour type of the component to create.
[in]	name	The name of the component to create.
[in]	super	The name this component inherits from. If NULL the component has no super defined.

Note: A component is a reusable window or panel.

Definition at line 544 of file ui_lua.cpp.

References uiNode_t::behaviour, Com_Printf(), name, uiBehaviour_t::name, type, UI_AllocNode(), UI_CloneNode(), UI_GetComponent(), UI_GetNodeBehaviour(), UI_InsertComponent(), UI_Node_Loaded(), UI_TokenIsName(), and UI_TokenIsReserved().

Referenced by _wrap_create_component().

◆ UI_CreateControl()

uiNode_t * UI_CreateControl	(	uiNode_t *	parent,
		const char *	type,
		const char *	name,
		const char *	super )

Create a new control inherited from a given node class or other node.

Parameters

[in]	parent	The parent control or window/component owning this control.
[in]	type	The behaviour type of the control to create. This can be a previously defined control instance.
[in]	name	The name of the control to create.
[in]	super	The name this control inherits from. If specified overrides the behaviour type of super must match type.

Note: A control is a node inside a component or window. Unlike a component or window, a control is always attached to a parent.; Code needs to be refactored.

Definition at line 428 of file ui_lua.cpp.

References uiNode_t::behaviour, Com_DPrintf(), Com_Printf(), DEBUG_CLIENT, name, uiBehaviour_t::name, uiNode_t::root, uiNode_t::super, type, UI_AllocNode(), UI_AppendNode(), UI_CloneNode(), UI_GetComponent(), UI_GetNode(), UI_GetNodeBehaviour(), UI_GetPath(), UI_Node_Loaded(), UI_TokenIsName(), UI_TokenIsReserved(), and UI_UpdateRoot().

Referenced by _wrap_create_control(), UI_CreateBar(), UI_CreateBaseInventory(), UI_CreateBaseLayout(), UI_CreateButton(), UI_CreateCheckBox(), UI_CreateConFunc(), UI_CreateContainer(), UI_CreateData(), UI_CreateGeoscape(), UI_CreateImage(), UI_CreateItem(), UI_CreateLineChart(), UI_CreateMessageList(), UI_CreateModel(), UI_CreateOption(), UI_CreateOptionList(), UI_CreateOptionTree(), UI_CreatePanel(), UI_CreateRadar(), UI_CreateRadioButton(), UI_CreateRows(), UI_CreateSelectBox(), UI_CreateSequence(), UI_CreateSpinner(), UI_CreateString(), UI_CreateTab(), UI_CreateTBar(), UI_CreateText(), UI_CreateText2(), UI_CreateTextEntry(), UI_CreateTextList(), UI_CreateTexture(), UI_CreateTimer(), UI_CreateVideo(), UI_CreateVScrollbar(), UI_CreateWidget(), and UI_CreateZone().

◆ UI_CreateWindow()

uiNode_t * UI_CreateWindow	(	const char *	type,
		const char *	name,
		const char *	super )

Create a window node with specified type and inheritance.

Parameters

[in]	type	The behaviour type of the window to create.
[in]	name	The name of the window to create.
[in]	super	The name this window inherits from. If NULL the window has no super defined.

Note: A window is a top level component in the ui.

Todo: If the old style ui scripts are no longer used, the check UI_TokenIsReserved should be removed.

Definition at line 618 of file ui_lua.cpp.

References Com_Error(), Com_Printf(), ERR_FATAL, i, name, Q_streq, uiNode_t::root, Sys_Error(), type, UI_AllocNode(), UI_CloneNode(), UI_GetWindow(), ui_global, UI_InsertWindow(), UI_MAX_WINDOWS, UI_Node_Loaded(), UI_TokenIsName(), and UI_TokenIsReserved().

◆ UI_ExecuteLuaConFunc()

bool UI_ExecuteLuaConFunc	(	uiNode_t *	node,
		LUA_FUNCTION	fcn )

Executes a lua based confunc node.

Parameters

[in]	node	The node the method is defined on.
[in]	fcn	The The method to execute.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the method in lua is: function(sender, p1..pn), so the actual number of parameters for the function is actually nparams + 1.; Parameters are read from cmd.; All parameters are send to lua as strings.

Definition at line 323 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Cmd_Argc(), Cmd_Argv(), Com_Printf(), i, uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by UI_ConfuncCommand_f(), and UI_ExecuteCallAction().

◆ UI_ExecuteLuaEventScript()

bool UI_ExecuteLuaEventScript	(	uiNode_t *	node,
		LUA_EVENT	event )

Executes a lua event handler.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender)

Definition at line 71 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by uiSequenceNode::draw(), uiTimerNode::draw(), uiVideoNode::drawOverWindow(), uiNode::onActivate(), uiRadioButtonNode::onActivate(), uiOptionListNode::onCapturedMouseMove(), uiOptionTreeNode::onCapturedMouseMove(), uiContainerNode::onDndFinished(), uiLocatedNode::onFocusGained(), uiLocatedNode::onFocusLost(), uiTextListNode::onLeftClick(), uiNode::onLoaded(), uiBaseInventoryNode::onMouseDown(), uiContainerNode::onMouseDown(), uiMaterialEditorNode::onMouseDown(), uiLocatedNode::onMouseEnter(), uiLocatedNode::onMouseLeave(), uiTextListNode::onRightClick(), uiOptionListNode::onScroll(), uiOptionTreeNode::onScroll(), uiPanelNode::onScroll(), uiWindowNode::onWindowActivate(), uiWindowNode::onWindowClosed(), uiAbstractScrollableNode::setScrollY(), uiAbstractValueNode::setValue(), UI_AbstractOption_SetCurrentValue(), UI_AbstractScrollbarNodeSet(), UI_AbstractValue_SetValueCvar(), UI_BaseInventoryNodeUpdateScroll(), UI_ClientLayout(), UI_ColumnLayout(), UI_ContainerNodeAutoPlaceItem(), UI_OptionListNodeUpdateScroll(), UI_OptionTree_SelectValue(), UI_OptionTreeNodeUpdateScroll(), UI_TextEntryNodeValidateEdition(), UI_TextNodeSelectLine(), UI_TextScrollEnd(), and UI_TopDownFlowLayout().

◆ UI_ExecuteLuaEventScript_DragDrop()

bool UI_ExecuteLuaEventScript_DragDrop	(	uiNode_t *	node,
		LUA_EVENT	event,
		bool &	result )

Executes a lua event handler for dragdrop interaction.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[out]	result	A reference to a bool set to the function result.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender) and should return a boolean

Definition at line 211 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by uiLocatedNode::onDndEnter(), and uiLocatedNode::onDndLeave().

◆ UI_ExecuteLuaEventScript_DragDrop_IsDropped()

bool UI_ExecuteLuaEventScript_DragDrop_IsDropped	(	uiNode_t *	node,
		LUA_EVENT	event,
		bool	isDropped,
		bool &	result )

Executes a lua event handler for dragdrop interaction.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[in]	isDropped	The boolean of the call signature (isDropped).
[out]	result	A reference to a bool set to the function result.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender, isDropped) and should return a boolean

Definition at line 266 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by uiLocatedNode::onDndFinished().

◆ UI_ExecuteLuaEventScript_DragDrop_XY()

bool UI_ExecuteLuaEventScript_DragDrop_XY	(	uiNode_t *	node,
		LUA_EVENT	event,
		int	x,
		int	y,
		bool &	result )

Executes a lua event handler for dragdrop interaction.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[in]	x	The x value of the call signature (x, y)
[in]	y	The y value of the call signature (x, y)
[out]	result	A reference to a bool set to the function result.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender, x, y) and should return a boolean

Definition at line 238 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by uiLocatedNode::onDndDrop(), and uiLocatedNode::onDndMove().

◆ UI_ExecuteLuaEventScript_DxDy()

bool UI_ExecuteLuaEventScript_DxDy	(	uiNode_t *	node,
		LUA_EVENT	event,
		int	dx,
		int	dy )

Executes a lua event handler with (dx,dy) argument.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[in]	dx	The dx-coordinate of the (dx,dy) argument.
[in]	dy	The dy-coordinate of the (dx,dy) argument.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender, dx, dy)

Definition at line 166 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by uiLocatedNode::onScroll().

◆ UI_ExecuteLuaEventScript_Key()

bool UI_ExecuteLuaEventScript_Key	(	uiNode_t *	node,
		LUA_EVENT	event,
		unsigned int	key,
		unsigned short	unicode )

Executes a lua event handler with (keycode,unicode) argument.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[in]	key	The key value of the (keycode,unicode) argument.
[in]	unicode	The unicode value of the (keycode,unicode) argument.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender, key, unicode)

Definition at line 189 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), key, uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, UI_GetPath(), and unicode.

Referenced by uiLocatedNode::onKeyPressed(), and uiLocatedNode::onKeyReleased().

◆ UI_ExecuteLuaEventScript_ParamList()

bool UI_ExecuteLuaEventScript_ParamList	(	uiNode_t *	node,
		LUA_EVENT	event,
		linkedList_t *	params )

Executes a lua event handler with string parameter list.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[in]	params	LinkedLst of strings

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender, ...)

Definition at line 91 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), LIST_Foreach, uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by uiWindowNode::onWindowOpened().

◆ UI_ExecuteLuaEventScript_ReturnBool()

bool UI_ExecuteLuaEventScript_ReturnBool	(	uiNode_t *	node,
		LUA_EVENT	event,
		bool &	result )

Executes a lua event handler and returns the result as a boolean.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[in,out]	result	The boolean value returned by the lua script.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender) and must return a boolean value

Definition at line 116 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by UI_CheckVisibility().

◆ UI_ExecuteLuaEventScript_XY()

bool UI_ExecuteLuaEventScript_XY	(	uiNode_t *	node,
		LUA_EVENT	event,
		int	x,
		int	y )

Executes a lua event handler with (x,y) argument.

Parameters

[in]	node	The node the event handler is associated with.
[in]	event	The event to execute.
[in]	x	The x-coordinate of the (x,y) argument.
[in]	y	The y-coordinate of the (x,y) argument.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the event handler in lua is: onevent(sender, x, y)

Definition at line 143 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by uiCheckBoxNode::onLeftClick(), uiLocatedNode::onLeftClick(), uiRadioButtonNode::onLeftClick(), uiText2Node::onLeftClick(), uiTextEntryNode::onLeftClick(), uiTextListNode::onLeftClick(), uiTextNode::onLeftClick(), uiLocatedNode::onMiddleClick(), and uiLocatedNode::onRightClick().

◆ UI_ExecuteLuaMethod()

bool UI_ExecuteLuaMethod	(	uiNode_t *	node,
		LUA_FUNCTION	fcn,
		linkedList_t *	params,
		int	nparams )

Executes a lua based method defined on the behaviour class of a node.

Parameters

[in]	node	The node the method is defined on.
[in]	fcn	The The method to execute.
[in]	params	A linked list of parameters for the lua based function call.
[in]	nparams	The number of parameters for the lua based function call.

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the method in lua is: function(sender, p1..pn), so the actual number of parameters for the function is actually nparams + 1.; All parameters are send to lua as strings.

Definition at line 295 of file ui_lua.cpp.

References uiNode_t::behaviour, CL_GetLuaState(), Com_Printf(), i, LIST_GetByIdx(), uiBehaviour_t::lua_SWIG_typeinfo, uiBehaviour_t::name, SWIG_NewPointerObj, and UI_GetPath().

Referenced by UI_ExecuteCallAction(), and UI_ExecuteLuaMethod_ByName().

◆ UI_ExecuteLuaMethod_ByName()

bool UI_ExecuteLuaMethod_ByName	(	uiNode_t *	node,
		const char *	name,
		linkedList_t *	params,
		int	nparams )

Executes a lua based method defined on the behaviour class of a node.

Parameters

[in]	node	The node the method is defined on
[in]	name	The name of the node
[in]	params	List of Lua method parameters
[in]	nparams	Number of parameters on the list

Returns: True if the operation succeeds, false otherwise.

Note: The signature of the method in lua is: function(sender)

Definition at line 350 of file ui_lua.cpp.

References Com_Printf(), name, uiNode_t::name, UI_ExecuteLuaMethod(), and UI_GetNodeMethod().

◆ UI_InitLua()

void UI_InitLua ( void )

Performs UI specific initialization. Call this after CL_InitLua.

Definition at line 55 of file ui_lua.cpp.

Referenced by UI_Init().

◆ UI_Node_TypeOf()

const char * UI_Node_TypeOf ( uiNode_t * node )

Definition at line 529 of file ui_lua.cpp.

References uiNode_t::behaviour, and uiBehaviour_t::name.

◆ UI_ParseAndLoadLuaScript()

bool UI_ParseAndLoadLuaScript	(	const char *	name,
		const char **	text )

Parses and loads a .ufo file holding a lua script.

Parameters

[in]	name	The name of the .ufo file (holding the lua script).
[in]	text	The contents of the .ufo file, only provided to be in line with code handling other .ufo content types.

See also: CL_ParseClientData

Returns: True if parsing was succesful, false otherwise.

Note: All parsed lua files will be added to the lua state.

Definition at line 386 of file ui_lua.cpp.

References CL_GetLuaState(), Com_Error(), Com_Printf(), name, Q_strncpyz(), UI_CallHandler_OnLoad(), and ui_scriptname.

Referenced by CL_ParseClientData(), and UI_Restart_f().

◆ UI_PrintNodeTree()

void UI_PrintNodeTree	(	uiNode_t *	node,
		int	level )

Definition at line 513 of file ui_lua.cpp.

References Com_Printf(), uiNode_t::firstChild, i, level, uiNode_t::name, uiNode_t::next, and UI_PrintNodeTree().

Referenced by _wrap_nodetree(), and UI_PrintNodeTree().

◆ UI_RegisterHandler_OnLoad()

void UI_RegisterHandler_OnLoad ( LUA_FUNCTION fcn )

Register global lua callback function called after loading the module.

Definition at line 363 of file ui_lua.cpp.

References CL_RegisterCallback(), and ui_scriptname.

Referenced by _wrap_register_onload().

◆ UI_ShutdownLua()

void UI_ShutdownLua ( void )

Performs UI specific lua shutdown. Call this before CL_ShutdownLua.

Definition at line 61 of file ui_lua.cpp.

Referenced by UI_Shutdown().

Variable Documentation

◆ ui_scriptname

char ui_scriptname[256] = ""

Definition at line 49 of file ui_lua.cpp.

Referenced by UI_ParseAndLoadLuaScript(), and UI_RegisterHandler_OnLoad().

Functions

Variables

Detailed Description

Function Documentation

◆ UI_CallHandler_OnLoad()

◆ UI_CreateComponent()

◆ UI_CreateControl()

◆ UI_CreateWindow()

◆ UI_ExecuteLuaConFunc()

◆ UI_ExecuteLuaEventScript()

◆ UI_ExecuteLuaEventScript_DragDrop()

◆ UI_ExecuteLuaEventScript_DragDrop_IsDropped()

◆ UI_ExecuteLuaEventScript_DragDrop_XY()

◆ UI_ExecuteLuaEventScript_DxDy()

◆ UI_ExecuteLuaEventScript_Key()

◆ UI_ExecuteLuaEventScript_ParamList()

◆ UI_ExecuteLuaEventScript_ReturnBool()

◆ UI_ExecuteLuaEventScript_XY()

◆ UI_ExecuteLuaMethod()

◆ UI_ExecuteLuaMethod_ByName()

◆ UI_InitLua()

◆ UI_Node_TypeOf()

◆ UI_ParseAndLoadLuaScript()

◆ UI_PrintNodeTree()

◆ UI_RegisterHandler_OnLoad()

◆ UI_ShutdownLua()

Variable Documentation

◆ ui_scriptname