TGUI  1.3-dev
Loading...
Searching...
No Matches
Picture.hpp
1
2//
3// TGUI - Texus' Graphical User Interface
4// Copyright (C) 2012-2024 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_PICTURE_HPP
27#define TGUI_PICTURE_HPP
28
29
30#include <TGUI/Widgets/ClickableWidget.hpp>
31#include <TGUI/Renderers/PictureRenderer.hpp>
32
34
35TGUI_MODULE_EXPORT namespace tgui
36{
40 class TGUI_API Picture : public ClickableWidget
41 {
42 public:
43
44 using Ptr = std::shared_ptr<Picture>;
45 using ConstPtr = std::shared_ptr<const Picture>;
46
47 static constexpr const char StaticWidgetType[] = "Picture";
48
49
57 Picture(const char* typeName = StaticWidgetType, bool initRenderer = true);
58
59
65 TGUI_NODISCARD static Picture::Ptr create();
66
67
87 TGUI_NODISCARD static Picture::Ptr create(const Texture& texture, bool transparentTexture = false);
88
89
98 TGUI_NODISCARD static Picture::Ptr copy(const Picture::ConstPtr& picture);
99
100
105 TGUI_NODISCARD PictureRenderer* getSharedRenderer() override;
106 TGUI_NODISCARD const PictureRenderer* getSharedRenderer() const override;
107
113 TGUI_NODISCARD PictureRenderer* getRenderer() override;
114
115
124 void setSize(const Layout2d& size) override;
125 using Widget::setSize;
126
127
135 void ignoreMouseEvents(bool ignore = true);
136
137
143 TGUI_NODISCARD bool isIgnoringMouseEvents() const;
144
145
152 TGUI_NODISCARD bool canGainFocus() const override;
153
154
161 TGUI_NODISCARD bool isMouseOnWidget(Vector2f pos) const override;
162
163
167 void leftMouseReleased(Vector2f pos) override;
168
169
177 void draw(BackendRenderTarget& target, RenderStates states) const override;
178
179
181 protected:
182
192 TGUI_NODISCARD Signal& getSignal(String signalName) override;
193
194
196 public:
197
198 SignalVector2f onDoubleClick = {"DoubleClicked"};
199
200
202 protected:
203
210 void rendererChanged(const String& property) override;
211
212
216 TGUI_NODISCARD std::unique_ptr<DataIO::Node> save(SavingRenderersMap& renderers) const override;
217
218
222 void load(const std::unique_ptr<DataIO::Node>& node, const LoadingRenderersMap& renderers) override;
223
224
226 // This function is called every frame with the time passed since the last frame.
228 bool updateTime(Duration elapsedTime) override;
229
230
232 // Makes a copy of the widget
234 TGUI_NODISCARD Widget::Ptr clone() const override;
235
236
238 protected:
239
240 Sprite m_sprite;
241
242 bool m_ignoringMouseEvents = false;
243
244 // Will be set to true after the first click, but gets reset to false when the second click does not occur soon after
245 bool m_possibleDoubleClick = false;
246 };
247
249}
250
252
253#endif // TGUI_PICTURE_HPP
Base class for render targets.
Definition BackendRenderTarget.hpp:48
Clickable widget.
Definition ClickableWidget.hpp:40
Wrapper for durations.
Definition Duration.hpp:56
Class to store the position or size of a widget.
Definition Layout.hpp:305
Definition PictureRenderer.hpp:37
Picture widget.
Definition Picture.hpp:41
std::shared_ptr< Picture > Ptr
Shared widget pointer.
Definition Picture.hpp:44
void draw(BackendRenderTarget &target, RenderStates states) const override
Draw the widget to a render target.
static TGUI_NODISCARD Picture::Ptr copy(const Picture::ConstPtr &picture)
Makes a copy of another picture.
TGUI_NODISCARD bool isMouseOnWidget(Vector2f pos) const override
Returns whether the mouse position (which is relative to the parent widget) lies on top of the widget...
std::shared_ptr< const Picture > ConstPtr
Shared constant widget pointer.
Definition Picture.hpp:45
static TGUI_NODISCARD Picture::Ptr create()
Creates a new empty picture widget.
TGUI_NODISCARD bool canGainFocus() const override
Returns whether the widget can gain focus.
void rendererChanged(const String &property) override
Function called when one of the properties of the renderer is changed.
TGUI_NODISCARD std::unique_ptr< DataIO::Node > save(SavingRenderersMap &renderers) const override
Saves the widget as a tree node in order to save it to a file.
TGUI_NODISCARD PictureRenderer * getRenderer() override
Returns the renderer, which gives access to functions that determine how the widget is displayed.
static TGUI_NODISCARD Picture::Ptr create(const Texture &texture, bool transparentTexture=false)
Creates a new picture widget.
TGUI_NODISCARD Signal & getSignal(String signalName) override
Retrieves a signal based on its name.
TGUI_NODISCARD bool isIgnoringMouseEvents() const
Returns whether the widget is ignoring mouse events and letting them pass to the widgets behind it.
TGUI_NODISCARD PictureRenderer * getSharedRenderer() override
Returns the renderer, which gives access to functions that determine how the widget is displayed.
void setSize(const Layout2d &size) override
Changes the size of the picture.
TGUI_NODISCARD Widget::Ptr clone() const override
Makes a copy of the widget if you don't know its exact type.
void ignoreMouseEvents(bool ignore=true)
Sets whether the widget should completely ignore mouse events and let them pass to the widgets behind...
void load(const std::unique_ptr< DataIO::Node > &node, const LoadingRenderersMap &renderers) override
Loads the widget from a tree of nodes.
Signal to which the user can subscribe to get callbacks from.
Definition Signal.hpp:62
Definition Sprite.hpp:48
Wrapper class to store strings.
Definition String.hpp:101
Texture wrapper that internally reuses resources when multiple Texture objects are loaded from the sa...
Definition Texture.hpp:57
std::shared_ptr< Widget > Ptr
Shared widget pointer.
Definition Widget.hpp:87
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:39
States used for drawing.
Definition RenderStates.hpp:39