En esta página

QSurface3DSeries Class

La clase QSurface3DSeries representa una serie de datos en un gráfico de superficie en 3D. Más información...

Encabezado: #include <QSurface3DSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: Surface3DSeries
Heredan de: QAbstract3DSeries

Tipos públicos

enum DrawFlag { DrawWireframe, DrawSurface, DrawSurfaceAndWireframe, DrawFilledSurface }
flags DrawFlags

Propiedades

Funciones públicas

QSurface3DSeries(QObject *parent = nullptr)
QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
virtual ~QSurface3DSeries() override
QValue3DAxis *axisX() const
QValue3DAxis *axisY() const
QValue3DAxis *axisZ() const
void clearArray()
void clearRow(qsizetype rowIndex)
const QSurfaceDataArray &dataArray() const &
QSurfaceDataArray dataArray() &&
QSurfaceDataProxy *dataProxy() const
QSurface3DSeries::DrawFlags drawMode() const
bool isFlatShadingSupported() const
void resetAxisX()
void resetAxisY()
void resetAxisZ()
bool rowsSanitized() const
QPoint selectedPoint() const
void setAxisX(QValue3DAxis *axis)
void setAxisY(QValue3DAxis *axis)
void setAxisZ(QValue3DAxis *axis)
void setDataArray(const QSurfaceDataArray &newDataArray)
void setDataProxy(QSurfaceDataProxy *proxy)
void setDrawMode(QSurface3DSeries::DrawFlags mode)
void setRowsSanitized(bool sanitized)
void setSelectedPoint(QPoint position)
void setShading(const QSurface3DSeries::Shading shading)
void setTexture(const QImage &texture)
void setTextureFile(const QString &filename)
void setWireframeColor(QColor color)
QSurface3DSeries::Shading shading() const
QImage texture() const
QString textureFile() const
QColor wireframeColor() const

Señales

void axisXChanged(QValue3DAxis *axis)
void axisYChanged(QValue3DAxis *axis)
void axisZChanged(QValue3DAxis *axis)
void dataArrayChanged(const QSurfaceDataArray &array)
void dataProxyChanged(QSurfaceDataProxy *proxy)
void drawModeChanged(QSurface3DSeries::DrawFlags mode)
void flatShadingSupportedChanged(bool enabled)
void rowsSanitizedChanged(bool newRowsSanitized)
void selectedPointChanged(QPoint position)
void shadingChanged(const QSurface3DSeries::Shading shading)
void textureChanged(const QImage &image)
void textureFileChanged(const QString &filename)
void wireframeColorChanged(QColor color)

Miembros públicos estáticos

Descripción detallada

Esta clase gestiona los elementos visuales específicos de la serie, así como los datos de la misma (a través de un proxy de datos).

En cuanto a la relación entre el proxy y la serie, es fundamental destacar un par de puntos clave. En este contexto, los datos se almacenan en series y los usuarios pueden acceder al conjunto de datos a través de las series. Estas series están controladas o representadas por un objeto proxy. Por lo tanto, el proxy puede utilizarse para gestionar diversas operaciones sobre los datos y actualizar el conjunto de datos real. Sin embargo, es necesario crear una serie asociada a este proxy para editar el conjunto de datos.

Si no se establece explícitamente ningún proxy de datos para la serie, esta crea un proxy por defecto. Establecer otro proxy destruirá el proxy existente y todos los datos añadidos a la serie.

La malla de objetos establecida mediante la propiedad QAbstract3DSeries::mesh define la forma del puntero de selección en una serie de superficie.

QSurface3DSeries admite las siguientes etiquetas de formato para QAbstract3DSeries::setItemLabelFormat():

@xTitleTítulo del eje x
@yTitleTítulo del eje y
@zTitleTítulo del eje z
@xLabelValor del elemento formateado según el formato del eje X. Para obtener más información, consulta QValue3DAxis::labelFormat.
@yLabelValor del elemento formateado según el formato del eje y. Para obtener más información, consulta QValue3DAxis::labelFormat.
@zLabelValor del elemento formateado según el formato del eje z. Para obtener más información, consulta QValue3DAxis::labelFormat.
@seriesNameNombre de la serie

