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
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
| 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).
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():
| @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::setLabelFormat(). |
| @yLabel | Valor del elemento formateado según el formato del eje y. Para obtener más información, consulta QValue3DAxis::setLabelFormat(). |
| @zLabel | Valor del elemento formateado según el formato del eje z. Para obtener más información, consulta QValue3DAxis::setLabelFormat(). |
| @seriesName | Nombre 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.
| Constante | Valor | Descripción |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | Solo se dibuja la cuadrícula. |
QSurface3DSeries::DrawSurface | 2 | Solo se dibuja la superficie. |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | Se 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.