Q3DScatterWidgetItem Class

Description détaillée

Cette classe permet aux développeurs de rendre des graphiques de dispersion en 3D et de les visualiser en faisant pivoter librement la scène. La rotation est réalisée en maintenant le bouton droit de la souris enfoncé et en déplaçant la souris, tandis que le zoom est réalisé à l'aide de la molette de la souris. Si elle est activée, la sélection s'effectue à l'aide du bouton gauche de la souris. La scène peut être ramené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 tapotement et déplacement, la sélection par tapotement et maintien, et le zoom par pincement.

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

Q3DScatterWidgetItem supporte plus d'une série visible en même temps.

Q3DScatterWidgetItem prend en charge la transparence. Cette fonctionnalité vous permet d'ajuster l'opacité des points de diffusion, en les rendant partiellement transparents, totalement transparents ou opaques.

Comment construire un graphique Q3DScatterWidgetItem minimal ?

Commencez par construire Q3DScatterWidgetItem. Comme nous exécutons le graphique en tant que fenêtre de premier niveau dans cet exemple, 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 maintenant prêt à recevoir des données à rendre. 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 la rendre visible :

scatter.widget()->show();

Le code complet nécessaire à la création et à l'affichage de 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 ce que ces quelques lignes de code produisent :

La scène peut être tournée, zoomée, et un élément peut être sélectionné pour voir sa position, mais aucune autre interaction n'est incluse dans cet exemple de code minimal. Vous pouvez en apprendre davantage en vous familiarisant avec les exemples fournis, comme le graphique de dispersion simple.