Qt Quick 3D - Introducción
Muestra cómo renderizar una escena en 3D c Qt Quick.

Este ejemplo ofrece una visión general introductoria de las funciones básicas de Quick 3D a través del código de un ejemplo sencillo.
Configuración de la escena
Configuramos toda la escena en el archivo main.qml.
Para poder utilizar los tipos del módulo « QtQuick3D », debemos importarlo:
import QtQuick
import QtQuick3DPara dibujar cualquier escena 3D, necesitamos una ventana de visualización 3D dentro de la escena de « Qt Quick ». De ello se encarga la clase « View3D », y es ahí donde definimos nuestra escena. También es posible tener varias vistas en una misma aplicación; véase «Qt Quick » 3D - Ejemplo View3D.
Comenzamos definiendo el entorno de nuestra escena. En este ejemplo, simplemente borramos el color de fondo con ` skyblue`, que especificamos en un ` SceneEnvironment ` para la propiedad ` environment ` de la vista. SceneEnvironment describe diversas propiedades relacionadas con el entorno de la escena, como la configuración del mapeo de tonos, la configuración de las sondas de luz para la iluminación basada en imágenes, el modo de fondo o los parámetros de oclusión ambiental. También permite controlar el suavizado; véase Qt Quick 3D - Ejemplo de suavizado. En nuestro ejemplo, configuramos las propiedades clearColor y backgroundMode para obtener un fondo azul.
environment: SceneEnvironment {
clearColor: "skyblue"
backgroundMode: SceneEnvironment.Color
}Mallas
Para que la escena resulte un poco más interesante, vamos a añadir ahora algunas mallas. En Quick 3D hay varias mallas integradas para mayor comodidad, como por ejemplo la esfera, el cubo, el cono o el cilindro. Se hace referencia a ellas utilizando identificadores especiales, como #Sphere, #Cube o#Rectangle en la propiedad «source» de un nodo «Model». Además de las primitivas integradas, se puede especificar un archivo ` .mesh `. Para generar archivos ` .mesh ` a partir de recursos FBX o glTF2, estos deben procesarse con la herramienta Balsam Asset Import Tool. A continuación se muestra el código para añadir una esfera azul y un cilindro aplanado rojo:
Model {
position: Qt.vector3d(0, -200, 0)
source: "#Cylinder"
scale: Qt.vector3d(2, 0.2, 1)
materials: [ PrincipledMaterial {
baseColor: "red"
}
]
}
Model {
position: Qt.vector3d(0, 150, 0)
source: "#Sphere"
materials: [ PrincipledMaterial {
baseColor: "blue"
}
]
SequentialAnimation on y {
loops: Animation.Infinite
NumberAnimation {
duration: 3000
to: -150
from: 150
easing.type:Easing.InQuad
}
NumberAnimation {
duration: 3000
to: 150
from: -150
easing.type:Easing.OutQuad
}
}
}Para añadir las mallas, utilizamos dos nodos «Model», con « #Sphere » y « #Cylinder » como « source » para cargar nuestras mallas integradas. Para dar color al modelo, primero debemos especificar un material. En este caso, utilizamos un « PrincipledMaterial » con colores base rojo y azul. Hay tres materiales diferentes disponibles con distintas propiedades: PrincipledMaterial, SpecularGlossyMaterial y CustomMaterial; véase Qt Quick 3D - Ejemplo de material basado en principios y Materiales programables, efectos, geometría y datos de textura. La malla cargada mediante un « Model » puede tener varias submallas, y es necesario especificar un material para cada una de ellas. En el ejemplo solo se utilizan las mallas integradas, que solo tienen una submalla cada una; por lo tanto, basta con especificar un único « PrincipledMaterial » en la lista « materials ».
Un « Model » es un « Node », por lo que tiene una transformación asociada. Para aplicar una traslación, utilizamos la propiedad « position ». También es posible rotar el modelo ajustando la propiedad « eulerRotation ». Para que el cilindro parezca una placa, ajustamos la propiedad « scale » en consecuencia.
Cámara
A continuación, definimos una cámara, que especifica cómo se proyecta el contenido de la escena 3D sobre una superficie 2D. En este ejemplo, utilizamos PerspectiveCamera, lo que nos proporciona una proyección en perspectiva. También es posible realizar una proyección ortográfica mediante el tipo OrthographicCamera. La orientación predeterminada de la cámara tiene su vector de avance apuntando a lo largo del eje Z negativo y su vector de elevación a lo largo del eje Y positivo. En el ejemplo, la cámara se desplaza hacia atrás 300 en el eje Z. Además, se desplaza ligeramente hacia arriba en el eje Y y se gira ligeramente alrededor del eje X para que la vista apunte ligeramente hacia abajo.
PerspectiveCamera {
position: Qt.vector3d(0, 200, 300)
eulerRotation.x: -30
}Luces
La escena también necesita una fuente de luz para poder ver los modelos que contiene. Se añade a la escena una luz de tipo « DirectionalLight », que puede considerarse como un sol lejano que brilla desde una dirección determinada. Hay otras dos fuentes de luz disponibles, a saber, « SpotLight » y « PointLight »; véase el ejemplo «Qt Quick 3D - Lights».
DirectionalLight {
eulerRotation.x: -30
eulerRotation.y: -70
}Animación
Por último, también vamos a animar la esfera. Para ello, aplicamos un « SequentialAnimation » al componente y, lo que hace que la esfera se mueva hacia arriba y hacia abajo de forma infinita.
SequentialAnimation on y {
loops: Animation.Infinite
NumberAnimation {
duration: 3000
to: -150
from: 150
easing.type:Easing.InQuad
}
NumberAnimation {
duration: 3000
to: 150
from: -150
easing.type:Easing.OutQuad
}
}Con todas estas partes funcionando conjuntamente, podemos renderizar nuestra escena 3D. Este ejemplo solo aborda algunas de las capacidades básicas de Qt Quick 3D. Visita la página de ejemplos para ver más ejemplos.
© 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.