Qt Quick 3D - Ejemplo de elementos Quick
Muestra el uso de elementos « Qt Quick » en una escena «Quick 3D».

Este ejemplo muestra cómo utilizar elementos 2D de «Qt Quick » en una escena de Quick 3D.
Elementos Quick en una escena Quick 3D
Qt Quick Los elementos 2D de « Item», junto con todos sus elementos secundarios, se pueden añadir a escenas de Quick 3D. Al utilizar elementos de tipo « Qt Quick » en la escena 3D, hay que tener en cuenta algunas cosas:
- Cuando un elemento « Item » se encuentra dentro de un nodo « Node », su esquina superior izquierda se sitúa en el origen del nodo. Esto significa que, a menudo, será necesario especificar «
anchors.centerIn: parent» para garantizar que el origen del nodo « Node » coincida con el punto central del nodo « Item ». - Las transformaciones 3D se heredan del padre Node. Si más de un
Itemdebe verse afectado por la misma transformación, estos elementos pueden agruparse bajo un padre común Item dentro del Node. - En Qt 6.0, los elementos no reciben eventos táctiles ni de ratón, por ejemplo, con
MouseArea, por lo que deben ser no interactivos. - Los elementos Quick no se ven afectados por luces ni sombras.
- Clipping Se debe evitar su uso y no confiar en ellos.
A diferencia de versiones anteriores de Qt y de otros enfoques de integración de 2D en 3D, vincular un elemento Qt Quick a un nodo 3D Qt Quick no implica crear una textura, renderizar el contenido 2D en ella y, a continuación, dibujar un cuadrilátero texturizado. Más bien, Qt 6.0 admite el renderizado del contenido 2D dentro de la misma pasada de renderizado que la escena 3D. En la práctica, esto puede suponer mejoras de rendimiento potencialmente enormes. Esto no se aplica cuando el elemento se renderiza utilizando un destino de renderizado adicional por diseño, por ejemplo, porque tiene la opción « layer.enabled » establecida en «true» o porque se trata de un elemento « ShaderEffectSource ».
La escena de prueba
Las partes importantes de este ejemplo son el contenido de la escena del elemento « View3D ».
Comenzamos añadiendo la capa más alejada de la cámara. Esta capa contiene elementos ` Rectangle`, ` Text ` y ` Image `. Para garantizar que los elementos de la capa se sitúen correctamente, se agrupan bajo un elemento padre común ` Item`. Ten en cuenta que todo el contenido queda recortado dentro de este elemento raíz, por lo que debe tener el tamaño adecuado.
Node {
position: Qt.vector3d(0, 100, -120)
Item {
width: 400
height: 400
anchors.centerIn: parent
Rectangle {
anchors.fill: parent
opacity: 0.4
color: "#202020"
radius: 10
border.width: 2
border.color: "#f0f0f0"
}
Text {
anchors.top: parent.top
anchors.topMargin: 10
anchors.horizontalCenter: parent.horizontalCenter
font.pixelSize: 20
color: "#e0e0e0"
style: Text.Raised
text: qsTr("Background Item")
}
Image {
anchors.centerIn: parent
source: "Built_with_Qt_RGB_logo_vertical"
}
}
}A continuación, Node y sus elementos se sitúan un poco más cerca de la cámara. Contiene tres elementos Rectangle que animan tanto la posición x como la rotación. Ten en cuenta que las animaciones se realizan en el elemento padre Node, mientras que el contenido del elemento Quick Item permanece estático. Desde el punto de vista del rendimiento, este es un buen enfoque para elementos más complejos.
Node {
position: Qt.vector3d(0, 150, 100)
SequentialAnimation on x {
loops: Animation.Infinite
NumberAnimation {
to: -200
duration: 1500
easing.type: Easing.InOutQuad
}
NumberAnimation {
to: 200
duration: 1500
easing.type: Easing.InOutQuad
}
}
NumberAnimation on eulerRotation.z {
loops: Animation.Infinite
from: 0
to: 360
duration: 4000
easing.type: Easing.InOutBack
}
Item {
width: 400
height: 400
anchors.centerIn: parent
// This allows rendering into offscreen surface and caching it.
layer.enabled: true
Rectangle {
x: 150
y: 100
width: 100
height: 100
radius: 50
color: "#80808020"
border.color: "black"
border.width: 2
}
Rectangle {
x: 90
y: 200
width: 100
height: 100
radius: 50
color: "#80808020"
border.color: "black"
border.width: 2
}
Rectangle {
x: 210
y: 200
width: 100
height: 100
radius: 50
color: "#80808020"
border.color: "black"
border.width: 2
}
}
}La tercera capa de elementos de este ejemplo contiene un único elemento « Text » con una animación de opacidad. El elemento «Text» se centra automáticamente en el elemento padre « Node ».
Node {
position: Qt.vector3d(0, 80, 250)
Text {
anchors.centerIn: parent
width: 300
wrapMode: Text.WordWrap
horizontalAlignment: Text.AlignJustify
font.pixelSize: 14
color: "#e0e0e0"
style: Text.Raised
text: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod " +
"tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim " +
"veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea " +
"commodo consequat."
SequentialAnimation on opacity {
loops: Animation.Infinite
NumberAnimation {
to: 0
duration: 1500
easing.type: Easing.InOutQuad
}
NumberAnimation {
to: 1
duration: 1500
easing.type: Easing.InOutQuad
}
}
}
}Para visualizar el orden de superposición (z-ordering) de las capas de elementos «Quick» anteriores, también configuraremos un modelo para la bola de demolición en 3D. Esta se anima girando alrededor del elemento « Node » superior, lo que hace que la esfera se desplace a través de las demás capas.
Node {
position: Qt.vector3d(0, 800, 0)
SequentialAnimation on eulerRotation.x {
loops: Animation.Infinite
NumberAnimation {
to: 20
duration: 3500
easing.type: Easing.InOutQuad
}
NumberAnimation {
to: -20
duration: 3500
easing.type: Easing.InOutQuad
}
}
Model {
source: "#Cylinder"
y: -300
scale: Qt.vector3d(0.1, 6.1, 0.1)
materials: PrincipledMaterial {
baseColor: Qt.rgba(0.9, 0.9, 0.9, 1.0)
}
}
Model {
source: "#Sphere"
y: -700
scale: Qt.vector3d(2, 2, 2)
materials: PrincipledMaterial {
baseColor: Qt.rgba(0.4, 0.4, 0.4, 1.0)
}
}
}Véase también Qt Quick Escenas 3D con contenido 2D.
© 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.