En esta página

Surface3DSeries QML Type (Uncreatable)

Representa una serie de datos en un gráfico de superficie en 3D. Más...

Import Statement: import QtGraphs
In C++: QSurface3DSeries
Inherits:

Abstract3DSeries

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Señales

Métodos

Descripción detallada

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

Surface3DSeries admite las siguientes etiquetas de formato para itemLabelFormat:

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

Para obtener una descripción más completa, consulta QSurface3DSeries.

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

Documentación de propiedades

baseColor : color

El color base de la serie.

Véase también colorStyle y GraphsTheme.seriesColors.

baseGradient : Gradient

El gradiente base de la serie.

Véase también colorStyle.

colorStyle : GraphsTheme.ColorStyle

El estilo cromático de la serie.

Véase también GraphsTheme.ColorStyle.

dataArray : SurfaceDataArray

Contiene la referencia al conjunto de datos.

dataArrayChanged Se emite una señal cuando se establece la matriz de datos, a menos que « newDataArray » sea idéntico al anterior.

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

dataProxy : SurfaceDataProxy

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.

drawMode : DrawFlag

Establece el modo de dibujo en uno de los siguientes: Surface3DSeries.DrawFlag{QSurface3DSeries.DrawFilledSurface}. Se debe establecer «DrawWireframe» o «DrawSurface».

flatShadingSupported : bool [read-only]

Indica si el sistema actual admite el sombreado plano para superficies. Requiere, como mínimo, la versión 1.2 de GLSL con la extensión GL_EXT_gpu_shader4.

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

invalidSelectionPosition : point [read-only]

Una propiedad constante que proporciona una posición de selección no válida. Esta posición se asigna a la propiedad selectedPoint para borrar la selección de esta serie.

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

itemLabel : string [read-only]

La etiqueta del elemento con formato. Si no hay ningún elemento seleccionado o si el elemento seleccionado no está visible, devuelve una cadena vacía.

Véase también itemLabelFormat.

itemLabelFormat : string

El formato de etiqueta para los elementos de datos de esta serie. Este formato se utiliza para etiquetas de un solo elemento, por ejemplo, cuando se selecciona un elemento. La interpretación del formato depende del tipo de serie.

Véase también Bar3DSeries, Scatter3DSeries y Surface3DSeries.

itemLabelVisible : bool

Si true, las etiquetas de los elementos se dibujan como etiquetas flotantes en el gráfico. En caso contrario, no se dibujan. Para mostrar la etiqueta del elemento en un control externo, esta propiedad se establece en false. El valor por defecto es true.

Véase también « itemLabelFormat » y « itemLabel ».

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

El modo de iluminación de los elementos de la serie. El valor por defecto es QAbstract3DSeries::LightingMode::Shaded

Esta propiedad se introdujo en Qt 6.10.

Véase también QAbstract3DSeries::LightingMode.

mesh : Abstract3DSeries.Mesh

La malla de los elementos de la serie, o el puntero de selección en el caso de Surface3DSeries. Si la malla es Abstract3DSeries.Mesh.UserDefined, también debe establecerse la propiedad userDefinedMesh para que los elementos se representen correctamente. El valor por defecto depende del tipo de gráfico.

Véase también QAbstract3DSeries::Mesh.

meshRotation : quaternion

La rotación de la malla que se aplica a todos los elementos de la serie. La rotación debe ser un cuaternión normalizado. En los tipos de serie que admiten rotaciones específicas para cada elemento, las rotaciones se multiplican entre sí. Bar3DSeries ignora cualquier rotación que no sea alrededor del eje y. Surface3DSeries aplica la rotación únicamente al puntero de selección. Por defecto, no hay rotación.

meshSmooth : bool

Si se establece true, se utilizan versiones suavizadas de las mallas predefinidas configuradas mediante la propiedad mesh. Esta propiedad no afecta a las mallas personalizadas que se utilizan cuando la malla se establece en Abstract3DSeries.Mesh.UserDefined. El valor por defecto es false.

multiHighlightColor : color

El color de resaltado de varios elementos de la serie.

Véase también colorStyle y GraphsTheme.multiHighlightColor.

multiHighlightGradient : Gradient

El degradado de resaltado de varios elementos de la serie.

Véase también colorStyle y GraphsTheme.multiHighlightGradient.

name : string

El nombre de la serie. Se puede utilizar en el formato de etiqueta de artículo con la etiqueta @seriesName.

Véase también itemLabelFormat.

selectedPoint : point

Establece el punto de la cuadrícula de la superficie en la posición especificada por una fila y una columna de la matriz de datos de la serie seleccionada. Solo se puede seleccionar un punto a la vez.

Para borrar la selección de esta serie, asigna invalidSelectionPosition como posición. Si esta serie se añade a un gráfico, el gráfico 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.

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

shading : Shading

Establece el sombreado plano de la superficie en «visible». Por defecto, está preconfigurado en « Surface3DSeries.Shading.Flat ». 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 cada triángulo, lo que hace que el color del triángulo sea uniforme. 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 el sombreado plano es compatible en tiempo de ejecución.

singleHighlightColor : color

El color de resaltado de un único elemento de la serie.

Véase también colorStyle y GraphsTheme.singleHighlightColor.

singleHighlightGradient : Gradient

El artículo destacado con degradado de la serie.

Véase también colorStyle y GraphsTheme.singleHighlightGradient.

textureFile : string

El nombre del archivo de textura para la textura de la superficie. Para borrar la textura, se establece un nombre de archivo vacío.

