Back to Qt.io
Contact Us Blog Download Qt
Auf dieser Seite

Surface3DSeries QML Type (Uncreatable)

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

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

Abstract3DSeries

Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.

Eigenschaften

Signale

Methoden

Ausführliche Beschreibung

Dieser Typ verwaltet die serienspezifischen visuellen Elemente sowie die Seriendaten (über einen Datenproxy).

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

@xTitleTitel aus der x-Achse
@yTitleTitel von der y-Achse
@zTitleTitel von der z-Achse
@xLabelDer Wert des Elements, formatiert nach dem Format der x-Achse. Weitere Informationen finden Sie unter labelFormat.
@yLabelElementwert, formatiert im Stil der y-Achse. Weitere Informationen finden Sie unter labelFormat.
@zLabelDer Wert des Elements wird im Format der z-Achse formatiert. Weitere Informationen finden Sie unter labelFormat.
@seriesNameName der Reihe

Eine ausführlichere Beschreibung finden Sie unter QSurface3DSeries.

Siehe auch Qt Graphs Datenverarbeitung mit 3D.

Dokumentation zu den Eigenschaften

baseColor : color

Die Grundfarbe der Serie.

Siehe auch colorStyle und GraphsTheme.seriesColors.

baseGradient : Gradient

Der Basisgradient der Reihe.

Siehe auch colorStyle.

colorStyle : GraphsTheme.ColorStyle

Der Farbstil der Serie.

Siehe auch GraphsTheme.ColorStyle.

dataArray : SurfaceDataArray

Enthält den Verweis auf das Datenarray.

dataArrayChanged Ein Signal wird ausgelöst, wenn das Datenarray festgelegt wird, es sei denn, „ newDataArray “ ist identisch mit dem vorherigen.

Hinweis: Bevor irgendwelche Operationen mit dem „dataArray“ durchgeführt werden, muss für den entsprechenden Proxy eine Serie angelegt werden.

dataProxy : SurfaceDataProxy

Der aktive Daten-Proxy. Die Reihe übernimmt die Verantwortung für jeden ihr zugewiesenen Proxy und löscht alle zuvor zugewiesenen Proxys, sobald ein neuer hinzugefügt wird. Der Proxy darf weder null sein noch auf eine andere Reihe gesetzt sein.

drawMode : DrawFlag

Stellt den Zeichenmodus auf einen der folgenden Werte ein: „ 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. Dazu ist mindestens GLSL-Version 1.2 mit der Erweiterung GL_EXT_gpu_shader4 erforderlich.

Hinweis: Diese schreibgeschützte Eigenschaft wird erst nach dem ersten Renderdurchlauf auf den korrekten Wert gesetzt. Bis dahin lautet ihr Wert stets „ true “.

invalidSelectionPosition : point [read-only]

Eine Konstante, 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 Bezeichnung des Elements. Wenn kein Element ausgewählt ist oder das ausgewählte Element nicht sichtbar ist, wird eine leere Zeichenkette zurückgegeben.

Siehe auch „ itemLabelFormat “.

itemLabelFormat : string

Das Beschriftungsformat für Datenelemente in dieser Reihe. Dieses Format wird für Einzelelementbeschriftungen verwendet, beispielsweise wenn ein Element ausgewählt wird. Wie das Format interpretiert wird, hängt vom Reihetyp ab.

Siehe auch Bar3DSeries, Scatter3DSeries und Surface3DSeries.

itemLabelVisible : bool

Wenn „ true “ gesetzt ist, werden die Elementbeschriftungen als schwebende Beschriftungen im Diagramm dargestellt. Andernfalls werden die Elementbeschriftungen nicht angezeigt. Um die Elementbeschriftung in einem externen Steuerelement anzuzeigen, wird diese Eigenschaft auf „ false “ gesetzt. Der Standardwert ist „ true “.

Siehe auch „ itemLabelFormat “ und „ itemLabel “.

lightingMode : Abstract3DSeries.LightingMode [since 6.10]

Der Beleuchtungsmodus der Elemente der Serie. Der Standardwert lautet QAbstract3DSeries::LightingMode::Shaded

Diese Eigenschaft wurde in Qt 6.10 eingeführt.

Siehe auch „ QAbstract3DSeries::LightingMode “.

mesh : Abstract3DSeries.Mesh

Das Mesh der Elemente der Serie oder der Auswahlzeiger im Fall von „ Surface3DSeries “. Wenn das Mesh „ Abstract3DSeries.Mesh.UserDefined “ ist, muss zusätzlich die Eigenschaft „ userDefinedMesh “ festgelegt werden, damit die Elemente korrekt gerendert werden. Der Standardwert hängt vom Diagrammtyp ab.

Siehe auch QAbstract3DSeries::Mesh.

meshRotation : quaternion

