Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qtransform.h
Go to the documentation of this file.
1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3// Qt-Security score:significant reason:default
4#ifndef QTRANSFORM_H
5#define QTRANSFORM_H
6
7#include <QtGui/qtguiglobal.h>
8#include <QtGui/qpolygon.h>
9#include <QtGui/qregion.h>
10#include <QtGui/qwindowdefs.h>
11#include <QtCore/qline.h>
12#include <QtCore/qpoint.h>
13#include <QtCore/qrect.h>
14
15QT_BEGIN_NAMESPACE
16
17class QVariant;
18class QPainterPath;
19
20class Q_GUI_EXPORT QTransform
21{
22public:
23 enum TransformationType {
24 TxNone = 0x00,
25 TxTranslate = 0x01,
26 TxScale = 0x02,
27 TxRotate = 0x04,
28 TxShear = 0x08,
29 TxProject = 0x10
30 };
31
32 inline explicit QTransform(Qt::Initialization) {}
33 inline QTransform()
34 : m_matrix{ {1, 0, 0}, {0, 1, 0}, {0, 0, 1} }
35 , m_type(TxNone)
36 , m_dirty(TxNone) {}
37 QTransform(qreal h11, qreal h12, qreal h13,
38 qreal h21, qreal h22, qreal h23,
39 qreal h31, qreal h32, qreal h33)
40 : m_matrix{ {h11, h12, h13}, {h21, h22, h23}, {h31, h32, h33} }
41 , m_type(TxNone)
42 , m_dirty(TxProject) {}
43 QTransform(qreal h11, qreal h12, qreal h21,
44 qreal h22, qreal dx, qreal dy)
45 : m_matrix{ {h11, h12, 0}, {h21, h22, 0}, {dx, dy, 1} }
46 , m_type(TxNone)
47 , m_dirty(TxShear) {}
48
49 QTransform &operator=(QTransform &&other) noexcept = default;
50 QTransform &operator=(const QTransform &) noexcept = default;
51 QTransform(QTransform &&other) noexcept = default;
52 QTransform(const QTransform &other) noexcept = default;
53
54 bool isAffine() const;
55 bool isIdentity() const;
56 bool isInvertible() const;
57 bool isScaling() const;
58 bool isRotating() const;
59 bool isTranslating() const;
60
61 TransformationType type() const;
62
63 inline qreal determinant() const;
64
65 qreal m11() const;
66 qreal m12() const;
67 qreal m13() const;
68 qreal m21() const;
69 qreal m22() const;
70 qreal m23() const;
71 qreal m31() const;
72 qreal m32() const;
73 qreal m33() const;
74 qreal dx() const;
75 qreal dy() const;
76
77 void setMatrix(qreal m11, qreal m12, qreal m13,
78 qreal m21, qreal m22, qreal m23,
79 qreal m31, qreal m32, qreal m33);
80
81 [[nodiscard]] QTransform inverted(bool *invertible = nullptr) const;
82 [[nodiscard]] QTransform adjoint() const;
83 [[nodiscard]] QTransform transposed() const;
84
85 QTransform &translate(qreal dx, qreal dy);
86 QTransform &scale(qreal sx, qreal sy);
87 QTransform &shear(qreal sh, qreal sv);
88#if QT_VERSION < QT_VERSION_CHECK(7, 0, 0)
89 QTransform &rotate(qreal a, Qt::Axis axis, qreal distanceToPlane);
90 // ### Qt7: Remove
91 QTransform &rotate(qreal a, Qt::Axis axis = Qt::ZAxis);
92 QTransform &rotateRadians(qreal a, Qt::Axis axis, qreal distanceToPlane);
93 // ### Qt7: Remove
94 QTransform &rotateRadians(qreal a, Qt::Axis axis = Qt::ZAxis);
95#else
96 QTransform &rotate(qreal a, Qt::Axis axis = Qt::ZAxis, qreal distanceToPlane = 1024.0f);
97 QTransform &rotateRadians(qreal a, Qt::Axis axis = Qt::ZAxis, qreal distanceToPlane = 1024.0f);
98#endif
99
100 static bool squareToQuad(const QPolygonF &square, QTransform &result);
101 static bool quadToSquare(const QPolygonF &quad, QTransform &result);
102 static bool quadToQuad(const QPolygonF &one,
103 const QPolygonF &two,
104 QTransform &result);
105
106 bool operator==(const QTransform &) const;
107 bool operator!=(const QTransform &) const;
108
109 QTransform &operator*=(const QTransform &);
110 QTransform operator*(const QTransform &o) const;
111
112 operator QVariant() const;
113
114 void reset();
115 QPoint map(const QPoint &p) const;
116 QPointF map(const QPointF &p) const;
117 QLine map(const QLine &l) const;
118 QLineF map(const QLineF &l) const;
119 QPolygonF map(const QPolygonF &a) const;
120 QPolygon map(const QPolygon &a) const;
121 QRegion map(const QRegion &r) const;
122 QPainterPath map(const QPainterPath &p) const;
123 QPolygon mapToPolygon(const QRect &r) const;
124 QRect mapRect(const QRect &) const;
125 QRectF mapRect(const QRectF &) const;
126 void map(int x, int y, int *tx, int *ty) const;
127 void map(qreal x, qreal y, qreal *tx, qreal *ty) const;
128
129 QTransform &operator*=(qreal div);
130 QTransform &operator/=(qreal div);
131 QTransform &operator+=(qreal div);
132 QTransform &operator-=(qreal div);
133
134 static QTransform fromTranslate(qreal dx, qreal dy);
135 static QTransform fromScale(qreal dx, qreal dy);
136
137private:
138 struct Affine {
139 qreal (& m_matrix)[3][3];
140 };
141
142public:
143 auto asAffineMatrix() { return Affine { m_matrix }; }
144 friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &s, Affine &m);
145 friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &s, const Affine &m);
146
147private:
148 inline TransformationType inline_type() const;
149 void do_map(qreal x, qreal y, qreal &nx, qreal &ny) const;
150 qreal m_matrix[3][3];
151
152 mutable uint m_type : 5;
153 mutable uint m_dirty : 5;
154};
155Q_DECLARE_TYPEINFO(QTransform, Q_RELOCATABLE_TYPE);
156
157Q_GUI_EXPORT Q_DECL_CONST_FUNCTION size_t qHash(const QTransform &key, size_t seed = 0) noexcept;
158
159/******* inlines *****/
160inline QTransform::TransformationType QTransform::inline_type() const
161{
162 if (m_dirty == TxNone)
163 return static_cast<TransformationType>(m_type);
164 return type();
165}
166
167inline bool QTransform::isAffine() const
168{
169 return inline_type() < TxProject;
170}
171inline bool QTransform::isIdentity() const
172{
173 return inline_type() == TxNone;
174}
175
176inline bool QTransform::isInvertible() const
177{
178 return !qFuzzyIsNull(determinant());
179}
180
181inline bool QTransform::isScaling() const
182{
183 return type() >= TxScale;
184}
185inline bool QTransform::isRotating() const
186{
187 return inline_type() >= TxRotate;
188}
189
190inline bool QTransform::isTranslating() const
191{
192 return inline_type() >= TxTranslate;
193}
194
195inline qreal QTransform::determinant() const
196{
197 return m_matrix[0][0] * (m_matrix[2][2] * m_matrix[1][1] - m_matrix[2][1] * m_matrix[1][2]) -
198 m_matrix[1][0] * (m_matrix[2][2] * m_matrix[0][1] - m_matrix[2][1] * m_matrix[0][2]) +
199 m_matrix[2][0] * (m_matrix[1][2] * m_matrix[0][1] - m_matrix[1][1] * m_matrix[0][2]);
200}
201inline qreal QTransform::m11() const
202{
203 return m_matrix[0][0];
204}
205inline qreal QTransform::m12() const
206{
207 return m_matrix[0][1];
208}
209inline qreal QTransform::m13() const
210{
211 return m_matrix[0][2];
212}
213inline qreal QTransform::m21() const
214{
215 return m_matrix[1][0];
216}
217inline qreal QTransform::m22() const
218{
219 return m_matrix[1][1];
220}
221inline qreal QTransform::m23() const
222{
223 return m_matrix[1][2];
224}
225inline qreal QTransform::m31() const
226{
227 return m_matrix[2][0];
228}
229inline qreal QTransform::m32() const
230{
231 return m_matrix[2][1];
232}
233inline qreal QTransform::m33() const
234{
235 return m_matrix[2][2];
236}
237inline qreal QTransform::dx() const
238{
239 return m_matrix[2][0];
240}
241inline qreal QTransform::dy() const
242{
243 return m_matrix[2][1];
244}
245
246QT_WARNING_PUSH
247QT_WARNING_DISABLE_FLOAT_COMPARE
248
249inline QTransform &QTransform::operator*=(qreal num)
250{
251 if (num == 1.)
252 return *this;
253 m_matrix[0][0] *= num;
254 m_matrix[0][1] *= num;
255 m_matrix[0][2] *= num;
256 m_matrix[1][0] *= num;
257 m_matrix[1][1] *= num;
258 m_matrix[1][2] *= num;
259 m_matrix[2][0] *= num;
260 m_matrix[2][1] *= num;
261 m_matrix[2][2] *= num;
262 if (m_dirty < TxScale)
263 m_dirty = TxScale;
264 return *this;
265}
266inline QTransform &QTransform::operator/=(qreal div)
267{
268 if (div == 0)
269 return *this;
270 div = 1/div;
271 return operator*=(div);
272}
273inline QTransform &QTransform::operator+=(qreal num)
274{
275 if (num == 0)
276 return *this;
277 m_matrix[0][0] += num;
278 m_matrix[0][1] += num;
279 m_matrix[0][2] += num;
280 m_matrix[1][0] += num;
281 m_matrix[1][1] += num;
282 m_matrix[1][2] += num;
283 m_matrix[2][0] += num;
284 m_matrix[2][1] += num;
285 m_matrix[2][2] += num;
286 m_dirty = TxProject;
287 return *this;
288}
289inline QTransform &QTransform::operator-=(qreal num)
290{
291 if (num == 0)
292 return *this;
293 m_matrix[0][0] -= num;
294 m_matrix[0][1] -= num;
295 m_matrix[0][2] -= num;
296 m_matrix[1][0] -= num;
297 m_matrix[1][1] -= num;
298 m_matrix[1][2] -= num;
299 m_matrix[2][0] -= num;
300 m_matrix[2][1] -= num;
301 m_matrix[2][2] -= num;
302 m_dirty = TxProject;
303 return *this;
304}
305
306QT_WARNING_POP
307
308inline bool qFuzzyCompare(const QTransform& t1, const QTransform& t2) noexcept
309{
310 return qFuzzyCompare(t1.m11(), t2.m11())
311 && qFuzzyCompare(t1.m12(), t2.m12())
312 && qFuzzyCompare(t1.m13(), t2.m13())
313 && qFuzzyCompare(t1.m21(), t2.m21())
314 && qFuzzyCompare(t1.m22(), t2.m22())
315 && qFuzzyCompare(t1.m23(), t2.m23())
316 && qFuzzyCompare(t1.m31(), t2.m31())
317 && qFuzzyCompare(t1.m32(), t2.m32())
318 && qFuzzyCompare(t1.m33(), t2.m33());
319}
320
321
322/****** stream functions *******************/
323#ifndef QT_NO_DATASTREAM
324Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QTransform &);
325Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QTransform &);
326#endif
327
328#ifndef QT_NO_DEBUG_STREAM
329Q_GUI_EXPORT QDebug operator<<(QDebug, const QTransform &);
330#endif
331/****** end stream functions *******************/
332
333// mathematical semantics
334inline QPoint operator*(const QPoint &p, const QTransform &m)
335{ return m.map(p); }
336inline QPointF operator*(const QPointF &p, const QTransform &m)
337{ return m.map(p); }
338inline QLineF operator*(const QLineF &l, const QTransform &m)
339{ return m.map(l); }
340inline QLine operator*(const QLine &l, const QTransform &m)
341{ return m.map(l); }
342inline QPolygon operator *(const QPolygon &a, const QTransform &m)
343{ return m.map(a); }
344inline QPolygonF operator *(const QPolygonF &a, const QTransform &m)
345{ return m.map(a); }
346inline QRegion operator *(const QRegion &r, const QTransform &m)
347{ return m.map(r); }
348
349inline QTransform operator *(const QTransform &a, qreal n)
350{ QTransform t(a); t *= n; return t; }
351inline QTransform operator /(const QTransform &a, qreal n)
352{ QTransform t(a); t /= n; return t; }
353inline QTransform operator +(const QTransform &a, qreal n)
354{ QTransform t(a); t += n; return t; }
355inline QTransform operator -(const QTransform &a, qreal n)
356{ QTransform t(a); t -= n; return t; }
357
358QT_END_NAMESPACE
359
360#endif // QTRANSFORM_H
QColorTransform
The QColorTransform class is a transformation between color spaces.
Definition qcolortransform.h:27
QColorTransform::QColorTransform
QColorTransform(QColorTransform &&colorTransform)=default
QColorTransform::operator!=
friend bool operator!=(const QColorTransform &ct1, const QColorTransform &ct2)
Definition qcolortransform.h:51
QColorTransform::operator=
QColorTransform & operator=(const QColorTransform &other) noexcept
Definition qcolortransform.h:33
QColorTransform::QColorTransform
QColorTransform() noexcept=default
QColorTransform::~QColorTransform
Q_GUI_EXPORT ~QColorTransform()
QColorTransform::operator==
friend bool operator==(const QColorTransform &ct1, const QColorTransform &ct2)
Definition qcolortransform.h:49
QDataStream
\inmodule QtCore\reentrant
Definition qdatastream.h:50
QMap
Definition qmap.h:190
QTransform
The QTransform class specifies 2D transformations of a coordinate system.
Definition qtransform.h:21
qfloat16
\keyword 16-bit Floating Point Support\inmodule QtCore \inheaderfile QFloat16
Definition qfloat16.h:57
QT_BEGIN_NAMESPACE
Combined button and popup list for selecting options.
Definition qrandomaccessasyncfile_darwin.mm:17
QRgbaFloat32
QRgbaFloat< float > QRgbaFloat32
Definition qcolortransform.h:22
QRgbaFloat16
QRgbaFloat< qfloat16 > QRgbaFloat16
Definition qcolortransform.h:21
Q_TRACE_METADATA
Q_TRACE_METADATA(qtcore, "ENUM { AUTO, RANGE User ... MaxUser } QEvent::Type;")
operator<<
Q_CORE_EXPORT QDebug operator<<(QDebug debug, QDir::Filters filters)
Definition qdir.cpp:2582
IWX_MSB
#define IWX_MSB(b)
Definition qimage.cpp:4428
rotated90
static QImage rotated90(const QImage &src)
Definition qimage.cpp:4781
copyMetadata
static void copyMetadata(QImage *dst, const QImage &src)
Definition qimage.cpp:1186
QT_XFORM_TYPE_LSBFIRST
#define QT_XFORM_TYPE_LSBFIRST
Definition qimage.cpp:51
copyMetadata
static void copyMetadata(QImageData *dst, const QImageData *src)
Definition qimage.cpp:1177
QT_XFORM_TYPE_MSBFIRST
#define QT_XFORM_TYPE_MSBFIRST
Definition qimage.cpp:50
next_qimage_serial_number
static int next_qimage_serial_number()
Definition qimage.cpp:90
QIMAGE_SANITYCHECK_MEMORY
#define QIMAGE_SANITYCHECK_MEMORY(image)
Definition qimage.cpp:68
copyPhysicalMetadata
static void copyPhysicalMetadata(QImageData *dst, const QImageData *src)
Definition qimage.cpp:1170
IWX_LSB
#define IWX_LSB(b)
Definition qimage.cpp:4437
rotated270
static QImage rotated270(const QImage &src)
Definition qimage.cpp:4825
qt_getImageText
QMap< QString, QString > qt_getImageText(const QImage &image, const QString &description)
Definition qimage.cpp:6535
qt_imageTransform
Q_GUI_EXPORT void qt_imageTransform(QImage &src, QImageIOHandler::Transformations orient)
Definition qimage.cpp:6522
PIX
#define PIX(x, y)
rotated180
static QImage rotated180(const QImage &src)
Definition qimage.cpp:4807
toOrientations
static Qt::Orientations toOrientations(QImageIOHandler::Transformations orient)
Definition qimage.cpp:6512
qt_getImageTextFromDescription
QMap< QString, QString > qt_getImageTextFromDescription(const QString &description)
Definition qimage.cpp:6546
operator*
QTransform operator*(const QTransform &a, qreal n)
Definition qtransform.h:349
Q_DECLARE_TYPEINFO
Q_DECLARE_TYPEINFO(QTransform, Q_RELOCATABLE_TYPE)
operator/
QTransform operator/(const QTransform &a, qreal n)
Definition qtransform.h:351
operator*
QPoint operator*(const QPoint &p, const QTransform &m)
Definition qtransform.h:334
operator+
QTransform operator+(const QTransform &a, qreal n)
Definition qtransform.h:353
operator-
QTransform operator-(const QTransform &a, qreal n)
Definition qtransform.h:355
qFuzzyCompare
QT_WARNING_POP bool qFuzzyCompare(const QTransform &t1, const QTransform &t2) noexcept
Definition qtransform.h:308