Back to Qt.io
Contact Us Blog Download Qt

Surface3DSeries QML Type

Stellt eine Datenreihe in einem 3D-Oberflächendiagramm dar. Mehr...

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

Abstract3DSeries

Eigenschaften

Signale

Methoden

Detaillierte Beschreibung

Dieser Typ verwaltet sowohl die serienspezifischen visuellen Elemente als auch die Seriendaten (über einen Daten-Proxy).

Surface3DSeries unterstützt die folgenden Format-Tags für itemLabelFormat:

@xTitleTitel der x-Achse
@yTitleTitel von der y-Achse
@zTitleTitel von der z-Achse
@xLabelElementwert, formatiert unter Verwendung des Formats der x-Achse. Für weitere Informationen siehe labelFormat.
@yBeschriftungElementwert, formatiert unter Verwendung des Formats der y-Achse. Für weitere Informationen, siehe labelFormat.
@zBeschriftungElementwert, formatiert unter Verwendung des Formats der z-Achse. Für weitere Informationen, siehe labelFormat.
@ReihennameName der Serie

Eine ausführlichere Beschreibung finden Sie unter QSurface3DSeries.

Siehe auch Qt Graphs Datenverarbeitung mit 3D.

Eigenschaft Dokumentation

baseColor : color

Die Grundfarbe der Serie.

Siehe auch colorStyle und GraphsTheme.seriesColors.


baseGradient : Gradient

Der Grundgradient der Serie.

Siehe auch colorStyle.


colorStyle : GraphsTheme.ColorStyle

Der Farbstil für die Serie.

Siehe auch GraphsTheme.ColorStyle.


dataArray : SurfaceDataArray

Hält die Referenz auf das Daten-Array.

dataArrayChanged Das Signal wird ausgegeben, wenn dataArray gesetzt wird, es sei denn, newDataArray ist identisch mit dem vorherigen.

Hinweis: Bevor irgendetwas in Bezug auf das dataArray getan wird, muss eine Serie für den entsprechenden Proxy erstellt werden.


dataProxy : SurfaceDataProxy

Der aktive Daten-Proxy. Die Serie übernimmt alle Proxys, die für sie festgelegt wurden, und löscht alle zuvor festgelegten Proxys, wenn ein neuer hinzugefügt wird. Der Proxy kann nicht ungültig oder auf eine andere Serie festgelegt sein.


drawMode : DrawFlag

Setzt den Zeichenmodus auf einen der folgenden Werte: Surface3DSeries.DrawFlag{QSurface3DSeries.DrawFilledSurface}. Es muss entweder DrawWireframe oder DrawSurface eingestellt sein.


flatShadingSupported : bool [read-only]

Gibt an, ob Flat Shading für Oberflächen vom aktuellen System unterstützt wird. Es wird mindestens GLSL Version 1.2 mit GL_EXT_gpu_shader4 Erweiterung benötigt.

Hinweis: Diese schreibgeschützte Eigenschaft wird nach dem ersten Rendervorgang auf den richtigen Wert gesetzt. Bis dahin ist sie immer true.


invalidSelectionPosition : point [read-only]

Eine konstante Eigenschaft, die eine ungültige Auswahlposition angibt. Diese Position wird der Eigenschaft selectedPoint zugewiesen, um die Auswahl aus dieser Serie zu löschen.

Siehe auch GraphsItem3D::clearSelection().


itemLabel : string [read-only]

Die formatierte Artikelbezeichnung. Wenn es kein ausgewähltes Element gibt oder das ausgewählte Element nicht sichtbar ist, wird eine leere Zeichenfolge zurückgegeben.

Siehe auch itemLabelFormat.


itemLabelFormat : string

Das Beschriftungsformat für Datenelemente in dieser Reihe. Dieses Format wird für Beschriftungen einzelner Elemente verwendet, z. B. wenn ein Element ausgewählt ist. Wie das Format interpretiert wird, hängt vom Serientyp ab.

Siehe auch Bar3DSeries, Scatter3DSeries, und Surface3DSeries.


itemLabelVisible : bool

Bei true werden die Elementbeschriftungen als fließende Beschriftungen im Diagramm gezeichnet. Andernfalls werden die Elementbeschriftungen nicht gezeichnet. Um die Elementbeschriftung in einem externen Steuerelement anzuzeigen, wird diese Eigenschaft auf false gesetzt. Die Standardeinstellung ist true.

Siehe auch itemLabelFormat und itemLabel.


lightingMode : Abstract3DSeries.LightingMode [since 6.10]

Der Beleuchtungsmodus der Elemente in der Serie. Der Standardwert ist QAbstract3DSeries::LightingMode::Shaded

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

Siehe auch QAbstract3DSeries::LightingMode.


mesh : Abstract3DSeries.Mesh

Das Mesh der Elemente in der Serie oder der Auswahlzeiger im Falle von Surface3DSeries. Wenn das Mesh Abstract3DSeries.Mesh.UserDefined ist, muss auch die Eigenschaft userDefinedMesh gesetzt werden, damit die Elemente richtig gerendert werden. Der Standardwert hängt vom Diagrammtyp ab.

