Add support for QQuaternion (#1314)

* cxx-qt-lib: add QGenericMatrix

* cxx-qt-lib: add QQuaternion

* cxx-qt-lib: fix SPDX dates

* cxx-qt-lib: add missing QGenericMatrix docs

* cxx-qt-lib: add missing SPDX

* cxx-qt-lib: remove const from QGenericMatrix::data_mut

* cxx-qt-lib: avoid floating-point errors in QQuaternion unit tests

* cxx-qt-lib: fix QGenericMatrix documentation

Co-authored-by: Leon Matthes <[email protected]>

* cxx-qt-lib: construct an identity matrix inside QGenericMatrix::is_identity

Co-authored-by: Leon Matthes <[email protected]>

* cxx-qt-lib: use direct pointer casts instead of slice::from_raw_parts

* cxx-qt-lib: fix formatting

* Revert "cxx-qt-lib: use direct pointer casts instead of slice::from_raw_parts"

This reverts commit 5a53669.

* cxx-qt-lib: impl TryFrom insteead of From for QGeneric Matrix

* cxx-qt-lib: fix test case

* cxx-qt-lib: create intentionally failing test for QGenericMatrix

* cxx-qt-lib: use correct values for test

* cxx-qt-lib: add sizeof and align assertions for QGenericMatrix

* cxx-qt-lib: use repr(C) for QGenericMatrix

* cxx-qt-lib: fix array syntax

---------

Co-authored-by: Leon Matthes <[email protected]>

Author: jnbooth

CHANGELOG.md

@@ -23,7 +23,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `QSet::reserve` to reserve capacity up-front.
 - Support for further types: `QUuid`
 - New example: Basic greeter app
-- Support for further types: `qreal`, `qint64`, `qintptr`, `qsizetype`, `quint64`, `quintptr`
+- Support for further types: `qreal`, `qint64`, `qintptr`, `qsizetype`, `quint64`, `quintptr`, `QQuaternion`
 - Support for `cfg` attributes through to C++ generation
 - CXX-Qt-build: Improved compile time and propagation of initializers between crates
 - CXX-Qt-build: Multi-crate projects are now possible with Cargo and CMake (see `examples/qml_multi_crates`)

crates/cxx-qt-lib/build.rs

@@ -201,6 +201,7 @@ fn main() {
         rust_bridges.extend([
             "core/qlist/qlist_qcolor",
             "core/qvariant/qvariant_qcolor",
+            "core/qvariant/qvariant_qquaternion",
             "core/qvariant/qvariant_qvector2d",
             "core/qvariant/qvariant_qvector3d",
             "core/qvariant/qvariant_qvector4d",
@@ -209,6 +210,7 @@ fn main() {
             "gui/qfont",
             "gui/qguiapplication",
             "gui/qimage",
+            "gui/qquaternion",
             "gui/qpainterpath",
             "gui/qpainter",
             "gui/qpen",
@@ -279,13 +281,15 @@ fn main() {
         cpp_files.extend([
             "gui/qcolor",
             "gui/qfont",
+            "gui/qgenericmatrix",
             "gui/qguiapplication",
             "gui/qimage",
             "gui/qpainterpath",
             "gui/qpainter",
             "gui/qpen",
             "gui/qpolygon",
             "gui/qpolygonf",
+            "gui/qquaternion",
             "gui/qregion",
             "gui/qvector2d",
             "gui/qvector3d",

crates/cxx-qt-lib/include/common.h

@@ -89,6 +89,13 @@ operatorDiv(const S scalar, const T& t)
   return t / scalar;
 }
 
+template<typename T>
+T
+operatorNeg(const T& t)
+{
+  return -t;
+}
+
 template<typename T, typename... Args>
 std::unique_ptr<T>
 make_unique(Args... args)

crates/cxx-qt-lib/include/core/qvariant.h

@@ -33,6 +33,7 @@
 
 #ifdef CXX_QT_GUI_FEATURE
 #include <QtGui/QColor>
+#include <QtGui/QQuaternion>
 #include <QtGui/QVector2D>
 #include <QtGui/QVector3D>
 #include <QtGui/QVector4D>
@@ -83,6 +84,7 @@ CXX_QT_QVARIANT_CAN_CONVERT(I64)
 CXX_QT_QVARIANT_CAN_CONVERT(QByteArray)
 #ifdef CXX_QT_GUI_FEATURE
 CXX_QT_QVARIANT_CAN_CONVERT(QColor)
+CXX_QT_QVARIANT_CAN_CONVERT(QQuaternion)
 CXX_QT_QVARIANT_CAN_CONVERT(QVector2D)
 CXX_QT_QVARIANT_CAN_CONVERT(QVector3D)
 CXX_QT_QVARIANT_CAN_CONVERT(QVector4D)

crates/cxx-qt-lib/include/gui/qgenericmatrix.h

@@ -0,0 +1,9 @@
+// clang-format off
+// SPDX-FileCopyrightText: 2025 Klarälvdalens Datakonsult AB, a KDAB Group company <[email protected]>
+// clang-format on
+// SPDX-FileContributor: Joshua Booth <[email protected]>
+//
+// SPDX-License-Identifier: MIT OR Apache-2.0
+#pragma once
+
+#include <QtGui/QGenericMatrix>

crates/cxx-qt-lib/include/gui/qquaternion.h

@@ -0,0 +1,48 @@
+// clang-format off
+// SPDX-FileCopyrightText: 2025 Klarälvdalens Datakonsult AB, a KDAB Group company <[email protected]>
+// clang-format on
+// SPDX-FileContributor: Joshua Booth <[email protected]>
+//
+// SPDX-License-Identifier: MIT OR Apache-2.0
+#pragma once
+
+#include <QtGui/QQuaternion>
+
+namespace rust {
+namespace cxxqtlib1 {
+
+inline float (*qquaternionDotProduct)(const QQuaternion&, const QQuaternion&) =
+  QQuaternion::dotProduct;
+
+inline QQuaternion (*qquaternionFromAxes)(const QVector3D&,
+                                          const QVector3D&,
+                                          const QVector3D&) =
+  QQuaternion::fromAxes;
+
+inline QQuaternion (*qquaternionFromAxisAndAngle)(float, float, float, float) =
+  QQuaternion::fromAxisAndAngle;
+
+inline QQuaternion (*qquaternionFromDirection)(const QVector3D&,
+                                               const QVector3D&) =
+  QQuaternion::fromDirection;
+
+inline QQuaternion (*qquaternionFromEulerAngles)(float, float, float) =
+  QQuaternion::fromEulerAngles;
+
+inline QQuaternion (*qquaternionFromRotationMatrix)(const QMatrix3x3&) =
+  QQuaternion::fromRotationMatrix;
+
+inline QQuaternion (*qquaternionNlerp)(const QQuaternion&,
+                                       const QQuaternion&,
+                                       float) = QQuaternion::nlerp;
+
+inline QQuaternion (*qquaternionRotationTo)(const QVector3D&,
+                                            const QVector3D&) =
+  QQuaternion::rotationTo;
+
+inline QQuaternion (*qquaternionSlerp)(const QQuaternion&,
+                                       const QQuaternion&,
+                                       float) = QQuaternion::slerp;
+
+}
+}

crates/cxx-qt-lib/include/qgenericmatrix.h

@@ -0,0 +1,9 @@
+// clang-format off
+// SPDX-FileCopyrightText: 2025 Klarälvdalens Datakonsult AB, a KDAB Group company <[email protected]>
+// clang-format on
+// SPDX-FileContributor: Joshua Booth <[email protected]>
+//
+// SPDX-License-Identifier: MIT OR Apache-2.0
+#pragma once
+
+#include "gui/qgenericmatrix.h"

crates/cxx-qt-lib/include/qquaternion.h

@@ -0,0 +1,9 @@
+// clang-format off
+// SPDX-FileCopyrightText: 2025 Klarälvdalens Datakonsult AB, a KDAB Group company <[email protected]>
+// clang-format on
+// SPDX-FileContributor: Joshua Booth <[email protected]>
+//
+// SPDX-License-Identifier: MIT OR Apache-2.0
+#pragma once
+
+#include "gui/qquaternion.h"

crates/cxx-qt-lib/src/core/qvariant/generate.sh

@@ -108,6 +108,7 @@ generate_bridge_qt "QModelIndex" "qmodelindex"
 generate_bridge_qt "QPersistentModelIndex" "qpersistentmodelindex"
 generate_bridge_qt "QPoint" "qpoint"
 generate_bridge_qt "QPointF" "qpointf"
+generate_bridge_qt "QQuaternion" "qquaternion"
 generate_bridge_qt "QRect" "qrect"
 generate_bridge_qt "QRectF" "qrectf"
 generate_bridge_qt "QSize" "qsize"

crates/cxx-qt-lib/src/core/qvariant/mod.rs

@@ -204,6 +204,8 @@ impl_qvariant_value!(crate::QModelIndex, qvariant_qmodelindex);
 impl_qvariant_value!(crate::QPersistentModelIndex, qvariant_qpersistentmodelindex);
 impl_qvariant_value!(crate::QPoint, qvariant_qpoint);
 impl_qvariant_value!(crate::QPointF, qvariant_qpointf);
+#[cfg(feature = "qt_gui")]
+impl_qvariant_value!(crate::QQuaternion, qvariant_qquaternion);
 impl_qvariant_value!(crate::QRect, qvariant_qrect);
 impl_qvariant_value!(crate::QRectF, qvariant_qrectf);
 impl_qvariant_value!(crate::QSize, qvariant_qsize);