En esta página

Surface3D QML Type

Describe el uso del gráfico de superficie en 3D. Más información...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
Inherits:

AbstractGraph3D

Status: Deprecated

Este tipo está obsoleto. Recomendamos encarecidamente no utilizarlo en código nuevo.

Propiedades

Métodos

Descripción detallada

Este tipo permite a los desarrolladores representar gráficos de superficie en 3D con Qt Quick.

Para utilizar este tipo, tendrás que importar el módulo de visualización de datos:

import QtDataVisualization 1.2

A continuación, podrás utilizar Surface3D en tus archivos QML:

import QtQuick 2.0
import QtDataVisualization 1.2

Item {
    width: 640
    height: 480

    Surface3D {
        width: parent.width
        height: parent.height
        Surface3DSeries {
            itemLabelFormat: "Pop density at (@xLabel N, @zLabel E): @yLabel"
            ItemModelSurfaceDataProxy {
                itemModel: dataModel
                // Mapping model roles to surface series rows, columns, and values.
                rowRole: "longitude"
                columnRole: "latitude"
                yPosRole: "pop_density"
            }
        }
    }
    ListModel {
        id: dataModel
        ListElement{ longitude: "20"; latitude: "10"; pop_density: "4.75"; }
        ListElement{ longitude: "21"; latitude: "10"; pop_density: "3.00"; }
        ListElement{ longitude: "22"; latitude: "10"; pop_density: "1.24"; }
        ListElement{ longitude: "23"; latitude: "10"; pop_density: "2.53"; }
        ListElement{ longitude: "20"; latitude: "11"; pop_density: "2.55"; }
        ListElement{ longitude: "21"; latitude: "11"; pop_density: "2.03"; }
        ListElement{ longitude: "22"; latitude: "11"; pop_density: "3.46"; }
        ListElement{ longitude: "23"; latitude: "11"; pop_density: "5.12"; }
        ListElement{ longitude: "20"; latitude: "12"; pop_density: "1.37"; }
        ListElement{ longitude: "21"; latitude: "12"; pop_density: "2.98"; }
        ListElement{ longitude: "22"; latitude: "12"; pop_density: "3.33"; }
        ListElement{ longitude: "23"; latitude: "12"; pop_density: "3.23"; }
        ListElement{ longitude: "20"; latitude: "13"; pop_density: "4.34"; }
        ListElement{ longitude: "21"; latitude: "13"; pop_density: "3.54"; }
        ListElement{ longitude: "22"; latitude: "13"; pop_density: "1.65"; }
        ListElement{ longitude: "23"; latitude: "13"; pop_density: "2.67"; }
    }
}

Consulta la Galería de gráficos de superficie para ver ejemplos de uso más detallados.

Véase también Surface3DSeries, ItemModelSurfaceDataProxy, Bars3D, Scatter3D y Qt Data Visualization C++ Classes.

Documentación de propiedades

axisX : ValueAxis3D

El eje X activo.

Si no se especifica ningún eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

axisY : ValueAxis3D

El eje Y activo.

Si no se especifica ningún eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

axisZ : ValueAxis3D

El eje Z activo.

Si no se especifica ningún eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se elimina si se establece explícitamente otro eje con la misma orientación.

flipHorizontalGrid : bool [since QtDataVisualization 1.2]

En algunos casos de uso, la cuadrícula del eje horizontal queda cubierta en su mayor parte por la superficie, por lo que puede resultar más útil mostrar la cuadrícula del eje horizontal en la parte superior del gráfico en lugar de en la inferior. Un caso de uso típico de esto es la visualización de espectrogramas en 2D mediante proyección ortográfica con una perspectiva de arriba hacia abajo.

Si se establece ` false`, la cuadrícula del eje horizontal y las etiquetas se dibujan sobre el fondo horizontal del gráfico. Si se establece ` true`, la cuadrícula del eje horizontal y las etiquetas se dibujan en el lado opuesto del gráfico respecto al fondo horizontal. El valor por defecto es ` false`.

Esta propiedad se introdujo en QtDataVisualization 1.2.

selectedSeries : Surface3DSeries

La serie seleccionada o nulo. Si el objeto ` selectionMode ` tiene activado el indicador ` SelectionMultiSeries `, esta propiedad contiene la serie a la que pertenece el punto seleccionado.

seriesList : list<Surface3DSeries> [default]

Esta propiedad contiene las series del gráfico. Por defecto, esta propiedad contiene una lista vacía. Para establecer las series, utiliza la función addSeries() o defínelas como elementos secundarios del gráfico.

Documentación de métodos

void addSeries(Surface3DSeries series)

Añade el « series » al gráfico.

Véase también AbstractGraph3D::hasSeries().

void removeSeries(Surface3DSeries series)

Elimina el « series » del gráfico.

Véase también AbstractGraph3D::hasSeries().

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