En esta página

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

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:

Gráfico de dispersión 3D minimalista con tres esferas verdes situadas en una cuadrícula de estructura alámbrica

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:

QValue3DAxis *axisZ() const
void setAxisZ(QValue3DAxis *axis)

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.