Base class for the backend. More...

#include <TGUI/Backend/Window/Backend.hpp>

Inheritance diagram for tgui::Backend:

Public Member Functions
	Backend ()=default
	Default constructor.

	Backend (const Backend &)=delete

Backend &	operator= (const Backend &)=delete

virtual	~Backend ()=default
	Virtual destructor.

void	setDestroyOnLastGuiDetatch (bool destroyOnDetatch)
	Informs the backend whether it should destroy itself when the last Gui is detached from it. More...

virtual void	attachGui (BackendGui *gui)=0
	Informs the backend that a new gui object has been created. More...

virtual void	detatchGui (BackendGui *gui)=0
	Informs the backend that a gui object is being destroyed. More...

virtual Font	createDefaultFont ()
	Creates and returns the default font for all widgets. More...

std::shared_ptr< BackendFont >	createFont ()
	Creates a new font object. More...

std::shared_ptr< BackendText >	createText ()
	Creates a new text object. More...

std::shared_ptr< BackendTexture >	createTexture ()
	Creates a new texture object. More...

virtual void	setMouseCursorStyle (Cursor::Type type, const std::uint8_t *pixels, Vector2u size, Vector2u hotspot)=0
	Changes the look of a certain mouse cursor by using a bitmap. More...

virtual void	resetMouseCursorStyle (Cursor::Type type)=0
	Changes the look of a certain mouse cursor back to the system theme. More...

virtual void	setMouseCursor (BackendGui *gui, Cursor::Type type)=0
	Changes the mouse cursor when the mouse is on top of the window to which the gui is attached. More...

virtual void	openVirtualKeyboard (const FloatRect &inputRect)
	Opens the virtual keyboard on Android and iOS. More...

virtual void	closeVirtualKeyboard ()
	Closes the virtual keyboard on Android and iOS. More...

virtual bool	isKeyboardModifierPressed (Event::KeyModifier modifierKey)=0
	Checks the state for one of the modifier keys. More...

virtual void	setClipboard (const String &contents)
	Changes the contents of the clipboard. More...

virtual String	getClipboard () const
	Returns the contents of the clipboard. More...

virtual std::unique_ptr< std::uint8_t[]>	readFileFromAndroidAssets (const String &filename, std::size_t &fileSize) const
	Uses the AssetManager on Android to read a file and return its contents. More...

bool	hasRenderer () const
	Checks whether a renderer has been attached to the backend. More...

std::shared_ptr< BackendRenderer >	getRenderer () const
	Returns the renderer. More...

virtual void	setRenderer (std::shared_ptr< BackendRenderer > renderer)
	Sets the renderer that the backend should use. More...

bool	hasFontBackend () const
	Checks whether a font factory has been attached to the backend. More...

std::shared_ptr< BackendFontFactory >	getFontBackend () const
	Returns the font factory. More...

virtual void	setFontBackend (std::shared_ptr< BackendFontFactory > fontBackend)
	Sets the font factory that the backend should use. More...

Protected Attributes
bool	m_destroyOnLastGuiDetatch = false

String	m_clipboardContents

std::shared_ptr< BackendRenderer >	m_renderer

std::shared_ptr< BackendFontFactory >	m_fontBackend

Detailed Description

Base class for the backend.

Member Function Documentation

◆ attachGui()

virtual void tgui::Backend::attachGui ( BackendGui * gui )

pure virtual

Informs the backend that a new gui object has been created.

Parameters

gui	Newly created gui

Implemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ closeVirtualKeyboard()

virtual void tgui::Backend::closeVirtualKeyboard ( )

virtual

Closes the virtual keyboard on Android and iOS.

If this function isn't overriden then calling it does nothing.

Reimplemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ createDefaultFont()

virtual Font tgui::Backend::createDefaultFont ( )

virtual

Creates and returns the default font for all widgets.

Returns: Default font

◆ createFont()

std::shared_ptr< BackendFont > tgui::Backend::createFont ( )

Creates a new font object.

Returns: Font that is specific to the backend

◆ createText()

std::shared_ptr< BackendText > tgui::Backend::createText ( )

Creates a new text object.

Returns: Text that is specific to the backend

◆ createTexture()

std::shared_ptr< BackendTexture > tgui::Backend::createTexture ( )

Creates a new texture object.

Returns: Texture that is specific to the backend

◆ detatchGui()

virtual void tgui::Backend::detatchGui ( BackendGui * gui )

pure virtual

Informs the backend that a gui object is being destroyed.

Parameters

gui	Gui object that is about to be deconstructed

Implemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ getClipboard()

virtual String tgui::Backend::getClipboard ( ) const

virtual

Returns the contents of the clipboard.

Returns: Clipboard contents

Reimplemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ getFontBackend()

std::shared_ptr< BackendFontFactory > tgui::Backend::getFontBackend ( ) const

Returns the font factory.

Returns: Font factory attached to the backend

Warning: This function will assert if no font factory has been set.

See also: hasFontBackend()

