Qt Quick 3D

Qt Quick 3D proporciona una API de alto nivel para crear contenidos 3D e interfaces de usuario 3D basadas en Qt Quick. En lugar de utilizar un motor externo, que crea problemas de sincronización y capas adicionales de abstracción, Qt Quick 3D proporciona extensiones del gráfico de escena existente Qt Quick para contenido espacial y un renderizador para ese gráfico de escena extendido. Cuando se utiliza el gráfico de escena espacial, es posible mezclar Qt Quick contenido 2D con contenido 3D.

Qt Quick 3D también proporciona aplicaciones XR y VR con Qt Quick 3D Xr.

Uso del módulo

API QML

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

import QtQuick3D

Las siguientes importaciones del módulo proporcionan funcionalidad adicional:

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

API C

El uso de la API C++ de un módulo 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 tienen soporte dedicado para esto, incluyendo CMake y qmake.

Compilación con CMake

Utilice 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 información, consulta la descripción general de la compilación con CMake.

Compilación con qmake

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

QT += quick3d

Construcción desde el código fuente

Al construir desde el código fuente, asegúrese de que los módulos y herramientas de los repositorios qtdeclarative y qtshadertools se construyen en primer lugar, ya que no es posible utilizar Qt Quick 3D sin ellos. También se recomienda encarecidamente disponer de qtquicktimeline, ya que, de lo contrario, las animaciones basadas en fotogramas clave no estarán disponibles.

Además, algunos de los ejemplos dependen de Qt Quick Controls.

Evolución del módulo

Cambios en Qt Quick 3D enumera los cambios importantes en la API del módulo y la funcionalidad que se hicieron para la serie Qt 6 de Qt.

Artículos y Guías

• Qt Quick Ejemplo de Introducción 3D
• Qt Quick Introducción 3D con activos glTF
• Qt Quick Requisitos Gráficos 3D
• Qt Quick Arquitectura 3D
• Herramienta de Importación de Activos Balsam
• Optimización de activos 3D
• Renderizado basado en la física
• Iluminación basada en imágenes
• Mejores prácticas de antialiasing
• Qt Quick Escenas 3D con contenido 2D
• Materiales programables, efectos, geometría y datos de textura
• Animación esquelética
• Animación Morphing
• Renderizado por instancias
• Nivel de detalle
• Editor de materiales personalizado
• Mapas de luz e iluminación global
• Mapeado de sombras
• Qt Quick 3D Xr
• Renderizado multivista
• Caché de sombreadores en disco

Ejemplos

• Introducción
• View3D con múltiples ventanas
• Luces y sombras
• Creación dinámica de modelos
• Principio Material
• Efectos incorporados y tonemapping
• Qt Quick Elementos dentro de la escena 3D
• Materiales personalizados
• Materiales personalizados sin sombreado
• Escribiendo Efectos Personalizados de Post-Procesamiento
• Añadir geometría personalizada desde C
• Adición de datos de textura personalizados desde C++
• Uso de mapas de luz
• Demostración de la configuración de una escena de RV sencilla
• Demostración de la entrada del controlador en RV
• Demostración de anclajes espaciales en RV
• Todos los ejemplos

Referencia

• Qt Quick 3D QML Types
• Qt Quick 3D C++ Classes
• Qt Quick 3D Helpers QML Types
• Qt Quick 3D Asset Utility QML Types
• Qt Quick 3D Particles3D QML Types
• Qt Quick 3D Xr

Módulos relacionados

• Qt Quick

Cursos de Qt Academy

• Qt Quick 3D: Animaciones
• Qt Quick 3D: Activos y Recursos
• Qt Quick 3D: Materiales Personalizados, Ajustes de Render y Post-Procesamiento
• Qt Quick 3D: Interacción y Gestión del Rendimiento
• Qt Quick 3D: Iluminación y Cámaras
• Qt Quick 3D: Vistas, escenas y nodos

Licencias y atribuciones

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

Además, Qt Quick 3D contiene potencialmente módulos de terceros bajo las siguientes licencias permisivas: