Q3DScatter Class
La clase Q3DScatter proporciona métodos para representar gráficos de dispersión 3D. Más...
| Cabecera: | #include <Q3DScatter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| Hereda: | QAbstract3DGraph |
Propiedades
- axisX : QValue3DAxis*
- axisY : QValue3DAxis*
- axisZ : QValue3DAxis*
- selectedSeries : QScatter3DSeries*
Funciones públicas
| Q3DScatter(const QSurfaceFormat *format = nullptr, QWindow *parent = nullptr) | |
| virtual | ~Q3DScatter() |
| void | addAxis(QValue3DAxis *axis) |
| void | addSeries(QScatter3DSeries *series) |
| QList<QValue3DAxis *> | axes() const |
| QValue3DAxis * | axisX() const |
| QValue3DAxis * | axisY() const |
| QValue3DAxis * | axisZ() const |
| void | releaseAxis(QValue3DAxis *axis) |
| void | removeSeries(QScatter3DSeries *series) |
| QScatter3DSeries * | selectedSeries() const |
| QList<QScatter3DSeries *> | seriesList() const |
| void | setAxisX(QValue3DAxis *axis) |
| void | setAxisY(QValue3DAxis *axis) |
| void | setAxisZ(QValue3DAxis *axis) |
Señales
| void | axisXChanged(QValue3DAxis *axis) |
| void | axisYChanged(QValue3DAxis *axis) |
| void | axisZChanged(QValue3DAxis *axis) |
| void | selectedSeriesChanged(QScatter3DSeries *series) |
Descripción detallada
Esta clase permite a los desarrolladores renderizar gráficos de dispersión en 3D y visualizarlos rotando la escena libremente. La rotación se realiza manteniendo pulsado el botón derecho del ratón y moviendo el ratón. El zoom se realiza mediante la rueda del ratón. La selección, si está activada, se realiza con el botón izquierdo del ratón. La escena se puede restablecer a la vista de cámara predeterminada pulsando la rueda del ratón. En dispositivos táctiles, la rotación se realiza pulsando y moviendo, la selección pulsando y manteniendo pulsado y el zoom pellizcando.
Si no se establecen ejes explícitamente en Q3DScatter, 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.
Q3DScatter soporta más de una serie visible al mismo tiempo.
Cómo construir un gráfico Q3DScatter mínimo
En primer lugar, construya Q3DScatter. Como en este ejemplo estamos ejecutando el gráfico como ventana de nivel superior, necesitamos borrar la bandera Qt::FramelessWindowHint, que se establece por defecto:
Q3DScatter scatter; scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint);
Ahora Q3DScatter está listo para recibir datos para ser renderizados. Añade una serie de 3 elementos QVector3D:
QScatter3DSeries *series = new QScatter3DSeries; QScatterDataArray data; data << QVector3D(0.5f, 0.5f, 0.5f) << QVector3D(-0.3f, -0.5f, -0.4f) << QVector3D(0.0f, -0.3f, 0.2f); series->dataProxy()->addItems(data); scatter.addSeries(series);
Por último, tendrás que configurarlo como visible:
scatter.show();El código completo necesario para crear y mostrar este gráfico es:
#include <QtDataVisualization> int main(int argc, char **argv) { qputenv("QSG_RHI_BACKEND", "opengl"); QGuiApplication app(argc, argv); Q3DScatter scatter; scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint); QScatter3DSeries *series = new QScatter3DSeries; QScatterDataArray data; data << QVector3D(0.5f, 0.5f, 0.5f) << QVector3D(-0.3f, -0.5f, -0.4f) << QVector3D(0.0f, -0.3f, 0.2f); series->dataProxy()->addItems(data); scatter.addSeries(series); scatter.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 incluye ninguna otra interacción 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.
Véase también Q3DBars, Q3DSurface, y Qt Data Visualization C++ Classes.
Documentación de propiedades
axisX : QValue3DAxis*
Esta propiedad contiene el eje x activo.
Funciones de acceso:
| QValue3DAxis * | axisX() const |
| void | setAxisX(QValue3DAxis *axis) |
Señal del notificador:
| void | axisXChanged(QValue3DAxis *axis) |
axisY : QValue3DAxis*
Esta propiedad contiene el eje y activo.
Funciones de acceso:
| QValue3DAxis * | axisY() const |
| void | setAxisY(QValue3DAxis *axis) |
Señal del notificador:
| void | axisYChanged(QValue3DAxis *axis) |
axisZ : QValue3DAxis*
Esta propiedad contiene el eje z activo.
Funciones de acceso:
Señal del notificador:
| void | axisZChanged(QValue3DAxis *axis) |
[read-only] selectedSeries : QScatter3DSeries*
Esta propiedad contiene la serie seleccionada o null.
Funciones de acceso:
| QScatter3DSeries * | selectedSeries() const |
Señal del notificador:
| void | selectedSeriesChanged(QScatter3DSeries *series) |
Documentación de funciones miembro
[explicit] Q3DScatter::Q3DScatter(const QSurfaceFormat *format = nullptr, QWindow *parent = nullptr)
Construye un nuevo gráfico de dispersión 3D con la ventana opcional parent y la superficie format.
[virtual noexcept] Q3DScatter::~Q3DScatter()
Destruye el gráfico de dispersión 3D.
void Q3DScatter::addAxis(QValue3DAxis *axis)
Añade axis al gráfico. Los ejes añadidos a través de addAxis aún no se toman para su uso, addAxis se utiliza simplemente para dar la propiedad de la axis al gráfico. El axis no debe ser nulo o añadido a otro gráfico.
Véase también releaseAxis(), setAxisX(), setAxisY(), y setAxisZ().
void Q3DScatter::addSeries(QScatter3DSeries *series)
Añade series al gráfico. Un gráfico puede contener múltiples series, pero sólo tiene un conjunto de ejes. Si la serie recién añadida ha especificado un elemento seleccionado, se resaltará y se borrará cualquier selección existente. Sólo una serie añadida puede tener una selección activa.
Véase también QAbstract3DGraph::hasSeries().
QList<QValue3DAxis *> Q3DScatter::axes() const
Devuelve la lista de todos los ejes añadidos.
Véase también addAxis().
QValue3DAxis *Q3DScatter::axisZ() const
Devuelve el eje z utilizado.
Nota: Función Getter para la propiedad axisZ.
Véase también setAxisZ().
void Q3DScatter::releaseAxis(QValue3DAxis *axis)
Devuelve la propiedad de axis a quien lo solicitó, si se ha añadido a este gráfico. Si el axis liberado está en uso, se creará un nuevo eje por defecto y se activará.
Si el eje por defecto se libera y se vuelve a añadir más tarde, se comporta como cualquier otro eje.
Véase también addAxis(), setAxisX(), setAxisY() y setAxisZ().
void Q3DScatter::removeSeries(QScatter3DSeries *series)
Elimina la dirección series del gráfico.
Véase también QAbstract3DGraph::hasSeries().
QList<QScatter3DSeries *> Q3DScatter::seriesList() const
Devuelve la lista de series añadidas a este gráfico.
Véase también QAbstract3DGraph::hasSeries().
void Q3DScatter::setAxisX(QValue3DAxis *axis)
Establece axis como el eje x activo. Llama implícitamente a addAxis() para transferir la propiedad del eje a este gráfico.
Si axis es nulo, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se destruye si se establece explícitamente otro eje con la misma orientación.
Nota: Función Setter para la propiedad axisX.
Véase también axisX(), addAxis(), y releaseAxis().
void Q3DScatter::setAxisY(QValue3DAxis *axis)
Establece axis como el eje y activo. Llama implícitamente a addAxis() para transferir la propiedad del eje a este gráfico.
Si axis es nulo, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se destruye si se establece explícitamente otro eje con la misma orientación.
Nota: Función setter para la propiedad axisY.
Véase también axisY(), addAxis(), y releaseAxis().
void Q3DScatter::setAxisZ(QValue3DAxis *axis)
Establece axis como el eje z activo. Llama implícitamente a addAxis() para transferir la propiedad del eje a este gráfico.
Si axis es nulo, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se destruye si se establece explícitamente otro eje con la misma orientación.
Nota: Función setter para la propiedad axisZ.
Véase también axisZ(), addAxis(), y releaseAxis().
© 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.