En esta página

Qt 3D

Qt 3D se ofrece funcionalidad para sistemas de simulación casi en tiempo real con soporte para renderizado en 2D y 3D tanto en aplicaciones Qt C++ como en Qt Quick.

La funcionalidad de Qt 3D se divide en los siguientes módulos de C++:

Los siguientes módulos de C++ aún se encuentran en fase de desarrollo, pero están disponibles como avances tecnológicos:

Para las aplicaciones de « Qt Quick », Qt 3D ofrece los siguientes módulos QML:

Los siguientes módulos QML aún se encuentran en fase de desarrollo, pero están disponibles como vistas previas tecnológicas:

Uso del módulo

Para una aplicación en C++ que realice renderizado en 2D o 3D, detecte colisiones y gestione la entrada del usuario, incluye las siguientes directivas de las clases de los módulos:

#include <Qt3DCore>
#include <Qt3DRender>
#include <Qt3DInput>
#include <Qt3DLogic>
#include <Qt3DExtras>
#include <Qt3DAnimation>

Para importar los tipos QML a tu aplicación, utiliza la siguiente instrucción de importación en tu archivo .qml:

import Qt3D.Core
import Qt3D.Render
import Qt3D.Input
import Qt3D.Logic
import Qt3D.Extras
import Qt3D.Animation
import QtQuick.Scene2D
import QtQuick.Scene3D

El uso de la API de C++ de un módulo de Qt requiere la vinculación con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación cuentan con soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza el comando « find_package() » para localizar los componentes del módulo necesarios en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS
    3DCore
    3DRender
    3DInput
    3DLogic
    3DExtras
    3DAnimation
)
target_link_libraries(mytarget PRIVATE
    Qt6::3DCore
    Qt6::3DRender
    Qt6::3DLogic
    Qt6::3DExtras
    Qt6::3DAnimation
)

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añade los módulos a la variable QT en el archivo .pro del proyecto:

QT += 3dcore 3drender 3dinput 3dlogic 3dextras 3danimation

Una aplicación de Qt Quick requiere dependencias adicionales:

QT += 3dcore 3drender 3dinput 3dlogic 3dextras 3danimation qml quick 3dquick

Descripción general

El diseño de alto nivel y la motivación detrás de « Qt 3D » se describen en la Descripción general de «Qt 3D ». El renderizador « Qt 3D » ofrece soporte para la configuración basada en datos, tal y como se describe en «Qt 3D Render Framegraph».

Referencia

Qt 3D Compatibilidad con plataformas

Qt 3D ofrece compatibilidad con las siguientes plataformas:

  • Microsoft Windows (win32) - Compatible
  • Linux X11 - Compatible
  • macOS: compatible, aunque puede haber algunos problemas de escalado con pantallas Retina
  • Android: compatible
  • Linux embebido: compatible
  • iOS: compatible desde (Qt 5.7)
  • WinRT: aún no es compatible

Evolución del módulo

La sección«Cambios en Qt3D» enumera los cambios importantes en la API y la funcionalidad del módulo que se han realizado para la serie Qt 6 de Qt.

Licencias y atribuciones

Qt 3D Está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulta Licencias de Qt para obtener más detalles.

Por otra parte, Qt 3D contiene módulos de terceros bajo las siguientes licencias permisivas:

Dear ImGui - ProggyClean.ttf

Licencia MIT

Dear ImGui - stb

Licencia MIT o dominio público

Dear ImGui, version v1.91.0

Licencia MIT

Open Asset Import Library, version 6.0.5

Licencia BSD de 3 cláusulas «Nueva» o «Revisada»

© 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.