Q3DScatter Class
La clase Q3DScatter ofrece métodos para generar gráficos de dispersión en 3D. Más información...
| Encabezado: | #include <Q3DScatter> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Desde: | QtDataVisualization 1.0 |
| Heredado de: | QAbstract3DGraph |
| Estado: | Obsoleta |
Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.
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 representar gráficos de dispersión en 3D y visualizarlos girando 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 con la rueda del ratón. La selección, si está habilitada, se realiza con el botón izquierdo del ratón. La escena se puede restablecer a la vista predeterminada de la cámara haciendo clic con la rueda del ratón. En dispositivos táctiles, la rotación se realiza tocando y desplazando, la selección tocando y manteniendo pulsado, y el zoom pellizcando.
Si no se establecen ejes de forma explícita en Q3DScatter, se crean ejes predeterminados temporales sin etiquetas. Estos ejes predeterminados pueden modificarse mediante los accesores de ejes, pero tan pronto como se establezca explícitamente un eje para una orientación, el eje predeterminado para esa orientación se elimina.
Q3DScatter admite que haya más de una serie visible al mismo tiempo.
Cómo crear un gráfico Q3DScatter básico
En primer lugar, crea un objeto Q3DScatter. Dado que en este ejemplo vamos a ejecutar el gráfico como ventana de nivel superior, debemos desactivar el indicador « Qt::FramelessWindowHint », que viene activado por defecto:
Q3DScatter scatter;
scatter.setFlags(scatter.flags() ^ Qt::FramelessWindowHint);Ahora Q3DScatter está listo para recibir los datos que se van a representar. 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 para que sea 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 girar y ampliar, y se puede seleccionar un elemento para ver su posición, pero este ejemplo de código mínimo no incluye ninguna otra interacción. Puedes obtener más información 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 de notificación:
| 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 de notificación:
| void | axisYChanged(QValue3DAxis *axis) |
axisZ : QValue3DAxis*
Esta propiedad determina el eje Z activo.
Funciones de acceso:
Señal de notificación:
| void | axisZChanged(QValue3DAxis *axis) |
[read-only] selectedSeries : QScatter3DSeries*
Esta propiedad contiene la serie seleccionada o el valor nulo.
Funciones de acceso:
| QScatter3DSeries * | selectedSeries() const |
Señal de notificador:
| void | selectedSeriesChanged(QScatter3DSeries *series) |
Documentación de funciones de miembro
[explicit] Q3DScatter::Q3DScatter(const QSurfaceFormat *format = nullptr, QWindow *parent = nullptr)
Crea un nuevo gráfico de dispersión en 3D con una ventana opcional « parent » y una superficie « format ».
[virtual noexcept] Q3DScatter::~Q3DScatter()
Elimina el gráfico de dispersión en 3D.
void Q3DScatter::addAxis(QValue3DAxis *axis)
Añade axis al gráfico. Los ejes añadidos mediante addAxis aún no se consideran en uso; addAxis se utiliza simplemente para asignar la propiedad de axis al gráfico. axis no debe ser nulo ni estar añadido a otro gráfico.
Véase también releaseAxis(), setAxisX(), setAxisY() y setAxisZ().
void Q3DScatter::addSeries(QScatter3DSeries *series)
Añade la serie « series » al gráfico. Un gráfico puede contener varias series, pero solo tiene un conjunto de ejes. Si la serie recién añadida tiene un elemento seleccionado, este se resaltará y se desactivará cualquier selección existente. Solo una de las series añadidas 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óngetter para la propiedad axisZ.
Véase también setAxisZ().
void Q3DScatter::releaseAxis(QValue3DAxis *axis)
Devuelve la propiedad del « axis » al llamante, 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 predeterminado se libera y se vuelve a añadir más tarde, se comportará como cualquier otro eje.
Véase también addAxis(), setAxisX(), setAxisY() y setAxisZ().
void Q3DScatter::removeSeries(QScatter3DSeries *series)
Elimina el « 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 predeterminado temporal sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.
Nota: Funciónde configuración 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 elimina si se establece explícitamente otro eje con la misma orientación.
Nota: Funciónde configuración 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 predeterminado temporal sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.
Nota: Funciónde asignación 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.