QHeightMapSurfaceDataProxy Class
Basis-Proxy-Klasse für „ Q3DSurfaceWidgetItem “. Mehr...
| Header: | #include <QHeightMapSurfaceDataProxy> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| In QML: | HeightMapSurfaceDataProxy |
| Erbt von: | QSurfaceDataProxy |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- „QHeightMapSurfaceDataProxy“ ist Teil der „Qt Graphs “-C++-Klassen für 3D.
Eigenschaften
|
Öffentliche Funktionen
| QHeightMapSurfaceDataProxy(QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr) | |
| QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr) | |
| virtual | ~QHeightMapSurfaceDataProxy() override |
| bool | autoScaleY() const |
| QImage | heightMap() const |
| QString | heightMapFile() const |
| float | maxXValue() const |
| float | maxYValue() const |
| float | maxZValue() const |
| float | minXValue() const |
| float | minYValue() const |
| float | minZValue() const |
| void | setAutoScaleY(bool enabled) |
| void | setHeightMap(const QImage &image) |
| void | setHeightMapFile(const QString &filename) |
| void | setMaxXValue(float max) |
| void | setMaxYValue(float max) |
| void | setMaxZValue(float max) |
| void | setMinXValue(float min) |
| void | setMinYValue(float min) |
| void | setMinZValue(float min) |
| void | setValueRanges(float minX, float maxX, float minZ, float maxZ) |
Signale
| void | autoScaleYChanged(bool enabled) |
| void | heightMapChanged(const QImage &image) |
| void | heightMapFileChanged(const QString &filename) |
| void | maxXValueChanged(float value) |
| void | maxYValueChanged(float value) |
| void | maxZValueChanged(float value) |
| void | minXValueChanged(float value) |
| void | minYValueChanged(float value) |
| void | minZValueChanged(float value) |
Ausführliche Beschreibung
QHeightMapSurfaceDataProxy übernimmt die Verarbeitung von Höhenkartendaten in Bezug auf Oberflächen. Es ermöglicht die Visualisierung einer Höhenkarte als Oberflächendiagramm.
Da Höhenkarten keine Werte für die X- oder Z-Achse enthalten, müssen diese Werte separat über die Eigenschaften „ minXValue “, „ maxXValue “, „ minZValue “ und „ maxZValue “ angegeben werden. Der X-Wert entspricht der horizontalen Bildrichtung, der Z-Wert der vertikalen. Das Setzen einer dieser Eigenschaften löst eine asynchrone Neuberechnung aller vorhandenen Höhenkarten aus.
Siehe auch „ QSurfaceDataProxy “ und „ Qt Graphs “ – Datenverarbeitung mit 3D.
Dokumentation zu den Eigenschaften
autoScaleY : bool
Werte auf die Y-Achse skalieren.
Standardwert ist „ false “.
Wenn diese Eigenschaft auf „ true “ gesetzt ist, werden die Höhenwerte so skaliert, dass sie auf der Y-Achse zwischen „ minYValue “ und „ maxYValue “ liegen.
Zugriffsfunktionen:
| bool | autoScaleY() const |
| void | setAutoScaleY(bool enabled) |
Benachrichtigungssignal:
| void | autoScaleYChanged(bool enabled) |
Siehe auch „ minYValue “ und „ maxYValue “.
heightMap : QImage
Diese Eigenschaft enthält das Höhenkartenbild, das visualisiert werden soll.
Zugriffsfunktionen:
| QImage | heightMap() const |
| void | setHeightMap(const QImage &image) |
Benachrichtigungssignal:
| void | heightMapChanged(const QImage &image) |
heightMapFile : QString
Diese Eigenschaft enthält den Namen der Datei mit einem Höhenkartenbild, das visualisiert werden soll.
Zugriffsfunktionen:
| QString | heightMapFile() const |
| void | setHeightMapFile(const QString &filename) |
Benachrichtigungssignal:
| void | heightMapFileChanged(const QString &filename) |
maxXValue : float
Diese Eigenschaft enthält den maximalen X-Wert für die generierten Oberflächenpunkte.
Der Standardwert ist „ 10.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxXValue() const |
| void | setMaxXValue(float max) |
Benachrichtigungssignal:
| void | maxXValueChanged(float value) |
maxYValue : float
Diese Eigenschaft enthält den maximalen Y-Wert für die generierten Oberflächenpunkte.
Standardwert ist „ 10.0 “.
Bei der Festlegung dieser Eigenschaft wird der entsprechende Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxYValue() const |
| void | setMaxYValue(float max) |
Benachrichtigungssignal:
| void | maxYValueChanged(float value) |
Siehe auch „ autoScaleY “.
maxZValue : float
Diese Eigenschaft enthält den maximalen Z-Wert für die generierten Oberflächenpunkte.
Der Standardwert ist „ 10.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Minimalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | maxZValue() const |
| void | setMaxZValue(float max) |
Benachrichtigungssignal:
| void | maxZValueChanged(float value) |
minXValue : float
Diese Eigenschaft enthält den minimalen X-Wert für die generierten Oberflächenpunkte.
Der Standardwert ist „ 0.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minXValue() const |
| void | setMinXValue(float min) |
Benachrichtigungssignal:
| void | minXValueChanged(float value) |
minYValue : float
Diese Eigenschaft enthält den minimalen Y-Wert für die generierten Oberflächenpunkte.
Standardwert ist „ 0.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minYValue() const |
| void | setMinYValue(float min) |
Benachrichtigungssignal:
| void | minYValueChanged(float value) |
Siehe auch „ autoScaleY “.
minZValue : float
Diese Eigenschaft enthält den minimalen Z-Wert für die generierten Oberflächenpunkte.
Standardwert ist „ 0.0 “.
Bei der Einstellung dieser Eigenschaft wird der entsprechende Maximalwert bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt.
Zugriffsfunktionen:
| float | minZValue() const |
| void | setMinZValue(float min) |
Benachrichtigungssignal:
| void | minZValueChanged(float value) |
Dokumentation der Mitgliedsfunktionen
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(QObject *parent = nullptr)
Erstellt ein `QHeightMapSurfaceDataProxy` mit dem angegebenen ` parent`.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QImage &image, QObject *parent = nullptr)
Erstellt ein `QHeightMapSurfaceDataProxy` mit den angegebenen Werten für ` image ` und ` parent`. Die Höhenkarte wird durch Aufruf von ` setHeightMap()` mit ` image` festgelegt.
Siehe auch heightMap.
[explicit] QHeightMapSurfaceDataProxy::QHeightMapSurfaceDataProxy(const QString &filename, QObject *parent = nullptr)
Erstellt ein `QHeightMapSurfaceDataProxy` aus dem angegebenen Bild filename und parent. Die Höhenkarte wird durch den Aufruf von ` setHeightMapFile()` mit ` filename` festgelegt.
Siehe auch heightMapFile.
[override virtual noexcept] QHeightMapSurfaceDataProxy::~QHeightMapSurfaceDataProxy()
Löscht „ QHeightMapSurfaceDataProxy “.
void QHeightMapSurfaceDataProxy::setHeightMap(const QImage &image)
Ersetzt die aktuellen Daten durch die in „ image “ angegebenen Höhenkartendaten.
image kann in verschiedenen Formaten angegeben werden; sollte es jedoch nicht in einem direkt verwendbaren Format vorliegen, wird eine Konvertierung durchgeführt.
Hinweis: Sollte das Ergebnis falsch erscheinen, ist die automatische Konvertierung fehlgeschlagen, und Sie sollten versuchen, die „ image “ selbst zu konvertieren, bevor Sie sie festlegen. Das bevorzugte Format ist „ QImage::Format_RGB32 “ in Graustufen.
Die Höhe des „ image “ wird aus der Rotkomponente der Pixel ermittelt, wenn das „ image “ in Graustufen vorliegt. Andernfalls handelt es sich um einen Mittelwert, der aus den Rot-, Grün- und Blaukomponenten der Pixel berechnet wird. Die Verwendung von Graustufenbildern kann die Geschwindigkeit der Datenkonvertierung bei großen Bildern verbessern.
Nicht empfohlene Formate: alle Monochrom-Formate (z. B. „ QImage::Format_Mono “).
Die Höhenkarte wird asynchron ausgewertet. QSurfaceDataProxy::arrayReset() wird ausgelöst, sobald die Daten ausgewertet wurden.
Hinweis: Setter -Funktion für die Eigenschaft ` heightMap`.
Siehe auch ` heightMap()`.
void QHeightMapSurfaceDataProxy::setHeightMapFile(const QString &filename)
Ersetzt die aktuellen Daten durch Höhenkartendaten aus der durch ` filename` angegebenen Datei.
Hinweis: Setter -Funktion für die Eigenschaft „ heightMapFile “.
Siehe auch „ heightMapFile()“ und „ heightMap “.
void QHeightMapSurfaceDataProxy::setValueRanges(float minX, float maxX, float minZ, float maxZ)
Eine Komfortfunktion zum gleichzeitigen Festlegen aller Minimalwerte (minX und minZ) und Maximalwerte (maxX und maxZ). Die Minimalwerte müssen kleiner sein als der entsprechende Maximalwert. Andernfalls werden die Werte so angepasst, dass sie gültig sind.
© 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.
