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
- 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)
- meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- 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.
Eigenschaft Dokumentation
baseColor : color |
Legt die Grundfarbe der Serie fest.
Siehe auch colorStyle und GraphsTheme.seriesColors.
baseGradient : Gradient |
Legt den Grundgradienten der Serie fest.
Siehe auch colorStyle und GraphsTheme.seriesGradients.
colorStyle : GraphsTheme.ColorStyle |
Legt den Farbstil für die Serie fest.
Siehe auch GraphsTheme.ColorStyle.
dataArray : SurfaceDataArray |
Hält die Referenz auf das Datenarray.
dataArrayChanged Das Signal wird ausgegeben, wenn das Datenfeld 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 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 Werte Surface3DSeries.DrawFlag. Das Löschen aller Flags ist nicht zulässig.
flatShadingSupported : bool |
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 Rendering-Durchgang auf ihren korrekten Wert gesetzt. Bis dahin ist sie immer true.
invalidSelectionPosition : point |
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 |
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.
mesh : Abstract3DSeries.Mesh |
Legt das Netz der Elemente in der Serie fest, oder den Auswahlzeiger im Falle von Surface3DSeries. Wenn das Netz 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 |
Legt die Mesh-Drehung fest, die auf alle Elemente der Serie angewendet wird. Die Drehung sollte ein normalisiertes Quaternion sein. Bei den Reihentypen, die eine positionsspezifische Drehung 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 |
Legt die Farbe für die Hervorhebung mehrerer Elemente in der Serie fest.
Siehe auch colorStyle und GraphsTheme.multiHighlightColor.
multiHighlightGradient : Gradient |
Legt den Farbverlauf für die Hervorhebung mehrerer Elemente in der Serie fest.
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 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 |
Legt die Farbe für die Hervorhebung einzelner Elemente in der Serie fest.
Siehe auch colorStyle und GraphsTheme.singleHighlightColor.
singleHighlightGradient : Gradient |
Legt den Hervorhebungsgradienten für einzelne Elemente der Serie fest.
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 |
Der Typ der Serie. Einer der Werte von QAbstract3DSeries::SeriesType.
userDefinedMesh : string |
Legt den Dateinamen für ein benutzerdefiniertes benutzerdefiniertes Netz für Objekte fest, das verwendet wird, wenn mesh Abstract3DSeries.Mesh.UserDefined ist.
Hinweis: Die Datei muss im QtQuick3D Mesh-Format vorliegen. Verwenden Sie das Konvertierungstool balsam, um ein Netz aus anderen 3D-Modellformaten zu erstellen.
visible : bool |
Legt die Sichtbarkeit der Serie fest. Wenn false gewählt wird, wird die Serie nicht gerendert.
wireframeColor : color |
Die Farbe, die zum Zeichnen der Gitterlinien des Oberflächendrahtgitters verwendet wird.
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.
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 Farbe) |
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
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.
