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 DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake: QT += datavisualization
Desde: QtDataVisualization 1.0
En QML: Surface3DSeries
Heredado de: QAbstract3DSeries
Estado: Obsoleto

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum DrawFlag { DrawWireframe, DrawSurface, DrawSurfaceAndWireframe }
flags DrawFlags

Propiedades

Funciones públicas

QSurface3DSeries(QObject *parent = nullptr)
QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
virtual ~QSurface3DSeries()
QSurfaceDataProxy *dataProxy() const
QSurface3DSeries::DrawFlags drawMode() const
bool isFlatShadingEnabled() const
bool isFlatShadingSupported() const
QPoint selectedPoint() const
void setDataProxy(QSurfaceDataProxy *proxy)
void setDrawMode(QSurface3DSeries::DrawFlags mode)
void setFlatShadingEnabled(bool enabled)
void setSelectedPoint(const QPoint &position)
void setTexture(const QImage &texture)
void setTextureFile(const QString &filename)
void setWireframeColor(const QColor &color)
QImage texture() const
QString textureFile() const
QColor wireframeColor() const

Señales

void dataProxyChanged(QSurfaceDataProxy *proxy)
void drawModeChanged(QSurface3DSeries::DrawFlags mode)
void flatShadingEnabledChanged(bool enable)
void flatShadingSupportedChanged(bool enable)
void selectedPointChanged(const QPoint &position)
void textureChanged(const QImage &image)
void textureFileChanged(const QString &filename)
void wireframeColorChanged(const 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).

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

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::setLabelFormat().
@yLabelValor del elemento formateado según el formato del eje y. Para obtener más información, consulta QValue3DAxis::setLabelFormat().
@zLabelValor del elemento formateado según el formato del eje z. Para obtener más información, consulta QValue3DAxis::setLabelFormat().
@seriesNameNombre de la serie

Por ejemplo:

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

Véase también «Qt Data Visualization: Manejo de datos».

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::DrawWireframe1Solo se dibuja la cuadrícula.
QSurface3DSeries::DrawSurface2Solo se dibuja la superficie.
QSurface3DSeries::DrawSurfaceAndWireframeDrawWireframe | DrawSurfaceSe dibujan tanto la superficie como la cuadrícula.

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

Documentación de la propiedad

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 : 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)

flatShadingEnabled : bool

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

Por defecto, está preconfigurada en « true ».

Cuando está desactivado, las normales de la superficie se interpolan, lo que hace que los bordes parezcan redondeados. Cuando está activado, las normales se mantienen iguales en un triángulo, lo que hace que el color del triángulo sea sólido. Esto hace que los datos del modelo sean más legibles.

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 el sombreado plano es compatible en tiempo de ejecución.

Funciones de acceso:

bool isFlatShadingEnabled() const
void setFlatShadingEnabled(bool enabled)

Señal de notificación:

void flatShadingEnabledChanged(bool enable)

[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, se admite el sombreado plano para superficies.

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 enable)

selectedPoint : QPoint

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

Funciones de acceso:

QPoint selectedPoint() const
void setSelectedPoint(const QPoint &position)

Señal de notificación:

void selectedPointChanged(const QPoint &position)

texture : QImage

Esta propiedad contiene la textura de la superficie en forma de ` 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)

[since 6.3] wireframeColor : QColor

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

Esta enumeración se introdujo en Qt 6.3.

Funciones de acceso:

QColor wireframeColor() const
void setWireframeColor(const QColor &color)

Señal de notificador:

void wireframeColorChanged(const QColor &color)

Documentación de las funciones miembro

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

Crea una serie de superficies 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.

[virtual noexcept] QSurface3DSeries::~QSurface3DSeries()

Elimina la serie 3D de superficies.

[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 QAbstract3DGraph::clearSelection().

void QSurface3DSeries::setSelectedPoint(const QPoint &position)

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 ese mismo punto siga seleccionado.

Nota: Funciónde configuración para la propiedad selectedPoint.

Véase también selectedPoint() y QAbstract3DGraph::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.