PLEngine::ScriptApplication Class Reference

Script application class. More...

#include <ScriptApplication.h>

Inheritance diagram for PLEngine::ScriptApplication:

List of all members.

Public Member Functions
PL_API	ScriptApplication (PLCore::Frontend &cFrontend)
	Constructor.
PL_API	ScriptApplication (PLCore::Frontend &cFrontend, PLCore::String sScriptFilename)
	Constructor for loading in and executing a scripted stand-alone application using just a single line of C++ code.
PL_API	ScriptApplication (PLCore::Frontend &cFrontend, PLCore::String sScriptFilename, PLCore::String sName, PLCore::String sTitle, PLCore::String sAppDataSubdir)
	Constructor for loading in and executing a scripted stand-alone application using just a single line of C++ code.
virtual PL_API	~ScriptApplication ()
	Destructor.
PL_API PLCore::String	GetBaseDirectory () const
	Returns the base directory of the application.
PL_API void	SetBaseDirectory (const PLCore::String &sBaseDirectory)
	Sets the base directory of the application.
Protected Member Functions
virtual PL_API bool	OnStart () override
	Initialization function that is called prior to OnInit()
virtual PL_API void	OnStop () override
	De-initialization function that is called after OnDeInit()
virtual PL_API void	OnUpdate () override
	Called to let the frontend update it's states.
PL_API bool	LoadScript (const PLCore::String &sFilename)
	Loads a script.
PL_API void	DestroyScript ()
	Destroys the currently used script.
Protected Attributes
PLCore::String	m_sCurrentSceneBaseDirectory
PLCore::String	m_sScriptFilename
PLCore::Script *	m_pScript

---

Detailed Description

Script application class.

Remarks:

This class can load in and execute a given script out of the box.

Note:

• If a script filename was given to the constructor, the script is started within the "OnInit()"-method
• Adds the global variable "this" to the script so that it's able to access "this" RTTI class instance

---

Constructor & Destructor Documentation

PL_API PLEngine::ScriptApplication::ScriptApplication

(

PLCore::Frontend &

cFrontend

)

Constructor.

Parameters:

[in]

cFrontend

Frontend this application instance is running in

PL_API PLEngine::ScriptApplication::ScriptApplication	(	PLCore::Frontend &	cFrontend,
		PLCore::String	sScriptFilename
	)

Constructor for loading in and executing a scripted stand-alone application using just a single line of C++ code.

Parameters:

[in]	cFrontend	Frontend this application instance is running in
[in]	sScriptFilename	Filename of the script to load

Remarks:

		*    Usage example:
		*    int PLMain(const String &sExecutableFilename, const Array<String> &lstArguments)
		*    {
		*        return ScriptApplication("Data/Scripts/45ScriptApplication.lua").Run(sExecutableFilename, lstArguments);
		*    }
		*  

PL_API PLEngine::ScriptApplication::ScriptApplication	(	PLCore::Frontend &	cFrontend,
		PLCore::String	sScriptFilename,
		PLCore::String	sName,
		PLCore::String	sTitle,
		PLCore::String	sAppDataSubdir
	)

Constructor for loading in and executing a scripted stand-alone application using just a single line of C++ code.

Parameters:

[in]	cFrontend	Frontend this application instance is running in
[in]	sScriptFilename	Filename of the script to load
[in]	sName	Optional name of the application, if empty string a name is constructed automatically by using the filename of the script
[in]	sTitle	Optional title of the application, if empty string a title is constructed automatically by using the filename of the script
[in]	sAppDataSubdir	Optional subdirectory for application data files, if empty string a directory is constructed automatically by using the filename of the script

Remarks:

		*    Usage example:
		*    int PLMain(const String &sExecutableFilename, const Array<String> &lstArguments)
		*    {
		*        return ScriptApplication("Data/Scripts/45ScriptApplication.lua").Run(sExecutableFilename, lstArguments);
		*    }
		*  

virtual PL_API PLEngine::ScriptApplication::~ScriptApplication

(

)

[virtual]

Destructor.

---

Member Function Documentation

PL_API PLCore::String PLEngine::ScriptApplication::GetBaseDirectory

(

)

const

Returns the base directory of the application.

Returns:

The base directory of the application

PL_API void PLEngine::ScriptApplication::SetBaseDirectory

(

const PLCore::String &

sBaseDirectory

)

Sets the base directory of the application.

Parameters:

[in]

sBaseDirectory

The base directory of the application

virtual PL_API bool PLEngine::ScriptApplication::OnStart

(

)

[override, protected, virtual]

Initialization function that is called prior to OnInit()

Returns:

'true' if all went fine, else 'false' which will stop the application

Remarks:

The default implementation does the following tasks:

• Everything that EngineApplication::OnStart() does
• Load the script given to the constructor
• Call optional <OnInitFunction> script function
• Return and go on with OnInit()

Reimplemented from PLEngine::EngineApplication.

virtual PL_API void PLEngine::ScriptApplication::OnStop

(

)

[override, protected, virtual]

De-initialization function that is called after OnDeInit()

Remarks:

The default implementation does the following tasks:

• Call optional <OnDeInitFunction> script function
• Destroy the script
• Everything that EngineApplication::OnStop() does

Reimplemented from PLEngine::EngineApplication.

virtual PL_API void PLEngine::ScriptApplication::OnUpdate

(

)

[override, protected, virtual]

Called to let the frontend update it's states.

Remarks:

The default implementation does the following tasks:

• Everything that EngineApplication::OnUpdate() does
• Call optional <OnUpdateFunction> script function

Reimplemented from PLEngine::EngineApplication.

PL_API bool PLEngine::ScriptApplication::LoadScript

(

const PLCore::String &

sFilename

)

[protected]

Loads a script.

Parameters:

[in]

sFilename

Filename of the script to load

Returns:

'true' if all went fine, else 'false'

Note:

• Calls the optional script function <OnInitFunction>

PL_API void PLEngine::ScriptApplication::DestroyScript

(

)

[protected]

Destroys the currently used script.

Note:

• Calls the optional script function <OnDeInitFunction>

---

Member Data Documentation

PLCore::String PLEngine::ScriptApplication::m_sCurrentSceneBaseDirectory [protected]

Base directory of the currently loaded scene

PLCore::String PLEngine::ScriptApplication::m_sScriptFilename [protected]

Filename of the used script

PLCore::Script* PLEngine::ScriptApplication::m_pScript [protected]

Used script instance, can be a null pointer

---

The documentation for this class was generated from the following file:

• ScriptApplication.h