QQuick3D Class

Ausführliche Beschreibung

Bei der Verwendung von „ Qt Quick 3D “ mit OpenGL sind zusätzliche Schritte erforderlich, um bei der Initialisierung von „ Qt Quick “ festzulegen, welche Art von „ surface format “ verwendet wird. Der Grund dafür ist, dass zu dem Zeitpunkt, zu dem „ Qt Quick “ erkennt, dass 3D-Inhalte verwendet werden, der OpenGL-Kontext und die Fensteroberfläche bereits initialisiert sind. Daher wird diese Hilfsklasse bereitgestellt, um das ideale Oberflächenformat von Qt Quick 3D abzufragen, damit es vor der Initialisierung als Standardoberfläche für Qt Quick festgelegt werden kann.

Wird diese Hilfsklasse bei Verwendung eines anderen Rendering-Backends als OpenGL aufgerufen, gibt sie lediglich eine Kopie der aktuellen Standard- QSurfaceFormat mit den angeforderten Samples zurück.

Wird dieser Helfer bei Verwendung des OpenGL-Rendering-Backends ausgeführt, prüft er, ob eine ausreichend aktuelle OpenGL-Version vorliegt und ob Multisampling unterstützt wird, sofern dies angefordert wurde. Normalerweise fordert ` Qt Quick ` einen OpenGL 2.0- oder OpenGL ES 2.0-Kontext an, was die bei der Verwendung von ` Qt Quick 3D` verfügbaren Funktionen einschränken würde; daher ist ein zusätzlicher Schritt erforderlich, um einen leistungsfähigeren Kontext anzufordern.

Das korrekte Verwendungsmuster besteht darin, ` QSurfaceFormat::setDefaultFormat ` aufzurufen, um den von ` QQuick3D::idealSurfaceFormat` zurückgegebenen ` QSurfaceFormat ` festzulegen. Es ist wichtig, dass diese Methode aufgerufen wird, nachdem ` QGuiApplication ` erstellt wurde, jedoch bevor der Anwendungsinhalt von ` Qt Quick ` geladen wird. Dieser Codeausschnitt zeigt das korrekte Verwendungsmuster:

#include <QGuiApplication>
#include <QQmlApplicationEngine>

#include <QtGui>
#include <QtQuick3D/qquick3d.h>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QSurfaceFormat::setDefaultFormat(QQuick3D::idealSurfaceFormat(4));

    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}