TGUI  1.6.1
Loading...
Searching...
No Matches
CanvasSFML.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#ifndef TGUI_CANVAS_SFML_HPP
26#define TGUI_CANVAS_SFML_HPP
27
28#include <TGUI/Backend/Renderer/SFML-Graphics/BackendTextureSFML.hpp>
29
30#if !TGUI_BUILD_AS_CXX_MODULE
31 #include <TGUI/Backend/Renderer/BackendRenderTarget.hpp>
32 #include <TGUI/Widgets/CanvasBase.hpp>
33#endif
34
35#include <SFML/Graphics/RenderTexture.hpp>
36#include <SFML/Graphics/Sprite.hpp>
37
39
40TGUI_MODULE_EXPORT namespace tgui
41{
68 class TGUI_API CanvasSFML : public CanvasBase
69 {
70 public:
71
72 using Ptr = std::shared_ptr<CanvasSFML>;
73 using ConstPtr = std::shared_ptr<const CanvasSFML>;
74
75 static constexpr const char StaticWidgetType[] = "CanvasSFML";
76
84 CanvasSFML(const char* typeName = StaticWidgetType, bool initRenderer = true);
85
89 CanvasSFML(const CanvasSFML& copy);
90
94 CanvasSFML(CanvasSFML&& copy) noexcept;
95
99 CanvasSFML& operator= (const CanvasSFML& right);
100
104 CanvasSFML& operator= (CanvasSFML&& right) noexcept;
105
113 TGUI_NODISCARD static CanvasSFML::Ptr create(const Layout2d& size = {"100%", "100%"});
114
122 TGUI_NODISCARD static CanvasSFML::Ptr copy(const CanvasSFML::ConstPtr& canvas);
123
129 void setSize(const Layout2d& size) override;
130 using Widget::setSize;
131
145 void setView(const sf::View& view);
146
152 TGUI_NODISCARD const sf::View& getView() const;
153
161 TGUI_NODISCARD sf::View getDefaultView() const;
162
171 TGUI_NODISCARD IntRect getViewport() const;
172
180 void clear(Color color = Color::Black);
181
188 void draw(const sf::Drawable& drawable, const sf::RenderStates& states = {});
189
198 void draw(const sf::Vertex* vertices, std::size_t vertexCount,
199 sf::PrimitiveType type, const sf::RenderStates& states = {});
200
209 void draw(const Sprite& sprite, const RenderStates& states = {});
210
217 void display();
218
225 void draw(BackendRenderTarget& target, RenderStates states) const override;
226
234 TGUI_NODISCARD sf::RenderTexture& getRenderTexture()
235 {
236 return m_renderTexture;
237 }
238
240 protected:
241
243 // Makes a copy of the widget
245 TGUI_NODISCARD Widget::Ptr clone() const override;
246
248 protected:
249
250 sf::View m_view;
251 sf::RenderTexture m_renderTexture;
252 Vector2u m_usedTextureSize;
253 };
254}
255
257
258#endif // TGUI_CANVAS_SFML_HPP
Base class for render targets.
Definition BackendRenderTarget.hpp:46
This class is used as base class for the backend-specific canvas widgets.
Definition CanvasBase.hpp:38
CanvasSFML provides a way to directly render SFML contents on a widget.
Definition CanvasSFML.hpp:69
static CanvasSFML::Ptr create(const Layout2d &size={"100%", "100%"})
Creates a new canvas widget.
IntRect getViewport() const
Get the viewport of the currently applied view, applied to this canvas.
void draw(const Sprite &sprite, const RenderStates &states={})
Draws a TGUI sprite to the canvas.
CanvasSFML(const CanvasSFML &copy)
Copy constructor.
void setView(const sf::View &view)
Change the current active view.
static CanvasSFML::Ptr copy(const CanvasSFML::ConstPtr &canvas)
Makes a copy of another canvas.
void setSize(const Layout2d &size) override
Changes the size of the widget.
sf::View getDefaultView() const
Get the default view of the canvas.
sf::RenderTexture & getRenderTexture()
Access the internal render texture that the canvas widget uses to draw on.
Definition CanvasSFML.hpp:234
std::shared_ptr< CanvasSFML > Ptr
Shared widget pointer.
Definition CanvasSFML.hpp:72
void draw(const sf::Vertex *vertices, std::size_t vertexCount, sf::PrimitiveType type, const sf::RenderStates &states={})
Draws primitives defined by an array of vertices.
const sf::View & getView() const
Get the view currently in use in the canvas.
void draw(const sf::Drawable &drawable, const sf::RenderStates &states={})
Draws a drawable object to the canvas.
void clear(Color color=Color::Black)
Clears the entire canvas with a single color.
void display()
Updates the contents of the canvas.
CanvasSFML(CanvasSFML &&copy) noexcept
Move constructor.
Widget::Ptr clone() const override
Makes a copy of the widget if you don't know its exact type.
std::shared_ptr< const CanvasSFML > ConstPtr
Shared constant widget pointer.
Definition CanvasSFML.hpp:73
void draw(BackendRenderTarget &target, RenderStates states) const override
Draw the widget to a render target.
Wrapper for colors.
Definition Color.hpp:73
Class to store the position or size of a widget.
Definition Layout.hpp:323
Definition Rect.hpp:40
Definition Sprite.hpp:47
std::shared_ptr< Widget > Ptr
Shared widget pointer.
Definition Widget.hpp:86
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:38
States used for drawing.
Definition RenderStates.hpp:38