Q3DScatterWidgetItem Class

Description détaillée

Cette classe permet aux développeurs de générer des graphiques de dispersion en 3D et de les visualiser en faisant pivoter librement la scène. La rotation s'effectue en maintenant le bouton droit de la souris enfoncé et en déplaçant la souris, tandis que le zoom s'effectue à l'aide de la molette de la souris. Si cette option est activée, la sélection s'effectue avec le bouton gauche de la souris. La scène peut être réinitialisée à la vue par défaut de la caméra en cliquant sur la molette de la souris. Sur les appareils tactiles, la rotation s'effectue par « tap-and-move », la sélection par « tap-and-hold » et le zoom par « pinch ».

Si aucun axe n'est explicitement défini pour Q3DScatterWidgetItem, des axes par défaut temporaires sans étiquette sont créés. Ces axes par défaut peuvent être modifiés via des accesseurs d'axe, mais dès qu'un axe est explicitement défini pour une orientation, l'axe par défaut correspondant à cette orientation est supprimé.

Q3DScatterWidgetItem prend en charge l’affichage simultané de plusieurs séries.

Q3DScatterWidgetItem prend en charge la transparence. Cette fonctionnalité vous permet de régler l’opacité des points du nuage de points, en les rendant partiellement transparents, entièrement transparents ou opaques.

Comment créer un graphique Q3DScatterWidgetItem minimal

Commencez par créer un objet `Q3DScatterWidgetItem`. Comme, dans cet exemple, le graphique s’exécute en tant que fenêtre de niveau supérieur, nous devons désactiver le drapeau ` Qt::FramelessWindowHint `, qui est activé par défaut :

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

Q3DScatterWidgetItem est désormais prêt à recevoir les données à afficher. Ajoutez une série de 3 éléments « 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);

Enfin, vous devrez le rendre visible :

scatter.widget()->show();

Le code complet nécessaire pour créer et afficher ce graphique est le suivant :

#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();
}

Et voici le résultat obtenu avec ces quelques lignes de code :

La scène peut être pivotée, agrandie, et un élément peut être sélectionné pour afficher sa position, mais cet exemple de code minimal ne comporte aucune autre interaction. Vous pouvez en savoir plus en vous familiarisant avec les exemples fournis, comme le « Simple Scatter Graph ».