EngineController Class Reference

#include <EngineController.h>

Public Types
using	GameRoutine = std::function< void()>

Public Member Functions
	EngineController (EngineControlStateHandle state)
	~EngineController ()
void	tick (int count=1)
void	postEvent (std::unique_ptr< PlatformEvent > event)
void	pressKey (PlatformKey key)
void	pressAutoRepeatedKey (PlatformKey key)
void	releaseKey (PlatformKey key)
void	pressButton (PlatformMouseButton button, int x, int y)
void	releaseButton (PlatformMouseButton button, int x, int y)
void	moveMouse (int x, int y)
void	pressAndReleaseKey (PlatformKey key)
void	pressAndReleaseButton (PlatformMouseButton button, int x, int y)
void	pressGuiButton (std::string_view buttonId)
void	goToGame ()
void	goToInventory (int characterIndex)
void	goToMainMenu ()
void	startNewGame ()
void	skipLoadingScreen ()
Blob	saveGame ()
void	loadGame (const Blob &savedGame)
void	runGameRoutine (GameRoutine routine)
void	resizeWindow (int w, int h)
void	restAndHeal ()
Actor *	spawnMonster (Vec3f position, MonsterId id)
void	teleportTo (MapId map, Vec3f position, int viewYaw)
void	castSpell (int characterIndex, SpellId spell)

Private Member Functions
void	goToGameOrMainMenu ()
GUIButton *	existingButton (std::string_view buttonId)

Private Attributes
EngineControlStateHandle	_state

Detailed Description

This is the interface to be used from a control routine to control the game thread.

Most errors are reported as exceptions (derived from std::runtime_error) because the main way to use this class is from unit tests.

Member Typedef Documentation

GameRoutine

using EngineController::GameRoutine = std::function<void()>

Constructor & Destructor Documentation

EngineController()

EngineController::EngineController ( EngineControlStateHandle  state )

explicit

~EngineController()

EngineController::~EngineController ( )

default

Member Function Documentation

castSpell()

void EngineController::castSpell	(	int	characterIndex,
		SpellId	spell
	)

existingButton()

GUIButton * EngineController::existingButton ( std::string_view  buttonId )

private

goToGame()

void EngineController::goToGame

(

)

Closes all menus and goes to the game screen. Will fail if main menu is currently open.

goToGameOrMainMenu()

void EngineController::goToGameOrMainMenu ( )

private

goToInventory()

void EngineController::goToInventory

(

int

characterIndex

)

goToMainMenu()

void EngineController::goToMainMenu

(

)

Opens main menu no matter the current game state.

loadGame()

void EngineController::loadGame

(

const Blob &

savedGame

)

Loads the game by opening up the load game menu and actually clicking all the buttons.

Parameters

savedGame

Blob containing saved game data.

moveMouse()

void EngineController::moveMouse	(	int	x,
		int	y
	)

postEvent()

void EngineController::postEvent

(

std::unique_ptr< PlatformEvent >

event

)

pressAndReleaseButton()

void EngineController::pressAndReleaseButton	(	PlatformMouseButton	button,
		int	x,
		int	y
	)

pressAndReleaseKey()

void EngineController::pressAndReleaseKey

(

PlatformKey

key

)

pressAutoRepeatedKey()

void EngineController::pressAutoRepeatedKey

(

PlatformKey

key

)

pressButton()

void EngineController::pressButton	(	PlatformMouseButton	button,
		int	x,
		int	y
	)

pressGuiButton()

void EngineController::pressGuiButton

(

std::string_view

buttonId

)

Presses a GUI button identified by the provided id by sending a mouse press and release event.

Parameters

buttonId

Button id.

Exceptions

Exception

If the button with the provided id doesn't exist.

pressKey()

void EngineController::pressKey

(

PlatformKey

key

)

releaseButton()

void EngineController::releaseButton	(	PlatformMouseButton	button,
		int	x,
		int	y
	)

releaseKey()

void EngineController::releaseKey

(

PlatformKey

key

)

resizeWindow()

void EngineController::resizeWindow	(	int	w,
		int	h
	)

restAndHeal()

void EngineController::restAndHeal

(

)

Opens up the rest menu, presses the "rest and heal for 8 hours" button, and waits out the rest period.

runGameRoutine()

void EngineController::runGameRoutine

(

GameRoutine

routine

)

Runs the provided routine in game thread and returns once it's finished. This is mainly for running OpenGL code as the corresponding context is bound in the main thread.

Parameters

routine

Routine to run.

saveGame()

Blob EngineController::saveGame

(

)

Saves the game.

Returns

Blob containing saved game data.

skipLoadingScreen()

void EngineController::skipLoadingScreen

(

)

Waits for the loading screen to complete.

Exceptions

Exception

If there is no loading screen.

spawnMonster()

Actor * EngineController::spawnMonster	(	Vec3f	position,
		MonsterId	id
	)

Parameters

position	Position to spawn a monster at.
id	Id of the monster to spawn.

Returns

Spawned monster, so you can tweak it after spawning.

startNewGame()

void EngineController::startNewGame

(

)

Start new game no matter the current game state.

teleportTo()

void EngineController::teleportTo	(	MapId	map,
		Vec3f	position,
		int	viewYaw
	)

tick()

void EngineController::tick

(

int

count = 1

)

Passes execution to the game thread for the provided number of frames. This function provides a coroutine-like interface for control routines as calling tick basically suspends the control routine until the next frame.

Parameters

count

Number of frames to suspend the control routine for.

Member Data Documentation

_state

EngineControlStateHandle EngineController::_state

private

---

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

• src/Engine/Components/Control/EngineController.h
• src/Engine/Components/Control/EngineController.cpp