TGUI  1.6.1
Loading...
Searching...
No Matches
BackendRenderTarget.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_BACKEND_RENDER_TARGET_HPP
26#define TGUI_BACKEND_RENDER_TARGET_HPP
27
28#include <TGUI/Rect.hpp>
29#include <TGUI/Color.hpp>
30#include <TGUI/Sprite.hpp>
31#include <TGUI/Text.hpp>
32#include <TGUI/Outline.hpp>
33#include <TGUI/RenderStates.hpp>
34
36
37TGUI_MODULE_EXPORT namespace tgui
38{
39 class Widget;
40 class RootContainer;
41
45 class TGUI_API BackendRenderTarget
46 {
47 public:
48
49 // Don't allow copying or moving, because we don't expect derived classes to handle it correctly
52 BackendRenderTarget& operator=(const BackendRenderTarget&) = delete;
53 BackendRenderTarget& operator=(BackendRenderTarget&&) = delete;
54
59
63 virtual ~BackendRenderTarget() = default;
64
69 virtual void setClearColor(const Color& color) = 0;
70
74 virtual void clearScreen() = 0;
75
83 virtual void setView(FloatRect view, FloatRect viewport, Vector2f targetSize);
84
90 virtual void drawGui(const std::shared_ptr<RootContainer>& root) = 0;
91
98 virtual void drawWidget(const RenderStates& states, const std::shared_ptr<Widget>& widget);
99
110 virtual void addClippingLayer(const RenderStates& states, FloatRect rect);
111
117 virtual void removeClippingLayer();
118
127 virtual void drawBorders(const RenderStates& states, const Borders& borders, Vector2f size, Color color);
128
136 virtual void drawFilledRect(const RenderStates& states, Vector2f size, Color color);
137
144 virtual void drawSprite(const RenderStates& states, const Sprite& sprite);
145
154 virtual void drawText(const RenderStates& states, const Text& text);
155
168 virtual void drawTextOutline(const RenderStates& states, const Text& text);
169
182 virtual void drawTextWithoutOutline(const RenderStates& states, const Text& text);
183
194 virtual void drawTriangle(const RenderStates& states, const Vertex& point1, const Vertex& point2, const Vertex& point3);
195
205 virtual void drawCircle(const RenderStates& states, float size, const Color& backgroundColor, float borderThickness = 0, const Color& borderColor = {});
206
217 virtual void drawRoundedRectangle(const RenderStates& states, const Vector2f& size, const Color& backgroundColor, float radius,
218 const Borders& borders = {0}, const Color& borderColor = Color::Black);
219
230 virtual void drawVertexArray(const RenderStates& states, const Vertex* vertices, std::size_t vertexCount,
231 const unsigned int* indices, std::size_t indexCount, const std::shared_ptr<BackendTexture>& texture) = 0;
232
245 TGUI_NODISCARD Vector2f getPixelsPerPoint() const;
246
248 protected:
249
258 virtual void updateClipping(FloatRect clipRect, FloatRect clipViewport) = 0;
259
261 protected:
262
263 FloatRect m_viewRect;
264 FloatRect m_viewport;
265 Vector2f m_targetSize;
266
267 std::vector<std::pair<FloatRect, FloatRect>> m_clipLayers;
268 Vector2f m_pixelsPerPoint = {1, 1};
269 };
270
272}
273
275
276#endif // TGUI_BACKEND_RENDER_TARGET_HPP
Base class for render targets.
Definition BackendRenderTarget.hpp:46
virtual void updateClipping(FloatRect clipRect, FloatRect clipViewport)=0
Called from addClippingLayer and removeClippingLayer to apply the clipping.
virtual void removeClippingLayer()
Removes the last added clipping region.
virtual void setView(FloatRect view, FloatRect viewport, Vector2f targetSize)
Informs the render target about which part of the window is used for rendering.
virtual ~BackendRenderTarget()=default
Virtual destructor.
virtual void drawText(const RenderStates &states, const Text &text)
Draws some text.
virtual void setClearColor(const Color &color)=0
Select the color that will be used by clearScreen.
virtual void drawTextWithoutOutline(const RenderStates &states, const Text &text)
Draws some text, but without rendering its outline.
virtual void drawFilledRect(const RenderStates &states, Vector2f size, Color color)
Draws a colored rectangle.
virtual void drawTriangle(const RenderStates &states, const Vertex &point1, const Vertex &point2, const Vertex &point3)
Draws a single triangles (using the color that is specified in the vertices)
virtual void drawSprite(const RenderStates &states, const Sprite &sprite)
Draws a texture.
virtual void drawTextOutline(const RenderStates &states, const Text &text)
Draws only the outline of some text.
virtual void drawVertexArray(const RenderStates &states, const Vertex *vertices, std::size_t vertexCount, const unsigned int *indices, std::size_t indexCount, const std::shared_ptr< BackendTexture > &texture)=0
Draws a vertex array. This is called by the other draw functions when they are not overriden.
Vector2f getPixelsPerPoint() const
Returns the current mapping between the screen pixels and the points in the current view.
virtual void drawWidget(const RenderStates &states, const std::shared_ptr< Widget > &widget)
Draws a widget, if the widget is visible.
virtual void clearScreen()=0
Clears the screen, called at the beginning of each frame when gui.mainLoop() is called.
BackendRenderTarget()=default
Default constructor.
virtual void drawRoundedRectangle(const RenderStates &states, const Vector2f &size, const Color &backgroundColor, float radius, const Borders &borders={0}, const Color &borderColor=Color::Black)
Draws a rounded rectangle.
virtual void drawGui(const std::shared_ptr< RootContainer > &root)=0
Draws the gui and all of its widgets.
virtual void addClippingLayer(const RenderStates &states, FloatRect rect)
Adds another clipping region.
virtual void drawBorders(const RenderStates &states, const Borders &borders, Vector2f size, Color color)
Draws borders inside a provided rectangle.
virtual void drawCircle(const RenderStates &states, float size, const Color &backgroundColor, float borderThickness=0, const Color &borderColor={})
Draws a circle.
Wrapper for colors.
Definition Color.hpp:73
Definition Outline.hpp:38
Definition Sprite.hpp:47
Backend-independent wrapper around the backend-specific text class.
Definition Text.hpp:48
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:38
States used for drawing.
Definition RenderStates.hpp:38
Definition Vertex.hpp:39