TGUI 1.11
Loading...
Searching...
No Matches
BackendSFML.hpp
1
2//
3// TGUI - Texus' Graphical User Interface
4// Copyright (C) 2012-2025 Bruno Van de Velde (vdv_b@tgui.eu)
5//
6// This software is provided 'as-is', without any express or implied warranty.
7// In no event will the authors be held liable for any damages arising from the use of this software.
8//
9// Permission is granted to anyone to use this software for any purpose,
10// including commercial applications, and to alter it and redistribute it freely,
11// subject to the following restrictions:
12//
13// 1. The origin of this software must not be misrepresented;
14// you must not claim that you wrote the original software.
15// If you use this software in a product, an acknowledgment
16// in the product documentation would be appreciated but is not required.
17//
18// 2. Altered source versions must be plainly marked as such,
19// and must not be misrepresented as being the original software.
20//
21// 3. This notice may not be removed or altered from any source distribution.
22//
24
25#ifndef TGUI_BACKEND_SFML_HPP
26#define TGUI_BACKEND_SFML_HPP
27
28#include <TGUI/Config.hpp>
29#include <TGUI/Backend/Window/Backend.hpp>
30#include <TGUI/Backend/Window/SFML/BackendGuiSFML.hpp>
31
32#include <SFML/Window.hpp>
33
34#include <unordered_map>
35#include <map>
36
38
39TGUI_IGNORE_DEPRECATED_WARNINGS_START // Required for VS2017 due to inheriting a function that we deprecated
40
41namespace tgui
42{
43 class TGUI_API BackendSFML : public Backend
44 {
45 public:
46
55 void setGuiWindow(BackendGui* gui, sf::Window* window);
56
61 void detatchGui(BackendGui* gui) override;
62
71 void setMouseCursorStyle(Cursor::Type type, const std::uint8_t* pixels, Vector2u size, Vector2u hotspot) override;
72
79
86 void setMouseCursor(BackendGui* gui, Cursor::Type type) override;
87
88#ifndef TGUI_REMOVE_DEPRECATED_CODE
95 TGUI_DEPRECATED("Use BackendGui::startTextInput instead") void openVirtualKeyboard(const FloatRect& inputRect) override;
96
102 TGUI_DEPRECATED("Use BackendGui::stopTextInput instead") void closeVirtualKeyboard() override;
103#endif
104
112 TGUI_DEPRECATED("Use gui.isKeyboardModifierPressed(modifierKey) instead") TGUI_NODISCARD bool isKeyboardModifierPressed(Event::KeyModifier modifierKey) override;
113
119 void setClipboard(const String& contents) override;
120
126 TGUI_NODISCARD String getClipboard() const override;
127
128#ifdef TGUI_SYSTEM_ANDROID
137 TGUI_NODISCARD std::unique_ptr<std::uint8_t[]> readFileFromAndroidAssets(const String& filename, std::size_t& fileSize) const override;
138#endif
139
151 static void cleanupLeakedCursors();
152
154 protected:
155
157 // Helper function to create a system cursor
159 TGUI_NODISCARD std::unique_ptr<sf::Cursor> createSystemCursor(Cursor::Type type);
160
162 // Helper function to update the mouse cursors on all attached guis
164 void updateMouseCursor(Cursor::Type type, std::unique_ptr<sf::Cursor> cursor);
165
167 // Helper function to update the mouse cursor on a window
169 void updateMouseCursor(sf::Window* window, Cursor::Type type);
170
172 protected:
173
174 struct GuiResources
175 {
176 sf::Window* window = nullptr;
177 Cursor::Type mouseCursor = Cursor::Type::Arrow;
178 };
179
180 std::unordered_map<const BackendGui*, GuiResources> m_guiResources;
181 std::unordered_map<Cursor::Type, std::unique_ptr<sf::Cursor>> m_mouseCursors;
182
183 static std::vector<std::unique_ptr<sf::Cursor>> m_leakedCursors;
184 };
185
187}
188
189TGUI_IGNORE_DEPRECATED_WARNINGS_END
190
192
193#endif // TGUI_BACKEND_SFML_HPP
Base class for the Gui.
Definition BackendGui.hpp:45
Definition BackendSFML.hpp:44
void setClipboard(const String &contents) override
Changes the contents of the clipboard.
bool isKeyboardModifierPressed(Event::KeyModifier modifierKey) override
Checks the state for one of the modifier keys.
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.
void setGuiWindow(BackendGui *gui, sf::Window *window)
Informs the backend which window belongs to the gui.
void resetMouseCursorStyle(Cursor::Type type) override
Changes the look of a certain mouse cursor back to the system theme.
String getClipboard() const override
Returns the contents of the clipboard.
void detatchGui(BackendGui *gui) override
Informs the backend that a gui object is being destroyed.
void openVirtualKeyboard(const FloatRect &inputRect) override
Opens the virtual keyboard on Android and iOS.
static void cleanupLeakedCursors()
Destroys any leaked cursors.
void closeVirtualKeyboard() override
Closes the virtual keyboard on Android and iOS.
void setMouseCursor(BackendGui *gui, Cursor::Type type) override
Changes the mouse cursor when the mouse is on top of the window to which the gui is attached.
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.
Backend()=default
Default constructor.
Type
List of available cursors.
Definition Cursor.hpp:48
@ Arrow
Arrow cursor (default)
Definition Cursor.hpp:49
Wrapper class to store strings.
Definition String.hpp:94
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:36
Definition Event.hpp:38