Q3DScatterWidgetItem Class

Descripción detallada

Esta clase permite a los desarrolladores renderizar gráficos de dispersión en 3D y visualizarlos rotando libremente la escena. La rotación se consigue manteniendo pulsado el botón derecho del ratón y moviendo el ratón, mientras que el zoom se realiza utilizando la rueda del ratón. Si está activada, la selección se realiza con el botón izquierdo del ratón. La escena puede restablecerse a la vista de cámara predeterminada pulsando la rueda del ratón. En dispositivos táctiles, la rotación se consigue pulsando y moviendo, la selección pulsando y manteniendo pulsado, y el zoom pellizcando.

Si no se establecen ejes explícitamente en Q3DScatterWidgetItem, se crean ejes temporales por defecto sin etiquetas. Estos ejes por defecto pueden ser modificados a través de accesores de eje, pero tan pronto como cualquier eje se establece explícitamente para la orientación, el eje por defecto para esa orientación se destruye.

Q3DScatterWidgetItem soporta más de una serie visible al mismo tiempo.

Q3DScatterWidgetItem soporta transparencia. Esta característica permite ajustar la opacidad de los puntos de dispersión, haciéndolos parcialmente transparentes, totalmente transparentes u opacos.

Cómo construir un gráfico Q3DScatterWidgetItem mínimo

En primer lugar, construye Q3DScatterWidgetItem. Dado que en este ejemplo estamos ejecutando el gráfico como la ventana de nivel superior, necesitamos borrar la bandera Qt::FramelessWindowHint, que está establecida por defecto:

QQuickWidget quickWidget;
Q3DScatterWidgetItem scatter;
scatter.setWidget(&quickWidget);
scatter.widget()->setMinimumSize(QSize(256, 256));

Ahora Q3DScatterWidgetItem está listo para recibir datos para ser renderizados. Añada una serie de 3 elementos QVector3D:

QScatter3DSeries series;
QScatterDataArray data;
data << QScatterDataItem(0.5f, 0.5f, 0.5f) << QScatterDataItem(-0.3f, -0.5f, -0.4f)
     << QScatterDataItem(0.0f, -0.3f, 0.2f);
series.dataProxy()->addItems(data);
scatter.addSeries(&series);

Por último, será necesario hacerla visible:

scatter.widget()->show();

El código completo necesario para crear y mostrar este gráfico es:

#include <QtGraphs>
#include <QtGraphsWidgets/q3dscatterwidgetitem.h>
#include <QtWidgets/qapplication.h>

int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    QQuickWidget quickWidget;
    Q3DScatterWidgetItem scatter;
    scatter.setWidget(&quickWidget);
    scatter.widget()->setMinimumSize(QSize(256, 256));
    QScatter3DSeries series;
    QScatterDataArray data;
    data << QScatterDataItem(0.5f, 0.5f, 0.5f) << QScatterDataItem(-0.3f, -0.5f, -0.4f)
         << QScatterDataItem(0.0f, -0.3f, 0.2f);
    series.dataProxy()->addItems(data);
    scatter.addSeries(&series);
    scatter.widget()->show();

    return app.exec();
}

Y esto es lo que producen esas pocas líneas de código:

La escena se puede rotar, hacer zoom, y se puede seleccionar un elemento para ver su posición, pero no se incluyen otras interacciones en este ejemplo de código mínimo. Puedes aprender más familiarizándote con los ejemplos proporcionados, como el Gráfico de dispersión simple.