type : Abstract3DSeries.SeriesType [read-only]

El tipo de la serie. Uno de los valores de QAbstract3DSeries::SeriesType.

userDefinedMesh : string

El nombre de archivo de una malla personalizada definida por el usuario para objetos, que se utiliza cuando se utiliza « mesh », es Abstract3DSeries.Mesh.UserDefined.

Nota: El archivo debe estar en el formato de malla « QtQuick3D ». Utiliza la herramienta de conversión balsam para crear una malla a partir de otros formatos de modelos 3D.

visible : bool

La visibilidad de la serie. Si false, la serie no se muestra.

wireframeColor : color

El color utilizado para dibujar las líneas de la cuadrícula de la estructura alámbrica de la superficie.

Documentación de Signal

baseColorChanged(color color)

Esta señal se emite cuando baseColor cambia a color.

Nota: El controlador correspondiente es onBaseColorChanged.

baseGradientChanged(Gradient gradient)

Esta señal se emite cuando baseGradient cambia a gradient.

Nota: El controlador correspondiente es onBaseGradientChanged.

colorStyleChanged(GraphsTheme.ColorStyle style)

Esta señal se emite cuando colorStyle cambia a style.

Nota: El controlador correspondiente es onColorStyleChanged.

dataArrayChanged(SurfaceDataArray array)

Esta señal se emite cuando dataArray cambia a array.

Nota: El controlador correspondiente es onDataArrayChanged.

dataProxyChanged(SurfaceDataProxy proxy)

Esta señal se emite cuando dataProxy cambia a proxy.

Nota: El controlador correspondiente es onDataProxyChanged.

drawModeChanged(DrawFlag mode)

Esta señal se emite cuando drawMode cambia a mode.

Nota: El controlador correspondiente es onDrawModeChanged.

flatShadingSupportedChanged(bool enable)

Esta señal se emite cuando flatShadingSupported cambia a enable.

Nota: El controlador correspondiente es onFlatShadingSupportedChanged.

itemLabelChanged(string label)

Esta señal se emite cuando itemLabel cambia a label.

Nota: El controlador correspondiente es onItemLabelChanged.

itemLabelFormatChanged(string format)

Esta señal se emite cuando itemLabelFormat cambia a format.

Nota: El controlador correspondiente es onItemLabelFormatChanged.

itemLabelVisibilityChanged(bool visible)

Esta señal se emite cuando itemLabelVisibility cambia a « visible ».

Nota: El controlador correspondiente es « onItemLabelVisibilityChanged ».

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

Esta señal se emite cuando lightingMode cambia a lightingMode.

Nota: El controlador correspondiente es onLightingModeChanged.

Esta señal se introdujo en Qt 6.10.

meshChanged(Abstract3DSeries.Mesh mesh)

Esta señal se emite cuando mesh cambia a mesh.

Nota: El controlador correspondiente es onMeshChanged.

meshRotationChanged(quaternion rotation)

Esta señal se emite cuando meshRotation cambia a rotation.

Nota: El controlador correspondiente es onMeshRotationChanged.

meshSmoothChanged(bool enabled)

Esta señal se emite cuando meshSmooth cambia a enabled.

Nota: El controlador correspondiente es onMeshSmoothChanged.

multiHighlightColorChanged(color color)

Esta señal se emite cuando multiHighlightColor cambia a color.

Nota: El controlador correspondiente es onMultiHighlightColorChanged.

multiHighlightGradientChanged(Gradient gradient)

Esta señal se emite cuando multiHighlightGradient cambia a gradient.

Nota: El controlador correspondiente es onMultiHighlightGradientChanged.

nameChanged(string name)

Esta señal se emite cuando name cambia a name.

Nota: El controlador correspondiente es onNameChanged.

rowsSanitizedChanged(bool enabled)

Esta señal se emite cuando rowsSanitized cambia a « enabled ».

Nota: El controlador correspondiente es onRowsSanitizedChanged.

selectedPointChanged(point position)

Esta señal se emite cuando selectedPoint cambia a position.

Nota: El controlador correspondiente es onSelectedPointChanged.

shadingChanged(const Shading shading)

Esta señal se emite cuando shading cambia a shading.

Nota: El controlador correspondiente es onShadingChanged.

singleHighlightColorChanged(color color)

Esta señal se emite cuando singleHighlightColor cambia a color.

Nota: El controlador correspondiente es onSingleHighlightColorChanged.

singleHighlightGradientChanged(Gradient gradient)

Esta señal se emite cuando singleHighlightGradient cambia a gradient.

Nota: El controlador correspondiente es onSingleHighlightGradientChanged.

textureFileChanged(string filename)

Esta señal se emite cuando textureFile cambia a filename.

Nota: El controlador correspondiente es onTextureFileChanged.

userDefinedMeshChanged(string fileName)

Esta señal se emite cuando userDefinedMesh cambia a fileName.

Nota: El controlador correspondiente es onUserDefinedMeshChanged.

visibilityChanged(bool visible)

Esta señal se emite cuando la visibilidad de la serie cambia a « visible ».

Nota: El controlador correspondiente es onVisibilityChanged.

wireframeColorChanged(color color)

Esta señal se emite cuando wireframeColor cambia a color.

Nota: El controlador correspondiente es onWireframeColorChanged.

Documentación del método

void setMeshAxisAndAngle(vector3d axis, real angle)

Una función práctica para construir un cuaternión de rotación de malla a partir de axis y angle.

Véase también meshRotation.

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