TGUI  0.10-beta
BackendSDL.hpp
1
2//
3// TGUI - Texus' Graphical User Interface
4// Copyright (C) 2012-2022 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
26#ifndef TGUI_BACKEND_SDL_HPP
27#define TGUI_BACKEND_SDL_HPP
28
29#include <TGUI/Backend/Window/Backend.hpp>
30#include <TGUI/Backend/Window/SDL/BackendGuiSDL.hpp>
31#include <TGUI/extlibs/IncludeSDL.hpp>
32#include <unordered_map>
33#include <map>
34
36
37namespace tgui
38{
39 class TGUI_API BackendSDL : public Backend
40 {
41 public:
42
47
48
57 void setGuiWindow(BackendGui* gui, SDL_Window* window);
58
59
64 void attachGui(BackendGui* gui) override;
65
66
71 void detatchGui(BackendGui* gui) override;
72
73
82 void setMouseCursorStyle(Cursor::Type type, const std::uint8_t* pixels, Vector2u size, Vector2u hotspot) override;
83
84
91
92
99 void setMouseCursor(BackendGui* gui, Cursor::Type type) override;
100
101
106 void openVirtualKeyboard(const FloatRect& inputRect) override;
107
108
112 void closeVirtualKeyboard() override;
113
114
123
124
130 void setClipboard(const String& contents) override;
131
132
138 String getClipboard() const override;
139
140#ifdef TGUI_SYSTEM_ANDROID
149 std::unique_ptr<std::uint8_t[]> readFileFromAndroidAssets(const String& filename, std::size_t& fileSize) const override;
150#endif
151
153 private:
154
156 // Helper function to create a system cursor
158 SDL_Cursor* createSystemCursor(Cursor::Type type);
159
160
162 // Helper function to update the mouse cursors on all attached guis
164 void updateMouseCursorStyle(Cursor::Type type, SDL_Cursor* cursor);
165
166
168 // Helper function to update the mouse cursor on a window
170 void updateShownMouseCursor(SDL_Window* window, Cursor::Type type);
171
172
174 private:
175
176 struct GuiResources
177 {
178 SDL_Window* window = nullptr;
179 Cursor::Type mouseCursor = Cursor::Type::Arrow;
180 };
181
182 std::unordered_map<BackendGui*, GuiResources> m_guis;
183 std::map<Cursor::Type, SDL_Cursor*> m_mouseCursors;
184 };
185
187}
188
190
191#endif // TGUI_BACKEND_SDL_HPP
Base class for the Gui.
Definition: BackendGui.hpp:45
Definition: BackendSDL.hpp:40
void attachGui(BackendGui *gui) override
Informs the backend that a new gui object has been created.
void resetMouseCursorStyle(Cursor::Type type) override
Changes the look of a certain mouse cursor back to the system theme.
void closeVirtualKeyboard() override
Closes the virtual keyboard on Android and iOS.
bool isKeyboardModifierPressed(Event::KeyModifier modifierKey) override
Checks the state for one of the modifier keys.
~BackendSDL()
Destructor.
void detatchGui(BackendGui *gui) override
Informs the backend that a gui object is being destroyed.
void setClipboard(const String &contents) override
Changes the contents of the clipboard.
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.
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.
String getClipboard() const override
Returns the contents of the clipboard.
void openVirtualKeyboard(const FloatRect &inputRect) override
Opens the virtual keyboard on Android and iOS.
void setGuiWindow(BackendGui *gui, SDL_Window *window)
Informs the backend which window belongs to the gui.
Base class for the backend.
Definition: Backend.hpp:86
Type
List of available cursors.
Definition: Cursor.hpp:48
@ Arrow
Arrow cursor (default)
Wrapper class to store strings.
Definition: String.hpp:79
Namespace that contains all TGUI functions and classes.
Definition: AbsoluteOrRelativeValue.hpp:36
KeyModifier
Modifiers keys.
Definition: Event.hpp:156