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 tu propia aplicación de Qt Quick, consulta la ayuda de Qt Creator.

Gráfico de dispersión en 3D con esferas de colores y controles de visualización

Ejecución del ejemplo

Puede ejecutar el ejemplo desde:

Configuración del diseño

Antes de adentrarse en el código QML, main.cpp configura la aplicación. El archivo main.qml se lee desde el recurso (qrc:)

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

Este archivo ` main.qml ` es el punto de partida para el código QML de la aplicación. En primer lugar, importa todos los módulos QML necesarios:

import QtQuick
import QtQuick.Controls
import QtQuick.Layouts
import QtGraphs

A continuación, crea un elemento « Data », que será el que contenga los datos del gráfico.

Data {
    id: seriesData
}

A continuación, crea dos elementos « GraphsTheme » que definan dos temas diferentes para el gráfico: un tema «Qt Green» y un tema «Qt Neon Green».

GraphsTheme {
    id: themeQt
    theme: GraphsTheme.Theme.QtGreen
    labelFont.pointSize: 40
}

GraphsTheme {
    id: themeQtNeonGreen
    theme: GraphsTheme.Theme.QtGreenNeon
    colorScheme: GraphsTheme.ColorScheme.Dark
}

El diseño de esta aplicación constará de cinco botones diferentes para activar y desactivar distintas opciones visuales del gráfico y, por supuesto, del propio gráfico. Hay muchas formas de organizarlos; una de ellas es utilizar un elemento « GridLayout » que contenga cuatro botones —el « Graph » y el quinto botón—, todos ellos dentro de un elemento « ColumnLayout ».

ColumnLayout {
    id: mainLayout
    anchors.fill: parent
    anchors.margins: margin
    spacing: spacing

El GridLayout es responsivo. Esto significa que el número de columnas utilizadas depende del ancho de la ventana de la aplicación. Esto se consigue asignando a la propiedad columns un operador ternario, cuyo valor es 1, 2 o 4, dependiendo del ancho de la ventana.

GridLayout {
    Layout.fillWidth: true
    rowSpacing: spacing
    columnSpacing: spacing

    columns: mainView.width < mainView.buttonMinWidth * 2 + mainView.spacing + mainView.margin * 2 // width of 2 buttons
             ? 1
             : (mainView.width < mainView.buttonMinWidth * 4 + mainView.spacing * 3 + mainView.margin * 2 // width of 4 buttons
                ? 2
                : 4)

En este « GridLayout », se instancian cuatro « RoundButton». Uno para activar o desactivar las sombras, otro para suavizar la malla, otro para la posición de la cámara y, por último, otro para cambiar el fondo del gráfico. Todos los botones siguen la misma estructura. En lugar de redefinir esta estructura para todos los botones, se puede crear un componente personalizado.

component CustomButton : RoundButton {
    id: buttonRoot

CustomButtom extends the RoundButton type, but adds a few additions. Se establecen propiedades como Layout.minimumWidth, Layout.FillWidth, radius y background. Estas definen el estilo y el diseño del botón.

property alias source: iconImage.source

Layout.minimumWidth: buttonMinWidth
Layout.fillWidth: true

radius: mainView.radius

background: Rectangle {
    radius: mainView.radius
    color: "white"
    border.color: "black"
}

Por su parte, la propiedad « contentItem » define el contenido del botón; en este caso, un objeto de tipo « Row » que contiene un icono y algo de texto. El icono se importa utilizando un tipo « Image » y configurando la propiedad « source ». El texto se crea utilizando un tipo « Label » y se configura mediante su propiedad « text ». Se crean dos alias para estas dos propiedades en la parte superior del componente personalizado, lo que permitirá configurarlas cuando se cree una instancia de « CustomButton ».

contentItem: Row {
    id: content
    Image {
        id: iconImage
    }
    Label {
        text: buttonRoot.text
        horizontalAlignment: Text.AlignLeft
        anchors.verticalCenter: parent.verticalCenter
    }
}

En el ` GridLayout`, se crean cuatro ` CustomButton`. Es necesario establecer tres propiedades: los dos alias para la imagen del icono y el texto, y la señal ` onClicked`.

CustomButton {
    id: shadowButton
    text: graph.shadowQuality === Graphs3D.ShadowQuality.None ?
              qsTr("Show Shadows") : qsTr("Hide Shadows")
    source: graph.shadowQuality === Graphs3D.ShadowQuality.None ?
                "qrc:/images/shadow.svg" : "qrc:/images/shadow_hide.svg"
    onClicked: {
        graph.shadowQuality = graph.shadowQuality === Graphs3D.ShadowQuality.None ?
                    Graphs3D.ShadowQuality.High :
                    Graphs3D.ShadowQuality.None
    }
}

Por ejemplo, el botón «sombra» configura la señal onClicked para activar y desactivar la sombra.

Configuración del gráfico

A continuación en el diseño se encuentra el « Graph », que se define en su propio archivo QML « Graph.qml » y se instancia de la siguiente manera:

Graph {
    id: graph
    Layout.fillWidth: true
    Layout.fillHeight: true
}

Si observamos su implementación en Graph.qml, el gráfico es de tipo Scatter3D, anidado dentro de un tipo Item.

Scatter3D {
    id: scatterGraph

Antes de definir los conjuntos de datos, se configuran algunas de las propiedades de los ejes.

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"

Configuración de los datos

El gráfico muestra tres conjuntos de datos, que representan los datos proporcionados en Data.qml. Los conjuntos de datos se almacenan en tipos ListModel

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

ListModel {
    id: dataModelTwo
    ListElement{ xPos: 2.25 ; yPos: 1.36 ; zPos: -1.3 }
    ...
    ListElement{ xPos: -3.4 ; yPos: 0.6 ; zPos: 0.9 }
}

ListModel {
    id: dataModelThree
    ListElement{ xPos: 8.0; yPos: -2.0; zPos: 4.0 }
    ...
    ListElement{ xPos: 5.66 ; yPos: -4.98 ; zPos: 3.72 }
}

y se exponen a los demás archivos mediante property aliases

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

Antes de utilizar estos alias, cree un tipo « Scatter3DSeries » que contenga un elemento « ItemModelScatterDataProxy ».

Scatter3DSeries {
    id: scatterSeries
    itemLabelFormat: "Series 1: X:@xLabel Y:@yLabel Z:@zLabel"

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

Este proxy de datos hace referencia a los conjuntos de datos en Data.qml mediante su propiedad itemModel. Se accede a los alias mencionados anteriormente a través de la id del tipo Data instanciado en main.qml, seriesData.

itemModel: seriesData.model

Repite este proceso con los dos conjuntos de datos restantes.

Scatter3DSeries {
    id: scatterSeriesTwo
    ...
ItemModelScatterDataProxy {
    itemModel: seriesData.modelTwo
    ...
    }
}
Scatter3DSeries {
    id: scatterSeriesThree
    ...
ItemModelScatterDataProxy {
    itemModel: seriesData.modelThree
    ...
    }
}

Genial, el gráfico de dispersión ahora apunta a los tres conjuntos de datos.

Lo único que queda por hacer es añadir el botón restante, el « theme button », a nuestro « ColumnLayout ». La única diferencia con este botón es que está situado en el lado izquierdo del diseño. Esto se configura definiendo la propiedad « Layout.alignment » como « Qt.AlignLeft » y « Layout.fillWidth » como « false ».

CustomButton {
    id: themeButton
    Layout.alignment: Qt.AlignLeft
    Layout.fillWidth: false

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.