En esta página

QQuick3D Class

Clase auxiliar para seleccionar el formato de superficie adecuado. Más...

Header: #include <QQuick3D>

Miembros públicos estáticos

QSurfaceFormat idealSurfaceFormat(int samples = -1)

Descripción detallada

Al utilizar Qt Quick 3D con OpenGL, es necesario realizar pasos adicionales para definir qué tipo de surface format se utiliza al inicializar Qt Quick. Esto se debe a que, para cuando Qt Quick detecta que se está utilizando contenido 3D, el contexto de OpenGL y la superficie de la ventana ya se han inicializado. Por ello, se proporciona esta clase auxiliar para solicitar el formato de superficie ideal a Qt Quick 3D, de modo que pueda establecerse como superficie predeterminada para Qt Quick antes de la inicialización.

Si esta clase auxiliar se ejecuta al utilizar cualquier otro motor de renderizado distinto de OpenGL, simplemente devuelve una copia de la superficie predeterminada actual QSurfaceFormat con las muestras solicitadas.

Si esta función auxiliar se ejecuta al utilizar el motor de renderizado OpenGL, comprobará que se disponga de versiones suficientemente modernas de OpenGL y de compatibilidad con el multimuestreo, si así se solicita. Normalmente, ` Qt Quick ` solicitará un contexto de OpenGL 2.0 u OpenGL ES 2.0, lo que limitaría las funciones disponibles al utilizar ` Qt Quick ` 3D, por lo que se necesita un paso adicional para solicitar un contexto con mayor capacidad.

El patrón de uso correcto consiste en llamar a ` QSurfaceFormat::setDefaultFormat ` para establecer el ` QSurfaceFormat ` devuelto por ` QQuick3D::idealSurfaceFormat`. Es importante que este método se llame después de que se haya creado ` QGuiApplication `, pero antes de que se cargue el contenido de la aplicación ` Qt Quick `. Este fragmento de código muestra el patrón de uso correcto:

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

Véase también la información específica sobreOpenGL.

Documentación de las funciones miembro

[static] QSurfaceFormat QQuick3D::idealSurfaceFormat(int samples = -1)

Devuelve un formato de superficie ideal para la plataforma. De forma opcional, se puede especificar ` samples ` para seleccionar el número de multimuestras para el suavizado.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.