Back to Qt.io
Contact Us Blog Download Qt

Surface3D QML Type

Beschreibt die Verwendung des 3D-Oberflächendiagramms. Mehr...

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

AbstractGraph3D

Eigenschaften

Methoden

Detaillierte Beschreibung

Dieser Typ ermöglicht es Entwicklern, Oberflächenplots in 3D mit Qt Quick darzustellen.

Um diesen Typ zu verwenden, müssen Sie das Datenvisualisierungsmodul importieren:

import QtDataVisualization 1.2

Danach können Sie Surface3D in Ihren qml-Dateien verwenden:

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"; }
    }
}

Siehe Surface Graph Gallery für ein ausführliches Anwendungsbeispiel.

Siehe auch Surface3DSeries, ItemModelSurfaceDataProxy, Bars3D, Scatter3D, und Qt Data Visualization C++ Classes.

Dokumentation der Eigenschaften

axisX : ValueAxis3D

Die aktive x-Achse.

Wenn keine Achse angegeben wird, wird eine temporäre Standardachse ohne Beschriftung und mit einem automatisch angepassten Bereich erstellt. Diese temporäre Achse wird zerstört, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.


axisY : ValueAxis3D

Die aktive y-Achse.

Wenn keine Achse angegeben wird, wird eine temporäre Standardachse ohne Beschriftungen und mit einem sich automatisch anpassenden Bereich erstellt. Diese temporäre Achse wird zerstört, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.


axisZ : ValueAxis3D

Die aktive z-Achse.

Wenn keine Achse angegeben wird, wird eine temporäre Standardachse ohne Beschriftungen und mit einem sich automatisch anpassenden Bereich erstellt. Diese temporäre Achse wird zerstört, wenn eine andere Achse explizit auf dieselbe Ausrichtung gesetzt wird.


flipHorizontalGrid : bool [since QtDataVisualization 1.2]

In einigen Anwendungsfällen wird das horizontale Achsenraster größtenteils von der Oberfläche verdeckt, so dass es sinnvoller sein kann, das horizontale Achsenraster am oberen Rand des Diagramms statt am unteren Rand anzuzeigen. Ein typischer Anwendungsfall hierfür ist die Darstellung von 2D-Spektrogrammen unter Verwendung der orthoGraphic-Projektion mit einem Top-Down-Blickwinkel.

Bei false werden das horizontale Achsenraster und die Beschriftungen auf dem horizontalen Hintergrund des Diagramms gezeichnet. Bei true werden das horizontale Achsenraster und die Beschriftungen auf der dem horizontalen Hintergrund gegenüberliegenden Seite des Diagramms gezeichnet. Die Voreinstellung ist false.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.


selectedSeries : Surface3DSeries

Die ausgewählte Serie oder null. Wenn selectionMode das SelectionMultiSeries Flag gesetzt hat, enthält diese Eigenschaft die Serie, die den ausgewählten Punkt besitzt.


seriesList : list<Surface3DSeries> [default]

Diese Eigenschaft enthält die Serie des Graphen. Standardmäßig enthält diese Eigenschaft eine leere Liste. Um die Serien zu setzen, verwenden Sie entweder die Funktion addSeries() oder definieren Sie sie als Kinder des Diagramms.


Methode Dokumentation

void addSeries(Surface3DSeries series)

Fügt dem Diagramm die series hinzu.

Siehe auch AbstractGraph3D::hasSeries().


void removeSeries(Surface3DSeries series)

Entfernt die series aus dem Diagramm.

Siehe auch AbstractGraph3D::hasSeries().


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