Backend that uses SDL. More...

#include <TGUI/Backends/SDL/BackendSDL.hpp>

Inheritance diagram for tgui::BackendSDL:

Public Member Functions
	BackendSDL ()
	Default constructor.

	~BackendSDL ()
	Destructor.

void	attachGui (GuiBase *gui) override
	Informs the backend that a new gui object has been created. More...

void	detatchGui (GuiBase *gui) override
	Informs the backend that a gui object is being destroyed. More...

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

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

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

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

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

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

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

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

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

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

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

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

std::shared_ptr< BackendRenderTargetSDL >	createGuiRenderTarget (GuiSDL gui, SDL_Window window)
	Sets the SDL window to which the gui will render and returns a new render target object to interact with. More...

void	changeTexture (GLuint textureId, bool force)
	Changes the bound texture if another texture was currently set. More...

Public Member Functions inherited from tgui::BackendBase
	BackendBase ()=default
	Default constructor.

	BackendBase (const BackendBase &)=delete

BackendBase &	operator= (const BackendBase &)=delete

virtual	~BackendBase ()=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 (GuiBase *gui)=0
	Informs the backend that a new gui object has been created. More...

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

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

virtual std::shared_ptr< BackendFontBase >	createFont ()=0
	Creates a new font object. More...

virtual std::shared_ptr< BackendTextBase >	createText ()=0
	Creates a new text object. More...

virtual std::shared_ptr< BackendTextureBase >	createTexture ()=0
	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 (GuiBase *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)=0
	Opens the virtual keyboard on Android and iOS. More...

virtual void	closeVirtualKeyboard ()=0
	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...

Static Public Member Functions
static bool	convertEvent (const SDL_Event &eventSDL, Event &eventTGUI)
	Helper function that converts an SDL event to a TGUI event. More...

Additional Inherited Members
Protected Attributes inherited from tgui::BackendBase
bool	m_destroyOnLastGuiDetatch = false

String	m_clipboardContents

Detailed Description

Backend that uses SDL.

Member Function Documentation

◆ attachGui()

void tgui::BackendSDL::attachGui ( GuiBase * gui )

overridevirtual

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

Parameters

gui	Newly created gui

Implements tgui::BackendBase.

◆ changeTexture()

void tgui::BackendSDL::changeTexture	(	GLuint	textureId,
		bool	force
	)

Changes the bound texture if another texture was currently set.

Parameters

textureId	Texture to pass to glBindTexture
force	Call glBindTexture even if the id was still the same. This is required when calling this function after creating a new texture, as it could be reusing the id that was previously cached.

This function has to be used instead of glBindTexture so that the backend knows the last used texture

◆ closeVirtualKeyboard()

void tgui::BackendSDL::closeVirtualKeyboard ( )

overridevirtual

Closes the virtual keyboard on Android and iOS.

Implements tgui::BackendBase.

◆ convertEvent()

static bool tgui::BackendSDL::convertEvent	(	const SDL_Event &	eventSDL,
		Event &	eventTGUI
	)

static

Helper function that converts an SDL event to a TGUI event.

Parameters

eventSFML	The input SDL event
eventTGUI	The output TGUI event

Returns: Did the SDL event match on a TGUI event and has the output event been written to?

◆ createDefaultFont()

Font tgui::BackendSDL::createDefaultFont ( )

overridevirtual

Creates and returns the default font for all widgets.

Returns: Default font

Implements tgui::BackendBase.

◆ createFont()

std::shared_ptr< BackendFontBase > tgui::BackendSDL::createFont ( )

overridevirtual

Creates a new font object.

Returns: Font that is specific to the backend

Implements tgui::BackendBase.

◆ createGuiRenderTarget()

std::shared_ptr< BackendRenderTargetSDL > tgui::BackendSDL::createGuiRenderTarget	(	GuiSDL *	gui,
		SDL_Window *	window
	)

Sets the SDL window to which the gui will render and returns a new render target object to interact with.

Parameters

gui	The gui for which the render target should be created
window	SDL window to draw on

Returns: Render target that abstracts the SDL drawing code

◆ createText()

std::shared_ptr< BackendTextBase > tgui::BackendSDL::createText ( )

overridevirtual

Creates a new text object.

Returns: Text that is specific to the backend

Implements tgui::BackendBase.

◆ createTexture()

std::shared_ptr< BackendTextureBase > tgui::BackendSDL::createTexture ( )

overridevirtual

Creates a new texture object.

Returns: Texture that is specific to the backend

Implements tgui::BackendBase.

◆ detatchGui()

void tgui::BackendSDL::detatchGui ( GuiBase * gui )

overridevirtual

Informs the backend that a gui object is being destroyed.

Parameters

gui	Gui object that is about to be deconstructed

Implements tgui::BackendBase.

◆ getClipboard()

String tgui::BackendSDL::getClipboard ( ) const

overridevirtual

Returns the contents of the clipboard.

Returns: Clipboard contents

Reimplemented from tgui::BackendBase.

◆ isKeyboardModifierPressed()

bool tgui::BackendSDL::isKeyboardModifierPressed ( Event::KeyModifier modifierKey )

overridevirtual

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

Implements tgui::BackendBase.

◆ openVirtualKeyboard()

void tgui::BackendSDL::openVirtualKeyboard ( const FloatRect & inputRect )

overridevirtual

Opens the virtual keyboard on Android and iOS.

Parameters

inputRect Part of the screen where the text input is located

Implements tgui::BackendBase.

◆ resetMouseCursorStyle()

void tgui::BackendSDL::resetMouseCursorStyle ( Cursor::Type type )

overridevirtual

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

Parameters

type	Cursor that should no longer use a custom bitmap

Implements tgui::BackendBase.

◆ setClipboard()

void tgui::BackendSDL::setClipboard ( const String & contents )

overridevirtual

Changes the contents of the clipboard.

Parameters

contents New contents of the clipboard

Reimplemented from tgui::BackendBase.

◆ setMouseCursor()

void tgui::BackendSDL::setMouseCursor	(	GuiBase *	gui,
		Cursor::Type	type
	)

overridevirtual

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

Implements tgui::BackendBase.

◆ setMouseCursorStyle()

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

overridevirtual

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

Implements tgui::BackendBase.

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

include/TGUI/Backends/SDL/BackendSDL.hpp

TGUI

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ attachGui()

◆ changeTexture()

◆ closeVirtualKeyboard()

◆ convertEvent()

◆ createDefaultFont()

◆ createFont()

◆ createGuiRenderTarget()

◆ createText()

◆ createTexture()

◆ detatchGui()

◆ getClipboard()

◆ isKeyboardModifierPressed()

◆ openVirtualKeyboard()

◆ resetMouseCursorStyle()

◆ setClipboard()

◆ setMouseCursor()

◆ setMouseCursorStyle()