Siehe auch QAbstract3DSeries::Mesh.


meshRotation : quaternion

Die Maschenrotation, die auf alle Elemente der Serie angewendet wird. Die Drehung sollte ein normalisiertes Quaternion sein. Bei Reihentypen, die objektspezifische Drehungen unterstützen, werden die Drehungen miteinander multipliziert. Bar3DSeries ignoriert jede Drehung, die nicht um die y-Achse erfolgt. Surface3DSeries wendet die Drehung nur auf den Auswahlzeiger an. Die Voreinstellung ist keine Drehung.


meshSmooth : bool

Wenn true, werden glatte Versionen von vordefinierten Meshes verwendet, die über die Eigenschaft mesh festgelegt wurden. Diese Eigenschaft wirkt sich nicht auf benutzerdefinierte Meshes aus, die verwendet werden, wenn das Mesh auf Abstract3DSeries.Mesh.UserDefined eingestellt ist. Die Standardeinstellung ist false.


multiHighlightColor : color

Die Farbe der Hervorhebung mehrerer Elemente in der Serie.

Siehe auch colorStyle und GraphsTheme.multiHighlightColor.


multiHighlightGradient : Gradient

Der Farbverlauf für die Hervorhebung mehrerer Elemente in der Serie.

Siehe auch colorStyle und GraphsTheme.multiHighlightGradient.


name : string

Der Name der Serie. Er kann im Artikelbeschriftungsformat mit dem Tag @seriesName verwendet werden.

Siehe auch itemLabelFormat.


selectedPoint : point

Legt den Oberflächenrasterpunkt an der durch eine Zeile und eine Spalte im Datenfeld der Serie angegebenen Position als ausgewählt fest. Es kann jeweils nur ein Punkt ausgewählt werden.

Um die Auswahl für diese Reihe aufzuheben, geben Sie als Position invalidSelectionPosition an. Wenn diese Reihe zu einem Diagramm hinzugefügt wird, kann das Diagramm die Auswahl entsprechend der Benutzerinteraktion anpassen oder wenn sie ungültig wird.

Das Entfernen von Zeilen aus der Reihe oder das Einfügen von Zeilen in die Reihe vor der Zeile des ausgewählten Punktes passt die Auswahl so an, dass derselbe Punkt ausgewählt bleibt.

Siehe auch GraphsItem3D::clearSelection().


shading : Shading

Setzt die flache Schattierung der Oberfläche auf sichtbar. Standardmäßig ist diese Option auf Surface3DSeries.Shading.Flat voreingestellt. Wenn sie deaktiviert ist, werden die Normalen auf der Oberfläche interpoliert, wodurch die Kanten rund aussehen. Wenn sie sichtbar ist, werden die Normalen auf einem Dreieck gleich gehalten, wodurch die Farbe des Dreiecks einheitlich wird. Dadurch werden die Daten im Modell besser lesbar.

Hinweis: Flache schattierte Oberflächen erfordern mindestens GLSL Version 1.2 mit GL_EXT_gpu_shader4 Erweiterung. Der Wert der Eigenschaft flatShadingSupported zeigt an, ob Flat Shading zur Laufzeit unterstützt wird.


singleHighlightColor : color

Die Farbe der Hervorhebung der einzelnen Elemente der Serie.

Siehe auch colorStyle und GraphsTheme.singleHighlightColor.


singleHighlightGradient : Gradient

Der Hervorhebungsgradient des einzelnen Elements der Serie.

Siehe auch colorStyle und GraphsTheme.singleHighlightGradient.


textureFile : string

Der Name der Texturdatei für die Oberflächentextur. Um die Textur zu löschen, wird ein leerer Dateiname angegeben.


type : Abstract3DSeries.SeriesType [read-only]

Der Typ der Serie. Einer der Werte von QAbstract3DSeries::SeriesType.


userDefinedMesh : string

Der Dateiname für ein benutzerdefiniertes benutzerdefiniertes Netz für Objekte, das verwendet wird, wenn mesh Abstract3DSeries.Mesh.UserDefined ist.

Hinweis: Die Datei muss im Mesh-Format QtQuick3D vorliegen. Verwenden Sie das Konvertierungstool balsam, um ein Netz aus anderen 3D-Modellformaten zu erstellen.


visible : bool

Die Sichtbarkeit der Serie. Wenn false gewählt wird, wird die Serie nicht gerendert.


wireframeColor : color

Die Farbe, mit der die Gitterlinien des Oberflächendrahtgitters gezeichnet werden.


Signal Dokumentation

baseColorChanged(color color)

Dieses Signal wird ausgegeben, wenn baseColor zu color wechselt.

Hinweis: Der entsprechende Handler ist onBaseColorChanged.


baseGradientChanged(Gradient gradient)

Dieses Signal wird ausgegeben, wenn baseGradient zu gradient wechselt.

Hinweis: Der entsprechende Handler ist onBaseGradientChanged.


colorStyleChanged(GraphsTheme.ColorStyle style)

