En esta página

Gráfico de dispersión sencillo

Uso de Scatter3D en una aplicación QML.

«Gráfico de dispersión sencillo» muestra cómo crear una visualización sencilla de un gráfico de dispersión utilizando Scatter3D y QML.

Para obtener instrucciones sobre cómo interactuar con el gráfico, consulta esta página.

Para obtener instrucciones sobre cómo crear una nueva aplicación « Qt Quick » por tu cuenta, consulta la ayuda de « Qt Creator ».

Gráfico de dispersión en 3D que representa series de tres puntos con diferentes formas y densidades

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Conceptos básicos de la aplicación

Antes de profundizar en el código QML, echa un vistazo a la aplicación main.cpp.

Esta aplicación implementa un botón «Salir» en la interfaz de usuario, por lo que debes conectar la señal QQmlEngine::quit() con la ranura QWindow::close() de la aplicación:

QObject::connect(viewer.engine(), &QQmlEngine::quit, &viewer, &QWindow::close);

Para simplificar un poco la implementación, reúne todos los archivos .qml de la aplicación en un archivo de recursos (qmlscatter.qrc):

<RCC>
    <qresource prefix="/">
        <file>qml/qmlscatter/Data.qml</file>
        <file>qml/qmlscatter/main.qml</file>
    </qresource>
</RCC>

Esto también requiere configurar que el archivo « main.qml » se lea desde el recurso (qrc:):

viewer.setSource(QUrl("qrc:/qml/qmlscatter/main.qml"));

Cuando se utiliza cmake en lugar de qmake, los archivos « .qml » se añaden a un módulo QML en el archivo « CMakeLists.txt »:

qt6_add_qml_module(qmlscatter
    URI Scatter
    VERSION 1.0
    NO_RESOURCE_TARGET_PATH
    QML_FILES
        qml/qmlscatter/Data.qml
        qml/qmlscatter/main.qml
)

Por último, haz que la aplicación se ejecute en una ventana maximizada:

viewer.showMaximized();

Configuración del gráfico

En primer lugar, importa todos los módulos QML necesarios:

import QtQuick
import QtQuick.Controls
import QtDataVisualization

A continuación, crea el archivo « Item » principal y llámalo « mainView »:

Item {
    id: mainView

A continuación, añade otro « Item » dentro del « Item » principal y llámalo « dataView ». Este será el elemento que albergará el gráfico Scatter3D. Ancla este elemento a la parte inferior del elemento padre:

Item {
    id: dataView
    anchors.bottom: parent.bottom

A continuación, añade el propio gráfico Scatter3D. Añádelo dentro del dataView y asígnale el nombre scatterGraph. Haz que ocupe todo el dataView:

Scatter3D {
    id: scatterGraph
    anchors.fill: parent

Ahora el gráfico está listo para su uso, pero no tiene datos. Además, presenta los ejes y las propiedades visuales predeterminados.

A continuación, modifica primero algunas propiedades visuales añadiendo lo siguiente dentro de « scatterGraph »:

theme: themeQt
shadowQuality: AbstractGraph3D.ShadowQualityHigh
scene.activeCamera.cameraPreset: Camera3D.CameraPresetFront

Se ha añadido un tema personalizado, se ha cambiado la calidad de la sombra y se ha ajustado la posición de la cámara. El resto de propiedades visuales están bien, así que no es necesario modificarlas.

El tema personalizado se basa en un tema predefinido, Theme3D.ThemeQt, pero se ha cambiado la fuente:

Theme3D {
    id: themeQt
    type: Theme3D.ThemeQt
    font.pointSize: 40
}

A continuación, empieza a introducir datos en el gráfico.

Añadir datos al gráfico

Crea un elemento « Data » dentro de « mainView » y asígnale el nombre « seriesData »:

Data {
    id: seriesData
}

El elemento « seriesData » contiene los modelos de datos de las tres series utilizadas en este ejemplo.

Este es el componente que almacena los datos en « Data.qml ». Tiene un « Item » como componente principal.

En el componente principal, añade los datos propiamente dichos a un « ListModel » y asígnale el nombre « dataModel »:

ListModel {
    id: dataModel
    ListElement{ xPos: -10.0; yPos: 5.0; zPos: -5.0 }
    ...

Añade dos más de estos a las otras dos series y asígnales los nombres « dataModelTwo » y « dataModelThree ».

A continuación, exponga los modelos de datos para que puedan utilizarse desde « main.qml ». Para ello, defínalos como alias en el componente de datos principal:

property alias model: dataModel
property alias modelTwo: dataModelTwo
property alias modelThree: dataModelThree

Ahora puedes utilizar los datos de Data.qml junto con scatterGraph en main.qml. En primer lugar, añade una Scatter3DSeries y llámala scatterSeries:

Scatter3DSeries {
    id: scatterSeries

A continuación, configura el formato de la etiqueta de selección para la serie:

itemLabelFormat: "Series 1: X:@xLabel Y:@yLabel Z:@zLabel"

Y, por último, añade los datos de la serie uno en un ItemModelScatterDataProxy. Establece los propios datos como el itemModel para el proxy:

ItemModelScatterDataProxy {
    itemModel: seriesData.model
    xPosRole: "xPos"
    yPosRole: "yPos"
    zPosRole: "zPos"
}

Añade las otras dos series de la misma manera, pero modifica ligeramente algunos detalles específicos de cada serie:

Scatter3DSeries {
    id: scatterSeriesTwo
    itemLabelFormat: "Series 2: X:@xLabel Y:@yLabel Z:@zLabel"
    itemSize: 0.05
    mesh: Abstract3DSeries.MeshCube
    ...

A continuación, modifica ligeramente las propiedades de los ejes predeterminados en ` scatterGraph `:

axisX.segmentCount: 3
axisX.subSegmentCount: 2
axisX.labelFormat: "%.2f"
axisZ.segmentCount: 2
axisZ.subSegmentCount: 2
axisZ.labelFormat: "%.2f"
axisY.segmentCount: 2
axisY.subSegmentCount: 2
axisY.labelFormat: "%.2f"

A continuación, añade algunos botones al « mainView » para controlar el gráfico; a continuación se muestra uno de ellos a modo de ejemplo:

Button {
    id: shadowToggle
    width: mainView.buttonWidth // Calculated elsewhere based on screen orientation
    anchors.left: parent.left
    anchors.top: parent.top
    anchors.margins: 5
    text: scatterGraph.shadowsSupported ? "Hide Shadows" : "Shadows not supported"
    enabled: scatterGraph.shadowsSupported
    onClicked: {
        if (scatterGraph.shadowQuality === AbstractGraph3D.ShadowQualityNone) {
            scatterGraph.shadowQuality = AbstractGraph3D.ShadowQualityHigh;
            text = "Hide Shadows";
        } else {
            scatterGraph.shadowQuality = AbstractGraph3D.ShadowQualityNone;
            text = "Show Shadows";
        }
    }
}

A continuación, modifica dataView para dejar espacio para los botones en la parte superior:

Item {
    id: dataView
    anchors.bottom: parent.bottom
    width: parent.width
    // Adjust the space based on screen orientation:
    // If we're in portrait mode, we have 3 rows of buttons, otherwise they are all in one row.
    height: parent.height - (mainView.portraitMode ? shadowToggle.implicitHeight * 3 + 25
                                                   : shadowToggle.implicitHeight + 10)
    ...

¡Y ya está!

Contenido del ejemplo

Proyecto de ejemplo en code.qt.io

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