QQuick3D Class

Description détaillée

Lors de l’utilisation d’ Qt Quick 3D avec OpenGL, il est nécessaire de prendre des mesures supplémentaires pour définir le type d’ surface format utilisé lors de l’initialisation de Qt Quick. En effet, au moment où Qt Quick détecte qu’un contenu 3D est utilisé, le contexte OpenGL et la surface de la fenêtre ont déjà été initialisés. Cette classe d'aide est donc fournie pour demander le format de surface idéal à Qt Quick 3D afin qu’il puisse être défini comme surface par défaut pour Qt Quick avant l’initialisation.

Si cette classe d’aide est exécutée lors de l’utilisation d’un moteur de rendu autre qu’OpenGL, elle renvoie simplement une copie de l’ QSurfaceFormat e par défaut actuelle avec les échantillons demandés.

Si cette fonction d’aide est exécutée lors de l’utilisation du moteur de rendu OpenGL, elle vérifie alors que la version d’OpenGL est suffisamment récente et que le multi-échantillonnage est pris en charge si cela est demandé. Normalement, ` Qt Quick ` demande un contexte OpenGL 2.0 ou OpenGL ES 2.0, ce qui limiterait les fonctionnalités disponibles lors de l’utilisation d’ Qt Quick 3D ; une étape supplémentaire est donc nécessaire pour demander un contexte plus performant.

La procédure d’utilisation correcte consiste à appeler ` QSurfaceFormat::setDefaultFormat ` pour définir le ` QSurfaceFormat ` renvoyé par ` QQuick3D::idealSurfaceFormat`. Il est important que cette méthode soit appelée après la construction de ` QGuiApplication `, mais avant le chargement du contenu de l’application ` Qt Quick `. Cet extrait de code illustre la procédure d’utilisation correcte :

#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();
}