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

Ejecución del ejemplo
Puedes ejecutar el ejemplo desde:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
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 QtDataVisualizationA continuación, crea el archivo « Item » principal y llámalo « mainView »:
Item {
id: mainViewA 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.bottomA 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: parentAhora 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.CameraPresetFrontSe 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: dataModelThreeAhora 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: scatterSeriesA 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
© 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.