En esta página

Qt Quick 3D

Qt Quick 3D ofrece una API de alto nivel para crear contenido 3D e interfaces de usuario 3D basadas en Qt Quick. En lugar de utilizar un motor externo, lo que genera problemas de sincronización y capas adicionales de abstracción, Qt Quick 3D proporciona extensiones al grafo de escena existente deQt Quick para contenido espacial y un renderizador para ese grafo de escena ampliado. Al utilizar el grafo de escena espacial, es posible mezclar Qt Quick contenido 2D con contenido 3D.

Qt Quick El 3D también ofrece aplicaciones de XR y VR con Qt Quick 3D Xr.

Maqueta de un dragón metálico verde

Uso del módulo

API de QML

Los tipos QML del módulo están disponibles a través de la importación QtQuick3D. Para utilizar los tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import QtQuick3D

Las siguientes importaciones de módulos proporcionan funcionalidad adicional:

import QtQuick3D.AssetUtils
import QtQuick3D.Helpers
import QtQuick3D.Particles3D
import QtQuick3D.Xr

API de C++

Para utilizar la API de C++ de un módulo de Qt es necesario enlazar 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 el componente del módulo necesario en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS Quick3D)
target_link_libraries(mytarget PRIVATE Qt6::Quick3D)

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añada el módulo como valor de la variable ` QT ` en el archivo `.pro` del proyecto:

QT += quick3d

Compilación a partir del código fuente

Al compilar a partir del código fuente, asegúrate de que los módulos y herramientas de los repositorios qtdeclarative y qtshadertools se compilen primero, ya que no es posible utilizar « Qt Quick 3D» sin ellos. También se recomienda encarecidamente disponer de qtquicktimeline, ya que, de lo contrario, no estarán disponibles las animaciones basadas en fotogramas clave.

Además, algunos de los ejemplos dependen de los controles de «Qt Quick ».

Evolución del módulo

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

Artículos y guías

Ejemplos

Referencia

Cursos de Qt Academy

Licencias y atribuciones

Qt Quick Qt 3D está disponible bajo la licencia comercial de The Qt Company. Además, está disponible bajo la Licencia Pública General de GNU, versión 3. Consulta Licencias de Qt para obtener más detalles.

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

Blue Noise Texture

Creative Commons Zero v1.0 Universal

Godot Engine: Fog

Licencia MIT

Godot Engine: ProceduralSky

Licencia MIT

Intel Embree, version 3.13.3

Licencia Apache 2.0

Java Native Interface for C++, version 1.0.0

Licencia MIT

JsonCpp, version 1.9.6

Licencia MIT

Open Asset Import Library, version 6.0.5

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

OpenXR SDK, version 1.1.61

Licencia Apache 2.0

Tiny OpenEXR, version 1.0.13

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

closestPointOnTriangle

Licencia Apache versión 2.0

meshoptimizer, version 1.2

Licencia MIT

xatlas, version 16ace528acd2cf1f16a7c0dde99c42c486488dbe

Licencia del MIT

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