QSurface3DSeries Class
Die Klasse QSurface3DSeries stellt eine Datenreihe in einem 3D-Oberflächendiagramm dar. Mehr...
| Kopfzeile: | #include <QSurface3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| In QML: | Surface3DSeries |
| Vererbt: | QAbstract3DSeries |
Öffentliche Typen
Eigenschaften
|
|
Öffentliche Funktionen
| QSurface3DSeries(QObject *parent = nullptr) | |
| QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QSurface3DSeries() |
| QSurfaceDataProxy * | dataProxy() const |
| QSurface3DSeries::DrawFlags | drawMode() const |
| bool | isFlatShadingEnabled() const |
| bool | isFlatShadingSupported() const |
| QPoint | selectedPoint() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
| void | setFlatShadingEnabled(bool enabled) |
| void | setSelectedPoint(const QPoint &position) |
| void | setTexture(const QImage &texture) |
| void | setTextureFile(const QString &filename) |
| void | setWireframeColor(const QColor &color) |
| QImage | texture() const |
| QString | textureFile() const |
| QColor | wireframeColor() const |
Signale
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
| void | flatShadingEnabledChanged(bool enable) |
| void | flatShadingSupportedChanged(bool enable) |
| void | selectedPointChanged(const QPoint &position) |
| void | textureChanged(const QImage &image) |
| void | textureFileChanged(const QString &filename) |
| void | wireframeColorChanged(const QColor &color) |
Statische öffentliche Mitglieder
| QPoint | invalidSelectionPosition() |
Detaillierte Beschreibung
Diese Klasse verwaltet die serienspezifischen visuellen Elemente sowie die Daten der Serie (über einen Daten-Proxy).
Wenn kein Daten-Proxy explizit für die Serie festgelegt ist, erstellt die Serie einen Standard-Proxy. Wird ein anderer Proxy gesetzt, werden der bestehende Proxy und alle ihm hinzugefügten Daten zerstört.
Das über die Eigenschaft QAbstract3DSeries::mesh eingestellte Objektnetz definiert die Form des Auswahlzeigers in einer Oberflächenserie.
QSurface3DSeries unterstützt die folgenden Format-Tags für QAbstract3DSeries::setItemLabelFormat():
| @xTitle | Titel der x-Achse |
| @yTitel | Titel von der y-Achse |
| @zTitel | Titel von der z-Achse |
| @xLabel | Elementwert, formatiert unter Verwendung des Formats der x-Achse. Für weitere Informationen siehe QValue3DAxis::setLabelFormat(). |
| @yBeschriftung | Elementwert, formatiert unter Verwendung des Formats der y-Achse. Für weitere Informationen siehe QValue3DAxis::setLabelFormat(). |
| @zLabel | Elementwert, formatiert unter Verwendung des Formats der z-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @Reihenname | Name der Reihe |
Zum Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Siehe auch Qt Data Visualization Data Handling.
Dokumentation der Mitgliedstypen
enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags
Der Zeichenmodus der Oberfläche. Die Werte dieser Aufzählung können mit dem OR-Operator kombiniert werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | Nur das Gitter wird gezeichnet. |
QSurface3DSeries::DrawSurface | 2 | Nur die Oberfläche wird gezeichnet. |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | Sowohl die Oberfläche als auch das Gitter werden gezeichnet. |
Der Typ DrawFlags ist ein Typedef für QFlags<DrawFlag>. Er speichert eine ODER-Kombination von DrawFlag-Werten.
Dokumentation der Eigenschaften
dataProxy : QSurfaceDataProxy*
Diese Eigenschaft enthält den aktiven Daten-Proxy.
Die Reihe übernimmt den Besitz aller Proxys, die ihr zugeordnet sind, und löscht alle zuvor eingestellten Proxys, wenn ein neuer hinzugefügt wird. Der Proxy kann nicht ungültig sein oder auf eine andere Serie gesetzt werden.
Zugriffsfunktionen:
| QSurfaceDataProxy * | dataProxy() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
Benachrichtigungssignal:
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
drawMode : DrawFlags
Der Zeichenmodus.
Mögliche Werte sind die Werte von DrawFlag. Das Löschen aller Flags ist nicht erlaubt.
Zugriffsfunktionen:
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
Melder-Signal:
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
flatShadingEnabled : bool
Diese Eigenschaft bestimmt, ob die flache Schattierung der Oberfläche aktiviert ist.
Standardmäßig ist sie auf true voreingestellt.
Wenn sie deaktiviert ist, werden die Normalen auf der Oberfläche interpoliert, wodurch die Kanten rund aussehen. Wenn sie aktiviert ist, 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.
Zugriffsfunktionen:
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
Benachrichtigungssignal:
| void | flatShadingEnabledChanged(bool enable) |
[read-only] flatShadingSupported : const bool
Diese Eigenschaft gibt an, ob Flat Shading für Oberflächen vom aktuellen System unterstützt wird.
Flat Shading für Oberflächen erfordert mindestens GLSL Version 1.2 mit GL_EXT_gpu_shader4 Erweiterung. Wenn true, wird Flat Shading für Oberflächen unterstützt.
Hinweis: Diese schreibgeschützte Eigenschaft wird nach dem ersten Rendering-Durchgang auf ihren korrekten Wert gesetzt. Bis dahin ist sie immer true.
Zugriffsfunktionen:
| bool | isFlatShadingSupported() const |
Benachrichtigungssignal:
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
Diese Eigenschaft enthält den Oberflächenrasterpunkt, der in der Serie ausgewählt ist.
Zugriffsfunktionen:
| QPoint | selectedPoint() const |
| void | setSelectedPoint(const QPoint &position) |
Benachrichtigungssignal:
| void | selectedPointChanged(const QPoint &position) |
texture : QImage
Diese Eigenschaft enthält die Textur für die Oberfläche als QImage.
Das Setzen eines leeren QImage löscht die Textur.
Zugriffsfunktionen:
| QImage | texture() const |
| void | setTexture(const QImage &texture) |
Benachrichtigungssignal:
| void | textureChanged(const QImage &image) |
textureFile : QString
Diese Eigenschaft enthält die Textur für die Oberfläche als Datei.
Das Setzen eines leeren Dateinamens löscht die Textur.
Zugriffsfunktionen:
| QString | textureFile() const |
| void | setTextureFile(const QString &filename) |
Benachrichtigungssignal:
| void | textureFileChanged(const QString &filename) |
[since 6.3] wireframeColor : QColor
Diese Eigenschaft enthält die Farbe für das Drahtgitter der Oberfläche.
Diese Eigenschaft wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| QColor | wireframeColor() const |
| void | setWireframeColor(const QColor &color) |
Benachrichtigungssignal:
| void | wireframeColorChanged(const QColor &color) |
Member Function Dokumentation
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
Konstruiert eine 3D-Flächenreihe mit dem übergeordneten parent.
[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
Konstruiert eine 3D-Oberflächenserie mit dem Datenproxy dataProxy und dem übergeordneten parent.
[virtual noexcept] QSurface3DSeries::~QSurface3DSeries()
Löscht die 3D-Oberflächenserie.
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
Gibt die QPoint zurück, die eine ungültige Auswahlposition angibt. Diese wird auf die Eigenschaft selectedPoint gesetzt, um die Auswahl aus dieser Serie zu löschen.
Siehe auch QAbstract3DGraph::clearSelection().
void QSurface3DSeries::setSelectedPoint(const QPoint &position)
Wählt einen Oberflächengitterpunkt an der Position position im Datenfeld der durch eine Zeile und eine Spalte angegebenen Serie aus.
Es kann jeweils nur ein Punkt ausgewählt werden.
Um die Auswahl aus dieser Reihe aufzuheben, wird invalidSelectionPosition() als position festgelegt. 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 Serie oder das Einfügen von Zeilen in die Serie vor der Zeile des ausgewählten Punktes passt die Auswahl so an, dass derselbe Punkt ausgewählt bleibt.
Hinweis: Setter-Funktion für die Eigenschaft selectedPoint.
Siehe auch selectedPoint() und QAbstract3DGraph::clearSelection().
© 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.
