En esta página

Qt Quick 3D - Ejemplo de elementos Quick

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

Esfera en 3D con elementos en 2D superpuestos, entre los que se incluyen el logotipo de Qt y texto

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 Item debe 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)
        }
    }
}

Proyecto de ejemplo en code.qt.io

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.