En esta página

Surface3D QML Type

Describe el uso del gráfico de superficie 3D. Más...

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

AbstractGraph3D

Propiedades

Métodos

Descripción detallada

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

Deberá importar el módulo de visualización de datos para utilizar este tipo:

import QtDataVisualization 1.2

Después podrá utilizar Surface3D en sus 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"; }
    }
}

Ver Surface Graph Gallery para un ejemplo de uso más completo.

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 indica un eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se destruye si se establece explícitamente otro eje con la misma orientación.

axisY : ValueAxis3D

El eje y activo.

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

axisZ : ValueAxis3D

El eje z activo.

Si no se indica un eje, se crea un eje temporal por defecto sin etiquetas y con un rango que se ajusta automáticamente. Este eje temporal se destruye 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 está cubierta en su mayor parte por la superficie, por lo que puede ser más útil mostrar la cuadrícula del eje horizontal en la parte superior del gráfico en lugar de en la parte inferior. Un caso de uso típico para esto es mostrar espectrogramas 2D utilizando la proyección ortográfica con un punto de vista de arriba hacia abajo.

Si false, la rejilla del eje horizontal y las etiquetas se dibujan sobre el fondo horizontal del gráfico. Si true, la rejilla del eje horizontal y las etiquetas se dibujan en el lado opuesto del gráfico respecto al fondo horizontal. Por defecto es false.

Esta propiedad se introdujo en QtDataVisualization 1.2.

selectedSeries : Surface3DSeries

La serie seleccionada o null. Si 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, utilice la función addSeries() o defínalas como hijas del gráfico.

Documentación del método

void addSeries(Surface3DSeries series)

Añade la dirección series al gráfico.

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

void removeSeries(Surface3DSeries series)

Elimina la dirección 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.