TGUI 1.9.0
Loading...
Searching...
No Matches
Transform.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_TRANSFORM_HPP
26#define TGUI_TRANSFORM_HPP
27
29
30#include <TGUI/Config.hpp>
31#include <TGUI/Rect.hpp>
32
33#if !TGUI_EXPERIMENTAL_USE_STD_MODULE
34 #include <array>
35#endif
36
38
39TGUI_MODULE_EXPORT namespace tgui
40{
43 // Based on sf::Transform from SFML
45 class TGUI_API Transform
46 {
47 public:
48
55
69 Transform(float a00, float a01, float a02,
70 float a10, float a11, float a12,
71 float a20, float a21, float a22);
72
78 Transform(const std::array<float, 16>& matrix);
79
92 TGUI_NODISCARD const std::array<float, 16>& getMatrix() const;
93
101 TGUI_NODISCARD Transform getInverse() const;
102
110 TGUI_NODISCARD Vector2f transformPoint(const Vector2f& point) const
111 {
112 return {m_matrix[0] * point.x + m_matrix[4] * point.y + m_matrix[12],
113 m_matrix[1] * point.x + m_matrix[5] * point.y + m_matrix[13]};
114 }
115
125 TGUI_NODISCARD FloatRect transformRect(const FloatRect& rectangle) const;
126
138
146 Transform& translate(const Vector2f& offset);
147
159 Transform& rotate(float angle, const Vector2f& center = {0, 0});
160
172 Transform& scale(const Vector2f& factors, const Vector2f& center = {0, 0});
173
181 TGUI_NODISCARD Transform operator *(const Transform& right) const;
182 Transform& operator *=(const Transform& right);
183 TGUI_NODISCARD Vector2f operator *(const Vector2f& right) const;
184
191 TGUI_DEPRECATED("Use roundPosition(Vector2f) instead") void roundPosition(float pixelScaleX, float pixelScaleY);
192
198 void roundPosition(Vector2f pixelScale);
199
201 private:
202
203 std::array<float, 16> m_matrix;
204 };
205}
206
208
209#endif // TGUI_TRANSFORM_HPP
FloatRect transformRect(const FloatRect &rectangle) const
Transform a rectangle.
Transform(float a00, float a01, float a02, float a10, float a11, float a12, float a20, float a21, float a22)
Construct a transform from a 3x3 matrix.
Transform & translate(const Vector2f &offset)
Combine the current transform with a translation.
void roundPosition(float pixelScaleX, float pixelScaleY)
Rounds the position stored in the transform to the nearest pixel.
const std::array< float, 16 > & getMatrix() const
Return the transform as a 4x4 matrix.
Transform & combine(const Transform &other)
Combine the current transform with another one.
Transform()
Default constructor.
Vector2f transformPoint(const Vector2f &point) const
Transform a 2D point.
Definition Transform.hpp:110
Transform getInverse() const
Return the inverse of the transform.
Transform & scale(const Vector2f &factors, const Vector2f &center={0, 0})
Combine the current transform with a scaling.
Transform & rotate(float angle, const Vector2f &center={0, 0})
Combine the current transform with a rotation.
Transform(const std::array< float, 16 > &matrix)
Constructs a transform from a 4x4 matrix.
T y
Y coordinate of the vector.
Definition Vector2.hpp:136
T x
X coordinate of the vector.
Definition Vector2.hpp:135
Namespace that contains all TGUI functions and classes.
Definition AbsoluteOrRelativeValue.hpp:38