Revision control
+ // Copyright (C) 2026 The Qt Company Ltd.
+ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
+
+ #include <QTest>
+ #include <QtQml/QQmlEngine>
+ #include <QtQml/QQmlComponent>
+ #include <QtQml/qqmlextensionplugin.h>
+ #include <QtQuick3D/private/qquick3dcontentlayer_p.h>
+
+ #ifdef QT_STATIC
+ // Static builds need the QML plugins explicitly imported, since the test loads
+ // "import QtQuick" and "import QtQuick3D" via QQmlComponent::setData() at
+ // runtime and the import scanner cannot discover them from the C++ sources.
+ Q_IMPORT_QML_PLUGIN(QtQuick2Plugin)
+ Q_IMPORT_QML_PLUGIN(QQuick3DPlugin)
+ #endif
+
+ class tst_QQuick3DRenderPass : public QObject
+ {
+ Q_OBJECT
+
+ private slots:
+ void testContentLayer();
+ void testRenderPassQMLCreation();
+ void testAddDefine();
+ void testPipelineStateOverrideProperties();
+ void testRenderTargetBlend();
+ };
+
+ void tst_QQuick3DRenderPass::testContentLayer()
+ {
+ // Test that all layer constants are available and have expected values
+ QCOMPARE(QQuick3DContentLayer::Layer0, 1u << 0);
+ QCOMPARE(QQuick3DContentLayer::Layer1, 1u << 1);
+ QCOMPARE(QQuick3DContentLayer::Layer2, 1u << 2);
+ QCOMPARE(QQuick3DContentLayer::Layer23, 1u << 23);
+ QCOMPARE(QQuick3DContentLayer::Layer24, 1u << 24);
+ QCOMPARE(QQuick3DContentLayer::Layer31, 1u << 31);
+ QCOMPARE(QQuick3DContentLayer::LayerNone, 0u);
+ QCOMPARE(QQuick3DContentLayer::LayerAll, 0xFFFFFFu); // Only user layers (0-23)
+
+ // Test bitwise operations
+ quint32 layerMask = QQuick3DContentLayer::Layer0 | QQuick3DContentLayer::Layer1;
+ QCOMPARE(layerMask, 3u);
+
+ layerMask = QQuick3DContentLayer::Layer0 | QQuick3DContentLayer::Layer2;
+ QCOMPARE(layerMask, 5u);
+
+ // Test that layers are powers of 2
+ for (int i = 0; i < 32; ++i) {
+ quint32 layer = 1u << i;
+ // Verify it's a power of 2 (only one bit set)
+ QVERIFY((layer & (layer - 1)) == 0);
+ }
+ }
+
+ void tst_QQuick3DRenderPass::testRenderPassQMLCreation()
+ {
+ // Test that user render pass types can be created via QML
+ QQmlEngine engine;
+
+ // Test RenderPass creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; RenderPass { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+
+ // Test RenderPassTexture creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; RenderPassTexture { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+
+ // Test ColorAttachment creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; ColorAttachment { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+
+ // Test DepthStencilAttachment creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; DepthStencilAttachment { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+
+ // Test DepthTextureAttachment creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; DepthTextureAttachment { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+
+ // Test RenderablesFilter creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; RenderablesFilter { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+
+ // Test PipelineStateOverride creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; PipelineStateOverride { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+
+ // Test SubRenderPass creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; SubRenderPass { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QObject *object = component.create();
+ QVERIFY(object != nullptr);
+ delete object;
+ }
+ }
+
+ void tst_QQuick3DRenderPass::testAddDefine()
+ {
+ QQmlEngine engine;
+
+ // Basic creation
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; AddDefine { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ // Default property values
+ QByteArray name = object->property("name").toByteArray();
+ int value = object->property("value").toInt();
+ QCOMPARE(name, QByteArray());
+ QCOMPARE(value, 0);
+ }
+
+ // Set and read back name and value
+ {
+ QQmlComponent component(&engine);
+ component.setData(R"(import QtQuick3D; AddDefine { name: "MY_DEFINE"; value: 42 })", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ QCOMPARE(object->property("name").toByteArray(), QByteArray("MY_DEFINE"));
+ QCOMPARE(object->property("value").toInt(), 42);
+ }
+
+ // Dynamic update of name and value
+ {
+ QQmlComponent component(&engine);
+ component.setData(R"(import QtQuick3D; AddDefine { name: "INITIAL"; value: 1 })", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ QCOMPARE(object->property("name").toByteArray(), QByteArray("INITIAL"));
+ QCOMPARE(object->property("value").toInt(), 1);
+
+ object->setProperty("name", QByteArray("UPDATED"));
+ object->setProperty("value", 99);
+
+ QCOMPARE(object->property("name").toByteArray(), QByteArray("UPDATED"));
+ QCOMPARE(object->property("value").toInt(), 99);
+ }
+
+ // Empty name (no-op — the renderer guards against empty names)
+ {
+ QQmlComponent component(&engine);
+ component.setData(R"(import QtQuick3D; AddDefine { name: ""; value: 0 })", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+ QCOMPARE(object->property("name").toByteArray(), QByteArray(""));
+ }
+ }
+
+ void tst_QQuick3DRenderPass::testPipelineStateOverrideProperties()
+ {
+ QQmlEngine engine;
+
+ // Basic creation and default state
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; PipelineStateOverride { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ // Verify properties exist and are accessible
+ QVERIFY(object->metaObject()->indexOfProperty("depthTestEnabled") != -1);
+ QVERIFY(object->metaObject()->indexOfProperty("depthWriteEnabled") != -1);
+ QVERIFY(object->metaObject()->indexOfProperty("blendEnabled") != -1);
+ QVERIFY(object->metaObject()->indexOfProperty("cullMode") != -1);
+ QVERIFY(object->metaObject()->indexOfProperty("polygonMode") != -1);
+ QVERIFY(object->metaObject()->indexOfProperty("scissor") != -1);
+ QVERIFY(object->metaObject()->indexOfProperty("viewport") != -1);
+ }
+
+ // Set and read back boolean pipeline state properties
+ {
+ QQmlComponent component(&engine);
+ component.setData(R"(
+ import QtQuick3D
+ PipelineStateOverride {
+ depthTestEnabled: true
+ depthWriteEnabled: false
+ blendEnabled: true
+ })",
+ QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ QCOMPARE(object->property("depthTestEnabled").toBool(), true);
+ QCOMPARE(object->property("depthWriteEnabled").toBool(), false);
+ QCOMPARE(object->property("blendEnabled").toBool(), true);
+ }
+
+ // Dynamic property update
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; PipelineStateOverride { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ object->setProperty("depthTestEnabled", true);
+ object->setProperty("depthWriteEnabled", true);
+ object->setProperty("blendEnabled", false);
+
+ QCOMPARE(object->property("depthTestEnabled").toBool(), true);
+ QCOMPARE(object->property("depthWriteEnabled").toBool(), true);
+ QCOMPARE(object->property("blendEnabled").toBool(), false);
+
+ // Change again to verify updates propagate
+ object->setProperty("depthTestEnabled", false);
+ QCOMPARE(object->property("depthTestEnabled").toBool(), false);
+ }
+
+ // Scissor and viewport rect properties
+ {
+ QQmlComponent component(&engine);
+ component.setData(R"(
+ import QtQuick
+ import QtQuick3D
+ PipelineStateOverride {
+ scissor: Qt.rect(10, 20, 300, 200)
+ viewport: Qt.rect(0, 0, 400, 400)
+ })",
+ QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ QRectF scissor = object->property("scissor").toRectF();
+ QCOMPARE(scissor.x(), 10.0);
+ QCOMPARE(scissor.y(), 20.0);
+ QCOMPARE(scissor.width(), 300.0);
+ QCOMPARE(scissor.height(), 200.0);
+
+ QRectF viewport = object->property("viewport").toRectF();
+ QCOMPARE(viewport.x(), 0.0);
+ QCOMPARE(viewport.width(), 400.0);
+ }
+ }
+
+ void tst_QQuick3DRenderPass::testRenderTargetBlend()
+ {
+ QQmlEngine engine;
+
+ // PipelineStateOverride should expose targetBlend0 through targetBlend7
+ {
+ QQmlComponent component(&engine);
+ component.setData("import QtQuick3D; PipelineStateOverride { }", QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ // targetBlend0 through targetBlend7 should be accessible properties
+ for (int i = 0; i <= 7; ++i) {
+ const QByteArray propName = QByteArrayLiteral("targetBlend") + QByteArray::number(i);
+ const int propIndex = object->metaObject()->indexOfProperty(propName.constData());
+ QVERIFY2(propIndex != -1,
+ qPrintable(QString("PipelineStateOverride should have property '%1'").arg(QString::fromLatin1(propName))));
+ }
+ }
+
+ // Set targetBlend0.enable
+ {
+ QQmlComponent component(&engine);
+ component.setData(R"(
+ import QtQuick3D
+ PipelineStateOverride {
+ targetBlend0.enable: true
+ })",
+ QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ QVariant blend0 = object->property("targetBlend0");
+ QVERIFY(blend0.isValid());
+ // Extract the enable sub-property via the value type gadget
+ const QMetaObject *mo = QMetaType::fromName("QQuick3DRenderPassTargetBlend").metaObject();
+ if (mo) {
+ int enableIdx = mo->indexOfProperty("enable");
+ if (enableIdx != -1) {
+ void *gadget = blend0.data();
+ QVERIFY(mo->property(enableIdx).readOnGadget(gadget).toBool());
+ }
+ }
+ }
+
+ // targetBlend0 enum values via RenderTargetBlend namespace in QML
+ {
+ QQmlComponent component(&engine);
+ component.setData(R"(
+ import QtQuick3D
+ PipelineStateOverride {
+ targetBlend0.enable: true
+ targetBlend0.srcColor: RenderTargetBlend.SrcAlpha
+ targetBlend0.dstColor: RenderTargetBlend.OneMinusSrcAlpha
+ targetBlend0.opColor: RenderTargetBlend.Add
+ })",
+ QUrl());
+ QVERIFY2(!component.isError(), qPrintable(component.errorString()));
+ QScopedPointer<QObject> object(component.create());
+ QVERIFY(object != nullptr);
+
+ QVariant blend0 = object->property("targetBlend0");
+ QVERIFY(blend0.isValid());
+ }
+ }
+
+ QTEST_MAIN(tst_QQuick3DRenderPass)
+ #include "tst_qquick3drenderpass.moc"