Die Mesh-Drehung, die auf alle Elemente der Serie angewendet wird. Die Drehung sollte ein normalisiertes Quaternion sein. Bei Serientypen, die elementspezifische Drehungen unterstützen, werden die Drehungen miteinander multipliziert. „ Bar3DSeries “ ignoriert alle Drehungen, die nicht um die y-Achse erfolgen. „ Surface3DSeries “ wendet die Drehung nur auf den Auswahlzeiger an. Standardmäßig erfolgt keine Drehung.

meshSmooth : bool

Wenn „ true “ eingestellt ist, werden geglättete Versionen vordefinierter Gitter verwendet, die über die Eigenschaft „ mesh “ festgelegt wurden. Diese Eigenschaft hat keine Auswirkungen auf benutzerdefinierte Gitter, die verwendet werden, wenn die Gitteroption auf „ Abstract3DSeries.Mesh.UserDefined “ gesetzt ist. Die Standardeinstellung ist „ false “.

multiHighlightColor : color

Die Hervorhebungsfarbe für mehrere Elemente der Serie.

Siehe auch colorStyle und GraphsTheme.multiHighlightColor.

multiHighlightGradient : Gradient

Der Farbverlauf zur Hervorhebung mehrerer Elemente der Serie.

Siehe auch colorStyle und GraphsTheme.multiHighlightGradient.

name : string

Der Serienname. Er kann im Format einer Artikelbezeichnung mit dem Tag „ @seriesName “ verwendet werden.

Siehe auch itemLabelFormat.

selectedPoint : point

Legt den Oberflächenrasterpunkt an der Position fest, die durch eine Zeile und eine Spalte im Datenarray der ausgewählten Reihe angegeben wird. Es kann jeweils nur ein Punkt ausgewählt werden.

Um die Auswahl aus dieser Reihe zu löschen, weisen Sie als Position „ invalidSelectionPosition “ zu. 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 oder Einfügen von Zeilen in der 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 Flächenschattierung auf „sichtbar“. Standardmäßig ist „ Surface3DSeries.Shading.Flat “ voreingestellt. Bei deaktivierter Option werden die Normalen auf der Oberfläche interpoliert, wodurch die Kanten abgerundet erscheinen. Bei aktivierter Option bleiben die Normalen innerhalb eines Dreiecks gleich, wodurch die Farbe des Dreiecks deckend wirkt. Dadurch lassen sich die Daten des Modells besser erkennen.

Hinweis: Für flach schattierte Oberflächen ist mindestens GLSL-Version 1.2 mit der Erweiterung GL_EXT_gpu_shader4 erforderlich. Der Wert der Eigenschaft „ flatShadingSupported “ gibt an, ob flache Schattierung zur Laufzeit unterstützt wird.

singleHighlightColor : color

Die Highlight-Farbe für einzelne Artikel dieser Serie.

Siehe auch colorStyle und GraphsTheme.singleHighlightColor.

singleHighlightGradient : Gradient

Das Highlight der Serie: ein einzelnes Produkt mit Farbverlauf.

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 aus „ QAbstract3DSeries::SeriesType “.

userDefinedMesh : string

Der Dateiname für ein benutzerdefiniertes Netz für Objekte, das bei „ mesh “ verwendet wird, lautet „ Abstract3DSeries.Mesh.UserDefined “.

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

visible : bool

Die Sichtbarkeit der Serie. Wenn „ false “ gilt, wird die Serie nicht dargestellt.

wireframeColor : color

Die Farbe, mit der die Gitterlinien des Oberflächen-Drahtmodells gezeichnet werden.

Signal-Dokumentation

baseColorChanged(color color)

Dieses Signal wird ausgelöst, wenn sich „ baseColor “ in „ color “ ändert.

Hinweis: Der entsprechende Handler lautet onBaseColorChanged.

baseGradientChanged(Gradient gradient)

Dieses Signal wird ausgelöst, wenn sich baseGradient in gradient ändert.

Hinweis: Der entsprechende Handler lautet onBaseGradientChanged.

colorStyleChanged(GraphsTheme.ColorStyle style)

Dieses Signal wird ausgelöst, wenn sich colorStyle in style ändert.

Hinweis: Der entsprechende Handler lautet onColorStyleChanged.

dataArrayChanged(SurfaceDataArray array)

Dieses Signal wird ausgelöst, wenn sich dataArray in array ändert.

Hinweis: Der entsprechende Handler lautet onDataArrayChanged.

dataProxyChanged(SurfaceDataProxy proxy)

Dieses Signal wird ausgelöst, wenn sich „ dataProxy “ in „ proxy “ ändert.

Hinweis: Der entsprechende Handler lautet onDataProxyChanged.

drawModeChanged(DrawFlag mode)

Dieses Signal wird ausgelöst, wenn sich „ drawMode “ in „ mode “ ändert.

