En esta página

Qt 3D

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

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

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

Para las aplicaciones Qt Quick, Qt 3D proporciona los siguientes módulos QML:

Los siguientes módulos QML están aún en desarrollo pero están disponibles como avances tecnológicos:

Uso del módulo

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

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

Para importar las clases QML en su aplicación, utilice la siguiente sentencia import en su 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

Utilizar la API C++ de un módulo Qt requiere enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación tienen soporte dedicado para esto, incluyendo CMake y qmake.

Compilación con CMake

Utilice el comando find_package() para localizar los componentes necesarios del módulo 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
)

Construcción con qmake

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

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

Una aplicación Qt Quick requiere dependencias adicionales:

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

Visión general

El diseño de alto nivel y la motivación para Qt 3D se describen en la Visión general deQt 3D . El Qt 3D Render ofrece soporte para la configuración basada en datos como se describe en Qt 3D Render Framegraph.

Referencia

Qt 3D Soporte de plataformas

Qt 3D tiene el siguiente soporte para plataformas:

  • Microsoft Windows (win32) - Compatible
  • Linux X11 - Compatible
  • macOS - Compatible, aunque puede haber algunos problemas de escalado de retina
  • Android - Compatible
  • Embedded Linux - Compatible
  • iOS - Compatible desde (Qt 5.7)
  • WinRT - Aún no compatible

Evolución de los módulos

Cambios en Qt3D enumera los cambios importantes en la API del módulo y la funcionalidad que se hicieron 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. Consulte Licencias de Qt para más detalles.

Además 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.4

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.