Surface3DSeries QML Type
Stellt eine Datenreihe in einem 3D-Oberflächendiagramm dar. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | QSurface3DSeries |
| Inherits: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Surface3DSeries ist Teil von Qt Graphs QML Types for 3D.
Eigenschaften
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- dataArray : SurfaceDataArray
- dataProxy : SurfaceDataProxy
- drawMode : DrawFlag
- flatShadingSupported : bool
- invalidSelectionPosition : point
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- selectedPoint : point
- shading : Shading
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- textureFile : string
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
- wireframeColor : color
Signale
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- dataArrayChanged(SurfaceDataArray array)
- dataProxyChanged(SurfaceDataProxy proxy)
- drawModeChanged(DrawFlag mode)
- flatShadingSupportedChanged(bool enable)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
(since 6.10) - meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- rowsSanitizedChanged(bool enabled)
- selectedPointChanged(point position)
- shadingChanged(const Shading shading)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- textureFileChanged(string filename)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
- wireframeColorChanged(color color)
Methoden
- void setMeshAxisAndAngle(vector3d axis, real angle)
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:
| @xTitle | Titel der x-Achse |
| @yTitle | Titel von der y-Achse |
| @zTitle | Titel von der z-Achse |
| @xLabel | Elementwert, formatiert unter Verwendung des Formats der x-Achse. Für weitere Informationen siehe labelFormat. |
| @yBeschriftung | Elementwert, formatiert unter Verwendung des Formats der y-Achse. Für weitere Informationen, siehe labelFormat. |
| @zBeschriftung | Elementwert, formatiert unter Verwendung des Formats der z-Achse. Für weitere Informationen, siehe labelFormat. |
| @Reihenname | Name der Serie |
Eine ausführlichere Beschreibung finden Sie unter QSurface3DSeries.
Siehe auch Qt Graphs Datenverarbeitung mit 3D.
Dokumentation der Eigenschaft
baseColor : color
Die Grundfarbe der Serie.
Siehe auch colorStyle und GraphsTheme.seriesColors.
baseGradient : Gradient
Die Basissteigung der Reihe.
Siehe auch colorStyle.
colorStyle : GraphsTheme.ColorStyle
Das Farbschema für die Serie.
Siehe auch GraphsTheme.ColorStyle.
dataArray : SurfaceDataArray
Enthält den Verweis auf das Datenfeld.
dataArrayChanged Signal wird ausgegeben, wenn dataArray gesetzt wird, es sei denn, newDataArray ist mit dem vorherigen identisch.
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 Reihe ü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 von Surface3DSeries.DrawFlag{QSurface3DSeries.DrawFilledSurface}. Es muss entweder DrawWireframe oder DrawSurface eingestellt sein
flatShadingSupported : bool [read-only]
Zeigt an, ob Flat Shading für Oberflächen vom aktuellen System unterstützt wird. Erforderlich ist mindestens GLSL Version 1.2 mit der Erweiterung GL_EXT_gpu_shader4.
Hinweis: Diese schreibgeschützte Eigenschaft wird nach dem ersten Rendering-Durchgang auf ihren korrekten 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 Reihe zu löschen.
Siehe auch GraphsItem3D::clearSelection().
itemLabel : string [read-only]
Die formatierte Bezeichnung des Elements. Wenn es kein ausgewähltes Element gibt oder das ausgewählte Element nicht sichtbar ist, wird ein leerer String zurückgegeben.
Siehe auch itemLabelFormat.
itemLabelFormat : string
Das Beschriftungsformat für Datenelemente in dieser Serie. Dieses Format wird für Beschriftungen einzelner Elemente verwendet, z. B. wenn ein Element ausgewählt wird. Wie das Format interpretiert wird, hängt vom Serientyp ab.
Siehe auch Bar3DSeries, Scatter3DSeries, und Surface3DSeries.
itemLabelVisible : bool
Wenn 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 festgelegt werden, damit die Elemente richtig dargestellt werden. Der Standardwert hängt vom Diagrammtyp ab.
Siehe auch QAbstract3DSeries::Mesh.
meshRotation : quaternion
Die Drehung des Netzes, die auf alle Elemente der Serie angewendet wird. Die Drehung sollte eine normalisierte Quaternion sein. Bei den 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. Standardmäßig ist keine Drehung vorgesehen.
meshSmooth : bool
Wenn true eingestellt ist, werden glatte Versionen von vordefinierten Meshes verwendet, die über die Eigenschaft mesh eingestellt sind. 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 Hervorhebungsgradient für mehrere Elemente in der Serie.
Siehe auch colorStyle und GraphsTheme.multiHighlightGradient.
name : string
Der Name der Serie. Er kann im Format der Artikelbezeichnung 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 ausgewählten Serie angegebenen Position fest. Es kann jeweils nur ein Punkt ausgewählt werden.
Um die Auswahl für diese Reihe aufzuheben, weisen Sie invalidSelectionPosition als Position 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 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 Surface3DSeries.Shading.Flat eingestellt. Wenn sie deaktiviert ist, werden die Normalen auf der Oberfläche interpoliert, wodurch die Kanten rund aussehen. Wenn sichtbar, werden die Normalen auf einem Dreieck gleich gehalten, wodurch die Farbe des Dreiecks einfarbig 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 eines einzelnen Elements in 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 Mesh für Objekte, das bei mesh verwendet wird, lautet Abstract3DSeries.Mesh.UserDefined.
Hinweis: Die Datei muss im Mesh-Format QtQuick3D vorliegen. Verwenden Sie das Konvertierungswerkzeug balsam, um ein Netz aus anderen 3D-Modellformaten zu erstellen.
visible : bool
Die Sichtbarkeit der Serie. Wenn false, wird die Serie nicht gerendert.
wireframeColor : color
Die Farbe, mit der die Rasterlinien des Oberflächendrahtrahmens 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 wechselt.
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.
rowsSanitizedChanged(bool enabled)
Dieses Signal wird ausgegeben, wenn rowsSanitized auf enabled wechselt.
Hinweis: Der entsprechende Handler ist onRowsSanitizedChanged.
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 die Sichtbarkeit der Serie auf visible wechselt.
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 praktische Funktion, um eine Netzrotationsquaternion aus axis und angle zu konstruieren.
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.