Por ejemplo:

proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));

Véase también Qt Graphs :«Manejo de datos en 3D».

Documentación sobre tipos de miembros

enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags

El modo de dibujo de la superficie. Los valores de esta enumeración se pueden combinar con el operador OR.

ConstanteValorDescripción
QSurface3DSeries::DrawWireframe0x1Solo se dibuja la cuadrícula.
QSurface3DSeries::DrawSurface0x2Solo se dibuja la superficie.
QSurface3DSeries::DrawSurfaceAndWireframeDrawWireframe | DrawSurfaceSe dibujan tanto la superficie como la cuadrícula.
QSurface3DSeries::DrawFilledSurface (since Qt 6.10)0x4Dibuja un relleno para una superficie. Al establecer este modo, también se establece DrawSurface si aún no lo está.

El tipo DrawFlags es un typedef para QFlags<DrawFlag>. Almacena una combinación OR de valores de DrawFlag.

Documentación de propiedades

[since 6.11] axisX : QValue3DAxis*

Incluye un eje X adicional para la serie. Si se especifica un eje, la serie se ajustará a los valores mínimo y máximo de dicho eje.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QValue3DAxis *axisX() const
void setAxisX(QValue3DAxis *axis)
void resetAxisX()

Señal de notificación:

void axisXChanged(QValue3DAxis *axis)

[since 6.11] axisY : QValue3DAxis*

Incluye un eje Y adicional para la serie. Si se especifica un eje, la serie se ajustará a los valores mínimo y máximo de dicho eje.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QValue3DAxis *axisY() const
void setAxisY(QValue3DAxis *axis)
void resetAxisY()

Señal de notificador:

void axisYChanged(QValue3DAxis *axis)

[since 6.11] axisZ : QValue3DAxis*

Incluye un eje Z adicional para la serie. Si se especifica un eje, la serie se ajustará a los valores mínimo y máximo de dicho eje.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

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

Señal de notificación:

void axisZChanged(QValue3DAxis *axis)

dataArray : QSurfaceDataArray

Matriz de datos de la serie.

Contiene la referencia del conjunto de datos.

La señal «dataArrayChanged» se emite cuando se establece el matriz de datos, a menos que « newDataArray » sea idéntica a la anterior.

Nota: Antes de realizar cualquier operación relacionada con `dataArray`, es necesario crear una serie para el proxy correspondiente.

Funciones de acceso:

const QSurfaceDataArray &dataArray() const &
QSurfaceDataArray dataArray() &&
void setDataArray(const QSurfaceDataArray &newDataArray)

Señal de notificador:

void dataArrayChanged(const QSurfaceDataArray &array)

Véase también « clearRow(qsizetype rowIndex)» y « clearArray()».

dataProxy : QSurfaceDataProxy*

Esta propiedad contiene el proxy de datos activo.

La serie asume la propiedad de cualquier proxy que se le asigne y elimina cualquier proxy establecido anteriormente cuando se añade uno nuevo. El proxy no puede ser nulo ni estar asignado a otra serie.

Funciones de acceso:

QSurfaceDataProxy *dataProxy() const
void setDataProxy(QSurfaceDataProxy *proxy)

Señal de notificación:

void dataProxyChanged(QSurfaceDataProxy *proxy)

drawMode : QSurface3DSeries::DrawFlags

El modo de dibujo.

Los valores posibles son los de DrawFlag. No está permitido borrar todos los indicadores.

Funciones de acceso:

QSurface3DSeries::DrawFlags drawMode() const
void setDrawMode(QSurface3DSeries::DrawFlags mode)

Señal de notificación:

void drawModeChanged(QSurface3DSeries::DrawFlags mode)

[read-only] flatShadingSupported : bool

Esta propiedad indica si el sistema actual admite el sombreado plano de superficies.

El sombreado plano para superficies requiere, como mínimo, la versión 1.2 de GLSL con la extensión GL_EXT_gpu_shader4. Si true, el sombreado plano para superficies es compatible.

Nota: Esta propiedad de solo lectura se establece en su valor correcto tras la primera pasada de renderizado. Hasta entonces, siempre es ` true`.

