QSurface3DSeries Class
Die Klasse „QSurface3DSeries“ stellt eine Datenreihe in einem 3D-Flächendiagramm dar. Mehr...
| Header: | #include <QSurface3DSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | Surface3DSeries |
| Erbt von: | QAbstract3DSeries |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
Ö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() |
Ausführliche Beschreibung
Diese Klasse verwaltet die serienspezifischen visuellen Elemente sowie die Seriendaten (über einen Daten-Proxy).
Wenn für die Serie kein Datenproxy explizit festgelegt wurde, erstellt die Serie einen Standard-Proxy. Das Festlegen eines anderen Proxys löscht den bestehenden Proxy und alle ihm hinzugefügten Daten.
Das über die Eigenschaft „ QAbstract3DSeries::mesh “ festgelegte Objektgitter definiert die Form des Auswahlzeigers in einer Oberflächenreihe.
QSurface3DSeries unterstützt die folgenden Format-Tags für QAbstract3DSeries::setItemLabelFormat():
| @xTitle | Titel von der x-Achse |
| @yTitle | Titel von der y-Achse |
| @zTitle | Titel von der z-Achse |
| @xLabel | Elementwert, formatiert gemäß dem Format der x-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @yLabel | Elementwert, formatiert gemäß dem Format der y-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @zLabel | Elementwert, formatiert gemäß dem Format der z-Achse. Weitere Informationen finden Sie unter QValue3DAxis::setLabelFormat(). |
| @seriesName | Name der Reihe |
Beispiel:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Siehe auch „Qt Data Visualization –Datenverarbeitung“.
Dokumentation zum Mitgliedstyp
enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags
Der Zeichenmodus der Fläche. Die Werte dieser Aufzählung können mit dem OR-Operator kombiniert werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | Es wird nur das Gitter gezeichnet. |
QSurface3DSeries::DrawSurface | 2 | Es wird nur die Oberfläche 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 OR-Kombination von DrawFlag-Werten.
Dokumentation zur Eigenschaft
dataProxy : QSurfaceDataProxy*
Diese Eigenschaft enthält den aktiven Datenproxy.
Die Reihe übernimmt die Eigentumsrechte an jedem ihr zugewiesenen Proxy und löscht alle zuvor zugewiesenen Proxys, sobald ein neuer hinzugefügt wird. Der Proxy darf nicht null sein oder auf eine andere Reihe gesetzt sein.
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 zulässig.
Zugriffsfunktionen:
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
Benachrichtigungssignal:
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
flatShadingEnabled : bool
Diese Eigenschaft legt fest, ob die Flachschattierung für Oberflächen aktiviert ist.
Standardmäßig auf „ true “ voreingestellt.
Ist diese Option deaktiviert, werden die Normalen auf der Oberfläche interpoliert, wodurch die Kanten abgerundet erscheinen. Ist sie aktiviert, bleiben die Normalen innerhalb eines Dreiecks unverändert, 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.
Zugriffsfunktionen:
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
Notifier-Signal:
| void | flatShadingEnabledChanged(bool enable) |
[read-only] flatShadingSupported : bool
Diese Eigenschaft gibt an, ob das aktuelle System Flat Shading für Oberflächen unterstützt.
Für die „Flat Shading“-Darstellung von Oberflächen ist mindestens GLSL-Version 1.2 mit der Erweiterung GL_EXT_gpu_shader4 erforderlich. Wenn „ true “ gilt, wird „Flat Shading“ für Oberflächen unterstützt.
Hinweis: Diese schreibgeschützte Eigenschaft wird nach dem ersten Renderdurchlauf auf den korrekten Wert gesetzt. Bis dahin ist sie immer „ true “.
Zugriffsfunktionen:
| bool | isFlatShadingSupported() const |
Notifier-Signal:
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
Diese Eigenschaft enthält den Oberflächengitterpunkt, der in der Reihe 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 “.
Wird ein leerer ` QImage ` festgelegt, wird die Textur gelöscht.
Zugriffsfunktionen:
| QImage | texture() const |
| void | setTexture(const QImage &texture) |
Notifier-Signal:
| void | textureChanged(const QImage &image) |
textureFile : QString
Diese Eigenschaft speichert die Textur für die Oberfläche als Datei.
Durch die Angabe eines leeren Dateinamens wird die Textur gelöscht.
Zugriffsfunktionen:
| QString | textureFile() const |
| void | setTextureFile(const QString &filename) |
Notifier-Signal:
| void | textureFileChanged(const QString &filename) |
[since 6.3] wireframeColor : QColor
Diese Eigenschaft legt die Farbe für das Drahtgitter der Oberfläche fest.
Diese Aufzählung wurde in Qt 6.3 eingeführt.
Zugriffsfunktionen:
| QColor | wireframeColor() const |
| void | setWireframeColor(const QColor &color) |
Notifier-Signal:
| void | wireframeColorChanged(const QColor &color) |
Dokumentation der Mitgliedsfunktionen
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
Erstellt eine 3D-Oberflächenreihe mit dem übergeordneten Element „ parent “.
[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
Erstellt eine 3D-Oberflächenreihe mit dem Daten-Proxy dataProxy und dem übergeordneten Element parent.
[virtual noexcept] QSurface3DSeries::~QSurface3DSeries()
Löscht die 3D-Reihe der Fläche.
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
Gibt den Wert „ QPoint “ zurück, der eine ungültige Auswahlposition anzeigt. Dieser Wert wird der Eigenschaft „ selectedPoint “ zugewiesen, 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 Datenarray der durch eine Zeile und eine Spalte angegebenen Reihe aus.
Es kann jeweils nur ein Punkt ausgewählt werden.
Um die Auswahl aus dieser Reihe zu löschen, wird ` invalidSelectionPosition()` auf ` position` gesetzt. Wird diese Reihe einem Diagramm hinzugefügt, 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.
Hinweis: Setter -Funktion für die Eigenschaft ` selectedPoint`.
Siehe auch „ selectedPoint()“ und „ QAbstract3DGraph::clearSelection()“.
© 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.