Dieses Signal wird ausgegeben, wenn colorStyle zu style wechselt.

Hinweis: Der entsprechende Handler ist onColorStyleChanged.


dataArrayChanged(SurfaceDataArray array)

Dieses Signal wird ausgegeben, wenn dataArray zu array wechselt.

Hinweis: Der entsprechende Handler ist onDataArrayChanged.


dataProxyChanged(SurfaceDataProxy proxy)

Dieses Signal wird ausgegeben, wenn dataProxy zu proxy wechselt.

Hinweis: Der entsprechende Handler ist onDataProxyChanged.


drawModeChanged(DrawFlag mode)

Dieses Signal wird ausgegeben, wenn drawMode zu mode wechselt.

Hinweis: Der entsprechende Handler ist onDrawModeChanged.


flatShadingSupportedChanged(bool enable)

Dieses Signal wird ausgegeben, wenn flatShadingSupported zu enable wechselt.

Hinweis: Der entsprechende Handler ist onFlatShadingSupportedChanged.


itemLabelChanged(string label)

Dieses Signal wird ausgegeben, wenn itemLabel zu label wechselt.

Hinweis: Der entsprechende Handler ist onItemLabelChanged.


itemLabelFormatChanged(string format)

Dieses Signal wird ausgegeben, wenn itemLabelFormat zu format wechselt.

Hinweis: Der entsprechende Handler ist onItemLabelFormatChanged.


itemLabelVisibilityChanged(bool visible)

Dieses Signal wird ausgegeben, wenn itemLabelVisibility auf visible geändert wird.

Hinweis: Der entsprechende Handler ist onItemLabelVisibilityChanged.


[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

Dieses Signal wird ausgegeben, wenn lightingMode zu lightingMode wechselt.

Hinweis: Der entsprechende Handler ist onLightingModeChanged.

Dieses Signal wurde in Qt 6.10 eingeführt.


meshChanged(Abstract3DSeries.Mesh mesh)

Dieses Signal wird ausgegeben, wenn mesh zu mesh wechselt.

Hinweis: Der entsprechende Handler ist onMeshChanged.


meshRotationChanged(quaternion rotation)

Dieses Signal wird ausgegeben, wenn meshRotation zu rotation wechselt.

Hinweis: Der entsprechende Handler ist onMeshRotationChanged.


meshSmoothChanged(bool enabled)

Dieses Signal wird ausgegeben, wenn meshSmooth zu enabled wechselt.

Hinweis: Der entsprechende Handler ist onMeshSmoothChanged.


multiHighlightColorChanged(color color)

Dieses Signal wird ausgegeben, wenn multiHighlightColor zu color wechselt.

Hinweis: Der entsprechende Handler ist onMultiHighlightColorChanged.


multiHighlightGradientChanged(Gradient gradient)

Dieses Signal wird ausgegeben, wenn multiHighlightGradient zu gradient wechselt.

Hinweis: Der entsprechende Handler ist onMultiHighlightGradientChanged.


nameChanged(string name)

Dieses Signal wird ausgegeben, wenn name zu name wechselt.

Hinweis: Der entsprechende Handler ist onNameChanged.


selectedPointChanged(point position)

Dieses Signal wird ausgegeben, wenn selectedPoint zu position wechselt.

Hinweis: Der entsprechende Handler ist onSelectedPointChanged.


shadingChanged(const Shading shading)

Dieses Signal wird ausgegeben, wenn shading zu shading wechselt.

Hinweis: Der entsprechende Handler ist onShadingChanged.


singleHighlightColorChanged(color color)

Dieses Signal wird ausgegeben, wenn singleHighlightColor zu color wechselt.

Hinweis: Der entsprechende Handler ist onSingleHighlightColorChanged.


singleHighlightGradientChanged(Gradient gradient)

Dieses Signal wird ausgegeben, wenn singleHighlightGradient zu gradient wechselt.

Hinweis: Der entsprechende Handler ist onSingleHighlightGradientChanged.


textureFileChanged(string filename)

Dieses Signal wird ausgegeben, wenn textureFile zu filename wechselt.

Hinweis: Der entsprechende Handler ist onTextureFileChanged.


userDefinedMeshChanged(string fileName)

Dieses Signal wird ausgegeben, wenn userDefinedMesh zu fileName wechselt.

Hinweis: Der entsprechende Handler ist onUserDefinedMeshChanged.


visibilityChanged(bool visible)

Dieses Signal wird ausgegeben, wenn sich die Sichtbarkeit der Serie auf visible ändert.

Hinweis: Der entsprechende Handler ist onVisibilityChanged.


wireframeColorChanged(color color)

Dieses Signal wird ausgegeben, wenn wireframeColor zu color wechselt.

Hinweis: Der entsprechende Handler ist onWireframeColorChanged.


Dokumentation der Methode

void setMeshAxisAndAngle(vector3d axis, real angle)

Eine Komfortfunktion, um eine Maschenrotationsquaternion aus axis und angle zu konstruieren.

Siehe auch meshRotation.


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