Funciones de acceso:

bool isFlatShadingSupported() const

Señal de notificador:

void flatShadingSupportedChanged(bool enabled)

rowsSanitized : bool

Esta propiedad determina si se lleva a cabo la depuración de filas.

Cuando « sanitized » es « true », elimina las filas de la serie que no contienen datos válidos.

Nota: Esto puede suponer una ligera merma en el rendimiento.

Funciones de acceso:

bool rowsSanitized() const
void setRowsSanitized(bool sanitized)

Señal de notificador:

void rowsSanitizedChanged(bool newRowsSanitized)

selectedPoint : QPoint

Esta propiedad contiene el punto de la malla de superficie seleccionado en la serie.

Selecciona un punto de la malla de superficie en la posición position en la matriz de datos de la serie especificada por una fila y una columna.

Solo se puede seleccionar un punto a la vez.

Para borrar la selección de esta serie, se establece invalidSelectionPosition() como position. Si esta serie se añade a un gráfico, este puede ajustar la selección en función de la interacción del usuario o si deja de ser válida.

Si se eliminan o se insertan filas en la serie antes de la fila del punto seleccionado, la selección se ajustará de modo que dicho punto siga seleccionado.

Funciones de Access:

QPoint selectedPoint() const
void setSelectedPoint(QPoint position)

Señal de notificación:

void selectedPointChanged(QPoint position)

Véase también Q3DGraphsWidgetItem::clearSelection().

shading : QSurface3DSeries::Shading

Esta propiedad indica si está activado el sombreado plano de superficies.

Por defecto, está preconfigurada en « QSurface3DSeries::Shading::Flat ».

Cuando está desactivada, las normales de la superficie se interpolan, lo que hace que los bordes parezcan redondeados. Cuando está activada, las normales se mantienen iguales en un triángulo, lo que hace que el color del triángulo sea sólido. Esto facilita la lectura de los datos del modelo.

Nota: Las superficies con sombreadoplano requieren, como mínimo, la versión 1.2 de GLSL con la extensión GL_EXT_gpu_shader4. El valor de la propiedad « flatShadingSupported » indica si se admite el sombreado plano en tiempo de ejecución.

Funciones de acceso:

QSurface3DSeries::Shading shading() const
void setShading(const QSurface3DSeries::Shading shading)

Señal de notificador:

void shadingChanged(const QSurface3DSeries::Shading shading)

texture : QImage

Esta propiedad contiene la textura de la superficie como un objeto de tipo « QImage ».

Si se establece un « QImage » vacío, se borra la textura.

Funciones de acceso:

QImage texture() const
void setTexture(const QImage &texture)

Señal de notificación:

void textureChanged(const QImage &image)

textureFile : QString

Esta propiedad almacena la textura de la superficie en un archivo.

Si se establece un nombre de archivo vacío, se borra la textura.

Funciones de acceso:

QString textureFile() const
void setTextureFile(const QString &filename)

Señal de notificación:

void textureFileChanged(const QString &filename)

wireframeColor : QColor

Esta propiedad define el color de la estructura alámbrica de la superficie.

Funciones de acceso:

QColor wireframeColor() const
void setWireframeColor(QColor color)

Señal de notificación:

void wireframeColorChanged(QColor color)

Documentación de funciones de miembro

[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)

Crea una serie de superficies en 3D a partir del elemento principal parent.

[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)

Crea una serie de superficies en 3D con el proxy de datos dataProxy y el elemento principal parent.

[override virtual noexcept] QSurface3DSeries::~QSurface3DSeries()

Elimina la serie de superficies 3D.

void QSurface3DSeries::clearArray()

Borra la matriz existente.

void QSurface3DSeries::clearRow(qsizetype rowIndex)

Borra la fila existente en la matriz según el « rowIndex » indicado.

[static] QPoint QSurface3DSeries::invalidSelectionPosition()

Devuelve el valor « QPoint », que indica una posición de selección no válida. Este valor se asigna a la propiedad « selectedPoint » para borrar la selección de esta serie.

Véase también Q3DGraphsWidgetItem::clearSelection().

© 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.