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 |
- Lista de todos los miembros, incluidos los heredados
- QSurface3DSeries forma parte de las clases C++ deQt Graphs para 3D.
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
| QPoint | invalidSelectionPosition() |
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():
| @xTitle | Título del eje x |
| @yTitle | Título del eje y |
| @zTitle | Título del eje z |
| @xLabel | Valor del elemento formateado según el formato del eje X. Para obtener más información, consulta QValue3DAxis::labelFormat. |
| @yLabel | Valor del elemento formateado según el formato del eje y. Para obtener más información, consulta QValue3DAxis::labelFormat. |
| @zLabel | Valor del elemento formateado según el formato del eje z. Para obtener más información, consulta QValue3DAxis::labelFormat. |
| @seriesName | Nombre 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.
| Constante | Valor | Descripción |
|---|---|---|
QSurface3DSeries::DrawWireframe | 0x1 | Solo se dibuja la cuadrícula. |
QSurface3DSeries::DrawSurface | 0x2 | Solo se dibuja la superficie. |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | Se dibujan tanto la superficie como la cuadrícula. |
QSurface3DSeries::DrawFilledSurface (since Qt 6.10) | 0x4 | Dibuja 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.