◆ getRenderer()

std::shared_ptr< BackendRenderer > tgui::Backend::getRenderer ( ) const

Returns the renderer.

Returns: Renderer attached to the backend

Warning: This function will assert if no renderer has been set.

See also: hasRenderer()

◆ hasFontBackend()

bool tgui::Backend::hasFontBackend ( ) const

Checks whether a font factory has been attached to the backend.

Returns: Has setFontBackend been called with a valid font factory?

◆ hasRenderer()

bool tgui::Backend::hasRenderer ( ) const

Checks whether a renderer has been attached to the backend.

Returns: Has setRenderer been called with a valid backend renderer?

◆ isKeyboardModifierPressed()

virtual bool tgui::Backend::isKeyboardModifierPressed ( Event::KeyModifier modifierKey )

pure virtual

Checks the state for one of the modifier keys.

Parameters

modifierKey The modifier key of which the state is being queried

Returns: Whether queries modifier key is being pressed

Implemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ openVirtualKeyboard()

virtual void tgui::Backend::openVirtualKeyboard ( const FloatRect & inputRect )

virtual

Opens the virtual keyboard on Android and iOS.

Parameters

inputRect Part of the screen where the text input is located

If this function isn't overriden then calling it does nothing.

Reimplemented in tgui::BackendSDL, and tgui::BackendSFML.

◆ readFileFromAndroidAssets()

virtual std::unique_ptr< std::uint8_t[]> tgui::Backend::readFileFromAndroidAssets	(	const String &	filename,
		std::size_t &	fileSize
	)		const

virtual

Uses the AssetManager on Android to read a file and return its contents.

Parameters

filename	Path to the file to read
fileSize	Size of the file, to be filled in by this function if loading succeeds (untouched on failure)

Returns: File contents if the file was successfully read, or a nullptr on failure or if platform isn't Android.

◆ resetMouseCursorStyle()

virtual void tgui::Backend::resetMouseCursorStyle ( Cursor::Type type )

pure virtual

Changes the look of a certain mouse cursor back to the system theme.

Parameters

type	Cursor that should no longer use a custom bitmap

Implemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ setClipboard()

virtual void tgui::Backend::setClipboard ( const String & contents )

virtual

Changes the contents of the clipboard.

Parameters

contents New contents of the clipboard

Reimplemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ setDestroyOnLastGuiDetatch()

void tgui::Backend::setDestroyOnLastGuiDetatch ( bool destroyOnDetatch )

Informs the backend whether it should destroy itself when the last Gui is detached from it.

Parameters

destroyOnDetatch Should setBackend(nullptr) be called when there are no more Gui objects left?

This function will be called with "true" as parameter if the Backend is created by a Gui object.

◆ setFontBackend()

virtual void tgui::Backend::setFontBackend ( std::shared_ptr< BackendFontFactory > fontBackend )

virtual

Sets the font factory that the backend should use.

Parameters

fontBackend Font factory to attach to the backend

◆ setMouseCursor()

virtual void tgui::Backend::setMouseCursor	(	BackendGui *	gui,
		Cursor::Type	type
	)

pure virtual

Changes the mouse cursor when the mouse is on top of the window to which the gui is attached.

Parameters

gui	The gui that represents the window for which the mouse cursor should be changed
type	Which cursor to use

Implemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ setMouseCursorStyle()

virtual void tgui::Backend::setMouseCursorStyle	(	Cursor::Type	type,
		const std::uint8_t *	pixels,
		Vector2u	size,
		Vector2u	hotspot
	)

pure virtual

Changes the look of a certain mouse cursor by using a bitmap.

Parameters

type	Cursor that should make use of the bitmap
pixels	Pointer to an array with 4size.xsize.y elements, representing the pixels in 32-bit RGBA format
size	Size of the cursor
hotspot	Pixel coordinate within the cursor image which will be located exactly at the mouse pointer position

Implemented in tgui::BackendGLFW, tgui::BackendSDL, and tgui::BackendSFML.

◆ setRenderer()

virtual void tgui::Backend::setRenderer ( std::shared_ptr< BackendRenderer > renderer )

virtual

Sets the renderer that the backend should use.

Parameters

renderer Renderer to attach to the backend

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

include/TGUI/Backend/Window/Backend.hpp

TGUI

Public Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ attachGui()

◆ closeVirtualKeyboard()

◆ createDefaultFont()

◆ createFont()

◆ createText()

◆ createTexture()

◆ detatchGui()

◆ getClipboard()

◆ getFontBackend()

◆ getRenderer()

◆ hasFontBackend()

◆ hasRenderer()

◆ isKeyboardModifierPressed()

◆ openVirtualKeyboard()

◆ readFileFromAndroidAssets()

◆ resetMouseCursorStyle()

◆ setClipboard()

◆ setDestroyOnLastGuiDetatch()

◆ setFontBackend()

◆ setMouseCursor()

◆ setMouseCursorStyle()

◆ setRenderer()