Hinweis: Der entsprechende Handler lautet onDrawModeChanged.

flatShadingSupportedChanged(bool enable)

Dieses Signal wird ausgelöst, wenn sich „ flatShadingSupported “ in „ enable “ ändert.

Hinweis: Der entsprechende Handler lautet onFlatShadingSupportedChanged.

itemLabelChanged(string label)

Dieses Signal wird ausgelöst, wenn sich „ itemLabel “ in „ label “ ändert.

Hinweis: Der entsprechende Handler ist „ onItemLabelChanged “.

itemLabelFormatChanged(string format)

Dieses Signal wird ausgelöst, wenn sich itemLabelFormat in format ändert.

Hinweis: Der zugehörige Handler lautet onItemLabelFormatChanged.

itemLabelVisibilityChanged(bool visible)

Dieses Signal wird ausgelöst, wenn sich „itemLabelVisibility“ auf „ visible “ ändert.

Hinweis: Der entsprechende Handler lautet „ onItemLabelVisibilityChanged “.

[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)

Dieses Signal wird ausgelöst, wenn sich „ lightingMode “ in „ lightingMode “ ändert.

Hinweis: Der entsprechende Handler lautet „ onLightingModeChanged “.

Dieses Signal wurde in Qt 6.10 eingeführt.

meshChanged(Abstract3DSeries.Mesh mesh)

Dieses Signal wird ausgelöst, wenn sich „ mesh “ in „ mesh “ ändert.

Hinweis: Der entsprechende Handler lautet onMeshChanged.

meshRotationChanged(quaternion rotation)

Dieses Signal wird ausgelöst, wenn sich „ meshRotation “ in „ rotation “ ändert.

Hinweis: Der entsprechende Handler lautet onMeshRotationChanged.

meshSmoothChanged(bool enabled)

Dieses Signal wird ausgelöst, wenn sich „ meshSmooth “ in „ enabled “ ändert.

Hinweis: Der entsprechende Handler lautet onMeshSmoothChanged.

multiHighlightColorChanged(color color)

Dieses Signal wird ausgelöst, wenn sich multiHighlightColor in color ändert.

Hinweis: Der entsprechende Handler lautet onMultiHighlightColorChanged.

multiHighlightGradientChanged(Gradient gradient)

Dieses Signal wird ausgelöst, wenn sich „ multiHighlightGradient “ in „ gradient “ ändert.

Hinweis: Der entsprechende Handler ist onMultiHighlightGradientChanged.

nameChanged(string name)

Dieses Signal wird ausgelöst, wenn sich „ name “ in „ name “ ändert.

Hinweis: Der entsprechende Handler lautet onNameChanged.

rowsSanitizedChanged(bool enabled)

Dieses Signal wird ausgelöst, wenn sich „rowsSanitized“ auf „ enabled “ ändert.

Hinweis: Der entsprechende Handler ist onRowsSanitizedChanged.

selectedPointChanged(point position)

Dieses Signal wird ausgelöst, wenn sich „ selectedPoint “ in „ position “ ändert.

Hinweis: Der zugehörige Handler lautet onSelectedPointChanged.

shadingChanged(const Shading shading)

Dieses Signal wird ausgelöst, wenn sich shading in shading ändert.

Hinweis: Der entsprechende Handler lautet onShadingChanged.

singleHighlightColorChanged(color color)

Dieses Signal wird ausgelöst, wenn sich „ singleHighlightColor “ in „ color “ ändert.

Hinweis: Der zugehörige Handler lautet onSingleHighlightColorChanged.

singleHighlightGradientChanged(Gradient gradient)

Dieses Signal wird ausgelöst, wenn sich „ singleHighlightGradient “ in „ gradient “ ändert.

Hinweis: Der entsprechende Handler lautet onSingleHighlightGradientChanged.

textureFileChanged(string filename)

Dieses Signal wird ausgelöst, wenn sich „ textureFile “ in „ filename “ ändert.

Hinweis: Der entsprechende Handler lautet onTextureFileChanged.

userDefinedMeshChanged(string fileName)

Dieses Signal wird ausgelöst, wenn sich userDefinedMesh in fileName ändert.

Hinweis: Der entsprechende Handler lautet onUserDefinedMeshChanged.

visibilityChanged(bool visible)

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

Hinweis: Der zugehörige Handler lautet „ onVisibilityChanged “.

wireframeColorChanged(color color)

Dieses Signal wird ausgelöst, wenn sich wireframeColor in color ändert.

Hinweis: Der entsprechende Handler lautet „ onWireframeColorChanged “.

Methodendokumentation

void setMeshAxisAndAngle(vector3d axis, real angle)

Eine Hilfsfunktion zum Erstellen eines Mesh-Rotationsquaternions anhand von axis und angle.

Siehe auch 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.